From 2be1fedb1ece4ef5ebb4427b2b3dcba6eac94277 Mon Sep 17 00:00:00 2001 From: User Date: Mon, 25 Jan 2010 17:28:27 +0000 Subject: renames --- git-wiki.page | 68 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 68 insertions(+) create mode 100644 git-wiki.page (limited to 'git-wiki.page') diff --git a/git-wiki.page b/git-wiki.page new file mode 100644 index 0000000..7538a43 --- /dev/null +++ b/git-wiki.page @@ -0,0 +1,68 @@ +--- +format: rst +categories: projects +toc: no +... + +======== +Git Wiki +======== + +'Git Wiki' is a django__ app which +stores a hierarchy of articles/items in a git__ repository; each item +is formated in reStructured Text, which can be reinterpreted into +XHTML or LateX (and thus a pdf document). + +__ http://djangoproject.com/ +__ http://git.cx + +It's implemenatation is '''incomplete'''. For personal use I ended up +moving to gitit__; see http://know.bnewbold.net for an example. + +Features +~~~~~~~~ +Full File History + Because all files are stored in a repository all changes are tracked + and can be reverted. It could be interesting to watch the evolution + of a larger or controversial item. +PDF Output + Using a combination of `LaTeX`__ and rubber [#]_, portable document + files can be generated on the fly (with figures etc included) +LaTeX Math in (X)HTML + When rendering to (X)HTML LaTeX math sections are rendered to png + and inserted as images + +__ http://know.bnewbold.net/software/latex +.. [#] A python wrapper around LaTeX and pdflatex which does a great job + handling bibliographies, weird image formats, etc. + +Dependencies +~~~~~~~~~~~~ +Pygments_ + A python library for highlighting and/or typesetting source code. Used to + format diffs (aka, history of items) + +rubber_ + Python script to make LaTeX compliation less painful. + +.. _Pygments: http://pygments.org/ +.. _rubber: http://www.sourceforge.net/rubber + +Development +~~~~~~~~~~~ +The source tree can be browsed at `bn-project `__; +you'll have to look for an old branch or tag? + +To Do +----- +* implement per-section commentary +* possibly implement aafigure ascii->svg plugin for docutils +* possibly implement auto linking for CamelCase text (probably not) +* implement grouping many articles into single pdf/book automagicly +* possibly implement web-based editing/item creation + +Similar Projects +~~~~~~~~~~~~~~~~ +* http://spu.tnik.org/ +* http://gitit.net/ + -- cgit v1.2.3