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">Click me!</a>

Options