Thomas' Static Web Site Generator

You look for an open source tool to help you build and maintain a classical static web site? Well you just found one…

Purpose

trgensit is open source software and documentation to automate most tasks to build and maintain a static web site. Its main functionality is to automatically generate and maintain the navigation links that allow the user to navigate the site.

My Requirements

I have built this tool to match my own requirements:

Simplicity
Platform independence
Compact and fast HTML code
Web site should also be usable from the local file system without HTTP server

Prerequisites

Knowledge of HTML, CSS and XSLT programming
Python >= 3.5
xsltproc
Any operating system where Python and xsltproc are available
I have tested under Windows 10 both 64-Bit and 32-Bit, using always the 32-Bit version of Python
I have also tested under Debian 9 "Stretch" and Debian 12 "Bookworm", both 64-Bit, with the stock python versions

Installation

Download the file trgensit.zip and unzip. It will create directory trgensit.

Filename	Version	Size (Bytes)	Date	Comment
trgensit.zip	V1.1.2	102 K	2024-09-28	Add Org mode documentation

There is no setup script to run. This tool is meant to run in the user space, administrator/root rights are not needed.

The directory module contains the python modules. Copy them to a place where you can easily run them.

Emacs Org Mode Option

If you intend to use Emacs Org mode to write the web-pages, you might want to download the extended ZIP file trgensit-org.zip. It contains the Org mode source code of the trgensit manual. I added the manual page trgensit/doc/site/usage/orgmode/index.htm about using Org mode with trgensit.

Usage

Browse file manual.html. It will direct you to the file doc/site/index.htm, from where you can read the manual pages of trgensit. The manual also serves as an example for a web-site.

Limitations

trgensit is limited to the following use cases

Only hierarchical, tree-like web sites are supported
All web site content is static, no dynamically created pages
Version control is out of scope of trgensit. However, standard tools can be used

Disclaimer

Use this software at your own risk. I do not take any responsibility or warranty.

This software is Open Source. Use it under the GNU Public License conditions. Please do read file COPYING.TXT.

Bugs

I am sure there are bugs. Please e-mail me.

History

Filename	Version	Size (Bytes)	Date	Comment
trgensit.zip	V1.1.2	102 K	2024-09-28	Add Org mode documentation
trgensit.zip	V1.1.1	80 K	2021-09-11	Extend and correct documentation
trgensit.zip	V1.1	72 K	2020-03-20	First public release