fusions.ssg Configuration

The following configuration options are available for you to override in your project's src/fusion.json file:

postsFolder
baseURL
wips
tokens
conditional includes

postsFolder

The name to use for the folder that hosts your site's posts.

default: "posts"

Example: Assigning "blog" as the name to use for the folder to host posts.

"postsFolder": "blog""

baseURL

The name of the subfolder that your site is served from. Please see baseURL Tokens for more information.

default: ""

Example: Assign the name of the subfolder to use


"baseURL": "/fusion.ssg.docs"

wips

These are the paths to the files and folders that are located in the src/templates folder that are works in progress and that are to be ignored during release builds. To learn more about wips, please read Works In Progress.

default: []

Example: Declaring the files and folders located in the src/templates folder that are to be ignored during release builds.

"wips": ["docs/next-version/", "!docs/next-version/index.md"]

Files and folders prepended with "!" are negated and will be generated.

Folders must be appended with "/".

tokens

Simple token property values declared here are global to the project and replace all matching simple tokens declared in all HTML documents. If both a local simple token and a global simple token have the same name the local simple token takes precedence. Please see Simple Tokens for more information.

default: {}

Example: Declaring simple global tokens.

"tokens": {"version": "v1.0.0"}

Conditional Includes

Introduced in v1.2.0

These are files located in the src/includes folder that are specifically targeted for either development or release builds, but not for both.

default: conditionalIncludes: { developmentOnly: [], releaseOnly: [] }

Example: Declaring conditional includes.

"conditionalIncludes": {
    "developmentOnly": ["path/to/include/in/src/includes", ...],
    "releaseOnly": ["path/to/include/in/src/includes", ...]
}

All paths must be relative to the src/includes folder.