The gitit package

[Tags: gpl, library, program]

Gitit is a wiki program. Pages and uploaded files are stored in a git repository and may be modified either by using git's command-line tools or through the wiki's web interface. Pandoc's extended version of markdown is used as a markup language. Pages can be exported in a number of different formats, including LaTeX, RTF, OpenOffice ODT, and MediaWiki markup. Gitit can be configured to display TeX math (using jsMath) and highlighted source code (using highlighting-kate).


[Skip to ReadMe]

Properties

Versions0.1.0.1, 0.1.1, 0.2, 0.2.1, 0.2.2, 0.2.2.1, 0.3, 0.3.1, 0.3.2, 0.3.3, 0.3.4, 0.3.4.1, 0.3.4.2, 0.4.1, 0.4.1.2, 0.4.1.3, 0.5, 0.5.1, 0.5.2, 0.5.3, 0.6.1, 0.6.2, 0.6.3, 0.6.4, 0.6.5, 0.6.6, 0.7, 0.7.1, 0.7.2, 0.7.2.1, 0.7.3, 0.7.3.1, 0.7.3.2, 0.7.3.3, 0.7.3.4, 0.7.3.5, 0.7.3.6, 0.7.3.7, 0.7.3.8, 0.7.3.9, 0.7.3.10, 0.7.3.11, 0.7.3.12, 0.8, 0.8.0.1, 0.8.1, 0.9, 0.9.0.1, 0.10, 0.10.0.1, 0.10.0.2, 0.10.1, 0.10.1.1, 0.10.1.2, 0.10.2, 0.10.3, 0.10.3.1, 0.10.4, 0.10.5, 0.10.5.1, 0.10.6, 0.10.6.1, 0.10.6.2, 0.10.6.3, 0.10.7, 0.11, 0.11.1
Change logNone available
Dependenciesbase (>=3), bytestring, cgi, containers, directory, filepath, HAppS-Data (==0.9.3.*), HAppS-Server (==0.9.3.*), HAppS-State (==0.9.3.*), highlighting-kate, HTTP, mtl, network, old-time, pandoc (>=1.1), parsec (<3), pretty, process, SHA (>1), syb, utf8-string, xhtml [details]
LicenseGPL
AuthorJohn MacFarlane
Maintainerjgm@berkeley.edu
Stabilityexperimental
CategoryNetwork
Home pagehttp://github.com/jgm/gitit/tree/master
Executablesgitit
UploadedSun Nov 23 19:56:13 UTC 2008 by JohnMacFarlane
DistributionsDebian:0.10.7, FreeBSD:0.10.6.1, NixOS:0.11
Downloads11235 total (537 in last 30 days)
Votes
0 []
StatusDocs not available [build log]
All reported builds failed as of 2015-05-29 [all 2 reports]

Downloads

Maintainers' corner

For package maintainers and hackage trustees

Readme for gitit-0.3.1

Gitit

Gitit is a wiki program written in Haskell. It uses HAppS for the web server and session state, git for storage, history, search, diffs, and merging, and pandoc for markup processing. Pages and uploaded files are stored in a git repository and may be modified either by using git's command-line tools or through the wiki's web interface. Pandoc's extended version of markdown is used as a markup language. Pages can be exported in a number of different formats, including LaTeX, RTF, OpenOffice ODT, and MediaWiki markup. Gitit can be configured to display TeX math (using jsMath) and highlighted source code (using highlighting-kate).

Getting started

Compiling and installing gitit

You'll need the GHC compiler and the cabal-install tool. GHC can be downloaded here. For cabal-install on *nix, follow the [quick install][] instructions.

If you want the syntax highlighting feature, you need to make sure that pandoc is compiled with support for it. First, make sure your system has the pcre library installed. Then:

cabal install pandoc -fhighlighting

You can skip this step if you don't care about highlighting support.

You can now install the latest release of gitit:

cabal update
cabal install gitit

To install a version of gitit checked out from the repository, change to the gitit directory and type:

cabal install

The cabal tool will automatically install all of the required haskell libraries. If all goes well, by the end of this process, the latest release of gitit will be installed in your local .cabal directory. You can check this by trying:

gitit --version

If that doesn't work, check to see that gitit is in your local cabal-install executable directory (usually ~/.cabal/bin). And make sure ~/.cabal/bin is in your system path.

