a werc-like static site generator
Iru Cai
f03846f6a3
initial version
|
%!s(int64=3) %!d(string=hai) anos | |
|---|---|---|
| example-site | %!s(int64=3) %!d(string=hai) anos | |
| pub | %!s(int64=3) %!d(string=hai) anos | |
| wepage-tpl | %!s(int64=3) %!d(string=hai) anos | |
| README.rst | %!s(int64=3) %!d(string=hai) anos | |
| navgen.py | %!s(int64=3) %!d(string=hai) anos | |
| rst-template.txt | %!s(int64=3) %!d(string=hai) anos | |
| sitegen.sh | %!s(int64=3) %!d(string=hai) anos |
README.rst
wepage: a werc-like site generator
========================================
I used to use `werc `__ 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 `__, 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
Then you get your site.
Related work
----------------
I saw another two small static site generators recently, and they look more simple:
- `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.
========================================
I used to use `werc `__ 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 `__, 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
Then you get your site.
Related work
----------------
I saw another two small static site generators recently, and they look more simple:
- `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.