Verzování dokumentů ve webové aplikaci TeXonWeb

Transkript

1 Mendelova univerzita v Brně Provozně ekonomická fakulta Verzování dokumentů ve webové aplikaci TeXonWeb Bakalářská práce Vedoucí práce: Ing. Jan Přichystal, Ph.D. Václav Telenský Brno 2013

2 2

3 Děkuji Ing. Janu Přichystalovi, Ph.D. za příkladné vedení práce, trpělivost a za cenné připomínky.

4 4

5 Prohlašuji, že jsem tuto práci vypracoval sám a za pomocí literatury uvedené v kapitole Literatura V Brně dne 23. května

6 6

7 7 Abstract Telenský, V. Document versioning in TEXonWeb application. Bachelor thesis. Brno, This bachelor thesis deals with design and implementation document versioning into web application TEXonWeb. This process is used to save parts of document the user creates in time in such way the parts are easily available anytime and the user can retrace to them anytime during his work. For document versioning the open source version control system SVN is used. Client application integrated into TEXonWeb is developed using Javascript, AJAX and Perl technologies. Abstrakt Telenský, V. Verzování dokumentů ve webové aplikaci TEXonWeb. Bakalářská práce. Brno, Bakalářská práce se zabývá návrhem a implementací verzování dokumentů ve webové aplikaci TEXonWeb. Tento proces se využívá pro ukládání částí dokumentu, které uživatel postupně vytvoří tak, aby byly kdykoliv snadno dostupné a uživatel se k nim mohl jednoduše kdykoliv během práce vrátit. Pro verzování dokumentů je využíván volně dostupný verzovací systém SVN. Klientská aplikace integrovaná do TEXonWeb je vytvořena pomocí technologií Javascript, HTML, CSS, AJAX a Perl.

8 8

9 OBSAH 9 Obsah 1 Úvod a cíl práce Úvod Cíl práce Metodika a postup řešení Použité technologie Současný stav Dostupná řešení Microsoft Word Google Disk LibreOffice Writer Analýza současného stavu Implementace Návrh řešení Verzovací systém SVN Použité příkazy Nasazení verzovacího systému Automatizované ovládání verzovacího systému Uživatelské rozhraní Správce verzí Generování seznamu verzí Synchronizace správce verzí se správcem souborů Diskuze a zhodnocení Přínosy implementovaného řešení Nedostatky implementovaného řešení Další možný postup Zhodnocení Závěr 42 7 Literatura 43

10 10 OBSAH

11 1 ÚVOD A CÍL PRÁCE 11 1 Úvod a cíl práce 1.1 Úvod Práce se zabývá možností implementace verzování dokumentů do aplikace TEXonWeb 1. TEXonWeb je uživatelské rozhraní umožňující práci s DTP 2 systémem TEX 3 a jeho nadstavbou L A TEX. Aplikace je využívána při výuce předmětu Zpracování textů na počítači na Provozně ekonomické fakultě Mendelovy univerzity v Brně. Aplikace není dostupná pouze pro studenty, ale může ji využívat i široká veřejnost. Pro některé uživatele může být těžkým úkolem již samotná instalace desktopového řešení DTP systému. Proto je aplikace TEXonWeb možností jak rychle a efektivně vytvořit kvalitní dokument. TEXonWeb a obecně TEX/L A TEX fungují na principu značkovacího jazyka. Vstupní text je uživatelem označkován speciálními značkami a následně použit jako vstup pro kompilátor takto upraveného textu. Výstupem je precizní PDF 4 dokument. Alternativou výstupu PDF dokumentu je PostScript 5. Proto, aby uživatel mohl TEX/L A TEX používat, je nutné mít určité znalosti. Nicméně při použití aplikace TEXonWeb je uživateli dostupné intuitivní grafické rozhraní, které tento nedostatek odstraňuje. To činí z TEXonWeb efektivní a spolehlivý nástroj pro tvorbu dokumentů Verzování dokumentů je obecně způsob jak ukládat dokumenty od jejich vytvoření až po finální podobu s možností se kdykoliv vrátit k jedné z uložených podob. Každá tato podoba se nazývá verze dokumentu. Běžný uživatel často zjistí, že změny, které v dokumentu provedl, nejsou optimální a rád by se vrátil k předchozí verzi, na které pracoval před časem. Dostupná funkce Zpět umožňuje vracet pouze kroky od posledního uložení dokumentu. Ke starším verzím dokumentu se uživatel touto cestou již nedostane. Naproti tomu verzování dokumentů umožňuje obnovit jakoukoliv v předchozí době uloženou verzi. Velkou inspirací pro moji bakalářskou práci je aplikace Google disk 6 a její funkce Historie verzí. V aplikaci Google disk je možné vytvářet různé druhy dokumentů od obyčejných textových dokumentů až po skripty psané v programovacím jazyce Javascript. Je to webová aplikace, která nabízí uživateli k tvorbě jeho textových dokumentů WYSIWYG 7 editor. Další aplikace, které slouží jako inspirace pro moji 1 Lze nalézt na 2 Zkratka DTP vychází ze slova Desktop Publishing a označuje způsob profesionální sazby dokumentů 3 Autorem tohoto systému je Donald Ervin Knuth 4 Formát vyvinutý společností Adobe, čitelný na různých platformách pomocí prohlížeče Adobe Reader, dříve nazývaný Acrobat Reader 5 Programovací jazyk používaný pro grafický popis tištěných dokumentů byl vyvinut firmou Adobe Systems 6 Dříve Google dokumenty, dostupné na 7 WYSIWYG je zkratkou pro větu What you see is what you get. Označuje textové procesory, ve kterých by uživatel měl získat po vytisknutí stejnou podobu dokumentu, kterou vytvořil v textovém procesoru

12 12 1 ÚVOD A CÍL PRÁCE bakalářskou práci, jsou Microsoft Word 8 a LibreOffice Writer Cíl práce Cílem bakalářské práce je rozšířit stávající webovou aplikaci TEXonWeb o novou funkcionalitu verzování dokumentů. Tato funkcionalita bude umožňovat uživateli vytvářet verze a následně se k vybrané verzi vrátit. Správa těchto verzí bude umožněna pomocí uživatelsky přívětivého rozhraní. V tomto rozhraní budou uživateli poskytnuty veškeré důležité informace týkající se každé verze. Mezi tyto informace patří číslo verze, datum a čas vytvoření, velikost souboru. Z rozhraní pro správce verzí bude také možné poznat, kterou verzi má uživatel aktivní. Všechna zmíněná rozšíření budou implementována pomocí technologií Javascript, Perl, HTML, CSS a verzovacího systému SVN. 8 Placený software, který je součástí kancelářského balíku Microsoft Office 9 Svobodný software, který je součástí balíku LibreOffice

