README.rst
60 lines
| 2.5 KiB
| text/x-rst
|
RstLexer
r254 | ------------------------------------- | ||
r253 | Pylons based replacement for hgwebdir | ||
r254 | ------------------------------------- | ||
r253 | |||
Fully customizable, with authentication, permissions. Based on vcs library. | |||
r254 | |||
**Overview** | |||
- has it's own middleware to handle mercurial protocol request each request can | |||
r253 | be logged and authenticated + threaded performance unlikely to hgweb | ||
r325 | - full permissions per project read/write/admin access even on mercurial request | ||
r392 | - mako templates let's you cusmotize look and feel of application. | ||
r253 | - diffs annotations and source code all colored by pygments. | ||
r364 | - mercurial branch graph and yui-flot powered graphs | ||
r253 | - admin interface for performing user/permission managments as well as repository | ||
r392 | managment. | ||
r402 | - Additional settings for mercurial web, (hooks editable from admin | ||
panel !) also manage paths, archive, remote messages | |||
r325 | - backup scripts can do backup of whole app and send it over scp to desired location | ||
r290 | - setup project descriptions and info inside built in db for easy, non | ||
file-system operations | |||
r253 | - added cache with invalidation on push/repo managment for high performance and | ||
r392 | always upto date data. | ||
r402 | - rss / atom feeds, gravatar support | ||
r253 | - based on pylons 1.0 / sqlalchemy 0.6 | ||
r254 | **Incoming** | ||
r253 | |||
r325 | - code review based on hg-review (when it's stable) | ||
r253 | - git support (when vcs can handle it) | ||
r402 | - full text search of source codes with indexing daemons using whoosh | ||
(no external search servers required all in one application) | |||
- manage hg ui() per repo, add hooks settings, per repo, and not globally | |||
r325 | - other cools stuff that i can figure out | ||
r253 | |||
.. note:: | |||
r392 | This software is still in beta mode. | ||
I don't guarantee that it'll work correctly. | |||
r253 | |||
------------- | |||
Installation | |||
------------- | |||
r325 | .. note:: | ||
I recomend to install tip version of vcs while the app is in beta mode. | |||
r327 | - create new virtualenv and activate it - highly recommend that you use separate | ||
virtual-env for whole application | |||
r325 | - download hg app from default (not demo) branch from bitbucket and run | ||
'python setup.py install' this will install all required dependencies needed | |||
r327 | - run paster setup-app production.ini it should create all needed tables | ||
r344 | and an admin account. | ||
- remember that the given path for mercurial repositories must be write | |||
r327 | accessible for the application | ||
- run paster serve development.ini - or you can use manage-hg_app script. | |||
r254 | the app should be available at the 127.0.0.1:5000 | ||
r325 | - use admin account you created to login. | ||
- default permissions on each repository is read, and owner is admin. So remember | |||
r402 | to update these. | ||
r325 |