12345678910111213141516171819202122232425262728293031323334353637383940414243 |
- wepage: a werc-like site generator
- ========================================
- I used to use `werc <http://werc.cat-v.org/>`__ to make my home
- page. However, werc uses CGI, which is not supported by most of the
- modern web servers. After I knew how CGI works, I wrote a script
- called werc-gen, which simulates the CGI calls to generate the static
- pages. However, it still requires rc shell, which is not installed on
- a common GNU/Linux system, and usually fails to work. That's why I
- plan to write a new static site generator.
- Recently, I saw an article from Hacker News called `m4: the one true
- templating language <https://chrisman.github.io/9.html>`__, which I
- think is a good start to make my site generator. So I copy the werc
- HTML templates and rewrite them in m4, and make this project called
- wepage.
- The wepage site generator contains two tools:
- - navgen.py: generates the werc-like navigation side bar, currently
- written in Python
- - sitegen.sh: generates a site from markdown and reStructuredText
- files
- To use this tool, run::
- ./sitegen.sh <source dir> <dest dir>
- Then you get your site.
- Related work
- ----------------
- I saw another two small static site generators recently, and they look more simple:
- - `shayla <https://git.sr.ht/~ne02ptzero/shayla>`__: a very fast site generator written in C
- - ssg: the site generator which inspires shayla, using Unix shell, find, grep, awk
- License
- --------
- wepage is in the public domain.
|