Using Subversion Windows

8/8/2019 Using Subversion Windows

http://slidepdf.com/reader/full/using-subversion-windows 1/30

Using Subversion and TortoiseSVN for

Windows

by

Galen Wilkerson

Gund Institute for Ecological Economics

University of Vermont

[email protected]



Lesson Plan

Go over installation of Subversion and Simile (windows/mac)

On your own: Go through the Simile tutorials

http://simulistics.com/tutorials/index.htm

On your own: Go through our presentations on Subversion ²TortoiseSVN (Windows) or svnX (Mac) ² remainder of thispresentation

We will be available another time on Wimba and byemail/phone to answer questions about the tutorials



When collaborating, it is important to manage changes inthe models. For example:

² To create or edit a submodel

E.g. Habitat suitability is replaced with another method of computinghabitat values.

² To submit a ´rough copyµ of a model to the repository for review bycollaborators at another institution.

² To keep track of data needed from other submodels.

Can submit a ´data requestµ to all model developers

² To keep track of influences/data-flow between submodels.

² To revise documentation.² To track revisions by author, time, date, revision number.

² Possibly the best feature: Nothing is ever ́ gone foreverµ , since youcan always recover the last version.

Using Subversion



TortoiseSVN (Windows)

Getting started

How to download and install

Adding a model you have created

Modifying an existing file




Getting startedHow to download and install

² Visit the download site of tortoiseSVN

http://tortoisesvn.net/downloads² Click ´32-bit installerµ

Should look something like:

´TortoiseSVN-1.4.3.8645-win32-svn-1.4.3.msiµ

(Version numbers may be different.)




Getting startedHow to download and install² Double-click on the downloaded

installer file

² Step through the installationprocess

² Once you have installedTortoiseSVN, your Windows

Explorer will be modifiied Whenever you right-click

somewhere, you see additionalmenu-items




Getting startedTo obtain the Subversion repository location

From the MIMES repository homepage:

² Click Ćodeµ menu

Click ´SVNµ Within SVN, the following URL appears:

https://mimes.svn.sourceforge.net/svnroot/mimes



TortoiseSVN:

Common Subversion tasks- Add a new file to the repository

- Modify an existing file in the repository

(Note: For more information on this in the tortoiseSVNhelp:

- Right click anywhere

- Choose TortoiseSVN->Help

- Scroll to Chapter 5: Daily Use Guide)



TortoiseSVN:

Add a new file to the repositoryOverview:

- Checkout appropriate folder from the repository

(The folder where you will put your model.)

- Create file

(model file or other ² documentation, etc.)

- Áddµ

- Ćommitµ



TortoiseSVN:

Add a new file to the repository

(continued)

- Checkout appropriate

folder from the repository

- Start the ́ Repo-browserµ

(Repository browser)



TortoiseSVN:


(continued)

- Choose the folder where your new

model belongs

(Here, have chosen Aesthetic/)

- Right-click on the folder and

choose Ćheckout«µ

- A ́ Checkoutµ window appears



TortoiseSVN:


(continued)- Click the ´«µ next to Ćheckout Directoryµ

- A ́ Browse for Folderµ window appears

- Browse to the folder on your computerwhere you want to create a local copy of the repository folder

- Create a folder with the same name as theone in the repository

- Click ´Make New Folderµ- Enter the new folder name

(Here ́ Aestheticµ)

- Click ́ OKµ



TortoiseSVN:


(continued)

- This window appears telling youwhat has been downloaded:

- The folder you created now lookslike this:

- It contains the files from therepository



TortoiseSVN:


(continued)

- Move, copy, or create a new filethat will be added to the

repository

- Give the file a descriptivename to distinguish it fromother files

(Remember, we are addinga new file.)



TortoiseSVN:


(continued)

- Use Áddµ to add it to the local

repository- Right-click the new file

(Here, right-click on Áestheticµ)

- Click ́ TortoiseSVN->Addµ

- A window appears

- Click ́ OKµ

- A blue ´plusµ symbol should appear

on the file in Windows Explorer:



TortoiseSVN:


(continued)

- Right-click on the file you just added

- Choose ́ SVN Commit«µ to commit it tothe Sourceforge MIMES repository:



TortoiseSVN:


(continued)- A window ́ Enter Log Messageµ

appears:

- Please when adding a newmodel, always enter a message

telling something about your

model, documentation, a brief

description, and related work.

(Sourceforge automatically

saves your contact information

and the date/time you

commited your file.)

- Click ́ OKµ



TortoiseSVN:


(continued)

- This window appears:

- Once it says ́ Completedµyou have added a file to

the repository!

- Congratulations!



TortoiseSVN:


(practice)- To practice this, we have created the

folder ́ TestStuff/µ in the Sourceforge

subversion repository

- Full location:

https://mimes.svn.sourceforge.net/svnroot/

mimes/trunk/models/location/TestStuff

- Review this section, adding a file to the´TestStuff/µ folder in the repository



TortoiseSVN:

Modify an existing file in the

repository

Overview:

- Ćheck outµ the folder containing the file to bemodified

- Edit and save the file on your computer

- Ćommitµ the changes you have made



TortoiseSVN:

Modifying a file (continued)

- Checkout appropriate

folder from the repository

- Start the ́ Repo-browserµ

(Repository browser)



TortoiseSVN:


- Choose the folder containing the

file you want to edit

(Here, have chosen Aesthetic/)

- Right-click on the folder and

choose Ćheckout«µ

- A ́ Checkoutµ window appears



TortoiseSVN:


- Click the ´«µ next to Ćheckout Directoryµ

- A ́ Browse for Folderµ window appears

- Browse to the folder on your computerwhere you want to create a local copy of the repository folder

- Create a folder with the same name as theone in the repository

- Click ´Make New Folderµ- Enter the new folder name

(Here ́ Aestheticµ)

- Click ́ OKµ



TortoiseSVN:


- This window appears telling youwhat has been downloaded:

- The folder you created now lookslike this:

- It contains the files from therepository



- Double-click the file you want to open

- Edit the file (In Simile, for example)

- Save it

- The file now appears like this:

(This means it has been modified butchanges have not been ćommittedµ tothe repository.)

TortoiseSVN:




- Right-click the file you

want to commit

- Choose ́ SVN

Commit«µ

TortoiseSVN:




TortoiseSVN:

Modifying a file (continued)- A window ́ Enter Log Messageµ

appears:

- Please when modifying a model,

always enter a message tellingsomething about what you did

to the model, and links to other

related changes in the model,

documentation, or research.

(Sourceforge automatically

saves your contact information

and the date/time you

commited your file.)

- Click ́ OKµ



TortoiseSVN:

Modifying a file (continued)- This window appears:

- Once it says ́ Completedµyou have modified the

repository!

- Congratulations!



TortoiseSVN:

Modifying a file (practice)

- To practice this, we have created the

folder ́ TestStuff/µ in the Sourceforge

subversion repository

- Full location:

https://mimes.svn.sourceforge.net/svnroo

t/mimes/trunk/models/location/TestStuff

- Review this section, modifying a file inthe ´TestStuff/µ folder in the repository



Next steps:

- Download and install Simile Evaluation Edition:http://simulistics.com/products/simile.php

(Go to the bottom, where it says Évaluation Editionµ)

- Complete the 3 Simile tutorials located here:

http://simulistics.com/tutorials/index.htm

- Review this presentation and practice adding andmodifying models in the TestStuff/ folder

- Contact us if you have questions or problems.

Documents

Using Subversion Windows