README.md

Reseed

Reseed is an open-source tool for integrating static sites into subpaths.

Requires node >=10.0.0

Contents

• Installation & Usage
• Commands
  • reseed
  • reseed clone-assets
  • reseed rewrite-css
  • reseed rewrite-html
  • reseed rewrite-sitemap
  • reseed serve
  • reseed watch
• Options

Installation & Usage

Install with npm globally: npm install -g reseed or as a dev dependency: npm install -D reseed.
Then run using the following structure:

$ reseed [command] [options]

For example: reseed -s path/to/src -d path/to/dest -b baseurl

Once installed you can also set up your package.json with a custom script, such as:

{
  "scripts": {
    "reseed": "reseed -s path/to/src -d path/to/dest -b baseurl"
  }
}

Then use npm run reseed within your project.

Alternatively, you can use npx to avoid installing reseed as a dependency.
For example: npx reseed -s path/to/src -d path/to/dest -b baseurl

Commands

All commands (except clean) require both baseurl and dest options set.
The clean command only requires the dest option set.

See Options for more info.

reseed

Cleans destination directory, and copies files from src to dest/baseurl. CSS and HTML files have their hrefs/urls/etc (excluding external links) rewritten so that baseurl is prepended.

Example:

$ reseed -s path/to/src -d path/to/dest -b baseurl

reseed clean

Deletes all files in the destination directory.

Example:

$ reseed clean -d path/to/dest

reseed clone-assets

Copy all files (excluding CSS and HTML) from source to destination/baseurl without altering the data.

Example:

$ reseed clone-assets -b baseurl -d path/to/dest

reseed rewrite-css

Copies css files from src to dest/baseurl. Then rewrites the newly copied files so that urls/hrefs/etc that reference local content have baseurl prepended to them.

Example:

$ reseed rewrite-css -b baseurl -d path/to/dest

reseed rewrite-html

Copies html files from src to dest/baseurl. Rewrites the newly copied files so that internal urls/hrefs/etc have baseurl prepended to them.

Example:

$ reseed rewrite-html -b baseurl -d path/to/dest

reseed rewrite-sitemap

Copies the sitemap from src to dest/baseurl. Rewrites the copied file so that links have baseurl prepended to them. If the provided file is a sitemap index, the referenced sitemaps will be processed similarly.

The sitemap (or sitemap index) file can be specified using the -m | --sitemap option. If no sitemap file is specified, will default to sitemap.xml.

Example:

$ reseed rewrite-sitemap -b baseurl -d path/to/dest -m sitemapindex.xml

reseed rewrite-rss

Copies the specified RSS file(s) from src to dest/baseurl. Rewrites the copied file(s) so that links have baseurl prepended to them.

The RSS file must be specified using the -r | --rss option. This option is a glob. The specified file(s) must have the .xml extension.

If using a glob with wildcards (*) you must wrap the glob in quotes. See the example below.

Example:

$ reseed rewrite-rss -b baseurl -d path/to/dest -r "**/index.xml"

reseed serve

Runs reseed, then serves the files on a local webserver, so that they may be viewed in a browser. Then runs watch.

Example:

$ reseed serve -s path/to/src -d path/to/dest -b baseurl

reseed watch

Continuously watches the src directory to check for changes. If a change occurs, a new build is triggered, and the browser is then reloaded.

Example:

$ reseed watch -s path/to/src -d path/to/dest -b baseurl

Ignore

Prevents reseed from adding the baseurl infront of an elements path

<a href="/manual" reseed-ignore>Click me!</a>

Options

Option	Alias	Type	Description
--source	-s	String	The source folder to clone. Defaults to current working directory.
--dest	-d	String	The destination folder to clone the files to.
--baseurl	-b	String	The filename to prepend to the files in the source.
--port	-p	Integer	The port number to serve the cloned site on.
--extrasrc	-e	String	Extra src attribute to be rewritten. Can set multiple attributes by specifying the flag multiple times.
--sitemap	-m	String	Path to the index sitemap. Defaults to sitemap.xml.
--rss	-r	String	Glob to rss file or files.
--overwrite	-o	Boolean	When cleaning --dest, don't prompt for confirmation.
--split		Integer	The number of partitions to divide files into.
--partition		Integer	The partition number to process.
--help		Boolean	Show help in the terminal