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>

Additionally, the configuration has been simplified to not mention non-Git VCS
systems, and deprecated placeholder files has been removed from basewiki.


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

This README file is available at http://source.jones.dk/ together with a GIT
repository with source of the translation routines. Pull it like this:

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


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

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

    make


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 instead populate your newly created public repository with a multi-branched
local repository, first make a complete clone with all branches setup locally,
and push it all - like this for repository with master and master-da branches:

    git clone git-reference-to-old-public-repository some-temp-dir
    cd some-temp-dir
    git checkout -b master-da origin/master-da
    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 git://source.jones.dk/ikiwiki
    git pull ikiwiki master