Default Writer’s Block installation makes use of a tiny CSS sheet, a remix of https://bestmotherfucking.website/.
The stylesheet is located at
_static/css directory and is copied over to your
Layout Root upon initialising your site with
wb new (see: Usage).
wb comes with three templates out of the box:
- Main template - the outer HTML wrapping all your pages
- Index template - the inner HTML, rendered within Main template that is used for automatic directory indexing
- Single template - the inner HTML, rendered within Main template containing your markdown document(s) content
The only requirement is, all three must exist at least in your Layout Root.
Both stylesheet and the templates are copied over to your Layout Root when
wb new is executed during Installation.
You are free to edit them, if you don’t like the
For each subdirectory containing your markdown documents you can override any of the templates from the top-level Layout Root.
Say, your Layout Root is structured as follows:
my-wiki ├── thoughts │ ├── index.md │ ├── drafts │ │ ├── index.md │ │ ├── draft01.md │ │ ├── draft02.md │ │ └── draft03.md │ └── ideas.md ├── index.md ├── _main.html ├── _index.html └── _single.md
The templates that apply for all the pages are the ones in your root
directory. If, for whatever reason, you’d like to change how the documents in
thoughts/drafts render, you can maintain a copy of either
_single.html (or both) in
thoughts/drafts, like this:
my-wiki ├── thoughts │ ├── index.md │ ├── drafts │ │ ├── index.md │ │ ├── _single.html <- here │ │ ├── _main.html <- here │ │ ├── draft01.md │ │ ├── draft02.md │ │ └── draft03.md │ └── ideas.md ├── index.md ├── _main.html ├── _index.html └── _single.md
If you choose to only override
_main.html from the project
root will be used, and conversely, if you make a copy of only
_single.html will be used in
In the example above,
index.md documents were created in all the directories, meaning
wb will not
attempt to auto-index them. If you choose to remove
index.md from any of
wb will create one, using the Index template.