README



Ikiwiki w/ translations
=======================

Ikiwiki[1] is a perl-based wiki compiler.

This is routines to manage translatable parts of Ikiwiki and translations into
the following locales:

 * danish (da) by Jonas Smedegaard <dr@jones.dk>


Getting the source
------------------

This README file and related scripts are available at http://source.jones.dk/
as a GIT repository. Pull it like this:

    git clone http://source.jones.dk/ikiwiki.git


Installation
------------

To pull in all translatable and translated parts, do this:

    make

To pull in all parts with write access to the repository, do this:

    make origin_ikiwiki='login@example.com:path/to/repositories/ikiwiki_$(underlay).git'

To remove all translatable and translated parts, and anything else below those
directories without warning, do this:

    make ultraclean


Customizing
-----------

To publish your own forked repository through web, you first need to create a
special public repository that you "push" your changes into from your private
working repository - like this:

    GIT_DIR=public_dir/repository_name.git git --bare init --shared
    chmod +x public_dir/repository_name.git/hooks/post-update

To actually use your newly created public repository created above, you need to
populate it with your current working repository (the --all option is only this
once, not on subsequent pushes) - like this:

    git config remote.origin.url git-reference-to-public-repository
    git push --all

To resyncronize an older fork of the repository with newer upstream changes, do
like this (skip first command on subsequent updates):

    git remote add ikiwiki http://source.jones.dk/ikiwiki.git
    git pull ikiwiki master


----

References:

[1] http://ikiwiki.info/