Using Theme

Synopsis

PureBuilder Simply’s starting point is to make handwritten HTML convenient. Therefore, users can write all the HTML and CSS, or conversely, they must write them.

However, writing HTML and CSS is not an easy task for many users. The solution in PureBuilder Simply is to “copy what someone else has created.”

We call this a “theme” to make the terminology more consistent with other CMSs, but in PureBuilder Simply it should really be called a project template.

The PureBuilder Simply repository contains several themes, which can be applied by the pbsimply-init command to start a project with them applied.

Use Theme

To use an existing theme, use the -t option of pbsimply-init to specify the theme you wish to use.

pbsimply-init -t kramdown/init322 foo

This will use the kramdown/init322 theme.

The themes are separated by the document processor assumed by that theme. The kramdown/ theme is the one that uses Kramdown.

Use the -l option to list the available themes.

pbsimply-init -l

Install source files only

pbsimply-init creates Source and Build directories by default.

If you want to install (source) theme into Source, use -s option.

pbsimply-init -s foo

This command installs source theme into foo not foo/Source.

Apply different theme

If you want to change the theme of an already existing project, first create a project with that theme elsewhere.

pbsimply-init -t pandoc/newtheme bar

Then carefully check which files are overwritten by the theme, and if all is well, copy and merge.

If you know how the overwrite will be done without this check, you can use the -f option.

pbsimply-init -f -t pandoc/newtheme foo

Install theme

To use a theme published by a third party, copy the entire theme under ${XDG_CONFIG_HOME:-$HOME/.config}/pbsimply/themes. In Unix environment, it is usually ~/.config/pbsimply/themes directory, and if it does not exist, create it beforehand. On Windows, it is similarly %HOMEPATH%\.config\pbsimply, and it is easier to start by typing %HOMEPATH% in the Explorer address field.

The naming conventions for naming document processors do not apply to themes installed this way.

Themes published by third parties are not guaranteed to be secure. Please verify the contents at your own risk.