13 2 METODIKA A POSTUP ŘEŠENÍ 13 2 Metodika a postup řešení Protože aplikace TEXonWeb je již hotovou a používanou aplikací a na jejím vývoji se podílelo již mnoho programátorů, je proto její vlastní zdrojový kód velice rozsáhlý a komplexní. Z toho důvodu je také nutné v první řadě porozumět a zorientovat se ve struktuře souborů, které tyto zdrojové kódy obsahují. Poté budu muset přidat vlastní zdrojový kód, který umožní jak na klientské straně, tak na serverové, provádět úkoly vedoucí k vytváření samotných verzí dokumentů. Před implementací vlastního kódu bude nutné provést analýzu aktuálně fungujícího kódu aplikace. Tento krok je důležitý z důvodu zachování aktuální funkčnosti. Mohlo by se stát, že přidáním vlastního kódu by se narušila struktura současně implementovaných algoritmů a to by vedlo k výskytu chyb v aplikaci a nebo v nejhorším případě k celkové nemožnosti použití aplikace. Veškeré změny v kódu budou prováděny v adresáři devel 10. Tento adresář obsahuje vývojovou verzi aplikace TEXonWeb. Proto v případě nevydařené změny kódu nebude ovlivněna ostrá verze a tím i práce běžných uživatelů. Práce bude obsahovat popis a srovnání dostupných alternativ verzování dokumentů. Aplikace, které v této kapitole srovnám, se nazývají Google disk, Microsoft Word a LibreOffice Writer. Důležitou částí bude nastudování verzovacího systému SVN 11. Tento systém bude tvořit stěžejní část funkčnosti verzování dokumentů. Detailně tento systém popíši v části Implementace. Systém SVN bude ovládaný automatizovaně pomocí skriptu napsaného v jazyce Perl. Detailní strukturu, vstupy a výstupy tohoto skriptu také popíši v části Implementace. Kapitola Implementace bude obsahovat veškerou vlastní práci a popis rozšíření aktuálního systému. Před zahájením programování funkcionality verzování dokumentů bude nutné zavést SVN do adresářů obsahující zdrojové soubory dokumentů. V aplikaci TEXonWeb má každý uživatel svůj vlastní prostor pro vytvářené dokumenty. Tento prostor je uložen na serveru a představuje ho adresář pojmenovaný stejně jako jméno uživatele. V první fázi zavedu SVN pouze na dva uživatelské účty. Prvním z nich je účet Ing. Jana Přichystala, Ph. D. a druhým je můj osobní účet. V této fázi bude následovat implementace základní funkcionality, jako je vytváření nových verzí a přecházení k již vytvořeným verzím. Také bude nutné zajistit synchronizaci se správcem souborů. Po otestování a potvrzení funkčnosti bude následovat fáze dvě. V této fázi půjde o hromadné zavedení SVN na všechny existující účty aplikace TEXonWeb. Během práce bude nutné konzultovat provedené změny s Ing. Janem Přichystalem, Ph. D. Tyto konzultace budou nutné z důvodu ověření funkčnosti a provádění úkonů na serveru spojených se zaváděním SVN na existující účty. Práce bude ve svém závěru obsahovat diskuzi a zhodnocení vytvořeného řešení. V této části srovnám vlastní řešení s konkurenčními. Část týkající se zhodnocení vytvořeného řešení bude také obsahovat ekonomický pohled na věc a přínosy nově vytvořené funkcionality. 10 Dostupné na 11 Zkratka pro pojem Subversion

14 14 2 METODIKA A POSTUP ŘEŠENÍ 2.1 Použité technologie Z toho důvodu, že aplikace TEXonWeb je již hotové řešení a má práce se zabývá rozšířením stávající funkcionality, je velká část technologií již zvolena. Pouze v případě technologie pro verzování dokumentů bylo zapotřebí rozhodnout, kterou z dostupných možností zvolit. Rozhodli jsme se pro verzovací systém SVN. Učinili jsme tak, protože SVN je využíván pro verzování všech souborů obsahující zdrojové kódy aplikace TEXonWeb. Nebylo tedy nutné instalovat žádný nový systém na server. Systém SVN bude pro naše účely postačovat ve všech ohledech. V současné době se pro klientskou část aplikace využívá programovací jazyk Javascript. Pomocí tohoto jazyka je vytvořeno celé uživatelské rozhraní a všechny jeho nabízené funkce. Aplikace využívá také frameworku jquery 12. Pomocí něj můžeme vytvářet dialogová okna a provádět různé akce, které by v případě použití samotného Javascriptu bylo složité implementovat. Samozřejmostí je využití technologií HTML a CSS. Tyto dvě technologie jsou klíčové pro vytváření webových aplikací. Není proto pochyb, že HTML a CSS jsou použity i v naší aplikaci. TEXonWeb využívá technologii AJAX 13. Tato technologie je velmi významnou na poli webových technologií a využívá se při tvorbě takzvaných RIA 14 aplikací. Využitím této technologie jsme schopni získávat informace ze serveru, aniž by se musela obnovit stránka. Tato výhoda neaktualizování vyvolává dojem, jakoby uživatel používal desktopovou aplikaci. V případě verzování dokumentů bude AJAX využíván pro zasílání HTTP 15 dotazů na skript pro správu SVN. Programovacím jazykem na straně serveru je Perl. V současné době jsou skripty využívány například pro vytváření seznamu souborů a adresářů, pro provádění akcí se souborovým systémem každého uživatele a mnohé další. V našem případě bude skript provádět příkazy, kterými bude ovládat SVN repozitář 16 přihlášeného uživatele. 12 Dostupné z 13 Zkratka AJAX znamená Asynchronous Javascript and XML 14 Označení RIA znamená Rich Internet application 15 Komunikační protokol aplikační vrstvy 16 Prostor na serveru, ve kterém jsou uloženy verzované soubory

