SVN - návod

[Refly]

Jak už jsem psal tady - používám SVN na verzování (nejenom) titulků.

Zkusím tady napsat obecný návod, jak se SVN používá, třeba se to někomu zalíbí, třeba se to pak bude používat u 3. série při vytváření a ladění/korekci titulků, popř. na vývoj Bronies webu. A třeba taky ne... Já už SVN používám řadu let - jak v práci, tak k soukromým účelů, tak ho nabídnu i vám...

Nelekněte se délky návodu - je psaný hodně podrobně - v praxi je to pár kliknutí myší.

Výhody jsou jasné:
- Centrální úložiště
-- Už žádné posílání různých verzí souborů e-mailem/PM
-- Vždy aktuální verze souboru, může na něm dělat více lidí současně (po domluvě)
- Jasné verzování změn souborů
-- Historie změn, jejich porovnávání, jednotnost
- Jednoduché ovládání pomocí několika málo kliknutí
- Hodí se na verzování jakýchkoliv textových souborů (titulky, weby (zdrojové kódy), ...)
-- Nehodí se na verzování obrázků či jiných binárních souborů

Základní informace najdete na Wikipedii.

Místo popisu nějaké nudné teorie dám raději ukázku z praxe - základ používání (možností je samozřejmě mnohem více), ale pro začátek to vezmu jednoduše.

---

SVN klient je ke stažení zde:
32 bit: http://sourceforge.net/projects/tortoise...i/download
64 bit: http://sourceforge.net/projects/tortoise...i/download

Volitelně čeština:
32 bit: http://sourceforge.net/projects/tortoise...i/download
64 bit: http://sourceforge.net/projects/tortoise...i/download

---

Prvním krokem je Checkout - to se dělá pouze jednou, tím získáte aktuální revizi z centrálního repozitáře, tj. nejaktuálnější soubory z úložiště na serveru, včetně všech změn od ostatních lidí s přístupem do SVN.
- Vytvořte si prázdný adresář a klikněte pravým tlačítkem myši (dále PTM) na SVN Získat (Checkout):



- Ve formuláři nic neměníte, kromě URL (veřejně nesděluji, pouze pro vážné zájemce) a dáte OK.




Nyní už následuje standardní "kolečko", které se dělá vždy když chcete pracovat se soubory v SVN:
1. Update
2. Změny souborů
3. Commit

1. Update
Tím si aktualizujete svoji lokální kopii repozitáře (získanou pomocí Checkoutu výše) podle serveru.
Není to povinné, ale je to důrazně doporučené před začátkem práce, neboť se tím vyhnete případným konfliktům (tj. když někdo před vámi zeditoval stejný soubor na stejném řádku jako vy a vy tedy pracujete se starou kopií) při odevzdání (commitu).



2. Změny souborů
- Pokud již soubor v repozitáři je, tak ho normálně zeditujete a uložíte
- Pokud je soubor/adresář nový, tak ho repozitář nezná a ignoruje ho. Musíte ho do něj přidat (říct mu, že tento soubor/adresář chcete verzovat): PTM -> TortoiseSVN -> Přidat (Add)
- Pokud chcete nějaké své změny v souboru/adresáři vrátit (rozmysleli jste si to), tak PTM -> TortoiseSVN -> Navrátit (Revert)
- Před Commitem se dá "Vrátit Přidat", tj. zrušení přidání souboru/adresáře (stejně jako ostatní souborové operace - smazání, přejmenování, ...)
- Jakmile je jednou soubor/adresář přidán a commitnut, tak k práci s ním (souborové operace) musíte používat VÝHRADNĚ SVN nástroje - nesmíte soubor "ručně" přesouvat, přejmenovávat, mazat apod., vždy zvolte položku v menu:



3. Commit
Commit znamená odeslání veškerých změn z kroku 2 (přidání, mazání, editace souborů) na server. Dokud neuděláte Commit, tak jsou veškeré změny pouze u vás na disku a nikdo jiný je nevidí! Poté, co uděláte Commit získají tyto změny ostatní lidé pomocí přílazu Update, viz první krok.
A tím se nám kolečko uzavírá... Jen vyplníte popis změn a dáte OK.

---

No a teď praktická ukázka nejběžnějších věcí:
1. Přidání souboru
2. Editace souboru + porovnání s originálem (kontrola změn před Commitem)
3. Smazání souboru (moc se nepoužívá)
4. Zobrazení logu

Pro adresáře platí prakticky stejný postup. Můžete najednou přidat více souborů i více adresářů (pokud spolu souvisí) a pak to teprve vše Commitnout.

Obecně je to tak, že vždy v rámci jednoho Commitu pracuje se soubory a adresáři které spolu významově souvisí.
Např. Nejprve zedituji titulky S01E01.srt a Commitnu změny a poté teprve začnu pracovat na jiném souboru - nemíchat dohromady zbytečně věci, které spolu nesouvisí.

Pokud editujete více souborů, vždy Commitujte nadřazený adresář, aby se to odeslalo jako jeden balík změn, NEcommitujte po jednotlivých souborech.

Už jen rychle, formou obrázků:

1. Přidání souboru



2. Editace souboru



3. Smazání souboru (moc se nepoužívá)



4. Zobrazení logu

---

Je to jen takový rychlý přehled (k ideálnímu návodu to má daleko... ), kdyby to někoho zaujalo, tak dotazy zodpovím na Mumble...