Tota logo

Docs

Getting started

  • Overview
  • Commands
  • Configuration

Usage

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

Pages

The most basic type of resource, usually devoid of any dates, and suitable for home pages, landing pages, and other standalone site pages.


Directory

Pages are written in Markdown (.md) format and stored in the pages directory. Tota will convert these files to HTML and save them in the public directory when your site is built.

The pages directory location can be changed in the directory configuration.

TOTA_PAGES_DIR="pages"

Create a page

Create a new page by running the new command. This will create a new Markdown file in the pages directory.

tota new "Parrots and Cockatoos"

Alternatively, you can manually create files in the pages directory.


Filenames

By default, the new command will transform your page title into a slug and use that as the filename. For example, the command from the example above will produce the file:

pages/parrots-and-cockatoos.md

⚠️ Filename are important! They are re-used for the HTML files and therefore reflected in the URL. Make sure your filenames are URL-friendly and don't contain unsafe characters like spaces and punctuation marks.


Sub-directories

You can group related pages into sub-directories within the pages directory. The same directory structure will be re-used in the public directory when Tota builds your site.

This allows you to create a nested URL structure:

https://www.example.com/birds/psittaciformes/parrot.html

Related

  • Posts
  • 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