Running gitit

To run gitit, you'll need git in your system path. Check this by doing

git --version

Switch to the directory where you want to run gitit. This should be a directory where you have write access, since two directories, static and wikidata, and a file, gitit-users, will be created here. To start gitit, just type:

gitit

If all goes well, gitit will do the following:

  1. Create a git repository, wikidata, and add a default front page.
  2. Create a static directory containing the scripts and CSS used by gitit.
  3. Start a web server on port 5001.

Check that it worked: open a web browser and go to http://localhost:5001.

Configuration options

You can set some configuration options when starting gitit, using the option -f [filename]. A configuration file takes the following form:

Config {
repositoryPath  = "wikidata",
userFile        = "gitit-users",
staticDir       = "static",
wikiLogo        = Just "/img/logo.png",
wikiTitle       = "Wiki",
wikiFooter      = "Powered by Gitit\n<!-- Logo courtesy of http://flickr.com/photos/wolfhound/127936545/, licensed under Creative Commons Attribution license -->",
tableOfContents = False,
maxUploadSize   = 100000,
portNumber      = 5001,
passwordSalt    = "l91snthoae8eou2340987",
debugMode       = True,
frontPage       = "Front Page",
noEdit          = ["Help", "Front Page"],
noDelete        = ["Help", "Front Page"],
accessQuestion  = Just ("Enter the access code (to request an access code, contact me@somewhere.org):", ["abcd"])
}

Configuring gitit

The static directory

If there is no wiki page or uploaded file corresponding to a request, gitit always looks last in the static directory. So, for example, a file foo.jpg in the img subdirectory of the static directory will be accessible at the url /img/foo.jpg. Pandoc creates three subdirectories of static, css, img, and js, which include the icons, stylesheets, and javascripts it uses.

Changing the theme

To change the look of the wiki, modify screen.css in static/css. To change the look of printed pages, modify print.css.

Adding support for math

Gitit is designed to work with jsMath to display LaTeX math in HTML. Download jsMath and jsMath Image Fonts from the jsMath download page. You'll have two .zip archives. Unzip them both in the static/js directory (a new subdirectory, jsMath, will be created). You can test to see if math is working properly by clicking "help" on the top navigation bar and looking for the math example (the quadratic formula).

To write math on a wiki page, just enclose it in dollar signs, as in LaTeX:

Here is a formula:  $\frac{1}{\sqrt{c^2}}$

You can write display math by enclosing it in double dollar signs:

$$\frac{1}{\sqrt{c^2}}$$

Highlighted source code

If gitit was compiled against a version of pandoc that has highlighting support (see above), you can get highlighted source code by using delimited code blocks:

~~~ {.haskell .numberLines}
qsort []     = []
qsort (x:xs) = qsort (filter (< x) xs) ++ [x] ++
               qsort (filter (>= x) xs) 
~~~

To see what languages are available:

pandoc -v

Accessing the wiki via git

All the pages and uploaded files are stored in a git repository. By default, this lives in the wikidata directory (though this can be changed through configuration options). So you can interact with the wiki using git command line tools:

git clone ssh://my.server.edu/path/of/wiki/wikidata
cd wikidata
vim Front\ Page.page  # edit the page
git commit -m "Added message about wiki etiquette" Front\ Page.page
git push 

If you now look at the Front Page on the wiki, you should see your changes reflected there. Note that the pages all have the extension .page.

Wiki links and formatting

For instructions on editing pages and creating links, see the "Help" page.

Upgrading and _local

HAppS uses the _local subdirectory to make state persistent. Gitit does not rely on this persistence; the configuration and user database are read from files on startup. So, it is okay to delete the _local subdirectory. You may need to do this after you have upgraded to a new version of gitit, with a different AppState data structure, because the new gitit will not be able to read the old gitit's state.

Reporting bugs

There is no bug tracker as yet, so report bugs directly to the author, jgm at berkeley . edu

Acknowledgements

The visual layout is shamelessly borrowed from Wikipedia.

The code in Gitit/State.hs is based on http://hpaste.org/5957 by mightybyte, as revised by dbpatterson.

The stylesheets are influenced by Wikipedia's stylesheets and by the bluetrip CSS framework (see BLUETRIP-LICENSE). Some of the icons in img/icons come from bluetrip as well.