kallithea Files · docs/usage/subrepos.rst

Files @ 24498ba2fbec

Branch filter:

Location: kallithea/docs/usage/subrepos.rst

24498ba2fbec 1013 B text/prs.fallenstein.rst Show Annotation Show as Raw Download as Raw

Bradley M. Kuhn

SETTINGS_PREFIX for identifiers (e.g., db table names) incl. project's name.

kallithea.SETTINGS_PREFIX is a variable string used as a prefix for specific
external identifiers, such as database table names (and likely later form
fields), so that the name of the project need not necessarily be encoded into
data.

This setting is configurable so that compatibility with old, similar
databases can be maintained at the users' request.

.. _subrepos:

=============================================
working with Kallithea and mercurial subrepos
=============================================

example usage of Subrepos with Kallithea::

    ## init a simple repo
    hg init repo1
    cd repo1
    echo "file1" > file1
    hg add file1
    hg ci --message "initial file 1"

    #clone subrepo we want to add
    hg clone http://rc.local/subrepo

    ## use path like url to existing repo in Kallithea
    echo "subrepo = http://rc.local/subrepo" > .hgsub

    hg add .hgsub
    hg ci --message "added remote subrepo"



In file list of repo1 you will see a connected subrepo at revision it was
during cloning.
Clicking in subrepos link should send you to proper repository in Kallithea

cloning repo1 will also clone attached subrepository.

Next we can edit the subrepo data, and push back to Kallithea. This will update
both of repositories.

see http://mercurial.aragost.com/kick-start/en/subrepositories/ for more
information about subrepositories