metanohi/site/projects/mege/index.org

38 lines
1.3 KiB
Org Mode

#+title: mege
#&summary
mege is the generator used by metanohi
#&
#+license: bysa, page
#+license: agpl 3+, program
* mege
mege is a website generator. It was designed for metanohi and is released under
the AGPLv3+ license. It uses Python 3.1 and WSGI to work together with an
Apache 2.x server. It uses git for revision control and utilizes a slightly
modified Org-Mode syntax for documents.
+ [[./tests/][Tests]]
+ [[./docs/][Documentation]]
Both are works in progress, like mege. Note that the author of mege does
believe in good documentation. And while believing is not the same as doing,
good mege documentation /will/ exist at some point in {the near}&del a future.
*Note:* The part of mege that generates HTML from Org-Mode files works quite
well (surprisingly well, actually), but code-wise and design-wise it is not
great. In Danish, such code is called /slamkode/ which literally means
something like {/garbage/}/{/excrement code/} (I don't know the exact
translation of the "slam" I'm thinking of, but it's the stuff you'll find in
sewers). This part will have to be rewritten at some point, possibly to factor
in support for a new markup language meant to replace the current, somewhat
strange Org-Mode-my-mode mix.
* Download
No release is out yet. You can clone the current code with git (always
up-to-date):
: $ git clone git://metanohi.name/mege