2023-02-09 10:12:01 -05:00
# Atlas48's Neocites Archives
2023-10-24 09:59:38 -04:00
Welcome to the technical documentation for my [Neocities ](https://neocities.org ) 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.
2023-02-09 10:12:01 -05:00
# License
All markup is licensed under the Creative Commons [Attribution 4.0 International (CC BY 4.0) ](https://creativecommons.org/licenses/by/4.0/ ) license.
Any runnable computer code or Sass/CSS definitions are licensed under the [GNU General Public License v3.0 ](https://www.gnu.org/licenses/gpl-3.0.html )
# Specification
## Dependencies
You will need the following tools to render and upload the site
2023-10-24 09:59:38 -04:00
- A [Ruby ](https://www.ruby-lang.org/en/ ) interpreter
2023-02-09 10:12:01 -05:00
- [RedCloth ](http://redcloth.org/ )
- [org-ruby ](http://github.com/bdewey/org-ruby )
- [comrak ](https://github.com/kivikakk/comrak )
## `Makefile`
2023-02-19 09:53:44 -05:00
Wraps `render.sh` for the most part.
2023-02-09 10:12:01 -05:00
### 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/`