15 3 SOUČASNÝ STAV 15 3 Současný stav 3.1 Dostupná řešení Verzování dokumentů je funkcionalita, která je v současné době rozšířena v běžně používaných WYSIWYG editorech. Proto při vytváření funkcionality verzování dokumentů v TEXonWeb sloužily k inspiraci tři nejpoužívanější aplikace pro tvorbu dokumentů Microsoft Word, LibreOffice Writer a Google Disk. Zvolili jsme si tyto aplikace z důvodu velké komunity uživatelů, která by v případě problému mohla prostřednictvím diskuzních fór poskytnout cenné informace. Mezi rozdíly z pohledu členitelnosti těchto aplikacích patří licence, pod kterou jsou tyto produkty poskytované, a typ aplikace. Tato fakta je zajímavé zahrnout do hodnocení funkcionality verzování dokumentů v jednotlivých aplikacích Microsoft Word Aplikace Microsoft Word je textovým procesorem, který je součástí kancelářského balíku Microsoft Office. Produkt Microsoft Office je poskytován firmou Microsoft pod různými licencemi. V rámci mé bakalářské práce byla použita licence určená pro vysokoškolské studenty, která se vztahuje na verzi Microsoft Office V případě Microsoft Word je zbytečné pátrat po pojmu verzování dokumentů. Firma Microsoft tuto funkcionalitu nazvala sledování změn v dokumentu. Sledování změn dokumentu je ve výchozím stavu programu vypnuté. Uživatel si tuto funkcionalitu může zapnout z karty Revize v podmenu Sledování. Jakmile je funkcionalita zapnutá, tak veškerý nově přidaný text je ve výchozím stavu zbarven červenou barvou. Avšak je dobré si před zahájením práce na dokumentu zvolit způsob, jakým se prováděné změny budou v dokumentu zobrazovat. Dialog 17 nastavení je možné vyvolat kliknutím na spodní část tlačítka Sledovat změny, kde po kliknutí se zobrazí skrývatelná nabídka, ve které si uživatel zvolí možnost Změnit možnosti sledování. V zobrazeném dialogu je možné měnit širokou škálu možností. Mezi zajímavé možnosti patří změna barvy písma u specifických akcí. Uživatel si může zvolit barvu, kterou se bude písmo obarvovat, a to v případě přidání nového textu a odstranění textu. V případě odstraňování se písmo textu obarví zvolenou barvou jen v případě, že uživatel odstraní část textu, která byla v minulosti přijata jako součást originálního dokumentu, a zároveň má vypnutou možnost zobrazování bublin. K procesu přijímání a odmítání změn se v této kapitole ještě vrátíme. Taktéž bude vysvětlena možnost zobrazování bublin. Mimo změny barvy písma u výše zmíněných akcí lze měnit také styl písma. Uživatel může například nastavit, aby se písmo textu, který se rozhodne přidat do dokumentu, zobrazovalo podtrženě. Lze si samozřejmě vybrat z široké nabídky možností stylů písma. Příkladem stylů písma může být tučný řez písma, kurzíva 17 Dialog je uzavíratelné okno, které je možné libovolně přesouvat po obrazovce

16 16 3 SOUČASNÝ STAV nebo přeškrtnuté písmo. Styly je možné úplně vypnout. V takovém případě bude text zobrazován podle toho, jak si uživatel zvolí pomocí vlastních stylů. Mezi další vizuální pomůcky, které si uživatel může nastavit v rámci Sledování změn, patří označení změněných řádků. Řádky se označují pomocí vertikální čáry vedené po okraji dokumentu. Stranu, po které bude čára vedena, lze měnit podle preferencí uživatele. Speciálním případem je zvolení vnějšího ohraničení. V takovém případě je čára vedena po levé straně na lichých stránkách dokumentu a po pravé na sudých stránkách dokumentu. Barevně lze také odlišovat komentáře. Komentář může uživatel přidat tím, že označí komentovaný text do bloku a stiskne tlačítko Nový komentář. Zvolenou barvou jsou pak obarveny kulaté závorky, do kterých je okomentovaný text uzavřen. Komentáře slouží k přidání dodatečné informace pro další uživatele, kteří budou dokument později editovat. Pokud dokument edituje pouze jeden uživatel, slouží komentáře pro jeho osobní potřebu. V případě, že uživatel používá funkci zobrazování bublin, není komentář vyznačen kulatými závorkami v textu, ale je zobrazen při přejetí kurzorem myši přes bublinu. Word nabízí také možnost barevně odlišit změny, které uživatel provede při úpravě tabulek. Odlišnou barvu lze nastavit pro čtyři různé uživatelské akce. Těmito akcemi jsou vložení buňky, sloučení buňky, odstranění buňky, rozdělení buněk. Volitelnou akcí, kterou je možné pomocí funkce sledování změn zachycovat, je formátování písma. Slovem volitelnou v tomto případě myslíme akci, kterou lze vypnout a přestat ji tak úplně zachycovat. Formátování je zachyceno, pouze pokud uživatel využije nějakou z možností v kartě Domů, v podmenu Písmo. Naformátovaný text je možné zobrazovat zvolenou barvou, zvoleným stylem písma nebo kombinací předchozích dvou. Stejným způsobem, jakým si uživatel zvolí zobrazovat formátování písma v dokumentu, bude zobrazována definice vlastního stylu pro písmo. Zajímavou možností, kterou lze využít při sledování dokumentu, je použití takzvaných bublin. Bubliny obsahují informace, které říkají uživateli, jaká akce v daném místě dokumentu vznikla. Místo je určeno čárkovanou čarou vedoucí od bubliny a zakončenou střelkou označující přesné místo vzniku uživatelské akce. Čára je vykreslena barvou, kterou si zvolil uživatel k odpovídající akci. Čáru mezi bublinou na okraji a místem označujícím vznik akce je možné nezobrazovat. Bubliny se vztahují k akcím jako jsou odstranění textu, přidání komentáře, naformátování písma. Okraj, na který se budou bubliny zarovnávat, si uživatel může zvolit dle svých potřeb. Volitelná je také šířka bubliny, kterou bude na stránce zabírat. Šířku je možné nastavovat v procentech nebo centimetrech. Důležitými funkcemi z hlediska sledování změn je přijímání a odmítání provedených změn v dokumentu. Změny v dokumentu jsou všechny akce, které uživatel provedl během svojí práce. Změny jsou barevně odlišeny podle toho, jak si je uživatel definoval v dialogu možností sledování změn. Přijímání provedených změn v dokumentu může uživatel provést pomocí tlačítka Přijmout, které se nachází v kartě Revize, v podmenu Změny. Přijímání změn může uživatel provádět postupně změnu

17 3.1 Dostupná řešení 17 Obrázek 1: Okno Možností sledování změn po změně nebo přijmout všechny změny v dokumenty najednou. K tomu, aby uživatel mohl procházet změny postupně, může využít tlačítek Další a Předchozí. Pomocí těchto tlačítek je možné projít změny v dokumentu postupně od první až k poslední. Jednotlivé změny se vždy po kliknutí na tlačítko Další nebo Předchozí označí do bloku. Poté, co uživatel stiskne tlačítko Přijmout nad označenou změnou, stává se přijatá změna součástí dokumentu a je vyjmuta z celkového sledování změn. Podobně jako přijímání změn funguje také odmítání změn s rozdílem, že po stisknutí tlačítka Odmítnout nad označenou změnou se změna zruší a vrátí se do původního stavu. Užitečnou funkcí pro orientaci v celkových změnách v dokumentu je zobrazení podokna revizí. Podokno lze zobrazit kliknutím na tlačítko Podokno revizí v kartě Revize, v podmenu Sledování. V zobrazeném podokně jsou veškeré změny provedené v dokumentu roztříděny do kategorií určující část dokumentu. Tímto způsobem má uživatel k dispozici přehlednou navigaci, kde pomocí kliknutí na vybrané změny či komentáře může přímo přejít k potřebným změnám a provést požadovanou akci. Program Microsoft Word nabízí uživatelům významnou možnost porovnání dvou dokumentů. Tlačítko Porovnat dostupné z karty Revize, v podmenu Porovnat, umožňuje porovnávání dokumentů. V případě porovnávání dokumentů si uživatel

