Create 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 reality it should be called a project template.
The PureBuilder Simply repository contains several themes, and
pbsimply-init
applies a different theme than that.
And of course, there is absolutely no problem for users to publish
their own themes.
Structure of theme
An essential part of PureBuilder Simply’s design is the
template file. If Pandoc is used, it is the Pandoc template
obtained by pandoc -D html5
, otherwise it is the
eRuby template.
PureBuilder Simply uses this template to output HTML. For this reason, the template file is essential even if you want to output only the body text.
For designing, you will need CSS in addition to this. PureBuilder Simply does not have a “common template,” so you will need to distribute a set of templates as well as CSS to treat it as a theme.
Since the template determines what CSS is loaded, you are free to arrange the CSS as you wish. Conversely, when distributing a theme, file placement must also be fixed. This is also true for other materials, such as images.
Publish
For now, PureBuilder Simply does not have an official distribution location.
Please release PureBuilder Simply at your favorite place (e.g. GitHub).