Ark

A static website generator for people who enjoy the simpler things in life.

Version 7.7.0

Home


Ark is a static website generator built in Python. It's small, elegant, and simple to use.

$ ark --help

Usage: ark [command]

  Ark is a static website generator. It transforms a
  directory of text files into a self-contained website.

Flags:
  -h, --help        Print the application's help text.
  -v, --version     Print the application's version.

Commands:
  build             Build the site.
  clear             Clear the output directory.
  init              Initialize a new site directory.
  serve             Run the test server.
  tree              Print the site's node tree.
  watch             Monitor the site directory and
                    automatically rebuild on changes.

Command Help:
  help <command>    Print the command's help text.

You can build many different kinds of websites using Ark but it's particularly suited to building project documentation like the documentation you're looking at right now.

Formats

Ark has builtin support for content written in Markdown, Syntext, or plain HTML, but Ark itself is format-agnostic — you can write your content in any format with a suitable Python library.

Similarly, Ark has builtin support for Jinja and Ibis templates but can use any template language with a suitable Python library.

Installation

Install Ark from the Python Package Index using pip:

pip install ark

Ark requires Python 3.10 or later.

License

Zero-Clause BSD (0BSD).