18 18 3 SOUČASNÝ STAV Obrázek 2: Podokno revizí v aplikaci MS Word před spuštěním samotného porovnání vybere, který dokument považuje za originální a vůči kterému chce dokument porovnávat. Tedy který dokument chce uživatel použít jako revidovaný. Porovnávané dokumenty by měly obsahovat podobný obsah s tím rozdílem, že každý dokument by měl být jiné verze. Funkce Porovnat poté zjistí rozdíly mezi jednotlivými verzemi a barevně tyto rozdíly odliší a zobrazí obsah obou dokumentů. Při porovnání dvou dokumentů se typy změn nalezené v revidovaném dokumentu zobrazí v podokně revizí. Například pokud v revidovaném dokumentu je na první stránce nadpis, který v originálním dokumentu není, pak je tento nadpis označen za změnu, která je typu vkládání. Odlišnosti porovnávaných dokumentů je možné zobrazit jak v originálním dokumentu, tak v revidovaném dokumentu nebo v nově otevřeném dokumentu. Porovnáváním dokumentů je uživatel nejen schopen rychle zjistit změny vyskytující se v revidovaném dokumentu, ale může přijímáním těchto změn vytvořit zcela nový dokument Google Disk Google Disk je webová aplikace, která primárně umožňuje uživatelům službu webového uložiště. Uživatel může po vytvoření účtu využívat zdarma 5 GB volného místa pro svoji potřebu. Kapacitu uložiště je možné rozšířit za poměrně malou cenu na 25 GB nebo v případě vyšší potřeby na 100 GB. Do uložiště je možné nahrát veškeré vlastní soubory, které uživatel má na svém disku. Možné je i vytváření adresářů, což umožňuje vytvářet svoji vlastní souborovou strukturu. Soubory lze poté sdílet

19 3.1 Dostupná řešení 19 s ostatními uživateli Google Disk. Sdílení lze provést zadáním ové adresy identifikující přesně uživatele nebo pomocí sociálních sítí mezi více uživatelů. Uživatelům je možné různě nastavit práva ke sdíleným souborům. Souborům lze nastavit práva pro editaci, čtení a přidávání komentářů. Mimo to, že je možné na Google Disk uložit prakticky vše, co vás napadne, nabízí aplikace možnost vytváření dokumentů, tabulek, prezentací a co víc, dokonce poskytuje vývojové prostředí pro vytváření vlastních skriptů. Pro vytváření každého typu dokumentu je k dispozici specifické rozhraní. Google Disk nabízí tedy webovou verzi aplikací, které lze najít v kancelářských balících, jako je Microsoft Office nebo LibreOffice Writer. Google Disk lze také propojit s jinými oblíbenými aplikacemi pro tvorbu různých dokumentů, grafů a dalších souborů. Propojení lze zajistit pomocí intuitivního průvodce. Do průvodce je možné se dostat přes tlačítko Vytvořit, kde se po stisknutí objeví menu s výběrem typů souboru. V dolní části menu se nachází odkaz s textem Připojit další aplikace, odkaz uživateli zobrazí průvodce. Google Disk zaznamenává každou změnu, kterou v souboru provedete. Kdykoli tedy stisknete tlačítko Uložit, uloží se nová verze. Automaticky máte k dispozici verze až z posledních 30 dní.(google Disk, 2012, online) Avšak vytvářené verze jsou dostupné pouze u textových dokumentů, tabulek, prezentací, nákresů a skriptů. U ostatních dokumentů se verze nevytvářejí. Ukládání nových verzí nevzniká pouze při stisknutí tlačítka Uložit, ale přímo při změně obsahu dokumentu. Google Disk rozpozná, že uživatel změnil obsah dokumentu, a automaticky vytvoří novou verzi. K vytvořeným verzím je možné se dostat pomocí panelu Historie revizí. Panel si uživatel může zobrazit klávesovou zkratkou Ctrl + Alt + Shift + G nebo otevřením záložky Soubor v záhlaví dokumentu a vybráním možnosti Zobrazit historii verzí. Panel Historie revizí obsahuje veškeré verze, které byly vytvořeny uložením dokumentu. Každá verze obsahuje informaci o datu a času vytvoření a jménech uživatelů, kteří na dokumentu pracovali v době vytváření verze. Každý uživatel má u každé verze uvedené své barevné označení. To znamená, že změny, které v dokumentu uživatel provede, budou vyznačeny uvedenou barvou. Po kliknutí na verzi se automaticky zobrazí náhled na podobu dokumentu, v jaké byl v době vzniku verze dokument uložen. Každá verze, až na aktivní, zobrazuje kromě zmíněných informací i odkaz, který umožňuje obnovit dokument k označené verzi. Aktivní verze je vždy nejvýše v panelu Historie revizí. Historie revizí umožňuje v každém náhledu zobrazit změny, které uživatelé provedli oproti předchozí verzi. Tuto funkcionalitu je možné zapnout zaškrtnutím zatrhávacího políčka Zobrazit změny, které se nachází ve spodní části panelu Historie revizí. Změny jsou zobrazeny barvou identifikující uživatele, který změnu provedl. Přeškrtnuté změny symbolizují odstraněné položky dokumentu. Naopak pouze obarvené změny bez přeškrtnutí symbolizují položky, které byly do dokumentu přidány. Poslední možností, kterou lze v panelu Historie revizí využít, je omezení počtu zobrazovaných verzí. Uživatel má možnost zobrazit více verzí, ve kterých proběhla změna pouze několika málo znaků, jako jednu verzi. Druhý způsob zobrazování verzí umožňuje zobrazit každou verzi nezávisle na tom, jak velké změny byly v dokumentu

20 20 3 SOUČASNÝ STAV Obrázek 3: Panel Historie revizí v aplikaci Google Disk provedeny od posledně vytvořené verze. Omezení počtu zobrazených verzí lze zapnout stisknutím tlačítka Zobrazit méně podrobné revize. Po stisknutí se název tlačítka automaticky změní na Zobrazit podrobnější revize. Je tedy možné zobrazovat verze pouze jedním z uvedených způsobů LibreOffice Writer LibreOffice je svobodný kancelářský balík pro Windows, Macintosh a Linux, který nabízí šest plnohodnotných aplikací pro práci s vašimi dokumenty a daty: Writer, Calc, Impress, Draw, Base a Math. (LibreOffice The Document Foundation, 2007, online) LibreOffice je šířený pod licencí GNU LGPL 18. Pod touto licencí je možné software libovolně šířit, používat k osobním i komerčním potřebám a také je možné libovolně upravovat zdrojový kód. Projekt LibreOffice vyvíjí rozsáhlá skupina dobrovolníků, kteří zastávají jednotlivé funkce. Například programátoři, testeři, dokumentaristé a další. LibreOffice nabízí tvorbu mnoha typů dokumentů, stejně tak jako Microsoft Office. Je tedy možné nejen vytvářet textové dokumenty, ale použít i nástroje pro tvorbu tabulek, prezentací nebo vytváření grafů a diagramů. 18 Lesser General Public License je licence pro šíření svobodného softwaru. Pod touto licencí je šířena například i Mozzila

