static wiki generator
fix typo
Generate atom feed
Add readme and license


browse  log 



You can also use your local clone with git send-email.


Ni is a static wiki generator. It allows you to write files that reference each other, and to generate an html output that includes links and back links.

#How to run

ni input output template.html atom-template.xml url


  • input: source folder containing .gmi files
  • ouput: destination folder for .html files
  • template.html: html template file
  • atom-template.xml: xml template for atom feed
  • url: canonical url where your site will be hosted

#How to use

In input folder, create files that end with .gmi. Use [[]] to reference other files in them. For example:

in coffee.gmi

# coffee

A popular machine is the [[aeropress]].

The above automatically create a link in the generated .html file, but it requires aeropress.gmi to be created:

# aeropress

Created by Alan Adler

Here is an example of template:

<!DOCTYPE html>
<html lang="en">
    <meta charset="UTF-8">
    <nav><a href="/">home</a> <a href="/changelog.html">changelog</a></nav>
    {{ template "content" . }}
      <a href="https://ichi.city">
	<img src="https://ichi.city/banner.png" alt="ichi"/>

Here is an example of an atom-template.xml:

<?xml version="1.0" encoding="utf-8"?>
<feed xmlns="http://www.w3.org/2005/Atom">
  <link rel="alternate" href="https://wiki.ichi.city"/>
  {{ template "content" . }}

Finally, an example of a canonical url is: https://wiki.ichi.city/ (make sure to add the trailing /)