Mercurial > kallithea
annotate README.rst @ 1146:cb77867d69d3
fixed changelog release date
author | Marcin Kuzminski <marcin@python-works.com> |
---|---|
date | Thu, 17 Mar 2011 21:34:21 +0100 |
parents | 93b980ebee55 |
children | c5af1d3c861f |
rev | line source |
---|---|
572
a60cd29ba7e2
more docs update
Marcin Kuzminski <marcin@python-works.com>
parents:
564
diff
changeset
|
1 |
796 | 2 ================================================= |
3 Welcome to RhodeCode (RhodiumCode) documentation! | |
4 ================================================= | |
572
a60cd29ba7e2
more docs update
Marcin Kuzminski <marcin@python-works.com>
parents:
564
diff
changeset
|
5 |
1091 | 6 ``RhodeCode`` (formerly hg-app) is a Pylons framework based Mercurial repository |
7 browser/management tool with a built in push/pull server and full text search. | |
8 It works on http/https and has a built in permission/authentication system with | |
9 the ability to authenticate via LDAP. | |
10 | |
1136
93b980ebee55
changes for release 1.1.5
Marcin Kuzminski <marcin@python-works.com>
parents:
1091
diff
changeset
|
11 RhodeCode is similar in some respects to github or bitbucket_, |
93b980ebee55
changes for release 1.1.5
Marcin Kuzminski <marcin@python-works.com>
parents:
1091
diff
changeset
|
12 however RhodeCode can be run as standalone hosted application on your own server. |
93b980ebee55
changes for release 1.1.5
Marcin Kuzminski <marcin@python-works.com>
parents:
1091
diff
changeset
|
13 It is open source and donation ware and focuses more on providing a customized, |
93b980ebee55
changes for release 1.1.5
Marcin Kuzminski <marcin@python-works.com>
parents:
1091
diff
changeset
|
14 self administered interface for Mercurial(and soon GIT) repositories. |
93b980ebee55
changes for release 1.1.5
Marcin Kuzminski <marcin@python-works.com>
parents:
1091
diff
changeset
|
15 RhodeCode is powered by a vcs_ library that Lukasz Balcerzak and I created to |
93b980ebee55
changes for release 1.1.5
Marcin Kuzminski <marcin@python-works.com>
parents:
1091
diff
changeset
|
16 handle multiple different version control systems. |
572
a60cd29ba7e2
more docs update
Marcin Kuzminski <marcin@python-works.com>
parents:
564
diff
changeset
|
17 |
a60cd29ba7e2
more docs update
Marcin Kuzminski <marcin@python-works.com>
parents:
564
diff
changeset
|
18 RhodeCode uses `Semantic Versioning <http://semver.org/>`_ |
a60cd29ba7e2
more docs update
Marcin Kuzminski <marcin@python-works.com>
parents:
564
diff
changeset
|
19 |
a60cd29ba7e2
more docs update
Marcin Kuzminski <marcin@python-works.com>
parents:
564
diff
changeset
|
20 RhodeCode demo |
a60cd29ba7e2
more docs update
Marcin Kuzminski <marcin@python-works.com>
parents:
564
diff
changeset
|
21 -------------- |
a60cd29ba7e2
more docs update
Marcin Kuzminski <marcin@python-works.com>
parents:
564
diff
changeset
|
22 |
1136
93b980ebee55
changes for release 1.1.5
Marcin Kuzminski <marcin@python-works.com>
parents:
1091
diff
changeset
|
23 http://demo.rhodecode.org |
572
a60cd29ba7e2
more docs update
Marcin Kuzminski <marcin@python-works.com>
parents:
564
diff
changeset
|
24 |
1091 | 25 The default access is anonymous but you can login to an administrative account |
26 using the following credentials: | |
254 | 27 |
572
a60cd29ba7e2
more docs update
Marcin Kuzminski <marcin@python-works.com>
parents:
564
diff
changeset
|
28 - username: demo |
a60cd29ba7e2
more docs update
Marcin Kuzminski <marcin@python-works.com>
parents:
564
diff
changeset
|
29 - password: demo |
a60cd29ba7e2
more docs update
Marcin Kuzminski <marcin@python-works.com>
parents:
564
diff
changeset
|
30 |
a60cd29ba7e2
more docs update
Marcin Kuzminski <marcin@python-works.com>
parents:
564
diff
changeset
|
31 Source code |
a60cd29ba7e2
more docs update
Marcin Kuzminski <marcin@python-works.com>
parents:
564
diff
changeset
|
32 ----------- |
a60cd29ba7e2
more docs update
Marcin Kuzminski <marcin@python-works.com>
parents:
564
diff
changeset
|
33 |
1136
93b980ebee55
changes for release 1.1.5
Marcin Kuzminski <marcin@python-works.com>
parents:
1091
diff
changeset
|
34 The latest source for RhodeCode can be obtained from official RhodeCode instance |
93b980ebee55
changes for release 1.1.5
Marcin Kuzminski <marcin@python-works.com>
parents:
1091
diff
changeset
|
35 https://hg.rhodecode.org |
254 | 36 |
847 | 37 Rarely updated source code and issue tracker is available at bitbcuket |
38 http://bitbucket.org/marcinkuzminski/rhodecode | |
572
a60cd29ba7e2
more docs update
Marcin Kuzminski <marcin@python-works.com>
parents:
564
diff
changeset
|
39 |
796 | 40 Installation |
41 ------------ | |
572
a60cd29ba7e2
more docs update
Marcin Kuzminski <marcin@python-works.com>
parents:
564
diff
changeset
|
42 |
1091 | 43 Please visit http://packages.python.org/RhodeCode/installation.html |
572
a60cd29ba7e2
more docs update
Marcin Kuzminski <marcin@python-works.com>
parents:
564
diff
changeset
|
44 |
a60cd29ba7e2
more docs update
Marcin Kuzminski <marcin@python-works.com>
parents:
564
diff
changeset
|
45 |
1091 | 46 RhodeCode Features |
47 ------------------ | |
572
a60cd29ba7e2
more docs update
Marcin Kuzminski <marcin@python-works.com>
parents:
564
diff
changeset
|
48 |
1091 | 49 - Has it's own middleware to handle mercurial_ protocol requests. |
50 Each request can be logged and authenticated. | |
51 - Runs on threads unlike hgweb. You can make multiple pulls/pushes simultaneous. Supports http/https | |
1071
bdc438fb4fe4
Fixes for release 1.1.4
Marcin Kuzminski <marcin@python-works.com>
parents:
856
diff
changeset
|
52 and LDAP |
847 | 53 - Full permissions (private/read/write/admin) and authentication per project. |
54 One account for web interface and mercurial_ push/pull/clone operations. | |
1091 | 55 - Mako templates let's you customize the look and feel of the application. |
56 - Beautiful diffs, annotations and source code browsing all colored by pygments. | |
572
a60cd29ba7e2
more docs update
Marcin Kuzminski <marcin@python-works.com>
parents:
564
diff
changeset
|
57 - Mercurial_ branch graph and yui-flot powered graphs with zooming and statistics |
847 | 58 - Admin interface with user/permission management. Admin activity journal, logs |
59 pulls, pushes, forks, registrations and other actions made by all users. | |
1091 | 60 - Server side forks. It is possible to fork a project and modify it freely without |
847 | 61 breaking the main repository. |
1091 | 62 - Full text search powered by Whoosh on the source files, and file names. |
847 | 63 Build in indexing daemons, with optional incremental index build |
498
6aa7db1c083a
version bump, small readme update
Marcin Kuzminski <marcin@python-works.com>
parents:
402
diff
changeset
|
64 (no external search servers required all in one application) |
847 | 65 - Setup project descriptions and info inside built in db for easy, non |
66 file-system operations | |
1071
bdc438fb4fe4
Fixes for release 1.1.4
Marcin Kuzminski <marcin@python-works.com>
parents:
856
diff
changeset
|
67 - Intelligent cache with invalidation after push or project change, provides high |
1091 | 68 performance and always up to date data. |
847 | 69 - Rss / atom feeds, gravatar support, download sources as zip/tar/gz |
572
a60cd29ba7e2
more docs update
Marcin Kuzminski <marcin@python-works.com>
parents:
564
diff
changeset
|
70 - Async tasks for speed and performance using celery_ (works without them too) |
564
ba7e24cd4786
refactor codes and setup for python 2.5
Marcin Kuzminski <marcin@python-works.com>
parents:
552
diff
changeset
|
71 - Backup scripts can do backup of whole app and send it over scp to desired |
847 | 72 location |
73 - Based on pylons / sqlalchemy / sqlite / whoosh / vcs | |
0 | 74 |
253
7effcce03192
docs update, developments serves statics as default
Marcin Kuzminski <marcin@python-works.com>
parents:
244
diff
changeset
|
75 |
796 | 76 .. include:: ./docs/screenshots.rst |
77 | |
78 | |
676
bdd1ddd05b7c
docs update, setup libs version bumps
Marcin Kuzminski <marcin@python-works.com>
parents:
643
diff
changeset
|
79 Incoming / Plans |
bdd1ddd05b7c
docs update, setup libs version bumps
Marcin Kuzminski <marcin@python-works.com>
parents:
643
diff
changeset
|
80 ---------------- |
241
48727add84c9
Made repos path config configurable from pylons app configs. update Readme
Marcin Kuzminski <marcin@python-works.com>
parents:
224
diff
changeset
|
81 |
1091 | 82 - Project grouping |
847 | 83 - User groups/teams |
1091 | 84 - SSH based authentication with server side key management |
85 - Code review (probably based on hg-review) | |
86 - Full git_ support, with push/pull server (currently in beta tests) | |
87 - Redmine integration | |
88 - Public accessible activity feeds | |
89 - Commit based built in wiki system | |
90 - Clone points and cloning from remote repositories into RhodeCode | |
91 - More statistics and graph (global annotation + some more statistics) | |
92 - Other advancements as development continues (or you can of course make additions and or requests) | |
552
2642f128ad46
removed egg info, update files for distutils build
Marcin Kuzminski <marcin@python-works.com>
parents:
549
diff
changeset
|
93 |
572
a60cd29ba7e2
more docs update
Marcin Kuzminski <marcin@python-works.com>
parents:
564
diff
changeset
|
94 License |
a60cd29ba7e2
more docs update
Marcin Kuzminski <marcin@python-works.com>
parents:
564
diff
changeset
|
95 ------- |
a60cd29ba7e2
more docs update
Marcin Kuzminski <marcin@python-works.com>
parents:
564
diff
changeset
|
96 |
1091 | 97 ``RhodeCode`` is released under the GPL_ license. |
572
a60cd29ba7e2
more docs update
Marcin Kuzminski <marcin@python-works.com>
parents:
564
diff
changeset
|
98 |
a60cd29ba7e2
more docs update
Marcin Kuzminski <marcin@python-works.com>
parents:
564
diff
changeset
|
99 |
676
bdd1ddd05b7c
docs update, setup libs version bumps
Marcin Kuzminski <marcin@python-works.com>
parents:
643
diff
changeset
|
100 Mailing group Q&A |
bdd1ddd05b7c
docs update, setup libs version bumps
Marcin Kuzminski <marcin@python-works.com>
parents:
643
diff
changeset
|
101 ----------------- |
bdd1ddd05b7c
docs update, setup libs version bumps
Marcin Kuzminski <marcin@python-works.com>
parents:
643
diff
changeset
|
102 |
1091 | 103 Join the `Google group <http://groups.google.com/group/rhodecode>`_ |
676
bdd1ddd05b7c
docs update, setup libs version bumps
Marcin Kuzminski <marcin@python-works.com>
parents:
643
diff
changeset
|
104 |
1091 | 105 Open an issue at `issue tracker <http://bitbucket.org/marcinkuzminski/rhodecode/issues>`_ |
676
bdd1ddd05b7c
docs update, setup libs version bumps
Marcin Kuzminski <marcin@python-works.com>
parents:
643
diff
changeset
|
106 |
1091 | 107 Join #rhodecode on FreeNode (irc.freenode.net) |
796 | 108 or use http://webchat.freenode.net/?channels=rhodecode for web access to irc. |
109 | |
110 Online documentation | |
111 -------------------- | |
572
a60cd29ba7e2
more docs update
Marcin Kuzminski <marcin@python-works.com>
parents:
564
diff
changeset
|
112 |
1091 | 113 Online documentation for the current version of RhodeCode is available at |
114 http://packages.python.org/RhodeCode/. | |
115 You may also build the documentation for yourself - go into ``docs/`` and run:: | |
572
a60cd29ba7e2
more docs update
Marcin Kuzminski <marcin@python-works.com>
parents:
564
diff
changeset
|
116 |
a60cd29ba7e2
more docs update
Marcin Kuzminski <marcin@python-works.com>
parents:
564
diff
changeset
|
117 make html |
a60cd29ba7e2
more docs update
Marcin Kuzminski <marcin@python-works.com>
parents:
564
diff
changeset
|
118 |
1091 | 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 | |
1071
bdc438fb4fe4
Fixes for release 1.1.4
Marcin Kuzminski <marcin@python-works.com>
parents:
856
diff
changeset
|
122 .. _virtualenv: http://pypi.python.org/pypi/virtualenv |
bdc438fb4fe4
Fixes for release 1.1.4
Marcin Kuzminski <marcin@python-works.com>
parents:
856
diff
changeset
|
123 .. _python: http://www.python.org/ |
bdc438fb4fe4
Fixes for release 1.1.4
Marcin Kuzminski <marcin@python-works.com>
parents:
856
diff
changeset
|
124 .. _django: http://www.djangoproject.com/ |
bdc438fb4fe4
Fixes for release 1.1.4
Marcin Kuzminski <marcin@python-works.com>
parents:
856
diff
changeset
|
125 .. _mercurial: http://mercurial.selenic.com/ |
1136
93b980ebee55
changes for release 1.1.5
Marcin Kuzminski <marcin@python-works.com>
parents:
1091
diff
changeset
|
126 .. _bitbucket: http://bitbucket.org/ |
1071
bdc438fb4fe4
Fixes for release 1.1.4
Marcin Kuzminski <marcin@python-works.com>
parents:
856
diff
changeset
|
127 .. _subversion: http://subversion.tigris.org/ |
bdc438fb4fe4
Fixes for release 1.1.4
Marcin Kuzminski <marcin@python-works.com>
parents:
856
diff
changeset
|
128 .. _git: http://git-scm.com/ |
bdc438fb4fe4
Fixes for release 1.1.4
Marcin Kuzminski <marcin@python-works.com>
parents:
856
diff
changeset
|
129 .. _celery: http://celeryproject.org/ |
bdc438fb4fe4
Fixes for release 1.1.4
Marcin Kuzminski <marcin@python-works.com>
parents:
856
diff
changeset
|
130 .. _Sphinx: http://sphinx.pocoo.org/ |
bdc438fb4fe4
Fixes for release 1.1.4
Marcin Kuzminski <marcin@python-works.com>
parents:
856
diff
changeset
|
131 .. _GPL: http://www.gnu.org/licenses/gpl.html |
bdc438fb4fe4
Fixes for release 1.1.4
Marcin Kuzminski <marcin@python-works.com>
parents:
856
diff
changeset
|
132 .. _vcs: http://pypi.python.org/pypi/vcs |