SVN tutorial

[FC2 liga - poredak]

FC2 liga - poredak

FC2 League - Stats and Ladder

IL-2 League - Stats and Ladder

[BabaLooey]

Localization effort is organized around SVN repository - a server for subversion control - located at SourceForge.

SVN address:
https://dcsl10n.svn.sourceforge.net/svnroot/dcsl10n

Web browsing of the files and structure:
http://lockonhr.svn.sourceforge.net/viewvc/dcsl10n/

Important
SVN uses a bit strange terminology, as working with it is a weird combination of Windows browser and FTP application.
SVN repository - Remote (server) side of your files.
Commit - Uploading your changes to SVN repository.
Checkout - Downloading a latest version from SVN repository.

To work with SVN you need following:
- TortoiseSVN: http://tortoisesvn.tigris.org/
- Account at SourceForge: http://sourceforge.net/

I recommend that you divide your work with SVN in two groups: translator and testers.
- Translators will have write access to SVN. They need to create an account at SourceForge. Send me your account name in order to get write access to SVN repository.
- Testers do not need an account, only TortoiseSVN.

SVN Tutorial:
1. Installing SVN
2. Downloading the content from SVN repository
3. Working with DCS
4. Uploading changed content to the SVN repository
5. Adding the file that was not previously there
6. Deleting the existing content from repository


Testers should follow only steps 1 & 2.
All steps apply to translators only.

1. Installing SVN

Straightforward - download, install, and restart PC as SVN integrates into shell. It's integrated into contextual menu (right-click) so it's available at any moment, no need to "activate" the app.

2. Downloading the content from SVN repository
(note that file paths on the pics does not follow instruction in text for security reasons)

Somewhere on your HDD create a folder and name it like "DCS-SVN". Open that folder and right-click inside of it, and select "SVN Checkout".



In presented dialog box, under "URL of repository" you have to enter:
https://dcsl10n.svn.sourceforge.net/svnroot/dcsl10n

In field Checkout directory you should see your current folder.



Click OK, and the download will start:



Happy message when procedure finishes:



Your local folder should look like this:



That's it!

6. Working with DCS

SVN information is saved in hidden folders .svn (dot-svn), and SVN will not work without those folders. Make sure you can see hidden files and folders in Windows OS:
Tools -> Folder Options -> View -> Show hidden files or folders

After you have downloaded everything to a new folder on your HDD, open the folder K-50 for your language. Copy all of the content from folder (INCLUDING FOLDER SVN):
HDD:\DCS-i18n\your_language\Ka-50
… to a DCS installation folder:
C:\Program Files\1C\Eagle Dynamics\Ka-50

Confirm overwrite when prompted. That's it!

Note to translators:
Inform your testers about your latest upload.
Note to testers:
Perform a Checkout before starting the game. If there are conflicts, delete your local conflicting file, do another Checkout and inform your translator.

[BabaLooey]

4. Uploading changed content to the SVN repository

When you edit one of the files inside your local copy of repository, or you overwrite and existing one, your folder will look like this:



You may right-click individual files and commit them one by one. In case you have edited several files inside different maps, the simplest way is to right-click on the main folder DCS-SVN and choose SVN Commit... option.



TortoiseSVN will search the content of your local copy for changed files, and they will appear on the list below. In case there are newly created files inside of your local copy, they will also appear on the list, but they will not be check-marked.

In following dialog you may enter some comment (i.e. "fixed typos"). In lower section of dialog there is a list of all files that were locally changed since the last update. If there are more files, and you think you should work on one of those a bit more, you may choose not to upload the file at this moment. But, do upload it anyway! No harm on that.



On success, uploading dialog looks like this:

[BabaLooey]

5. Adding the file that was not previously there

If you add a file to your local copy of SVN repository, it will not be automatically added to remote SVN repository. First you have to tell your local Tortoise to mark some files for adding, and afterwards you actuall add the new file.

Copy/Paste some file into your local SVN repository copy. Right-click that file and choose TortoiseSVN -> Add...



In following dialog, you may choose files that you want to add to repository (Same option if you right-click the folder). At this moment you do NOT actually upload that file! You are just telling your SVN that it will be added to repository. After adding to file list, you need to upload the fiel itself.





Right-click on file/folder with red exclamation mark and proceed with Committing.



When done, the red exclamation mark will change into green OK check.

If option TortoiseSVN -> Add... is not available from inside of selected folder, right click the main folder and chose TortoiseSVN -> Add... there. You will see a list of all files that were added. Choose only those that you need.

6. Deleting the existing content from repository

Do not mix up deleting the file from folder on your HDD with deleting the content in the repository!
Once again, you have to tell your local SVN that file is marked for removal:



Strangely, the file disappears, and the green check mark changes into red exclamation!

Right click upper most folder in your local copy DCS-SVN and choose SVN COMMIT !!!

Same dialog as when committing normal update, but this time on lower list there is a file with status "deleted" - This is the file that will be deleted from SVN repository on server!



And that's it! Piece of a pie! No need to worry if somebody else edited something, and what it was. No need to compare remote and local copy by hand. TortoiseSVN will do that for you. When a newer version of file exist in repository, in downloading dialog the message status "updated" will appear. So, if that is a file that you