DEPRECATION NOTICE
THIS REPO IS NOW ARCHIVED. PLEASE VISIT site-neo2 ON sr.ht FOR ANY FURTHER UPDATES.
I enjoyed the process of writing a custom SSG, and I'm still proud of it, but this codebase is a mess, and I'm worried I'm going to wind up with something like PHP on my hands, where a fun little toy templating engine becomes the programming language that is most of the web.
I'm switching to Lume across all websites.
Atlas48's Neocities Archives
Welcome to the technical documentation for my Neocities page, which also contains a rudimentary static site generator cobbled together out of unix tools, and Ruby scripts, that I've taken to calling the "tape-and-string" framework for obvious reasons.
License
All markup is licensed under the Creative Commons Attribution 4.0 International (CC BY 4.0) license.
Any runnable computer code or Sass/CSS definitions are licensed under the GNU General Public License v3.0
All fonts belong to their respective owners.
Specification
Dependencies
You will need the following tools to render and upload the site
Makefile
Wraps render.sh for the most part.
Makefile Options
list
Lists all components in a heading-annotated list
list-{doc,sass,dir,rest}
Lists markup files, sass files, directories, and other files respectively.
clean
Removes the out/ directory that is generated on running of render.sh.
render.sh
The primary worker script, sets up the directory structure, transpiles the markup, then the Sass, then copies the contents of in/ to out/