21 3.1 Dostupná řešení 21 Verzování dokumentů v rámci celého balíku umožňuje pouze aplikace LibreOffice Writer. Dle mého názoru je možnost verzování dokumentů v aplikaci LibreOffice Writer nejpropracovanější. Nabízí totiž kombinaci dvou předchozích řešení. Tedy aplikací Google Disk a Microsoft Word. Uživatel je schopen jak využívat možnost sledování změn, tak i vytváření celých verzí. Je tedy možné si zvolit způsob, jakým bude uživatel přistupovat ke kontrole provedených změn v dokumentu. V první řadě popíši jakým způsobem je možné verzovat určitý dokument pomocí vytváření celých verzí dokumentu. Proto, aby uživatel mohl vytvořit novou verzi dokumentu, musí k tomuto úkonu provést následující akci. Akce spočívá v otevření okna všech dostupných verzí, kde poté kliknutím na tlačítko Uložit novou verzi se vytvoří nová verze otevřeného dokumentu. Okno dostupných verzí je možné otevřít přes kartu Soubor s následným kliknutím na možnost Verze nebo stisknutím klávesy E. Před vytvořením nové verze se uživateli zobrazí dialog, ve kterém je dotázán na přidání případných komentářů k vytvářené verzi. Po kliknutí na tlačítko OK se vytvoří nová verze, která je dostupná v seznamu existujících verzí v otevřeném okně. Pokud chce uživatel, aby se nová verze vytvářela automaticky, musí zaškrtnout políčko nacházející se vedle tlačítka pro vytváření nových verzí. Avšak tato funkcionalita nefunguje zcela podle očekávání. Popisek zaškrtávacího políčka říká Při zavírání automaticky uložit verzi. Nicméně po zaškrtnutí políčka, následné editaci dokumentu a jeho uzavření se program dotáže, zda-li chceme obsah uložit. Pokud uživatel zvolí možnost Uložit a dokument znovu otevře, přejde k oknu dostupných verzí, tak v seznamu nenajde žádnou novou verzi. V případě zvolení možnosti Zavřít bez uložení by se změny neuložily a nová verze by se také nevytvořila. Okno dostupných verzí nabízí kromě vytváření nových verzí řadu dalších možností. Například je možné si vytvořené verze otevřít v separátních dokumentech a prohlížet si tak podobu dokumentu, v jaké se nacházel v čase vytváření verze. Uživatel má možnost si verzi zobrazit v režimu čtení nebo verzi otevřít ve zcela novém dokumentu, kde bude možné podobu dokumentu vztaženou k vybrané verzi editovat. V režimu čtení se otevře stejnojmenná kopie dokumentu zvolené verze. Ve čtecím režimu není možné provádět žádné změny, lze pouze prohlížet dokument. Další možností je editace komentářů vztahujících se k vybrané verzi. Uživatel může vybraný komentář změnit pomocí tlačítka Zobrazit, nacházejícího se v okně dostupných verzí. Po rozkliknutí se zobrazí dialog s textovým polem obsahující již uložený komentář. V případě, že verze neobsahuje žádný komentář, je textové pole prázdné. Uživatel má také k dispozici funkci mazání vybraných verzí. Smazat verzi je možné pomocí tlačítka Smazat. Zajímavou funkcí je porovnávání aktuální verze dokumentu vůči vybrané verzi. Zapnutí této funkcionality je možné pomocí tlačítka Porovnat. Po stisknutí tlačítka se do aktuální verze nahrají změny, které byly provedeny ve vybrané verzi a zobrazí se dialog umožňující přijímání nebo odmítání změn. Okno obsahuje několik možností jak vybrané změny přijmout nebo odmítnout. Uživatel může přijmout všechny změny naráz pomocí tlačítka Přijmout vše nebo v opačném případě použít tlačítko

22 22 3 SOUČASNÝ STAV Odmítnout vše. Pokud však chce změny projít pečlivěji a některé změny odmítnout a některé naopak přijmout, slouží mu k tomu seznam všech změn nacházející se nad zmíněnými tlačítky. Seznam je zobrazen v tabulce. Řádky tabulky symbolizují dílčí změny v dokumentu. Po kliknutí na řádek tabulky se natáhne do bloku místo, ve kterém změna proběhla. Poté je možné vyznačenou změnu odmítnout či přijmout pomocí stejnojmenných tlačítek. Každý řádek obsahuje informace o typu změny, uživateli, který změnu provedl, datu a času vytvoření změny. Poslední zobrazovanou informací na řádku je komentář dílčí změny. Tento komentář lze přidat pomocí funkce sledování změn. K přidávání komentářů se ještě vrátíme v nadcházejícím textu. Zobrazené dílčí změny v tabulce lze omezit pouze na vybrané pomocí karty Filtr, nacházející se v horní části okna přijímání a odmítání změn. Změny lze filtrovat pomocí specifikace hodnot sloupců tabulky. Například pokud bude uživatel chtít zobrazit v seznamu verzí pouze změny, které provedl v určitém časovém rozmezí, zaškrtne políčko Datum, v roletkovém menu nastaví hodnotu leží mezi a určí požadované datum a čas. Podobně lze postupovat při nastavování další filtrů. Obrázek 4: Okno dostupných verzí v aplikaci LibreOffice Writer Druhým způsobem, jak lze k verzování dokumentů přistupovat v programu LibreOffice Writer, je použití funkce sledování změn. Tato funkce je podobná funkcionalitě, kterou implementuje Microsoft Word. Nicméně proto, aby bylo možné začít změny v dokumentu sledovat, je třeba tuto funkci zapnout. Tento úkon je možné provést kliknutím na možnost Úpravy v menu, které se nachází v horní části otevřeného dokumentu. Po zobrazení nabídky je třeba najet kurzorem na možnost Sledování změn a v další nabídce zvolit možnost Záznam. Odlišnosti, které si uživatel jistě všimne, je nemožnost nastavení takového množství barevných označení, jako umožňuje Word. Všechny změny provedené v dokumentu jsou označeny jednou barvou a sice oranžovou. Změněné řádky jsou označeny po levé straně tenkou černou čarou. Tyto odlišení jsou pevně nastavené a nelze je měnit.

