Difference between revisions of "Git"

From openZIM
Jump to navigation Jump to search
m (moved Subversion to Git)
Line 1: Line 1:
== Subversion Access ==
== Access ==
=== WebSVN ===
=== Web ===
 
Browse our repository via HTTP:
Browse our repository via HTTP:
* http://svn.openzim.org/
* http://svn.openzim.org/


=== Checking Out ===
=== Read only ===
Read-only access via WEBDAV is available to our repository.
Read-only access via WEBDAV is available to our repository.


Checking out the complete trunk the first time:
Checking out the complete trunk the first time:
<pre>
<pre>
svn co http://svn.openzim.org/svnroot/trunk zim
git clone https://gerrit.wikimedia.org/r/p/openzim.git
</pre>
</pre>


or update everything once you have checked out:
=== Read/Write ===
Once you got write permission on the repository:
<pre>
<pre>
svn up http://svn.openzim.org/svnroot/trunk
git clone ssh://<user>@gerrit.wikimedia.org:29418/openzim.git
</pre>
</pre>


=== Commit Access ===
==== How to contribute without Write 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:
<pre>
svn co svn+ssh://USER@openzim.org/var/svn/repos/trunk zim
</pre>
 
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.
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'']]
* [[Mailinglist|Subscribe yourself to ''offline-l (at) lists.wikimedia.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 ==
== Structure ==
The suggested subversion repository structure is:
The suggested subversion repository structure is:
* trunk
* zimlib
** zimlib
*: Contains the libzim, which allows programs to read zim-files. Here are also some command line tools to access zim-files.
**: Contains the libzim, which allows programs to read zim-files. Here are also some command line tools to access zim-files.
* zimwriter
** zimwriter
*: is a system, which creates zim files using zimlib.
**: is a system, which creates zim files using zimlib.
* zimreader
** zimreader
*: a web server based on [http://www.tntnet.org Tntnet], which makes zim-files available via web.
**: a web server based on [http://www.tntnet.org Tntnet], which makes zim-files available via web.

Revision as of 20:56, 7 January 2013

Access

Web

Browse our repository via HTTP:

Read only

Read-only access via WEBDAV is available to our repository.

Checking out the complete trunk the first time:

git clone https://gerrit.wikimedia.org/r/p/openzim.git

Read/Write

Once you got write permission on the repository:

git clone ssh://<user>@gerrit.wikimedia.org:29418/openzim.git

How to contribute without Write Access

Just send your patches to the developers mailinglist. They can be discussed their and reach the developers in the team which are able to integrate them into the current codebase.

Structure

The suggested subversion repository structure is:

  • 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 Tntnet, which makes zim-files available via web.