Sisällys
Koska kaikkia TortoiseSVN-komentoja voi ohjata komentorivivalitsimilla, voit automatisoida sitä komentojonoilla tai käynnistää haluamiasi komentoja ja ikkunoita muista ohjelmista (esim. tekstinkäsittelyohjelmastasi).
Muista, että TortoiseSVN on graafinen käyttöliittymä Subversioniin - niinpä tämä automaatio-opas näyttääkin, miten saada TortoiseSVN:n ikkunat aukeamaan odottamaan käyttäjän syötteitä. Jos haluat käyttää komentoja, jotka eivät tarvitse syötteitä, sinun on sen sijaan käytettävä virallista Subversion-komentoriviasiakasta.
TortoiseSVN:n käyttöliittymän nimi on TortoiseProc.exe. Kaikki komennot määritellään valitsimella /command:abcd, missä abcd on tarvittava komento. Useimmat komennot tarvitsevat ainakin yhden tiedostopolun toimiakseen; se määritellään valitsimella /path:"joku\polku". Seuraavassa taulukossa komento viittaa valitsimeen /command:abcd ja polku puolestaan valitsimeen /path:"joku\polku".
Jos valitsin /command:abcd jätetään antamatta, käynnistyy projektiseurain. Mikäli valitsin /tray annetaan, projektiseurain käynnistyy piilotettuna ilmoitusalueelle.
Koska jotkut komennot voivat ottaa parametrikseen useita polkuja (esim. useiden nimettyjen tiedostojen toimitus arkistoon), valitsin /path ymmärtää useita polkuja, kunhan ne erotetaan merkillä *.
Voit myös luoda tiedoston, jossa on joukko rivinvaihdoin eroteltuja polkuja. Tiedoston on oltava UTF-16-muodossa, ilman BOM -merkintää. Jos välität ko. tiedoston, käytä valitsinta /pathfile valitsimen /path sijaan. Jos haluat, että tiedosto poistetaan komennon suorituksen päätyttyä, anna valitsin /deletepathfile. Muussa tapauksessa sinun on poistettava tiedosto itse.
Edistymiskkuna, jota käytetään arkistotoimituksiin, päivityksiin ja muille komennoille, pysyy komennon suorituksen päätyttyä yleensä auki, kunnes käyttäjä napsauttaa -painiketta. Tätä voidaan muuttaa asettamalla vastaava valitsin asetusikkunassa. Asetuksen muuttaminen sulkee kuitenkin edistymisikkunan, käynnistitpä komennon komentojonosta tai TortoiseSVN-kontekstivalikosta.
Jos haluat, että TortoiseSVN käyttää erilaista määrittelytiedostoa, käytä valitsinta /configdir:"polku\määrittely\hakemistoon". Tämä korvaa oletuspolun (myös mahdollisista rekisteriasetuksista välittämättä).
Voit käyttää valitsinta /closeonend sulkeaksesi edistymisikkunan automaattisesti komennon päättyessä muuttamatta pysyvää asetusta.
/closeonend:0 älä sulje ikkunaa automaattisesti
/closeonend:1 sulje ikkuna automaattisesti, jos komento päättyy virheittä
/closeonend:2 sulje ikkuna automaattisesti, jos komento päättyy ilman virheitä ja ristiriitoja
/closeonend:3 sulje ikkuna automaattisesti, jos komento päättyy ilman virheitä, ristiriitoja tai yhdistämisiä
Käytä valitsinta /closeforlocal sulkeaksesi edistymisikkunan automaattisesti onnistuneiden paikallisten operaatioiden jälkeen.
Alla oleva taulukko luettelee kaikki komennot, jotka voidaan käynnistää TortoiseProc.exe-komentoriviltä. Kuten yllä on kuvattu, näitä tulee käyttää muodossa /command:abcd. Etuliite /command on jätetty taulukosta pois tilan säästämiseksi.
Taulu D.1. Komennot ja niiden valitsimet
| Komento | Kuvaus |
|---|---|
| :about | Näyttää Tietoja-ikkunan. Tämä aukeaa myös, jos komentoa ei anneta. |
| :log |
Avaa loki-ikkunan. Valitsin
An svn date revision can be in one of the following formats:
|
| :checkout |
Avaa työkopion noutoikkunan. Valitsin Mikäli annat valitsimen |
| :import | Avaa tuonti-ikkunan. Valitsin /path kertoo hakemiston, jossa tuotavat tiedostot sijaitsevat. Voit myös antaa lokiviestin valitsimella /logmsg. Jos et halua antaa lokiviestiä komentorivillä, käytä valitsinta /logmsgfile:polku, missä polku kertoo tiedoston, joka sisältää lokiviestin. |
| :update | Päivittää työkopion paikassa /path HEAD-versioon. Mikäli valitsin /rev on annettu, esiin avautuu ikkuna, johon käyttäjä voi syöttää versionumeron, johon päivitys tulisi tehdä. Interaktiivinen ikkuna voidaan ohittaa käyttämällä valitsinta /rev:1234. Muita valitsimia ovat /nonrecursive, /ignoreexternals ja /includeexternals. Valitsimen /stickydepth avulla voidaan luoda harva työkopio kertomalla, että annettu syvyys on pysyvä. Valitsinta /skipprechecks voidaan käyttää ohittamaan kaikki ennen päivitystä tehtävät tarkistukset. Sen seurauksena painike Näytä loki ei ole käytettävissä, eikä päivityksen jälkeen ole mahdollista verrata muutoksia. |
| :commit | Avaa toimitusikkunan. Valitsin /path määrittää kohdehakemiston tai luettelon toimitettavista tiedostoista. Voit myös määritellä valitsimella /logmsg ikkunalle ennalta määritelly lokiviestin. Jos et halua välittää lokiviestiä komentorivillä, käytä valitsinta /logmsgfile:polku, missä polku viittaa tiedostoon, jossa lokiviesti on. Täyttääksesi vikatunnuskentän (olettaen, että olet integroinut TortoisSVN:n vikaseurantaohjelmaan) ennalta voit käyttää valitsinta /bugid:"vikatunnus tähän" |
| :add | Lisää tiedostot /path versionhallintaan. |
| :revert | Peruu paikalliset muutokset työkopioon. Valitsin /path kertoo, mitkä kohteet perutaan. |
| :cleanup | Siivoaa pois keskeytyneet tai keskeytetyt toiminnot ja poistaa lukituksen työkopiosta /path. Sinun on myös annettava valitsin /cleanup suorittaaksesi varsinaisen siivouksen. Käytä valitsinta /noui estääksesi tulosikkunan aukeamisen (ikkunassa kerrotaan joko siivouksen päättymisestä tai annetaan virheilmoitus). Valitsin /noprogressui jättää edistymisikkunan näyttämättä. Valitsin /nodlg estää siivoustoiminnon säätöikkunan näyttämisen. Käytettävissä olevat säädöt voidaan määritellä seuraavilla valitsimilla: /cleanup työkopion tilan siivous, /breaklocks lukkojen vapautus, /revert työkopion muutosten peruminen, /delunversioned, /delignored, /refreshshell, /externals, /fixtimestamps ja /vacuum. |
| :resolve | Merkitsee valitsimen /path määrittämän ristiriitaisen tiedoston ratkaistuksi. Jos valitsin /noquestion on annettu, ratkaisu tehdään varmistamatta ensin käyttäjältä, pitäisikö se todella tehdä. |
| :repocreate | Luo arkiston paikkaan /path |
| :switch | Avaa vaihtoikkunan. Valitsin /path määrittää kohdehakemiston ja <placeholder-2> paikantimen, johon siirrytään.</placeholder-2> |
| :export | Vie valitsimella /path määritellyn työkopion toiseen kansioon. Jos /path määrittää versioimattoman kansion, esiin aukeaa ikkuna, johon syötettävä paikannin viedään kansioon /path. Jos annat valitsimen /blockpathadjustments, polkujen automaattinen korjaus viennin yhteydessä estetään. |
| :dropexport | Vie paikassa /path olevan työkopion hakemistoon /droptarget. Vienti ei käytä vienti-ikkunaa vaan toimii suoraan. Valinta /overwrite ohjaa ylikirjoittamaan olemassa olevat tiedostot ilman käyttäjän vahvistusta, ja valinta /autorename määrittää, että viedyt tiedosot nimetään automaattisesti uudelleen ylikirjoituksen välttämikseksi. Valinta /extended voi olla joko localchanges pelkkien paikallisesti muuttuneiden tiedostojen viemiseksi tai versioimaton myös versioimattomien tiedostojen viemiseksi. |
| :dropvendor | Kopioi kansion /path palautuvasti kansioon /droptarget. Uudet tiedostot lisätään automaattisesti, ja puuttuvat tiedostot poistetaan kohdekansiosta. Tämä takaa, että lähde- ja kohdekansiot ovat samoja. Asetus /noui ohittaa vahvistusikkunan, ja asetus /noprogressui estää edistymisikkunan näyttämisen. |
| :merge | Avaa yhdistämisikkunan. Valitsin /path määrittää kohdehakemiston. Versiovälin yhdistämiseen voi käyttää seuraavia valitsimia: /fromurl:URL, /revrange:string. Kahden arkistopuun yhdistämiseen voi käyttää seuraavia valitsimia: /fromurl:URL, /tourl:URL, /fromrev:xxx ja /torev:xxx. |
| :mergeall | Avaa Yhdistä kaikki -ikkunan. Valitsin /path määrittää kohdehakemiston. |
| :copy | Avaa haarautumisikkunan. Valitsin /path kertoo työkopion, josta haara / merkitty versio tehdään. Valitsin /url on kohdepaikannin. Jos paikannin alkaa merkillä ^ sen oletetaan olevan suhteessa arkiston juureen. Valinta Vaihda työkopio osoittamaan haaraan / merkittyyn versioon voidaan m/switchaftercopy. Valinta Luo v voidaan m/makeparents. Voit my/logmsg lokiviestipohjan antamiseksi. Mik/logmsgfile:polku, misspolku kertoo tiedoston, miss |
| :settings | Avaa asetusikkunan. |
| :remove | Poistaa valitsimen /path määrittämät tiedostot versionhallinnasta. |
| :rename | Nimeää uudelleen tiedoston /path. Tiedoston uusi nimi annetaan aukeavaan ikkunaan. Välttääksesi kysymyksen samantapaisten tiedostojen nimeämisestä uudelleen, anna valitsin /noquestion. |
| :diff | Käynnistää TortoiseSVN-asetuksissa määritellyn ulkoisen vertailuohjelman. Valitsin /path määrittää ensimmäisen tiedoston. Mikäli /path2 on annettu, vertailuohjelma vertaa näitä kahta tiedostoa. Jos /path2 jätetään pois, vertailu tehdään tiedoston /path ja sen BASE-version kanssa. Jos annetulla tiedostolla on myös ominaisuusmuutoksia, vertailutyökalu käynnistyy myös kullekin muutetulle ominaisuudelle. Valitsin /ignoreprops estää tämän. Halutessasi määritellä tarkan versionumeron, anna /startrev:xxx ja /endrev:xxx sekä mahdollisesti /pegrevision:xxx ankkuriversiota varten. Mikäli /blame on annettu ja /path2 ei, vertailu tehdään selvittämällä ensin tekijät annetuille versioille. Valitsin /line:xxx määrittää rivinumeron, joka näytetään vertailun käynnistyessä. |
| :shelve | Hyllyttää valitut polut uudelle hyllylle. Valitsin /shelfname:name määrittää hyllyn nimen. Valinnainen lokiviesti voidaan antaa valitsimella /logmsg:message. Mikäli valitsin /checkpointannetaan, hyllytetyt muutokset jätetään työkopioon. |
| :unshelve | Yhdistää hyllyn /shelfname:name sisällön työkopioon. Oletusarvoisesti käytetään hyllyn viimeisintä versiota, mutta tämän voi muuttaa valitsimella /version:X. |
| :showcompare |
Paikantimista ja vertailtavista versioista riippuen komento näyttää joko unified diff-luettelon (mikäli valitsin Valitsimet Mikäli annetulla paikantimella on ominaisuusmuutoksia, ulkoinen vertailutyökalu käynnistetään kullekin muutetulle ominaisuudelle. Valitsin Mikäli muutokset halutaan unified diff -muodossa, niiden luettavuutta voidaan tarvittaessa parantaa asetuksella |
| :conflicteditor | Käynnistää TortoiseSVN-asetuksissa määritellyn yhdistämistyökalun valitsimella /path annetun ristiriitaisen tiedoston tarvitsemien tiedostojen kera. |
| :relocate | Avaa Sijoita uudelleen -ikkunan. Valitsin /path määrittää uudelleen sijoitettavan työkopiopolun. |
| :help | Avaa käyttöohjeet. |
| :repostatus | Avaa Tarkista muutokset -ikkunan. Valitsin /path määrittää työkopion hakemiston. Jos valitsin /remote on annettu, ikkuna ottaa yhteyden arkistoon välittömästi käynnistyttyään (ikään kuin käyttäjä olisi napsauttanut painiketta Tarkista arkisto). |
| :repobrowser |
Käynnistää arkistoselaimen Valitsin Jos valitsin Jos valitsin |
| :ignore | Vie kaikki valitsimen /path määrittämät kohteet ohituslistaan, ts. lisää niille ominaisuuden svn:ignore. |
| :blame |
Avaa Selvitä tekijä -ikkunan valitsimella Jos valitsimet Jos valitsin Valitsimia |
| :cat | Tallentaa valitsimella /path annetun paikantimen tai työkopiopolun valitsimella /savepath:polku annettuun paikkaan. Versionumero annetaan valitsimella /revision:xxx; tätä voidaan käyttää hankkimaan tiedostosta tietty versio. |
| :createpatch | Luo paikkatiedoston valitsemella /path annettuun polkuun. Ohittaaksesi Tallenna nimellä -ikkunan voit määritellä paikkatiedoston tallennuspolun valitsimella /savepath:polku. Anna valitsin /noview estääksesi paikkatiedoston näyttämisen unified diff -vertailuohjelmalla.
Mikäli muutokset halutaan unified diff -muodossa, niiden luettavuutta voidaan tarvittaessa parantaa asetuksella Lisää luettavuutta. Asetus näyttää merge-info -ominaisuudet helpommin luettavassa muodossa. |
| :revisiongraph |
Näytä versiograafi valitsimella Luodaksesi kuvan versiograafista jollekin arkistopolulle näyttämättä itse graafi-ikkunaa, anna valitsin Koska versiograafilla on useita valitsimia, jotka vaikuttavat sen ulkoasuun, voit myös määrittää ne luodessasi kuvatiedostoa. Anna nämä valitsimet muodossa |
| :lock | Avaa lukitusikkunan valitsimella /path määritellylle hakemistolle, jotta ne voidaan lukita (ja antaa lukitusviesti). |
| :unlock | Poistaa lukituksen valitsimella /path määritellystä tiedostosta, tai, jos valitsin on kansio, kaikista kansion tiedostoista. |
| :rebuildiconcache | Korjaa Windowsin kuvakemuistin. Käytä tätä vain, jos ikkunoiden kuvakkeet eivät näy oikein. Toiminnon (väistämätön) sivuvaikutus on, että työpöydän kuvakkeet järjestetään uudelleen. Ohittaaksesi viestin, välitä valitsin /noquestion. |
| :properties |
Näyttää ominaisuusikkunan valitsimella Versioitujen ominaisuuksien kanssa tämä komento vaatii työkopion. Versio-ominaisuuksia voidaan katsella/muuttaa, mikäli valitsin Avataksesi ominaisuusikkunan suoraan halutulle ominaisuudelle, välitä sen nimi muodossa |
| :sync |
Vie/tuo asetukset riippuen siitä, ovatko nykyiset vai viedyt asetukset tuoreempia, tai määritellysti. Jos polku annetaan valitsimella Valitsin Jos kumpaakaan valitsimista Valitsin Valitsin Valitsin |
Esimerkkejä (syötä yhdelle riville):
TortoiseProc.exe /command:commit
/path:"c:\svn_wc\file1.txt*c:\svn_wc\file2.txt"
/logmsg:"test log message" /closeonend:0
TortoiseProc.exe /command:update /path:"c:\svn_wc\" /closeonend:0
TortoiseProc.exe /command:log /path:"c:\svn_wc\file1.txt"
/startrev:50 /endrev:60 /closeonend:0