4
7
Fork
You've already forked untitled
4
powerful multi-site static site generator written in bash, using pandoc templates to produce HTML websites from markdown files. it's the same one that generates pages on libreboot.org and fedfree.org, originally written specifically for the libreboot site
Shell 84.2%
CSS 15.8%
Find a file
Leah Rowe 2cc45fba92 sitemap.xml: strip .html if /index.html
otherwise, for example a homepage entry would say:
https://example.com/.html
whereas it should say:
https://example.com/
Signed-off-by: Leah Rowe <leah@libreboot.org>
2025年01月20日 16:06:00 +00:00
include Enable to deploy websites in subdirectories. 2023年12月07日 05:25:36 +01:00
lang Add spanish support to lang/ 2024年01月14日 23:51:48 +00:00
www-example Add example website for deploying websites in subdirectories. 2023年12月07日 05:39:43 +01:00
.gitignore add tmp to gitignore 2023年08月05日 13:21:36 +01:00
build sitemap.xml: strip .html if /index.html 2025年01月20日 16:06:00 +00:00
clean move clean to include/clean.sh 2023年12月03日 20:05:53 +00:00
COPYING untitled static site generator 2021年05月18日 09:40:59 +01:00
README.md update the readme 2023年12月04日 17:28:14 +00:00
roll new feature: ./roll (update sites without nuking) 2023年12月03日 18:55:56 +00:00
title.example allow use of normal titles in files started with # 2021年05月22日 23:36:16 +01:00

Untitled static site generator

Multi-site static site generator! Written in POSIX sh, using Pandoc to generate HTML documents from Pandoc-variant Markdown files, with Pandoc templates, and it can generate newsfeeds/blogs with RSS. With Untitled, you can host any number of websites each with their own themes, headers, footers, navigation and everything else, all from the same instance.

Most other static site generators are not flexible enough to handle more than a few websites. Untitled's simple design (under 900 source lines of code) leans heavily on use of the templates features in Pandoc. Despite the simple design, Untitled is extremely powerful and can create many different kinds of websites.

Introduction

You can download the latest version of Untitled here:
https://untitled.vimuser.org/

For documentation, please also refer to the above website URL. This README is merely an introductory text, based on the homepage of the above website. The untitled website is also available in Git (the Untitled website itself is written as Markdown files, generated into HTML by Untitled!)

Pandoc can convert between many formats, but Untitled only supports converting from Markdown into HTML. It is written precisely and exclusively with the goal of making it easier for Free Software projects to create their own websites. This is to fight against the trend of crappy github-powered websites that plague the internet. It is highly desirable to see a return to the days where software projects have websites!

History

This software is very new, so expect some rough edges, and funky looking websites! Here are some websites that already are built using untitled:

Actually, it's not new at all. This static site generator was originally written for the Libreboot project website in 2017, but it was much simpler and even more broken than the version you're now reading about. That (very simple) generator was forked many times, across different websites, with different features added.

The untitled static site generator was created to combine the features of all the forks. Untitled static site generator was created by Leah Rowe, who also leads the Libreboot project. Untitled is heavily based on the original static site generator written by Alyssa Rosenzweig for the Libreboot website.

Untitled is Free Software. See the COPYING file included with the untitled static site generator. Learn more about Free Software:
https://writefreesoftware.org/ (basically, it means that you have control over your own copy, to do whatever you want with, and you could even fork it to make your own version if you wished)


This README file is released under the terms of the GNU Free Documentation License, version 1.3, as published by the Free Software Foundation with no Invariant sections, no Back Cover texts and no Front Cover texts. You can find this license here: https://www.gnu.org/licenses/fdl-1.3.en.html