You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
hex e32c33de4f updated readme 1 year ago
license.md license and cleanup 2 years ago
readme.md updated readme 1 year ago
stagen.py markdown post support 1 year ago

readme.md

This is an incredibly simple static site generator

HOW TO USE: Your project should look like this.

stagen.py
templates/{templates}.html
templates/post.html
templates/posts.html
content/{html files here}.html
output/
posts/{posts}.md

An easy way to install this is checkout the repo and symlink stagen.py to your project root directory

When you run stagen.py it just takes jinja2 and processes every .html file in content as a template mirrored to the output directory. You can access templates in the templates folder but these are not automatically processed. Refer to the Jinja2 docs for more info.

For posts, the post.html file is used when processing a post in markdown format, and posts.html is used for displaying the list of posts.

More documentation on that in the future but for now just make sure those files exist or it’ll get mad at you

EXAMPLE

templates/page.html

<h1>A header</h1>
{% block content %}{% endblock %}

content/index.html

{% extends "templates/page.html" %}
{% block content %}
<p>Some Content</p>
{% endblock %}

this will output a file in the output folder titled index.html with the contents

<h1>A header</h1>
<p>Some Content</p>

html files in the output directory are rewritten each run but everything else is safe.