Ker je vse ukaze TortoiseSVN možno krmiliti preko parameterov ukazne vrstice, lahko za avtomatizacijo uporabite paketno datoteko ali pa ukaze in pogovorna okna poganjate z določeni parameteri znotraj drugih programov (n. pr. iz vašega priljubljenega urejevalnika besedil).
Upoštevajte, da je TortoiseSVN odjemalec z grafičnim uporabniškim vmesnikom, to poglavje pa vam pove, kako lahko prikažete okna programa TortoiseSVN, tako da od uporabnika pridobite informacije. Če želite napisati ukazno datoteko, ki ne potrebuje vnosa s strani uporabnika, namesto TortoiseSVN uporabite uradni odjemalec Subversion za ukazno vrstico.
Program TortoiseSVN se imenuje TortoiseProc.exe. Vse ukaze kličemo s parametrom /command:abcd, kjer je abcd ime zahtevanega ukaza. Večina ukazov potrebuje vsaj eno pot kot parameter, ki ga podamo z /path:"neka\pot". V spodnji tabeli ukaz ustreza /command:abcd, pot pa parametru /path:"neka\pot".
There's a special command that does not require the parameter /command:abcd but, if nothing is specified on the command line, starts the project monitor instead. If /tray is specified, the project monitor starts hidden and only adds its icon to the system tray.
Ker nekateri ukazi sprejmejo seznam ciljnih poti (n. pr. ko objavljate več datotek), lahko podamo parametru /path več poti, ki jih ločimo z znakom *.
You can also specify a file which contains a list of paths, separated by newlines. The file must be in UTF-16 format, without a BOM. If you pass such a file, use /pathfile instead of /path. To have TortoiseProc delete that file after the command is finished, you can pass the parameter /deletepathfile. If you don't pass /deletepathfile, you have to delete the file yourself or the file gets left behind.
Pogovorno okno, ki se uporablja pri objavah, posodobitvah in ostalih ukazih običajno ostane odprto dokler ne pritisnemo na gumb . To obnašanje lahko spremenimo z nastavitvami aplikacije. Vendar se bo pogovorno okno zaprlo v vsakem primeru - če ga pokličete iz paketne datoteke ali iz kontekstnega menija.
Za nastavitev druge lokacije konfiguracijske datoteke uporabite parameter /configdir:"pot\do\konfiguracijske\mape". S tem preprišete privzete vrednosti, vključno z zapisi v registru.
To close the progress dialog at the end of a command automatically without using the permanent setting you can pass the /closeonend parameter.
/closeonend:0 okna ne zapri samodejno
/closeonend:1 samodejno zapri, če ni napak
/closeonend:2 samodejno zapri, če ni napak in sporov
/closeonend:3 samodejno zapri, če ni napak, sporov ali spajanj
To close the progress dialog for local operations if there were no errors or conflicts, pass the /closeforlocal parameter.
Spodnja tabela prikazuje vse ukaze, do katerih lahko dostopate preko programa TortoiseProc.exe. Ko smo že omenili zgoraj, uporabljamo obliko /command:abcd. V tabeli smo zaradi varčevanja s prostorom opustili predpono /command.
Tabela D.1. Seznam ukazov in možnosti
| Ukaz | Opis |
|---|---|
| :about | Pokaže pogovorno okno "O programu". Prikaže se tudi, če ne podamo pokaza. |
| :log |
Opens the log dialog. The
An svn date revision can be in one of the following formats:
|
| :checkout |
Opens the checkout dialog. The If you specify |
| :import | Opens the import dialog. The /path specifies the directory with the data to import. You can also specify the /logmsg switch to pass a predefined log message to the import dialog. Or, if you don't want to pass the log message on the command line, use /logmsgfile:pot, where pot points to a file containing the log message. |
| :update | Updates the working copy in /path to HEAD. If the option /rev is given then a dialog is shown to ask the user to which revision the update should go. To avoid the dialog specify a revision number /rev:1234. Other options are /nonrecursive, /ignoreexternals and /ignoreexternals. The /stickydepth indicates that the specified depth should be sticky, creating a sparse checkout. The /skipprechecks can be set to skip all checks that are done before an update. If this is specified, then the Show log button is disabled, and the context menu to show diffs is also disabled after the update. |
| :commit | Odpre pogovorno okno za objave. /path določa ciljno mapo ali seznam datotek za objavo. Določite lahko tudi stikalo /logmsg, s katerim določite sporočilo dnevniškega zapisa. Če pa ne želite podati sporočila v ukazni vrstici, uporabite /logmsgfile:pot, kjer pot kaže na datoteko, ki vsebuje sporočilo zapisa. Za izpolnitev polja ID hrošča (če ste pravilno nastavili integracijo s sledilnikom zadev) lahko uporabite /bugid:"številka hrošča". |
| :add | Doda datoteke v /path v sistem verzioniranja. |
| :revert | Povrne krajevne spremembe v delovni kopiji. /path pove, katere elemente je potrebno povrniti. |
| :cleanup | Cleans up interrupted or aborted operations and unlocks the working copy in /path. You also have to pass the /cleanup to actually do the cleanup. Use /noui to prevent the result dialog from popping up (either telling about the cleanup being finished or showing an error message). /noprogressui also disables the progress dialog. /nodlg disables showing the cleanup dialog where the user can choose what exactly should be done in the cleanup. The available actions can be specified with the options /cleanup for status cleanup, /breaklocks to break all locks, /revert to revert uncommitted changes, /delunversioned, /delignored, /refreshshell, /externals, /fixtimestamps and /vacuum. |
| :resolve | Označi sporno datoteko, podano v /path, kot rešeno. Če je podana možnost /noquestion, se označevanje izvede brez uporanikove potrditve. |
| :repocreate | V /path ustvari skladišče |
| :switch | Opens the switch dialog. The /path specifies the target directory and /url the URL to switch to. |
| :export | Exports the working copy in /path to another directory. If the /path points to an unversioned directory, a dialog will ask for an URL to export to the directory in /path. If you specify the key /blockpathadjustments, the automatic export path adjustments are blocked. |
| :dropexport | Exports the working copy in /path to the directory specified in /droptarget. This exporting does not use the export dialog but executes directly. The option /overwrite specifies that existing files are overwritten without user confirmation, and the option /autorename specifies that if files already exist, the exported files get automatically renamed to avoid overwriting them. The option /extended can specify either localchanges to only export files that got changed locally, or unversioned to also export all unversioned items as well. |
| :dropvendor | Copies the folder in /path recursively to the directory specified in /droptarget. New files are added automatically, and missing files get removed in the target working copy, basically ensuring that source and destination are exactly the same. Specify /noui to skip the confirmation dialog, and /noprogressui to also disable showing the progress dialog. |
| :merge | Opens the merge dialog. The /path specifies the target directory. For merging a revision range, the following options are available: /fromurl:URL, /revrange:string. For merging two repository trees, the following options are available: /fromurl:URL, /tourl:URL, /fromrev:xxx and /torev:xxx. |
| :mergeall | Odpre okno za spajanje. /path določa ciljno mapo. |
| :copy | Brings up the branch/tag dialog. The /path is the working copy to branch/tag from. And the /url is the target URL. If the urls starts with a ^ it is assumed to be relative to the repository root. To already check the option Switch working copy to new branch/tag you can pass the /switchaftercopy switch. To check the option Create intermediate folders pass the /makeparents switch. You can also specify the /logmsg switch to pass a predefined log message to the branch/tag dialog. Or, if you don't want to pass the log message on the command line, use /logmsgfile:pot, where pot points to a file containing the log message. |
| :settings | Odpre okno za nastavitve |
| :remove | Odstrani datoteke v /path iz sistema Subversion. |
| :rename | Preimenuje datoteko v /path. Novo ime vpišete v pogovornem oknu. Če se želite izgoniti vprašanju o preimenovanju podobnih datotek v enem koraku, podajte /noquestion. |
| :diff | Starts the external diff program specified in the TortoiseSVN settings. The /path specifies the first file. If the option /path2 is set, then the diff program is started with those two files. If /path2 is omitted, then the diff is done between the file in /path and its BASE. If the specified file also has property modifications, the external diff tool is also started for each modified property. To prevent that, pass the option /ignoreprops. To explicitly set the revision numbers use /startrev:xxx and /endrev:xxx, and for the optional peg revision use /pegrevision:xxx. If /blame is set and /path2 is not set, then the diff is done by first blaming the files with the given revisions. The parameter /line:xxx specifies the line to jump to when the diff is shown. |
| :shelve | Shelves the specified paths in a new shelf. The option /shelfname:name specifies the name of the shelf. An optional log message can be specified with /logmsg:message. If option /checkpoint is passed, the modifications of the files are kept. |
| :unshelve | Applies the shelf with the name /shelfname:name to the working copy path. By default the last version of the shelf is applied, but you can specify a version with /version:X. |
| :showcompare |
Odvisno od naslovov URL in revizij, ki jih želite primerjati, se prikaže poenotena razlika (če je nastavljena možnost Možnosti If the specified url also has property modifications, the external diff tool is also started for each modified property. To prevent that, pass the option If a unified diff is requested, an optional |
| :conflicteditor | Zažene urejevalnik sporov, ki je naveden v nastavitvah TortoiseSVN, s pravilnimi datotekami za sporno datoteko /path. |
| :relocate | Odpre pogovorno okno za premestitev. /path določa pot delovne kopije za premestitev. |
| :help | Odpre datoteko pomoči. |
| :repostatus | Opens the check-for-modifications dialog. The /path specifies the working copy directory. If /remote is specified, the dialog contacts the repository immediately on startup, as if the user clicked on the Check repository button. |
| :repobrowser |
Starts the repository browser dialog, pointing to the URL of the working copy given in An additional option If If |
| :ignore | Doda vse cilje v /path na seznam prezrtih elementov, to pomeni, da datotekam doda lastnost svn:ignore. |
| :blame |
Odpre pogovorno okno Okrivi za datoteko, podano z opcijo Če sta nastavljevni možnosti Če je nastavljena opcija Podprte so tudi možnosti |
| :cat | Shrani datoteko z naslova URL ali delovne kopije, navedene v /path, na lokacijo /savepath:pot. /revision:xxx predstavlja številko revizije. S tem lahko prevzamemo datoteko v določeni reviziji. |
| :createpatch | Creates a patch file for the path given in /path. To skip the file Save-As dialog you can pass /savepath:pot to specify the path where to save the patch file to directly. To prevent the unified diff viewer from being started showing the patch file, pass /noview. If a unified diff is requested, an optional prettyprint option can be specified which will show the merge-info properties in a more user readable format. |
| :revisiongraph |
Shows the revision graph for the path given in To create an image file of the revision graph for a specific path, but without showing the graph window, pass Since the revision graph has many options that affect how it is shown, you can also set the options to use when creating the output image file. Pass these options with |
| :lock | Zaklene datoteko ali vse datoteke v mapi, podani v /path. Pogovorno okno za zaklepanje se pojavi, da lahko uporabnik vnese sporočilo zaklepanja. |
| :unlock | Odklene datoteko ali vse datoteke v mapi, podani v /path. |
| :rebuildiconcache | Ponovno zgradi predpomnilnik ikon sistema. Ta ukaz uporabite le v primeru, če se ikone na nek način poškodujejo. Neizogiben stranski učinek tega postopka je, da se ikone na namizju prerazporedijo po svoje. Če sporočila ne želite videti, podajte /noquestion. |
| :properties |
Shows the properties dialog for the path given in For dealing with versioned properties this command requires a working copy. Revision properties can be viewed/changed if To open the properties dialog directly for a specific property, pass the property name as |
| :sync |
Exports/imports settings, either depending on whether the current settings or the exported settings are newer, or as specified. If a path is passed with The parameter If neither If If The parameter |
Primeri (vpisati jih je potrebno v eno vrstico):
TortoiseProc.exe /command:commit
/path:"c:\svn_wc\file1.txt*c:\svn_wc\file2.txt"
/logmsg:"sporočilo" /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