Mercurial > kallithea
comparison README.rst @ 1091:e67786cb2afa
- Further corrections.
author | jfh <jason@jasonfharris.com> |
---|---|
date | Sat, 26 Feb 2011 20:44:32 +0100 |
parents | bdc438fb4fe4 |
children | 93b980ebee55 |
comparison
equal
deleted
inserted
replaced
1090:de86a0870874 | 1091:e67786cb2afa |
---|---|
1 | 1 |
2 ================================================= | 2 ================================================= |
3 Welcome to RhodeCode (RhodiumCode) documentation! | 3 Welcome to RhodeCode (RhodiumCode) documentation! |
4 ================================================= | 4 ================================================= |
5 | 5 |
6 ``RhodeCode`` (formerly hg-app) is Pylons framework based Mercurial repository | 6 ``RhodeCode`` (formerly hg-app) is a Pylons framework based Mercurial repository |
7 browser/management tool with build in push/pull server and full text search. | 7 browser/management tool with a built in push/pull server and full text search. |
8 It works on http/https, has build in permission/authentication system with | 8 It works on http/https and has a built in permission/authentication system with |
9 ability to auth via LDAP. It's similar in some parts to github or bitbucket, | 9 the ability to authenticate via LDAP. |
10 but it's suppose to run as standalone hosted application, it's open source | 10 |
11 and donation ware and focuses more on providing customized, self administered | 11 RhodeCode is similar in some respects to github or bitbucket, |
12 interface for Mercurial(and soon GIT) repositories. It's powered by vcs_ | 12 however RhodeCode can be run as standalone hosted application on your own server. It is open source |
13 library that me and Lukasz Balcerzak created to handle many various version | 13 and donation ware and focuses more on providing a customized, self administered |
14 interface for Mercurial(and soon GIT) repositories. RhodeCode is powered by a vcs_ | |
15 library that Lukasz Balcerzak and I created to handle multiple different version | |
14 control systems. | 16 control systems. |
15 | 17 |
16 RhodeCode uses `Semantic Versioning <http://semver.org/>`_ | 18 RhodeCode uses `Semantic Versioning <http://semver.org/>`_ |
17 | 19 |
18 RhodeCode demo | 20 RhodeCode demo |
19 -------------- | 21 -------------- |
20 | 22 |
21 http://hg.python-works.com | 23 http://hg.python-works.com |
22 | 24 |
23 The default access is anonymous but You can login to administrative account | 25 The default access is anonymous but you can login to an administrative account |
24 using those credentials | 26 using the following credentials: |
25 | 27 |
26 - username: demo | 28 - username: demo |
27 - password: demo | 29 - password: demo |
28 | 30 |
29 Source code | 31 Source code |
30 ----------- | 32 ----------- |
31 | 33 |
32 The most up to date sources can be obtained from my own RhodeCode instance | 34 The latest source for RhodeCode can be obtained from my own RhodeCode instance |
33 https://rhodecode.org | 35 https://rhodecode.org |
34 | 36 |
35 Rarely updated source code and issue tracker is available at bitbcuket | 37 Rarely updated source code and issue tracker is available at bitbcuket |
36 http://bitbucket.org/marcinkuzminski/rhodecode | 38 http://bitbucket.org/marcinkuzminski/rhodecode |
37 | 39 |
38 Installation | 40 Installation |
39 ------------ | 41 ------------ |
40 | 42 |
41 Please visit http://packages.python.org/RhodeCode/installation.html | 43 Please visit http://packages.python.org/RhodeCode/installation.html |
42 | 44 |
43 | 45 |
44 Features | 46 RhodeCode Features |
45 -------- | 47 ------------------ |
46 | 48 |
47 - Has it's own middleware to handle mercurial_ protocol request. | 49 - Has it's own middleware to handle mercurial_ protocol requests. |
48 Each request can be logged and authenticated. Runs on threads unlikely to | 50 Each request can be logged and authenticated. |
49 hgweb. You can make multiple pulls/pushes simultaneous. Supports http/https | 51 - Runs on threads unlike hgweb. You can make multiple pulls/pushes simultaneous. Supports http/https |
50 and LDAP | 52 and LDAP |
51 - Full permissions (private/read/write/admin) and authentication per project. | 53 - Full permissions (private/read/write/admin) and authentication per project. |
52 One account for web interface and mercurial_ push/pull/clone operations. | 54 One account for web interface and mercurial_ push/pull/clone operations. |
53 - Mako templates let's you customize look and feel of application. | 55 - Mako templates let's you customize the look and feel of the application. |
54 - Beautiful diffs, annotations and source codes all colored by pygments. | 56 - Beautiful diffs, annotations and source code browsing all colored by pygments. |
55 - Mercurial_ branch graph and yui-flot powered graphs with zooming and statistics | 57 - Mercurial_ branch graph and yui-flot powered graphs with zooming and statistics |
56 - Admin interface with user/permission management. Admin activity journal, logs | 58 - Admin interface with user/permission management. Admin activity journal, logs |
57 pulls, pushes, forks, registrations and other actions made by all users. | 59 pulls, pushes, forks, registrations and other actions made by all users. |
58 - Server side forks, it's possible to fork a project and hack it free without | 60 - Server side forks. It is possible to fork a project and modify it freely without |
59 breaking the main repository. | 61 breaking the main repository. |
60 - Full text search powered by Whoosh on source codes, and file names. | 62 - Full text search powered by Whoosh on the source files, and file names. |
61 Build in indexing daemons, with optional incremental index build | 63 Build in indexing daemons, with optional incremental index build |
62 (no external search servers required all in one application) | 64 (no external search servers required all in one application) |
63 - Setup project descriptions and info inside built in db for easy, non | 65 - Setup project descriptions and info inside built in db for easy, non |
64 file-system operations | 66 file-system operations |
65 - Intelligent cache with invalidation after push or project change, provides high | 67 - Intelligent cache with invalidation after push or project change, provides high |
66 performance and always up to date data. | 68 performance and always up to date data. |
67 - Rss / atom feeds, gravatar support, download sources as zip/tar/gz | 69 - Rss / atom feeds, gravatar support, download sources as zip/tar/gz |
68 - Async tasks for speed and performance using celery_ (works without them too) | 70 - Async tasks for speed and performance using celery_ (works without them too) |
69 - Backup scripts can do backup of whole app and send it over scp to desired | 71 - Backup scripts can do backup of whole app and send it over scp to desired |
70 location | 72 location |
71 - Based on pylons / sqlalchemy / sqlite / whoosh / vcs | 73 - Based on pylons / sqlalchemy / sqlite / whoosh / vcs |
75 | 77 |
76 | 78 |
77 Incoming / Plans | 79 Incoming / Plans |
78 ---------------- | 80 ---------------- |
79 | 81 |
80 - project grouping | 82 - Project grouping |
81 - User groups/teams | 83 - User groups/teams |
82 - ssh based authentication with server side key management | 84 - SSH based authentication with server side key management |
83 - code review (probably based on hg-review) | 85 - Code review (probably based on hg-review) |
84 - full git_ support, with push/pull server (currently in beta tests) | 86 - Full git_ support, with push/pull server (currently in beta tests) |
85 - redmine integration | 87 - Redmine integration |
86 - public accessible activity feeds | 88 - Public accessible activity feeds |
87 - commit based build in wiki system | 89 - Commit based built in wiki system |
88 - clone points and cloning from remote repositories into RhodeCode | 90 - Clone points and cloning from remote repositories into RhodeCode |
89 - more statistics and graph (global annotation + some more statistics) | 91 - More statistics and graph (global annotation + some more statistics) |
90 - other cools stuff that i can figure out (or You can help me figure out) | 92 - Other advancements as development continues (or you can of course make additions and or requests) |
91 | 93 |
92 License | 94 License |
93 ------- | 95 ------- |
94 | 96 |
95 ``RhodeCode`` is released under GPL_ license. | 97 ``RhodeCode`` is released under the GPL_ license. |
96 | 98 |
97 | 99 |
98 Mailing group Q&A | 100 Mailing group Q&A |
99 ----------------- | 101 ----------------- |
100 | 102 |
101 join the `Google group <http://groups.google.com/group/rhodecode>`_ | 103 Join the `Google group <http://groups.google.com/group/rhodecode>`_ |
102 | 104 |
103 open an issue at `issue tracker <http://bitbucket.org/marcinkuzminski/rhodecode/issues>`_ | 105 Open an issue at `issue tracker <http://bitbucket.org/marcinkuzminski/rhodecode/issues>`_ |
104 | 106 |
105 join #rhodecode on FreeNode (irc.freenode.net) | 107 Join #rhodecode on FreeNode (irc.freenode.net) |
106 or use http://webchat.freenode.net/?channels=rhodecode for web access to irc. | 108 or use http://webchat.freenode.net/?channels=rhodecode for web access to irc. |
107 | 109 |
108 Online documentation | 110 Online documentation |
109 -------------------- | 111 -------------------- |
110 | 112 |
111 Online documentation for current version is available at | 113 Online documentation for the current version of RhodeCode is available at |
112 http://packages.python.org/RhodeCode/. | 114 http://packages.python.org/RhodeCode/. |
113 You may also build documentation for yourself - go into ``docs/`` and run:: | 115 You may also build the documentation for yourself - go into ``docs/`` and run:: |
114 | 116 |
115 make html | 117 make html |
116 | 118 |
119 (You need to have sphinx installed to build the documentation. If you don't | |
120 have sphinx installed you can install it via the command: ``easy_install sphinx``) | |
121 | |
117 .. _virtualenv: http://pypi.python.org/pypi/virtualenv | 122 .. _virtualenv: http://pypi.python.org/pypi/virtualenv |
118 .. _python: http://www.python.org/ | 123 .. _python: http://www.python.org/ |
119 .. _django: http://www.djangoproject.com/ | 124 .. _django: http://www.djangoproject.com/ |
120 .. _mercurial: http://mercurial.selenic.com/ | 125 .. _mercurial: http://mercurial.selenic.com/ |
121 .. _subversion: http://subversion.tigris.org/ | 126 .. _subversion: http://subversion.tigris.org/ |