sceox
05b50d5c5f
The old build system worked, but ssg adds some features while still being simple and easy to hack on: * set page title from the h1 tag, rather than the file name * generate a sitemap (which we adapt to also generate a nav) This site doesn't need a dynamic nav, but the Anarchy Planet docs site will have a lot of rapidly changing pages and will benefit from a dynamic nav. This way we can use the same build system for both sites.
1.6 KiB
1.6 KiB
Anarchy Planet web site
This repo includes markdown files for the Anarchy Planet web site and tools to generate a static HTML site from the source files.
You can see this method in action at https://testing.anarchyplanet.org.
Contributing
If you are familiar with editing markdown and using git, you should already be able to figure out how to contribute.
TODO: write docs for someone who's not familiar with editing markdown and/or using git.
Dependencies
We use lowdown for markdown conversion. See its documentation:
- overview
- lowdown(1)
- lowdown(5) which describes the lanuage syntax
The rest of the heavy lifting is done by a modified version of ssg which is included in this source code.
TODOs
- TODO discuss and decide on sections
- notnull's proposals for the sections are:
- home
- projects (not services)
- webring (instead of 'others')
- contact (probably just a mailto: link)
- notnull's proposals for the sections are:
- write copy for sections
- What rocinante has done on anarchist news is already pretty great. Maybe these could be more verbose, but maybe they are fine the way they are!
- add a favicon
- use an automatic toc generator
- and add to Makefile (make toc)
- see https://github.com/ekalinin/github-markdown-toc