23 3.2 Analýza současného stavu 23 K jednotlivým změnám, které uživatel v dokumentu provede, je možné přidat komentář. Komentáře se následně zobrazují v okně přijímání a odmítání změn, jak bylo avizováno v předchozím textu. Komentáře je možné přidat rozkliknutím možnosti Komentář v nabídce Sledování změn. Možnost Komentář otevře dialog pro vkládání komentářů. V dialogu se nachází textové pole pro vkládání komentářů, šipky pro pohyb v jednotlivých změnách v dokumentu a také tlačítka pro potvrzení a zrušení komentáře. Pomocí šipek je uživatel schopen iterativně projít všechny změny v dokumentu a v případě potřeby si vytvářet komentáře. Komentáře plní pouze informativní charakter. Je dobré si některé změny okomentovat v případě, že na dokumentu pracuje více uživatelů. Poté uživatel ví, z jakého důvodu byly v dokumentu provedeny určité změny, a může s těmito změnami patřičně nakládat při procesu přijímání a odmítání změn. Okno přijímání a odmítání změn je možné zobrazit ze stejného místa jako dialog komentářů. Stačí jen zvolit možnost Přijmou nebo Odmítnout. Způsob, jakým přijímání a odmítání změn funguje, bylo již vysvětleno. 3.2 Analýza současného stavu V první řadě, nežli začneme s vysvětlením, jak lze v současné době uživateli umožnit alespoň částečný návrat k provedeným změnám v dokumentu, by bylo dobré si definovat pojem krok. Krokem je myšlena jedna uživatelská akce. Za akci můžeme považovat: Napsání jednoho znaku Smazání jednoho znaku Odstranění bloku textu Vložení bloku textu Vložení speciální značky do dokumentu pomocí hlavní nabídky V současné době aplikace TEXonWeb neumožňuje žádným komplexním způsobem verzovat dokumenty. Jediný způsob, jak vrátit provedené změny, je použití funkce Zpět. Tlačítko umožňující tuto funkci se nachází v základním panelu tlačítek. Tato funkce umožňuje návrat pouze o tři kroky zpět. To je v případě potřeby návratu k dřívějším změnám nedostačující. Pro obnovení odstraněných změn pomocí funkce Zpět slouží funkce Vpřed. Podobně jako předchozí funkce umožňuje obnovit pouze tři kroky, avšak je možné obnovit pouze změny, které byly odstraněny pomocí funkce Zpět. Nelze tedy obnovovat text, který byl smazán klávesou Backspace nebo Delete. Funkce Vpřed je tedy reverzní funkcí k funkci Zpět. Odpovídající tlačítko také nalezneme v základním panelu tlačítek. Z důvodu současné absence rozsáhlejší funkcionality v oblasti verzování dokumentů v aplikaci TEXonWeb jsme se s Ing. Janem Přichystalem, Ph. D. rozhodli tuto skutečnost změnit a zavést tak do aplikace novou funkcionalitu.

24 24 3 SOUČASNÝ STAV TEXonWeb je projekt umožňující využívat DTP systém TEX/L A TEX na webovém serveru za použití webového prohlížeče. (Dokumentace systému TeXonWeb, 2006, online) Aplikace TEXonWeb poskytuje uživatelům dva způsoby, jak vytvářet dokumenty. První z nich je možný využít bez nutnosti registrace uživatele. Uživatel pouze napíše svůj zdrojový text do okna pro jeho tvorbu, zvolí překladač, počet průchodů a stiskne tlačítko určující typ výstupu, ve kterém bude dokument uložen. První ze způsobů neposkytuje uživateli žádnou z rozšířených funkcí, které TEXonWeb nabízí. Hlavní nevýhodou je pak nemožnost ukládání svých zdrojových textů na serveru. Pro zpřístupnění těchto funkcí je nutné, aby se uživatel zaregistroval a vytvořil si tak svůj osobní účet. Registrací a následným přihlášením získá uživatel přístup k druhému způsobu vytváření dokumentů. Po přihlášení je zobrazeno uživatelské menu. V menu je možné pak využít možnost pro ukládání dokumentů, správce souborů a mnoho dalších možností. Z toho důvodu, že vytvářené dokumenty lze ukládat pouze v přihlášeném režimu uživatele, bude možné dokumenty verzovat také až po přihlášení uživatele. Z toho důvodu se práce týká pouze druhého způsobu vytváření dokumentů. TEXonWeb obecně funguje tak, že vytvořený zdrojový text se odešle na skript index.pl. Skript pak rozpozná kliknutí na tlačítko s typem výstupu a poskytne dokument ke stažení. V případě, že soubor obsahuje chybu ve zdrojovém textu, je hlášení o chybách zapsáno do logového souboru. Logový soubor je možné zobrazit přímo v prohlížeči. Projekt je založen na TEXLive 2011 z distribuce Linux CentOS 5.2. (Dokumentace systému TeXonWeb, 2006, online) Technologie, na kterých v současné době aplikace TEXonWeb běží, jsou Perl, Javascript, HTML a CSS. Perl je programovací jazyk, který se v současné době těší značné oblibě. Přestože vůči němu lze mít z teoretického hlediska vážné námitky, je to jazyk zajímavý a mimořádně praktický. (Satrapa, 2000) Programovací jazyk Perl je používán k vytváření skriptů pracujících na straně serveru. Patří sem například skripty pro správu souborů, generování HTML a jiné. Javascript je potom využit k vytváření klientské části aplikace. Pomocí Javascriptu je naprogramované celé uživatelské menu, které je zobrazeno po přihlášení uživatele. HTML a CSS jsou použity standardně jako ve většině webových aplikací. Významnou technologii, kterou TEXonWeb využívá, je AJAX. Technologie umožňuje zasílat HTTP požadavky na vybrané skripty a získávat odpovědi, aniž by se musela obnovovat celá stránka. AJAX je například využíván pro zasílání požadavků na skript generující seznam uložených souborů a složek v uživatelově osobním prostoru na serveru.

25 4 IMPLEMENTACE 25 4 Implementace 4.1 Návrh řešení Předtím, než přistoupím k popisu samotné implementace, bych chtěl popsat, jakým způsobem bude verzování dokumentů v aplikaci TEXonWeb fungovat. Především bude funkce verzování dokumentů dostupná pouze registrovaným uživatelům. V režimu, kdy uživatel není přihlášen do aplikace, není možné ukládat vytvořené dokumenty na server. Tudíž není ani možné nijak zachycovat případné změny v dokumentu. Při popisu funkčnosti verzování dokumentů bych chtěl věnovat pozornost způsobu, jakým je uživatel schopen vytvořit novou verzi. Pojem nová verze lze v případě verzování dokumentů v TEXonWeb rozdělit na dva typy: Počáteční verze označená číslem 1 Každá další verze označená číslem větším jak 1 Čísla označující verze budou hrát svoji roli v uživatelském rozhraní umožňující správu verzí. Uživatelské rozhraní bude podrobněji popsáno později v textu této kapitoly. Nicméně zpět ke způsobu vytváření nových verzí. Počáteční verzi dokumentu vytváří uživatel v případě, že dokument ještě nemá uložen na serveru. Dokument se na server uloží v okamžiku, kdy uživatel poprvé v nově otevřeném dokumentu stiskne tlačítko Uložit v kartě Soubor. Poté je vyzván pomocí ukládacího dialogu k tomu, aby pojmenoval svůj dokument a určil místo, kam chce dokument uložit. Po stisknutí tlačítka Uložit se dokument uloží v osobním prostoru uživatele na serveru. V okamžiku úspěšného uložení se vytvoří počáteční verze dokumentu. Počáteční verzi dokumentu lze vytvořit také nahráním vlastního souboru z pevného disku. Vlastní soubor by měl obsahovat zdrojový text. Soubor je možné nahrát pomocí Správce souborů. Do Správce souborů se uživatel dostane pomocí tlačítka Správce souborů v kartě Soubor. Po otevření dialogu uživatel musí zvolit tlačítko Procházet a poté si vybrat vlastní soubor na disku. Stisknutím tlačítka OK uživatel odešle soubor na server a tím vytvoří i počáteční verzi dokumentu. Každé další verze uživatel vytváří následným uložením dokumentu. Pokud uživatel použije tlačítko Uložit jako, potom se aplikace chová, jakoby se dokument na server ukládal poprvé, a tedy vytvoří u takto uloženého dokumentu počáteční verzi. Mezi vytvořenými verzemi je možné samozřejmě přepínat. Načtení jakékoliv z předchozích verzí je umožněno pomocí Správce verzí. Pokud se uživatel vrátí k nějaké z předchozích verzí a následně dokument uloží, vytvoří novou verzi. Potom, bez ohledu na to, zda uživatel v dokumentu provedl jakékoliv změny, se veškeré následující verze smažou a vytvoří se zcela nová verze dokumentu. Předcházející verze se zachovají. Pro lepší pochopení vysvětlím na příkladu. Uvažujme, že dokument bude evidovat pět verzí. V okně bude načtena nejnovější verze dokumentu, a sice pátá. Uživatel

