Skip to content

Commit

Permalink
Instructions for using custom templates and wide content.
Browse files Browse the repository at this point in the history
  • Loading branch information
valderman committed Mar 17, 2017
1 parent 9420dcb commit 9ad643a
Showing 1 changed file with 23 additions and 0 deletions.
23 changes: 23 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -142,6 +142,10 @@ Pages can have the following metadata items:
arbitrary (but consistent; i.e. will always be the same).
If `menuorder` is either `none` or a negative number, the page will not
appear in the main menu at all (but can, of course, still be linked manually).
* `template`. The name of the template to use for this page.
Templates live in the `templates` subdirectory, so if a page wants to use
`mytemplate` as its template, the file `templates/mytemplate.html` will be
loaded.


### Creating a page with a submenu
Expand All @@ -150,6 +154,25 @@ See the section [creating a page](#create_page); more specifically, the
discussion of the `submenu` metadata item.


### Creating a page with a custom template

See the section [creating a page](#create_page); more specifically, the
discussion of the `template` metadata item.
In short:

1. Create a new template (or copy from `default.html` and modify) in the
`templates` directory.
2. Set the `template` metadata variable to the name of your template, on all
pages that should use the custom template.


### Creating a page with very wide content

Create a page as usual, but set the `template` metadata item for the page
to `wide`. This will apply the `widecontent` CSS class to
the contents of your page.


### Creating a page with a quickref bar

In addition to the left sidebar containing the website's main menu, pages on
Expand Down

0 comments on commit 9ad643a

Please sign in to comment.