Creating pages is not much different from writing posts. You're still required to include the map representing the metadata and the page must be written in valid Markdown.
The Pages Folder
Similar to your posts, all of your pages should reside under the page-root folder specified in your configuration file. Again, as long as the file contains the proper metadata followed by valid Markdown content, they will be converted into an HTML page.
Creating Pages
To create a new page, just make a new Markdown/AsciiDoc file under your page-root. You don't need to include a date in the file name or in the metadata like you did a post but words should still be dash-separated and the file must have a .md or .asc extension. For example:
about.md
my-projects.md
contact-me.asc
Page Contents
The following information is mandatory in your page metadata.
| Key | Description |
|---|---|
title | Your post title provided as a string. |
page-index | Because pages can be linked up with previous/next links, this is how they get sorted. |
These are some optional keys that you may provide:
| Key | Description |
|---|---|
navbar? | Set this to true if you want the link to this page to appear in the navbar. Set it to false or leave out the key if you want it in the sidebar. |
home? | Set this to true if you want to use this page as your index rather than a blog post or list of previews. Only one page may have this flag set to true. This page will not be part of your navbar-pages or sidebar-pages collection. The :layout key will be respected. :previews? must be set to false in the config.edn. |
toc | Set this to true if you want a table of contents to be generated from the headers/headings in your post. (The default table of contents format is an ordered list. Set this to :ul if you want a bulleted list.) |
toc-class | Specify the class that you want attached to the root element of your TOC (either ul or li). If this is not provided then the compiler will look for the class in config.edn. If neither are provided then "toc" is used. |
klipse | Set Klipse configuration for the post. See Klipse Integration for details. |
layout | A keyword corresponding to an HTML file under themes/{theme}/html. Defaults to :page. |
description | Provide a custom description for the post (available as {{post.description}} in the templates) instead of the one created automatically from the post's preview. Set it to false to disable description for the page. (post.description will thus be nil.) |
For example:
{:title "Check out this page!"
:page-index 0
:navbar? false
:home? false}
Images in Your Pages
You can include images in your pages in the same way you include images in your blog posts. Please refer to the "Including Images in Posts" and "Images in Markdown" sections of the Writing Posts page.
Linking to other Posts or Pages
You can link to other pages or posts on your site in the same way you include these links in your blog posts.
Highlighting Code Snippets
Want to show off your code in a page? It works the same way as it does in posts. Just wrap your code block in triple backticks and highlight.js will take care of the rest.