26 26 4 IMPLEMENTACE se vrátí k verzi číslo tři a stiskne tlačítko Uložit. V takovém případě budou u dokumentu již evidovány pouze tři verze. V okně bude načtena třetí, tedy nejnovější verze. Na obrázku pět je zachycen způsob vytváření verzí při práci uživatele. Obrázek 5: UML stavový diagram znázorňující práci uživatele 4.2 Verzovací systém SVN Verzovací systém SVN je jedním z hlavních nosných pilířů, na kterém stojí řešení problematiky verzování dokumentů v aplikaci TEXonWeb. SVN se obvykle využívá k správě a verzování zdrojových kódů při vývoji software. SVN je zkratka pro název Subversion. Systém je vyvíjen softwarovou nadací Apache. Nadace vytvořila již mnoho známých Open Source projektů. Mezi nejznámější patří například Apache HTTP server. Vzhledem k tomu, že SVN je primárně používáno k verzování souborů obsahující zdrojové kódy, které jsou pouhým textem, je proto pro naše potřeby ideálním řešením. Soubory vytvářené uživatelem v aplikaci TEXonWeb, které jsou na serveru ukládány, jsou také pouze textové soubory. Z toho důvodu jsme schopni využít

27 4.2 Verzovací systém SVN 27 stejný postup, jakým programátoři využívají Subversion k verzování svých zdrojových kódů. I když psaní TEXových maker bezesporu je programování, zdá se, že mnoho autorů TEXových dokumentů, narozdíl od běžných programátorů, zatím neobjevilo sílu a užitečnost nástrojů pro správu verzí. Nezřídka se pak stává, že ani autoři sami nejsou po nějaké době schopni znovu vysázet své staré dokumenty, neboť již nemají potřebné verze svých makrobalíků. Stejně tak mají problémy orientovat se ve vlastním kódu nebo dohledat zdroj chyby, která se náhle objevila zdánlivě odnikud. (Růžička, 2003, online) Stejně tak jako u mnoha jiných projektů, je SVN využíváno i v případě verzování veškerých zdrojových kódů aplikace TEXonWeb. K mé výhodě tedy bylo SVN na serveru již nainstalováno. Nebylo tedy nutné se zamýšlet nad volbou alternativního verzovacího systému. Příkladem alternativního verzovacího systému může být Mercurial SCM 19 nebo Git 20. SVN funguje na principu synchronizace pracovní kopie uživatele a prostoru na serveru. Ten nazýváme repozitář. Pracovní kopie uživatele je stažený obsah repozitáře, aktualizovaný k určité revizi. Jednotlivé verze souborů, které repozitář obsahuje, se nazývají revize. V případě verzovacích systémů nemluvíme tedy o jednotlivých verzích souborů, ale o revizích. Synchronizací pracovní kopie a repozitáře myslíme, že uživatel vždy buď aktualizuje svoji pracovní kopii k určité verzi uložené na serveru, nebo odešle obsah pracovní kopie do repozitáře k vytvoření nové verze (viz obr. 6). Stažení obsahu repozitáře, vytvoření nové revize a mnoho další úkonů se provádí pomocí příkazů spouštěných z příkazové řádky. Příkazy, kterými lze SVN ovládat a byly v práci použity, si popíšeme blíže v následující kapitole. Obrázek 6: Schéma práce klientů s repozitářem (SVN Tutoriál, 2010, online) 19 Dostupné z 20 Dostupné z

28 28 4 IMPLEMENTACE Použité příkazy V podstatě existují dva způsoby jak ovládat SVN. Prvním z nich je použití SVN klienta, který implementuje grafické uživatelské rozhraní. Druhým způsobem je pak spouštění příkazů pomocí příkazové řádky. V této bakalářské práci se budu zabývat pouze druhou možností. Pro zajímavost zmíním, že často používaným klientem implementující grafické uživatelské rozhraní je TortoiseSVN 21. Používané příkazy se skládají z dvou částí, a sice z prvního příkazu svn, kterým uživatel dává na vědomí, že chce pracovat s SVN, a druhé části určující, co se v SVN má přesně stát. Pro zjištění všech použitelných příkazů je možné použít přepínač --help pro nápovědu. Příkaz je možné využít v následujícím tvaru svn --help. Přepínač pro nápovědu je možné využít i pro zjištění podrobnějších informací o dílčích příkazech příkazu svn. Příkladem může být svn commit --help. Takto spuštěný příkaz vypíše do terminálu popis funkčnosti příkazu a také všechny možné přepínače, které lze u příkazu použít. Nechybí samozřejmě příklad použití. Obecně lze říci, že příkazy pro ovládání SVN mají následující tvar. svn <příkaz> <přepínače> <parametry> V rámci mé bakalářské práce jsem použil celkově osm příkazů pro ovládání SVN. Přesně to potom byly příkazy: 1. svn add 2. svn commit 3. svn update 4. svn move 5. svn copy 6. svn delete 7. svn info 8. svn log První z vyjmenovaných příkazů slouží k začlenění souboru do verzovacího systému. Je to tedy první příkaz, který je nutné zadat předtím, než se souborem v SVN bude provedena jakákoliv akce. V rámci verzování dokumentů je příkaz volán pokud, uživatel poprvé uloží soubor, nahraje soubor ze svého disku nebo vytvoří adresář. Parametrem příkazu je potom cesta ke zvolenému adresáři či souboru. Druhý z použitých příkazů je využíván k potvrzení změn v pracovní kopii a jejich odeslání do repozitáře. Pomocí příkazu svn commit se vytvářejí nové verze souborů. V našem případě tedy vytváříme nové verze dokumentů. Je tedy volán vždy, když 21 Dostupné z

