Configuring a Remote Repository

The ./bin/ directory of the source code contains a post-update script. Either copy this script to ./.git/hooks/post-update link it with a symbolic link. To activate the hook, make it executable.

When a remote user pushes changes to the repository with git-push, the post-update hook will run and rebuild any changed files using Pandoc. This hook fundamentally updates the working copy and runs make to rebuild any changed Markdown/Pandoc files.

The working branch of the remote repository should not be updated locally, otherwise updates are likely to cause conflicts. Changes made locally are lost when a 'git reset --hard' is used.

If the local checked out repository misbehaves:

  1. Make a backup of the repository
  2. git reset --hard HEAD
  3. make clean
  4. make

If you want to be sure things are really clean in step 3:

This will show all files that a git-clean will delete:

$ git clean -dxn

This will delete all those files:

$ git clean -dxf

Related Topics: AboutViki, CreatingABlankWiki

-- Frank Dean - 08 Feb 2010