| 1 | = File repository svn = |
| 2 | The file storage revision system [http://subversion.tigris.org/ Subversion (svn)] is an integrated part of [wiki:TracGuide trac] and plays a key role in the collaboration room and project activity. First and foremost svn is the system which holds all project files. |
| 3 | |
| 4 | Files are available both by download from a web browser or by connecting to the file storage using a svn client. [wiki:Repository#access Read more below]. |
| 5 | |
| 6 | In addition to being a file storage, svn has features which are beneficial for the development of the data standards. svn contains a revision history of all changes and allows for arbitrary rollback in file versions. It has also the capability to compare and find differences between different versions of a file. |
| 7 | |
| 8 | == Access == #access |
| 9 | There are several ways to access the files. The simplest ones are to use the [/browser trac svn browser] or the [/svn svn web server interface]. Browse to the file you want access to and simply open like any regular link. |
| 10 | |
| 11 | If you want to download many files, e.g., a complete project or the whole file storage, this is best done by using an svn client. We recommend using [http://tortoisesvn.tigris.org/ TortoiseSVN] as the svn client. To install go to http://tortoisesvn.net/downloads and download the version that fits your system. |
| 12 | |
| 13 | To download (parts of) the file storage you need to use the command [http://tortoisesvn.net/docs/nightly/TortoiseSVN_en/tsvn-dug-checkout.html Checkout]. Follow the link and use the following values in the Checkout dialogue: |
| 14 | |
| 15 | * URL of repository: `https://trac.posccaesar.org` |
| 16 | * if you just want to download a specific folder, then input the complete path to that folder, e.g. `https://trac.posccaesar.org/projects/IDS-ADI` |
| 17 | * Checkout directory: any folder on your client computer |
| 18 | |
| 19 | For the other settings the default values should be sufficient most uses. |
| 20 | |
| 21 | [http://tortoisesvn.net/docs/nightly/TortoiseSVN_en/tsvn-dug-update.html Update]. The Update command downloads the changes in the repository from the version you have locally on your client computer. You should always update before you start working or reading a file to make sure that your using the latest version. |
| 22 | |
| 23 | To write to the file storage you will need a user account to the collaboration room. |
| 24 | |
| 25 | To upload your work to the file storage, use the [http://tortoisesvn.net/docs/nightly/TortoiseSVN_en/tsvn-dug-commit.html commit] command. Since svn keeps track of all file changes there is no need to include version information in file names, e.g., like `filename_[date].txt`. |
| 26 | |
| 27 | If you are not uploading a changed file, but a completely new file (i.e., the file or folder does not exist in the file storage), you will need to [http://tortoisesvn.net/docs/nightly/TortoiseSVN_en/tsvn-dug-add.html add] the new files and folders first. |
| 28 | |
| 29 | For more information see the [http://tortoisesvn.net/docs/nightly/TortoiseSVN_en/ complete TortoiseSVN manual]. |
| 30 | |
| 31 | See also [wiki:RepositoryTortoiseSVN] for a walk-through of how to use the TortoiseSVN client. |