|
|
(15 intermediate revisions by 2 users not shown) |
Line 1: |
Line 1: |
| == Subversion Access ==
| | We have an '''open developement process''', all our source code is public and available for download using [http://en.wikipedia.org/wiki/Git Git]. All our developments are managed and are available [https://github.com/openzim/ here]. |
| === WebSVN ===
| |
| Browse our repository via HTTP:
| |
| * http://svn.openzim.org/
| |
| | |
| === Checking Out ===
| |
| Read-only access via WEBDAV is available to our repository.
| |
| | |
| Checking out the complete trunk the first time:
| |
| <source lang="sh">
| |
| svn co http://svn.openzim.org/svnroot/trunk zim
| |
| </source>
| |
| | |
| or update everything once you have checked out:
| |
| <source lang="sh">
| |
| svn up http://svn.openzim.org/svnroot/trunk
| |
| </source>
| |
| | |
| === Commit Access ===
| |
| Once you got commit access to our server check out the whole trunk (or a part of it) before you start working on your local repository:
| |
| <source lang="sh">
| |
| svn co svn+ssh://USER@openzim.org/var/svn/repos/trunk
| |
| </source>
| |
| | |
| Commit changes:
| |
| <pre>
| |
| svn ci
| |
| </pre>
| |
| * replace USER with you openZIM user account
| |
| * replace trunk with the branch you whish to check out
| |
| | |
| ==== How to contribute without Commit Access ====
| |
| Just send your patches to the [[Mailinglist|developers mailinglist]]. They can be discussed their and reach the developers in the team which are able to integrate them into the current codebase.
| |
| | |
| * [[Mailinglist|Subscribe yourself to ''dev-l (at) openzim.org'']]
| |
| | |
| ==== How to get Commit Access at openZIM ====
| |
| If you are a frequent contributor to openZIM check with the developers on the [[Mailinglist|mailinglist]] for acknowledgement. Then send your username and and ssh public key to the list. [[Team|Manuel Schneider]] is in charge of the server management, he will create your account and notify you.
| |
| | |
| == Structure ==
| |
| The suggested subversion repository structure is:
| |
| * trunk
| |
| ** zimlib
| |
| **: Contains the libzim, which allows programs to read zim-files. Here are also some command line tools to access zim-files.
| |
| ** zimwriter
| |
| **: is a system, which creates zim files using zimlib.
| |
| ** zimreader
| |
| **: a web server based on [http://www.tntnet.org Tntnet], which makes zim-files available via web.
| |