Mercurial > kallithea

annotate docs/usage/vcs_support.rst @ 7223:5a8aa0a38e7d

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
less: rework select2 styling - make it shorter and more complete and flexible Mainly use 'inherit' to drop select2 styling, or use variables to apply Bootstrap styling. Tested to work with alternative color scemes - especially using non-white @kallithea-theme-inverse-color .
author Mads Kiilerich <mads@kiilerich.com>
date Sun, 01 Apr 2018 23:44:26 +0200
parents 4d04ac08fff7
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
4970
601282d36c06 docs/usage: generalize 'git support' into 'version control systems support'
Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
parents: 4955
diff changeset
1 .. _vcs_support:
601282d36c06 docs/usage: generalize 'git support' into 'version control systems support'
Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
parents: 4955
diff changeset
2
601282d36c06 docs/usage: generalize 'git support' into 'version control systems support'
Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
parents: 4955
diff changeset
3 ===============================
601282d36c06 docs/usage: generalize 'git support' into 'version control systems support'
Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
parents: 4955
diff changeset
4 Version control systems support
601282d36c06 docs/usage: generalize 'git support' into 'version control systems support'
Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
parents: 4955
diff changeset
5 ===============================
601282d36c06 docs/usage: generalize 'git support' into 'version control systems support'
Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
parents: 4955
diff changeset
6
601282d36c06 docs/usage: generalize 'git support' into 'version control systems support'
Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
parents: 4955
diff changeset
7 Kallithea supports Git and Mercurial repositories out-of-the-box.
601282d36c06 docs/usage: generalize 'git support' into 'version control systems support'
Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
parents: 4955
diff changeset
8 For Git, you do need the ``git`` command line client installed on the server.
811
bb35ad076e2f docs updates
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
9
4970
601282d36c06 docs/usage: generalize 'git support' into 'version control systems support'
Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
parents: 4955
diff changeset
10 You can always disable Git or Mercurial support by editing the
601282d36c06 docs/usage: generalize 'git support' into 'version control systems support'
Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
parents: 4955
diff changeset
11 file ``kallithea/__init__.py`` and commenting out the backend.
601282d36c06 docs/usage: generalize 'git support' into 'version control systems support'
Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
parents: 4955
diff changeset
12
601282d36c06 docs/usage: generalize 'git support' into 'version control systems support'
Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
parents: 4955
diff changeset
13 .. code-block:: python
601282d36c06 docs/usage: generalize 'git support' into 'version control systems support'
Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
parents: 4955
diff changeset
14
601282d36c06 docs/usage: generalize 'git support' into 'version control systems support'
Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
parents: 4955
diff changeset
15 BACKENDS = {
601282d36c06 docs/usage: generalize 'git support' into 'version control systems support'
Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
parents: 4955
diff changeset
16 'hg': 'Mercurial repository',
601282d36c06 docs/usage: generalize 'git support' into 'version control systems support'
Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
parents: 4955
diff changeset
17 #'git': 'Git repository',
601282d36c06 docs/usage: generalize 'git support' into 'version control systems support'
Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
parents: 4955
diff changeset
18 }
601282d36c06 docs/usage: generalize 'git support' into 'version control systems support'
Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
parents: 4955
diff changeset
19
5433
fbbe80e3322b docs: consistent spacing around headings
Mads Kiilerich <madski@unity3d.com>
parents: 5417
diff changeset
20
4937
326a9336fbe5 spelling: use correct Git capitalisation where appropriate
Andrew Shadura <andrew@shadura.me>
parents: 4902
diff changeset
21 Git support
4970
601282d36c06 docs/usage: generalize 'git support' into 'version control systems support'
Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
parents: 4955
diff changeset
22 -----------
2325
18d34a56a736 fix for issue #417, git execution was broken on windows for certain commands.
Marcin Kuzminski <marcin@python-works.com>
parents: 2095
diff changeset
23
5433
fbbe80e3322b docs: consistent spacing around headings
Mads Kiilerich <madski@unity3d.com>
parents: 5417
diff changeset
24
4902
03bbd33bc084 docs: rework stuff
Mads Kiilerich <madski@unity3d.com>
parents: 4192
diff changeset
25 Web server with chunked encoding
5575
ed2fb6e84a02 docs: use consistent style for section titles
Mads Kiilerich <madski@unity3d.com>
parents: 5434
diff changeset
26 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
5433
fbbe80e3322b docs: consistent spacing around headings
Mads Kiilerich <madski@unity3d.com>
parents: 5417
diff changeset
27
4970
601282d36c06 docs/usage: generalize 'git support' into 'version control systems support'
Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
parents: 4955
diff changeset
28 Large Git pushes require an HTTP server with support for
4955
4e6dfdb3fa01 docs: English and consistency corrections
Michael V. DePalatis <mike@depalatis.net>
parents: 4937
diff changeset
29 chunked encoding for POST. The Python web servers waitress_ and
4970
601282d36c06 docs/usage: generalize 'git support' into 'version control systems support'
Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
parents: 4955
diff changeset
30 gunicorn_ (Linux only) can be used. By default, Kallithea uses
6554
2c3d30095d5e gearbox: replace paster with something TurboGears2-ish that still works with the Pylons stack
Mads Kiilerich <madski@unity3d.com>
parents: 5575
diff changeset
31 waitress_ for `gearbox serve` instead of the built-in `paste` WSGI
4955
4e6dfdb3fa01 docs: English and consistency corrections
Michael V. DePalatis <mike@depalatis.net>
parents: 4937
diff changeset
32 server.
2023
c45fb78969a3 docs updates on git support
Marcin Kuzminski <marcin@python-works.com>
parents: 1123
diff changeset
33
6554
2c3d30095d5e gearbox: replace paster with something TurboGears2-ish that still works with the Pylons stack
Mads Kiilerich <madski@unity3d.com>
parents: 5575
diff changeset
34 The web server used by gearbox is controlled in the .ini file::
3224
8b8edfc25856 whitespace cleanup
Marcin Kuzminski <marcin@python-works.com>
parents: 2992
diff changeset
35
2023
c45fb78969a3 docs updates on git support
Marcin Kuzminski <marcin@python-works.com>
parents: 1123
diff changeset
36 use = egg:waitress#main
c45fb78969a3 docs updates on git support
Marcin Kuzminski <marcin@python-works.com>
parents: 1123
diff changeset
37
2325
18d34a56a736 fix for issue #417, git execution was broken on windows for certain commands.
Marcin Kuzminski <marcin@python-works.com>
parents: 2095
diff changeset
38 or::
18d34a56a736 fix for issue #417, git execution was broken on windows for certain commands.
Marcin Kuzminski <marcin@python-works.com>
parents: 2095
diff changeset
39
18d34a56a736 fix for issue #417, git execution was broken on windows for certain commands.
Marcin Kuzminski <marcin@python-works.com>
parents: 2095
diff changeset
40 use = egg:gunicorn#main
3224
8b8edfc25856 whitespace cleanup
Marcin Kuzminski <marcin@python-works.com>
parents: 2992
diff changeset
41
4902
03bbd33bc084 docs: rework stuff
Mads Kiilerich <madski@unity3d.com>
parents: 4192
diff changeset
42 Also make sure to comment out the following options::
2023
c45fb78969a3 docs updates on git support
Marcin Kuzminski <marcin@python-works.com>
parents: 1123
diff changeset
43
3224
8b8edfc25856 whitespace cleanup
Marcin Kuzminski <marcin@python-works.com>
parents: 2992
diff changeset
44 threadpool_workers =
8b8edfc25856 whitespace cleanup
Marcin Kuzminski <marcin@python-works.com>
parents: 2992
diff changeset
45 threadpool_max_requests =
8b8edfc25856 whitespace cleanup
Marcin Kuzminski <marcin@python-works.com>
parents: 2992
diff changeset
46 use_threadpool =
8b8edfc25856 whitespace cleanup
Marcin Kuzminski <marcin@python-works.com>
parents: 2992
diff changeset
47
2024
370e995e46c2 fixes in doc about waitress wsgi
Marcin Kuzminski <marcin@python-works.com>
parents: 2023
diff changeset
48
4971
9cef5a168b88 docs/usage: move Mercurial subrepository info to VCS support page
Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
parents: 4970
diff changeset
49 Mercurial support
9cef5a168b88 docs/usage: move Mercurial subrepository info to VCS support page
Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
parents: 4970
diff changeset
50 -----------------
9cef5a168b88 docs/usage: move Mercurial subrepository info to VCS support page
Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
parents: 4970
diff changeset
51
5433
fbbe80e3322b docs: consistent spacing around headings
Mads Kiilerich <madski@unity3d.com>
parents: 5417
diff changeset
52
4971
9cef5a168b88 docs/usage: move Mercurial subrepository info to VCS support page
Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
parents: 4970
diff changeset
53 Working with Mercurial subrepositories
5575
ed2fb6e84a02 docs: use consistent style for section titles
Mads Kiilerich <madski@unity3d.com>
parents: 5434
diff changeset
54 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
5433
fbbe80e3322b docs: consistent spacing around headings
Mads Kiilerich <madski@unity3d.com>
parents: 5417
diff changeset
55
4972
b52a1ccee927 docs/usage: reword information on Mercurial subrepository support
Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
parents: 4971
diff changeset
56 This section explains how to use Mercurial subrepositories_ in Kallithea.
b52a1ccee927 docs/usage: reword information on Mercurial subrepository support
Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
parents: 4971
diff changeset
57
b52a1ccee927 docs/usage: reword information on Mercurial subrepository support
Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
parents: 4971
diff changeset
58 Example usage::
4971
9cef5a168b88 docs/usage: move Mercurial subrepository info to VCS support page
Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
parents: 4970
diff changeset
59
9cef5a168b88 docs/usage: move Mercurial subrepository info to VCS support page
Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
parents: 4970
diff changeset
60 ## init a simple repo
4972
b52a1ccee927 docs/usage: reword information on Mercurial subrepository support
Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
parents: 4971
diff changeset
61 hg init mainrepo
b52a1ccee927 docs/usage: reword information on Mercurial subrepository support
Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
parents: 4971
diff changeset
62 cd mainrepo
b52a1ccee927 docs/usage: reword information on Mercurial subrepository support
Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
parents: 4971
diff changeset
63 echo "file" > file
b52a1ccee927 docs/usage: reword information on Mercurial subrepository support
Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
parents: 4971
diff changeset
64 hg add file
b52a1ccee927 docs/usage: reword information on Mercurial subrepository support
Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
parents: 4971
diff changeset
65 hg ci --message "initial file"
4971
9cef5a168b88 docs/usage: move Mercurial subrepository info to VCS support page
Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
parents: 4970
diff changeset
66
4972
b52a1ccee927 docs/usage: reword information on Mercurial subrepository support
Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
parents: 4971
diff changeset
67 # clone subrepo we want to add from Kallithea
4971
9cef5a168b88 docs/usage: move Mercurial subrepository info to VCS support page
Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
parents: 4970
diff changeset
68 hg clone http://kallithea.local/subrepo
9cef5a168b88 docs/usage: move Mercurial subrepository info to VCS support page
Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
parents: 4970
diff changeset
69
4972
b52a1ccee927 docs/usage: reword information on Mercurial subrepository support
Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
parents: 4971
diff changeset
70 ## specify URL to existing repo in Kallithea as subrepository path
4971
9cef5a168b88 docs/usage: move Mercurial subrepository info to VCS support page
Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
parents: 4970
diff changeset
71 echo "subrepo = http://kallithea.local/subrepo" > .hgsub
9cef5a168b88 docs/usage: move Mercurial subrepository info to VCS support page
Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
parents: 4970
diff changeset
72 hg add .hgsub
9cef5a168b88 docs/usage: move Mercurial subrepository info to VCS support page
Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
parents: 4970
diff changeset
73 hg ci --message "added remote subrepo"
9cef5a168b88 docs/usage: move Mercurial subrepository info to VCS support page
Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
parents: 4970
diff changeset
74
4972
b52a1ccee927 docs/usage: reword information on Mercurial subrepository support
Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
parents: 4971
diff changeset
75 In the file list of a clone of ``mainrepo`` you will see a connected
b52a1ccee927 docs/usage: reword information on Mercurial subrepository support
Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
parents: 4971
diff changeset
76 subrepository at the revision it was cloned with. Clicking on the
b52a1ccee927 docs/usage: reword information on Mercurial subrepository support
Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
parents: 4971
diff changeset
77 subrepository link sends you to the proper repository in Kallithea.
4971
9cef5a168b88 docs/usage: move Mercurial subrepository info to VCS support page
Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
parents: 4970
diff changeset
78
4972
b52a1ccee927 docs/usage: reword information on Mercurial subrepository support
Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
parents: 4971
diff changeset
79 Cloning ``mainrepo`` will also clone the attached subrepository.
4971
9cef5a168b88 docs/usage: move Mercurial subrepository info to VCS support page
Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
parents: 4970
diff changeset
80
4972
b52a1ccee927 docs/usage: reword information on Mercurial subrepository support
Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
parents: 4971
diff changeset
81 Next we can edit the subrepository data, and push back to Kallithea. This will
b52a1ccee927 docs/usage: reword information on Mercurial subrepository support
Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
parents: 4971
diff changeset
82 update both repositories.
811
bb35ad076e2f docs updates
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
83
6734
c5512c9d2118 docs/vcs_support: add information on importing repositories
Karl Goetz <karl@kgoetz.id.au>
parents: 6554
diff changeset
84 .. _importing:
c5512c9d2118 docs/vcs_support: add information on importing repositories
Karl Goetz <karl@kgoetz.id.au>
parents: 6554
diff changeset
85
c5512c9d2118 docs/vcs_support: add information on importing repositories
Karl Goetz <karl@kgoetz.id.au>
parents: 6554
diff changeset
86
c5512c9d2118 docs/vcs_support: add information on importing repositories
Karl Goetz <karl@kgoetz.id.au>
parents: 6554
diff changeset
87 Importing existing repositories
c5512c9d2118 docs/vcs_support: add information on importing repositories
Karl Goetz <karl@kgoetz.id.au>
parents: 6554
diff changeset
88 -------------------------------
c5512c9d2118 docs/vcs_support: add information on importing repositories
Karl Goetz <karl@kgoetz.id.au>
parents: 6554
diff changeset
89
c5512c9d2118 docs/vcs_support: add information on importing repositories
Karl Goetz <karl@kgoetz.id.au>
parents: 6554
diff changeset
90 There are two main methods to import repositories in Kallithea: via the web
c5512c9d2118 docs/vcs_support: add information on importing repositories
Karl Goetz <karl@kgoetz.id.au>
parents: 6554
diff changeset
91 interface or via the filesystem. If you have a large number of repositories to
c5512c9d2118 docs/vcs_support: add information on importing repositories
Karl Goetz <karl@kgoetz.id.au>
parents: 6554
diff changeset
92 import, importing them via the filesystem is more convenient.
c5512c9d2118 docs/vcs_support: add information on importing repositories
Karl Goetz <karl@kgoetz.id.au>
parents: 6554
diff changeset
93
c5512c9d2118 docs/vcs_support: add information on importing repositories
Karl Goetz <karl@kgoetz.id.au>
parents: 6554
diff changeset
94 Importing via web interface
c5512c9d2118 docs/vcs_support: add information on importing repositories
Karl Goetz <karl@kgoetz.id.au>
parents: 6554
diff changeset
95 ^^^^^^^^^^^^^^^^^^^^^^^^^^^
c5512c9d2118 docs/vcs_support: add information on importing repositories
Karl Goetz <karl@kgoetz.id.au>
parents: 6554
diff changeset
96
c5512c9d2118 docs/vcs_support: add information on importing repositories
Karl Goetz <karl@kgoetz.id.au>
parents: 6554
diff changeset
97 For a small number of repositories, it may be easier to create the target
c5512c9d2118 docs/vcs_support: add information on importing repositories
Karl Goetz <karl@kgoetz.id.au>
parents: 6554
diff changeset
98 repositories through the Kallithea web interface, via *Admin > Repositories* or
c5512c9d2118 docs/vcs_support: add information on importing repositories
Karl Goetz <karl@kgoetz.id.au>
parents: 6554
diff changeset
99 via the *Add Repository* button on the entry page of the web interface.
c5512c9d2118 docs/vcs_support: add information on importing repositories
Karl Goetz <karl@kgoetz.id.au>
parents: 6554
diff changeset
100
c5512c9d2118 docs/vcs_support: add information on importing repositories
Karl Goetz <karl@kgoetz.id.au>
parents: 6554
diff changeset
101 Repositories can be nested in repository groups by first creating the group (via
c5512c9d2118 docs/vcs_support: add information on importing repositories
Karl Goetz <karl@kgoetz.id.au>
parents: 6554
diff changeset
102 *Admin > Repository Groups* or via the *Add Repository Group* button on the
c5512c9d2118 docs/vcs_support: add information on importing repositories
Karl Goetz <karl@kgoetz.id.au>
parents: 6554
diff changeset
103 entry page of the web interface) and then selecting the appropriate group when
c5512c9d2118 docs/vcs_support: add information on importing repositories
Karl Goetz <karl@kgoetz.id.au>
parents: 6554
diff changeset
104 adding the repository.
c5512c9d2118 docs/vcs_support: add information on importing repositories
Karl Goetz <karl@kgoetz.id.au>
parents: 6554
diff changeset
105
c5512c9d2118 docs/vcs_support: add information on importing repositories
Karl Goetz <karl@kgoetz.id.au>
parents: 6554
diff changeset
106 After creation of the (empty) repository, push the existing commits to the
c5512c9d2118 docs/vcs_support: add information on importing repositories
Karl Goetz <karl@kgoetz.id.au>
parents: 6554
diff changeset
107 *Clone URL* displayed on the repository summary page. For Git repositories,
c5512c9d2118 docs/vcs_support: add information on importing repositories
Karl Goetz <karl@kgoetz.id.au>
parents: 6554
diff changeset
108 first add the *Clone URL* as remote, then push the commits to that remote. The
c5512c9d2118 docs/vcs_support: add information on importing repositories
Karl Goetz <karl@kgoetz.id.au>
parents: 6554
diff changeset
109 specific commands to execute are shown under the *Existing repository?* section
c5512c9d2118 docs/vcs_support: add information on importing repositories
Karl Goetz <karl@kgoetz.id.au>
parents: 6554
diff changeset
110 of the new repository's summary page.
c5512c9d2118 docs/vcs_support: add information on importing repositories
Karl Goetz <karl@kgoetz.id.au>
parents: 6554
diff changeset
111
c5512c9d2118 docs/vcs_support: add information on importing repositories
Karl Goetz <karl@kgoetz.id.au>
parents: 6554
diff changeset
112 A benefit of this method particular for Git repositories, is that the
c5512c9d2118 docs/vcs_support: add information on importing repositories
Karl Goetz <karl@kgoetz.id.au>
parents: 6554
diff changeset
113 Kallithea-specific Git hooks are installed automatically. For Mercurial, no
c5512c9d2118 docs/vcs_support: add information on importing repositories
Karl Goetz <karl@kgoetz.id.au>
parents: 6554
diff changeset
114 hooks are required anyway.
c5512c9d2118 docs/vcs_support: add information on importing repositories
Karl Goetz <karl@kgoetz.id.au>
parents: 6554
diff changeset
115
c5512c9d2118 docs/vcs_support: add information on importing repositories
Karl Goetz <karl@kgoetz.id.au>
parents: 6554
diff changeset
116 Importing via the filesystem
c5512c9d2118 docs/vcs_support: add information on importing repositories
Karl Goetz <karl@kgoetz.id.au>
parents: 6554
diff changeset
117 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^
c5512c9d2118 docs/vcs_support: add information on importing repositories
Karl Goetz <karl@kgoetz.id.au>
parents: 6554
diff changeset
118
c5512c9d2118 docs/vcs_support: add information on importing repositories
Karl Goetz <karl@kgoetz.id.au>
parents: 6554
diff changeset
119 The alternative method of importing repositories consists of creating the
c5512c9d2118 docs/vcs_support: add information on importing repositories
Karl Goetz <karl@kgoetz.id.au>
parents: 6554
diff changeset
120 repositories in the desired hierarchy on the filesystem and letting Kallithea
c5512c9d2118 docs/vcs_support: add information on importing repositories
Karl Goetz <karl@kgoetz.id.au>
parents: 6554
diff changeset
121 scan that location.
c5512c9d2118 docs/vcs_support: add information on importing repositories
Karl Goetz <karl@kgoetz.id.au>
parents: 6554
diff changeset
122
c5512c9d2118 docs/vcs_support: add information on importing repositories
Karl Goetz <karl@kgoetz.id.au>
parents: 6554
diff changeset
123 All repositories are stored in a central location on the filesystem. This
c5512c9d2118 docs/vcs_support: add information on importing repositories
Karl Goetz <karl@kgoetz.id.au>
parents: 6554
diff changeset
124 location is specified during installation (via ``setup-db``) and can be reviewed
c5512c9d2118 docs/vcs_support: add information on importing repositories
Karl Goetz <karl@kgoetz.id.au>
parents: 6554
diff changeset
125 at *Admin > Settings > VCS > Location of repositories*. Repository groups
c5512c9d2118 docs/vcs_support: add information on importing repositories
Karl Goetz <karl@kgoetz.id.au>
parents: 6554
diff changeset
126 (defined in *Admin > Repository Groups*) are represented by a directory in that
c5512c9d2118 docs/vcs_support: add information on importing repositories
Karl Goetz <karl@kgoetz.id.au>
parents: 6554
diff changeset
127 repository location. Repositories of the repository group are nested under that
c5512c9d2118 docs/vcs_support: add information on importing repositories
Karl Goetz <karl@kgoetz.id.au>
parents: 6554
diff changeset
128 directory.
c5512c9d2118 docs/vcs_support: add information on importing repositories
Karl Goetz <karl@kgoetz.id.au>
parents: 6554
diff changeset
129
c5512c9d2118 docs/vcs_support: add information on importing repositories
Karl Goetz <karl@kgoetz.id.au>
parents: 6554
diff changeset
130 To import a set of repositories and organize them in a certain repository group
c5512c9d2118 docs/vcs_support: add information on importing repositories
Karl Goetz <karl@kgoetz.id.au>
parents: 6554
diff changeset
131 structure, first place clones in the desired hierarchy at the configured
c5512c9d2118 docs/vcs_support: add information on importing repositories
Karl Goetz <karl@kgoetz.id.au>
parents: 6554
diff changeset
132 repository location.
c5512c9d2118 docs/vcs_support: add information on importing repositories
Karl Goetz <karl@kgoetz.id.au>
parents: 6554
diff changeset
133 These clones should be created without working directory. For Mercurial, this is
c5512c9d2118 docs/vcs_support: add information on importing repositories
Karl Goetz <karl@kgoetz.id.au>
parents: 6554
diff changeset
134 done with ``hg clone -U``, for Git with ``git clone --bare``.
c5512c9d2118 docs/vcs_support: add information on importing repositories
Karl Goetz <karl@kgoetz.id.au>
parents: 6554
diff changeset
135
c5512c9d2118 docs/vcs_support: add information on importing repositories
Karl Goetz <karl@kgoetz.id.au>
parents: 6554
diff changeset
136 When the repositories are added correctly on the filesystem:
c5512c9d2118 docs/vcs_support: add information on importing repositories
Karl Goetz <karl@kgoetz.id.au>
parents: 6554
diff changeset
137
c5512c9d2118 docs/vcs_support: add information on importing repositories
Karl Goetz <karl@kgoetz.id.au>
parents: 6554
diff changeset
138 * go to *Admin > Settings > Remap and Rescan* in the Kallithea web interface
c5512c9d2118 docs/vcs_support: add information on importing repositories
Karl Goetz <karl@kgoetz.id.au>
parents: 6554
diff changeset
139 * select the *Install Git hooks* checkbox when importing Git repositories
c5512c9d2118 docs/vcs_support: add information on importing repositories
Karl Goetz <karl@kgoetz.id.au>
parents: 6554
diff changeset
140 * click *Rescan Repositories*
6789
4d04ac08fff7 docs: fix some sphinx warnings
Mads Kiilerich <mads@kiilerich.com>
parents: 6734
diff changeset
141
6734
c5512c9d2118 docs/vcs_support: add information on importing repositories
Karl Goetz <karl@kgoetz.id.au>
parents: 6554
diff changeset
142 This step will scan the filesystem and create the appropriate repository groups
c5512c9d2118 docs/vcs_support: add information on importing repositories
Karl Goetz <karl@kgoetz.id.au>
parents: 6554
diff changeset
143 and repositories in Kallithea.
c5512c9d2118 docs/vcs_support: add information on importing repositories
Karl Goetz <karl@kgoetz.id.au>
parents: 6554
diff changeset
144
c5512c9d2118 docs/vcs_support: add information on importing repositories
Karl Goetz <karl@kgoetz.id.au>
parents: 6554
diff changeset
145 *Note*: Once repository groups have been created this way, manage their access
c5512c9d2118 docs/vcs_support: add information on importing repositories
Karl Goetz <karl@kgoetz.id.au>
parents: 6554
diff changeset
146 permissions through the Kallithea web interface.
c5512c9d2118 docs/vcs_support: add information on importing repositories
Karl Goetz <karl@kgoetz.id.au>
parents: 6554
diff changeset
147
5433
fbbe80e3322b docs: consistent spacing around headings
Mads Kiilerich <madski@unity3d.com>
parents: 5417
diff changeset
148
2023
c45fb78969a3 docs updates on git support
Marcin Kuzminski <marcin@python-works.com>
parents: 1123
diff changeset
149 .. _waitress: http://pypi.python.org/pypi/waitress
3224
8b8edfc25856 whitespace cleanup
Marcin Kuzminski <marcin@python-works.com>
parents: 2992
diff changeset
150 .. _gunicorn: http://pypi.python.org/pypi/gunicorn
4972
b52a1ccee927 docs/usage: reword information on Mercurial subrepository support
Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
parents: 4971
diff changeset
151 .. _subrepositories: http://mercurial.aragost.com/kick-start/en/subrepositories/