Creating a new page is simple. Create a new .html file, add a metadata block at the top, write your content below it, and drop it into the pages/ folder. The framework picks it up automatically — no registration, no database entry, no config change needed. Access it at yoursite.com/filename.
You can also organise pages into subfolders. A file at pages/docs/setup.html is accessible at yoursite.com/docs/setup.
Posts work the same way — the only difference is they live in pages/posts/ instead, which means they appear in the post archives page and the RSS feed.
If you prefer to create and edit pages in the browser rather than directly in the file system, the optional editor plugin lets you do exactly that. See the Editor documentation for setup instructions.
Each page requires specific metadata:
<!-- pagetitle: -->
<!-- pagelayout: -->
<!-- pagedate: -->
<!-- pageimage: -->
<!-- pageexcerpt: -->
<!-- pagekeywords: -->
<!-- pageauthor: -->
<!-- pagetype: -->
- pagetitle: The page title serves as the main header and browser tab title.
- pagelayout: Determines the theme layout applied. Usually, this defaults to 'page,' but your theme may offer alternative layouts.
- pagedate: Indicates the publication date, typically your own, although the system can use the file's timestamp if left blank.
- pageimage: Associates an image with the page, crucial for search engine visibility and, if applicable, as a thumbnail in layouts. Ensure the image path matches the page type (
pages/imagesfor pages,pages/posts/imagesfor posts). - pageexcerpt: Provides a concise 120-character summary, serving as a description or tagline.
- pagekeywords: Comprise essential terms for search engine optimization.
- pageauthor: Identifies the author for posts, appearing beneath the title.
- pagetype: Categorizes the page for search engines. Here are the possible categorizations:
website, article, blog, profile, video, music, book, product.