29 4.2 Verzovací systém SVN 29 uživatel stiskne tlačítko Uložit. Příkaz bychom mohli označit jako potvrzovací. Při volání potvrzovacího příkazu používáme přepínač -m "zpráva". V uvozovkách pak píšeme zprávu, která se uloží do logu. V našem případě se zprávy generují automaticky. Do zpráv je pak ukládána informace o velikosti souboru. Příkaz svn commit je nutné použít i pro potvrzení naplánovaných změn v repozitáři. Voláme ho vždy po příkazech, které manipulují s obsahem repozitáře. Ve výše uvedeném seznamu můžeme za manipulační příkazy označit 1., 4., 5. a 6. příkaz. V některých případech manipulačních příkazů není potřeba volat svn commit. Je možné totiž použít přepínače --force. Přepínač umožní provést změny v repozitáři přímo, aniž by se musel volat potvrzovací příkaz. Pracovat se zmíněným přepínačem je nebezpečné. Uživatel může lehce poškodit obsah repozitáře. Velkou nevýhodou použití přepínače je, že není zachována žádná zpráva v logu SVN. Je tedy velice těžko dohledatelné, mezi kterými revizemi byl příkaz spuštěn. Následující příkaz v seznamu umožňuje aktualizovat obsah pracovní kopie k nejnovější revizi v repozitaři. Je také možné přecházet k vybraným revizím. Pro přechod k vybrané revizi je nutné použít přepínač -rx, kde X je číslo potřebné revize. Parametrem příkazu může být cesta k adresáři nebo cesta ke specifickému souboru. V případě, že je zadána cesta k adresáři a není tedy vybrán určitý soubor, je provedena aktualizace všech souborů, které jsou umístěny ve specifikovaném adresáři. U verzování dokumentů v TEXonWeb používáme téměř vždy parametr, který specifikuje potřebný soubor. Je tomu tak, protože vždy když uživatel edituje svůj dokument, tak pracuje pouze s jedním souborem na serveru. Variantu parametru, kdy obsahuje cestu k adresáři, používá TEXonWeb pouze v případě smazání dokumentu. Po smazání dokumentu je nutné aktualizovat obsah pracovní kopie a tedy není možné volat příkaz nad souborem, který již neexistuje. Příkaz svn update je volán vždy, když je provedena nějáká změna v SVN. Je to z důvodu, aby uživatel měl vždy aktuální obsah své pracovní kopie. Následující tři příkazy provádí změny jak v pracovní kopii uživatele, tak v repozitáři uloženém na serveru. Jak již bylo avizováno, změny v repozitáři jsou provedeny jakmile je zavolán příkaz svn commit. Čtvrtý příkaz umožňuje přesouvání nebo přejmenování souborů a adresářů v repozitáři. Příkaz je volán se dvěma parametry. Může být volán i s více parametry, ale v rámci verzování v TEXonWeb je použita pouze varianta se dvěma parametry. Každý z parametrů obsahuje cestu k souboru nebo adresáři. Na základě toho, jakým způsobem jsou cesty v parametrech příkazu definovány, se určí, zda bude provedeno přejmenování, přesunutí nebo obojí. Z důvodu, že Správce souborů v TEXonWeb umožňuje pouze přesouvání nebo přejmenování souborů v rámci jednoho uživatelského úkonu, je evidentní, že nebude možné provést najednou přejmenování i přesunutí. Jestliže je prováděno přejmenování souboru nebo adresáře v SVN, potom první parametr obsahuje cestu k souboru se starým jménem. V druhém parametru je pak stejná cesta s rozdílem, že na konci obsahuje nové jméno souboru nebo adresáře. Pokud uživatel zvolí možnost přesunutí souboru, potom se cesta v prvním parametru liší od cesty definované v druhém parametru. Jediné v čem se parametry shodují je,

30 30 4 IMPLEMENTACE že jméno souboru na konci cest zůstává stejné. Adresáře nelze v TEXonWeb přesouvat. V SVN akce přesunutí probíhá následujícím způsobem. V První řadě se začlení nový soubor s novým jménem nebo novou cestou do SVN. Starý soubor, který v SVN již existuje, je poté odstraněn. Do nového souboru se přesouvají i všechny informace týkající předchozích revizí. Pátým příkazem je možné kopírovat soubory v repozitáři. Příkaz svn copy funguje obdobně jako předchozí příkaz. Rozdíl je v používání stejného jména souboru v obou parametrech. První parametr obsahuje cestu, odkud se bude kopírovat, druhý potom cestu, kam se bude kopírovat. V SVN pak proces kopírování souborů probíhá zcela identicky jako v případě příkazu svn move. Pokud uživatel chce kopírovat soubor do stejného adresáře, kde se původní soubor nachází, potom je zobrazen dialog, kde je dotázán, zda chce přepsat stávající soubor jeho kopii. Pokud akci potvrdí, je tedy takto provedeno. Druhou možností se kopírování zruší a původní soubor zůstane zachován. Samozřejmě je možné příkaz pro kopírování použít i s více jak dvěma parametry, ale opět tento příkaz používáme v rámci TEXonWeb pouze zmíněným způsobem. Také je možné použít možnost kopírovaní s přejmenováním souboru, avšak tu Správce souborů v současné době neumožňuje. Nebylo tedy nutné ji implementovat. Šestý z příkazů umožňuje mazání souborů z repozitáře. Používá pouze jeden parametr. Parametrem je cesta k mazanému souboru. Mazat lze buď soubory nebo prázdné složky. Neprázdné složky nelze smazat. Příkaz svn delete obecně umožňuje mazat neprázdné složky, ale v rámci TEXonWeb je ve Správci souborů nemožné mazat neprázdné složky, proto nebylo ani možné příkaz takto použít. Sedmý z příkazů vypisuje užitečné informace o verzovaném souboru do terminálu. Mezi tyto infomace patří například číslo revize, ve které se soubor nachází, číslo revize, ve které byla provedena poslední změna, datum provedení poslední změny, typ souboru nebo také uživatelské jméno uživatele, který provedl poslední změnu v souboru. V aplikaci TEXonWeb je využívána pouze informace o čísle revize ve, které byla provedena poslední změna. Příkaz svn info je spouštěn v okamžiku, kdy uživatel spustí Správce verzí. Pomocí něj se zjišťuje číslo revize, ke které se má přejít v případě, že uživatel pouze zavře dialog a nevybere žádnou z verzí. Parametrem příkazu je opět cesta k verzovanému souboru. Posledním příkazem je možné vypsat všechny zprávy, které se uložily do logu při spuštění příkazu svn commit. Mimo zprávy, které uživatel do logu zaslal prostřednictvím potvrzovacího příkazu, je uživatel schopen zjistit i jiné informace. Mezi další informace můžeme zařadit číslo revize, ke které se provedený potvrzovací příkaz vázal, název uživatele, který potvrzovací příkaz spustil, datum vytvoření revize, počet řádků, které zpráva zabírá (viz obr. 7). Příkaz svn log je v případě verzování dokumentů v TEXonWeb velice klíčový. Příkaz je spouštěn vždy, když uživatel otevře dialog Správce verzí. Pomocí něj jsou zjištěny všechny zmíněné důležité informace. S těmito informacemi je pak možné vytvořit tabulku, která se v dialogu zobrazí. Příkaz svn log je možné spouštět bez parametru, avšak takový způsob není v našem případě možný. Příkaz bez parametru by vypsal informace o všech