User guide

User guide

SVN repositories

When you enter the repository page of one project, you should now see a
"Checkout URL" link near the top-right corner of the page (You may find
a sample of that url on the OHR Support repository
page )

If the link isn't showing, then the project administrator has configured
it so it doesn't show. Please contact your project administrator in that
case.

Once you get hold of the svn repository, you should be able to checkout
it.

If you are using linux/unix, you can checkout a repository by using the
svn checkout (svn co) command. You will need to have a subversion client
installed on your machine.

Here's an example for checking out ohr support's repository:

svn co http://svn.ohwr.org/ohr-support/

If you are using windows, you will need a svn client, too. We recommend
tortoiseSVN for windows users,
although there are other
options.

If you have developer access to the project, you will be able to do
commits to its repository by using your ohwr.org username and password.
Otherwise, you will have read-only access. Please contact your project
manager if you need developer access.

Git repositories

Much like with the SVN repositories, the Git repositories are available
to everyone on read-only mode. There's a difference, though; git
repositories have two URLs; one for read-only access and another one
for read-write.

If you want to clone a git repository in read-only mode, you have to use
a command like the following:

git clone git:https://www.ohwr.org/white-rabbit/wr-switch-sw.git

(Notice that we are using the white-rabbit/wr-switch-sw project for this
example. You may get the correct url from your project's repository
page)

The only requisite for cloning a repository this way is that you have
git installed and configured on your machine.

Read/write access has more requirements.

The owner of the project you want to push changes to must have
granted you committer rights.

You must have installed SSH on your machine, and have generated at
least one public key / private key pair.

You must have uploaded at least one public key to your settings.

You may browse the Git-Client-Setup page for
instructions about how to install & configure Git.

Once the previous requirements are met, you will be able to clone the
repository by executing a command similar to this one:

git clone git@ohwr.org:white-rabbit/wr-switch-sw.git

Notice that the syntax is slighly different from the read-only version,
and that we are again using white-rabbit/wr-switch-sw as an example.

Wiki editing

Redmine uses a language called "textile" for wiki editing.

This page explains the most used commands, as well as several
modifications to textile introduced on redmine, such as links to issues
and
commits: