Templating

Using templates in simple-ssg is simple! All you need to do is provide a template.html file in any directory of your documentation.

NOTE: A nested template.html will take priority over a parent folder's template.html

An example template could be this:

<!DOCTYPE html>
<html>
    <head>
        <style>
            <!-- insert a style here -->
        </style>
    </head>
    <body>
      <h1>Contents:</h1>
        <!-- {TABLE_OF_CONTENTS} -->
      <hr>
        <!-- {CONTENT} -->
    </body>
</html>

This template contains two macros, the  macro which provides a simple bulleted list of all the page links for your static site, and , which is where the output of the Markdown and Djot converters goes.

Built-in Templates

There is currently one built-in template: github-markdown. Use the -t option to specify this template. You may also use -t force-none to force a blank page without a template!