Welcome!

Tobogma is a reasonable static site generator. It generates simple, readable HTML sites with exactly one command and one configuration file. You can install themes, use existing ones, or create your own, and it's all fairly easy. You can create your own custom navigation bar, and even add 10 pounds of JavaScript to your blog about design or whatever the kids do these days.

Features

Tobogma doesn't boast many fancy features that other static site generators don't have, but...

• Written somewhat readably in sorta commented Python 3
• Generates fully readable HTML no matter what template you use, using Beautiful Soup.
• Simple templating "engine" (really, it just pastes your HTML and all static assets into the output site)
• Pages are written in Markdown and parsed using markdown2
• Templates are raw HTML and CSS with simple character sequences
• Generates completely static sites as HTML files, which you can upload to any web hosting service, be it GitHub Pages, Neocities, or Codeberg

Themes

Tobogma's theming system is painfully simple. Themes are composed of the following file structure:

--- themes
  |_ your theme
    |_ static
      |- styles.css
    |- header.html
    |- footer.html

If you install a theme, you just copy the folder containing the HTML files and static folder to Tobogma's themes folder, then edit your config.json to represent the changes you made.

Tutorial

Coming Soon™