Tota logo

Docs

Getting started

  • Overview
  • Commands
  • Configuration

Usage

  • Pages
  • Posts
  • Front matter
  • Templates
  • Assets
  • Deployment

Posts

Blogging is a popular use-case for static-site generators, and Tota makes it easy to create one.

Posts are pages that contain additional information that allow Tota to create blog-specific features like archive and tag pages. Since all posts are pages (but not all pages are posts), everything that applies to pages also applies to posts.


Directory

Posts are written in Markdown (.md) format and are stored in a separate top-level posts directory. Tota will convert these files to HTML and save them in the public directory when your site is built.

However, unlike pages, posts will be stored in a nested directory inside the public directory. The name of this directory is the same as the posts directory, which can be changed in the configuration settings.

Since this sub-directory will be reflected in the final URL, you may wish to rename your posts directory:

TOTA_POSTS_DIR="blog"

This will create a URL structure of https://www.example.com/blog/hello-world.


Create a post

Create a new post by running the new command. This will create a new Markdown file in the posts directory.

tota new --type post "Talkative Parrot for Sale"

This will create the file posts/talkative-parrot-for-sale.md. Alternatively, you can manually create files in the posts directory.


Related

  • Pages
  • Front matter
  • Templates
Tota logo

Tota is a static-site generator made by @izolate.


© 2025 Tota. MIT license.

Site links

  • house Home
  • open book Docs
  • question mark Articles

Open source

  • Pub
  • GitHub
  • File an issue
  • Edit this site