gemini/README.md

~snit

The source files for my personal capsule, which can be viewed at:

=> Capsule (HTTPS)

=> Capsule (Gemini)

This capsule relies on STXGE, which is a static site generator I wrote myself using Guile Scheme. STXGE takes in source files written in Scheme, evaluates them to produce SGT(akin to SXML for GemText), then renders the SGT to XHTML and GemText.

=> STXGE Repository

=> SXML on Wikipedia

Building

The Makefile includes variables up top that may be messed with, such as paths to the STXGE tools if they aren't on your ${PATH}.

To build this capsule, you can run any of the following:

$ make            # Build everything
$ make gmi        # Only build for Gemini
$ make web        # Only build for HTTP(S)
$ make clean      # Delete rendered GMI/XHTML
$ make distclean  # Delete all build files
$ make wwwsrv     # Run a web server via Python

By default, the following directories are used:

• site/ contains document templates to render
• incl/ contains templates that can be included to provide code or data
• asst/ contains asset files such as media or stylesheets
• build/sgt/ will contain intermediary SGT data from evaluating templates
• build/sxml/ will contain intermediary SXML data, translated from the SGT
• dist/{www,gmi}/ will contain rendered XHTML and GemText documents, respectively