> For the complete documentation index, see [llms.txt](https://overleaf-pro.ayaka.space/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://overleaf-pro.ayaka.space/latex/cs/clanky-do-hloubky/27-how-to-use-latexdiff-on-overleaf.md). # Jak používat latexdiff na Overleafu Tento článek ukazuje dva způsoby, jak používat [latexdiff](https://ctan.org/pkg/latexdiff?lang=en) v Overleafu. ## Co je latexdiff? `latexdiff` je skript v Perlu určený k porovnání obsahu dvou souborů LaTeX. Generuje kód LaTeX, který vizuálně zobrazuje všechny významné rozdíly mezi těmito soubory. Pro porovnání `new.tex` s `old.tex` a výstup výsledků do souboru s názvem `diff.tex`, byste použili `latexdiff` takto: ``` latexdiff OPTIONS old.tex new.tex > diff.tex ``` `OPTIONS` jsou parametry příkazové řádky, které můžete použít ke konfiguraci `latexdiff`jeho chování — podívejte se do [`latexdiff` dokumentace](http://mirrors.ctan.org/support/latexdiff/doc/latexdiff-man.pdf) pro seznam dostupných možností. ## Jak použít latexdiff v Overleafu Nabízíme dvě řešení, obě publikovaná a diskutovaná na tex.stackexchage. První [první metoda](#david-carlisles-solution) byla [navržena Davidem Carislem](https://tex.stackexchange.com/a/603311), [druhé řešení](#tom-hejdas-solution) byla [navržené Tomem Hejdou](https://tex.stackexchange.com/a/603351), manažerem podpory Overleafu. ### Řešení Davida Carlislea Zdrojové soubory demonstrující toto řešení jsou uvedeny níže spolu s odkazy na jejich otevření jako projektu Overleaf. Viz [Jak funguje toto první řešení](#how-this-first-solution-works) pro krátké vysvětlení tohoto kódu. [Otevřete řešení Davida Carlislea v Overleafu.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name\[]=main.tex\&snip\[]=%5Cdocumentclass%7Barticle%7D%0A%5Ctitle%7BDavid+Carlisle%27s+solution%7D%0A%5Cauthor%7Bme%7D%0A%5Cdate%7BMay+2024%7D%0A%5Cbegin%7Bdocument%7D%0A%5Cmaketitle%0A%5Csection%7BIntroduction%7D%0Azzz%0A%5Cend%7Bdocument%7D\&snip_name\[]=main2.tex\&snip\[]=%5Cdocumentclass%7Barticle%7D%0A%5Ctitle%7Blatexdiff%7D%0A%5Cauthor%7Bme%5Cand+you%7D%0A%5Cdate%7BMay+2023%7D%0A%0A%5Cbegin%7Bdocument%7D%0A%0A%5Cmaketitle%0A%0A%5Csection%7BIntroduction%7D%0Azzz+zzz%0A%0A%5Csection%7BSection%7D%0Azzz%0A%5Cend%7Bdocument%7D\&snip_name\[]=latexmkrc\&snip\[]=%24pdflatex+%3D+%22latexdiff+main.tex+main2.tex+%3E+main-d.tex%3B+pdflatex+%25O++main-d%22\&main_document=main.tex) **main.tex** ```latex \documentclass{article} \title{Řešení Davida Carlislea} \author{já} \date{květen 2024} \begin{document} \maketitle \section{Úvod} zzz \end{document} ``` **main2.tex** ```latex \documentclass{article} \title{latexdiff} \author{já\and vy} \date{květen 2023} \begin{document} \maketitle \section{Úvod} zzz zzz \section{Sekce} zzz \end{document} ``` **latexmkrc** ```latex $pdflatex = "latexdiff main.tex main2.tex > main-d.tex; pdflatex %O main-d" ``` [Otevřete řešení Davida Carlislea v Overleafu.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name\[]=main.tex\&snip\[]=%5Cdocumentclass%7Barticle%7D%0A%5Ctitle%7BDavid+Carlisle%27s+solution%7D%0A%5Cauthor%7Bme%7D%0A%5Cdate%7BMay+2024%7D%0A%5Cbegin%7Bdocument%7D%0A%5Cmaketitle%0A%5Csection%7BIntroduction%7D%0Azzz%0A%5Cend%7Bdocument%7D\&snip_name\[]=main2.tex\&snip\[]=%5Cdocumentclass%7Barticle%7D%0A%5Ctitle%7Blatexdiff%7D%0A%5Cauthor%7Bme%5Cand+you%7D%0A%5Cdate%7BMay+2023%7D%0A%0A%5Cbegin%7Bdocument%7D%0A%0A%5Cmaketitle%0A%0A%5Csection%7BIntroduction%7D%0Azzz+zzz%0A%0A%5Csection%7BSection%7D%0Azzz%0A%5Cend%7Bdocument%7D\&snip_name\[]=latexmkrc\&snip\[]=%24pdflatex+%3D+%22latexdiff+main.tex+main2.tex+%3E+main-d.tex%3B+pdflatex+%25O++main-d%22\&main_document=main.tex) Tento příklad vytvoří následující výstup: ![Obrázek zobrazující výstup vytvořený nástrojem latexdiff](/files/7416412c9e51aa7176cf4e76e1e6b33f8972a545) #### Jak funguje toto první řešení Toto řešení porovnává soubory `main.tex` a `main2.tex` a zapisuje výsledky do souboru s názvem `main-d.tex`. Všimněte si, že protože `main-d.tex` soubor je *generovaný* soubor, tj. vytvořený naším kódem, nebude viditelný (uvedený) mezi soubory projektu. Funguje to tak, že využívá soubor s názvem `latexmkrc` který obsahuje kód v Perlu pro přizpůsobení procesu kompilace Overleafu. Zde je příkaz pro kompilaci pomocí pdfLaTeXu předefinován tak, aby se nejprve spustil `latexdiff` a poté se spustil pdfLaTeX pro kompilaci `main-d.tex`, soubor vygenerovaný `latexdiff`. Jak [uvádí autor řešení](https://tex.stackexchange.com/a/603311), aby se přestalo spouštět `latexdiff` a vysázel se skutečný obsah `main.tex` nebo `main2.tex`, stačí přidat `#`, znak komentáře v Perlu, do `latexmkrc` příkazového řádku, takže to vypadá takto: ``` # $pdflatex = "latexdiff main.tex main2.tex > main-d.tex; pdflatex %O main-d" ``` Nyní můžete kompilovat `main.tex` nebo `main2.tex` a vysázet jejich skutečný obsah, nikoli rozdíly mezi nimi. Další informace najdete v článku Overleafu [Jak používat `latexmkrc` s Overleafem](/latex/cs/clanky-do-hloubky/28-how-to-use-latexmkrc-with-overleaf.md). ### Řešení Tomáše Hejdy Zdrojové soubory demonstrující toto řešení jsou uvedeny níže spolu s odkazy na jejich otevření jako projektu Overleaf. Viz [Jak funguje toto druhé řešení](#how-this-second-solution-works) pro krátké vysvětlení tohoto kódu. [Otevřete řešení Tomáše Hejdy v Overleafu.](https://www.overleaf.com/docs?engine=\&snip_name\[]=diff.tex\&snip\[]=%5CRequirePackage%7Bshellesc%7D%0A%5CShellEscape%7Blatexdiff+main.tex+main2.tex+%3E+main-d.tex%7D%0A%5Cinput%7Bmain-d%7D%0A%5Cdocumentclass%7Bdummy%7D%0A%5Ctitle%7BDemonstrating+latexdiff%7D\&snip_name\[]=main.tex\&snip\[]=%5Cdocumentclass%7Barticle%7D%0A%5Ctitle%7BTom+Hejda%27s+solution%7D%0A%5Cauthor%7Bme%7D%0A%5Cdate%7BMay+2024%7D%0A%5Cbegin%7Bdocument%7D%0A%5Cmaketitle%0A%5Csection%7BIntroduction%7D%0Azzz%0A%5Cend%7Bdocument%7D\&snip_name\[]=main2.tex\&snip\[]=%5Cdocumentclass%7Barticle%7D%0A%5Ctitle%7Blatexdiff%7D%0A%5Cauthor%7Bme%5Cand+you%7D%0A%5Cdate%7BMay+2023%7D%0A%0A%5Cbegin%7Bdocument%7D%0A%0A%5Cmaketitle%0A%0A%5Csection%7BIntroduction%7D%0Azzz+zzz%0A%0A%5Csection%7BSection%7D%0Azzz%0A%5Cend%7Bdocument%7D\&main_document=diff.tex) **diff.tex** ```latex \RequirePackage{shellesc} \ShellEscape{latexdiff main.tex main2.tex > main-d.tex} \input{main-d} \documentclass{dummy} \title{Ukázka latexdiff} ``` **main.tex** ```latex \documentclass{article} \title{Řešení Tomáše Hejdy} \author{já} \date{květen 2024} \begin{document} \maketitle \section{Úvod} zzz \end{document} ``` **main2.tex** ```latex \documentclass{article} \title{latexdiff} \author{já\and vy} \date{květen 2023} \begin{document} \maketitle \section{Úvod} zzz zzz \section{Sekce} zzz \end{document} ``` [Otevřete řešení Tomáše Hejdy v Overleafu.](https://www.overleaf.com/docs?engine=\&snip_name\[]=diff.tex\&snip\[]=%5CRequirePackage%7Bshellesc%7D%0A%5CShellEscape%7Blatexdiff+main.tex+main2.tex+%3E+main-d.tex%7D%0A%5Cinput%7Bmain-d%7D%0A%5Cdocumentclass%7Bdummy%7D%0A%5Ctitle%7BDemonstrating+latexdiff%7D\&snip_name\[]=main.tex\&snip\[]=%5Cdocumentclass%7Barticle%7D%0A%5Ctitle%7BTom+Hejda%27s+solution%7D%0A%5Cauthor%7Bme%7D%0A%5Cdate%7BMay+2024%7D%0A%5Cbegin%7Bdocument%7D%0A%5Cmaketitle%0A%5Csection%7BIntroduction%7D%0Azzz%0A%5Cend%7Bdocument%7D\&snip_name\[]=main2.tex\&snip\[]=%5Cdocumentclass%7Barticle%7D%0A%5Ctitle%7Blatexdiff%7D%0A%5Cauthor%7Bme%5Cand+you%7D%0A%5Cdate%7BMay+2023%7D%0A%0A%5Cbegin%7Bdocument%7D%0A%0A%5Cmaketitle%0A%0A%5Csection%7BIntroduction%7D%0Azzz+zzz%0A%0A%5Csection%7BSection%7D%0Azzz%0A%5Cend%7Bdocument%7D\&main_document=diff.tex) Tento příklad vytvoří následující výstup: ![Obrázek zobrazující výstup vytvořený nástrojem latexdiff](/files/17c6eb1b0b8dcaac0f7bf888fbeef335ccfc6e97) #### Jak funguje toto druhé řešení Toto řešení porovnává soubory `main.tex` a `main2.tex` a zapisuje výsledky do souboru s názvem `main-d.tex`. Všimněte si, že protože `main-d.tex` soubor je *generovaný* soubor, tj. vytvořený naším kódem, nebude viditelný (uvedený) mezi soubory projektu. Soubor s názvem `diff.tex` používá `\ShellEscape` příkaz, poskytovaný balíčkem [`shellesc` accents](https://ctan.org/pkg/shellesc?lang=en), k provedení `latexdiff`. Výsledky porovnání, obsažené v `main-d.tex`, jsou `\input` do `diff.tex` pro sazbu. `diff.tex` obsahuje řádek `\documentclass{dummy}` který má přimět kompilátor Overleafu, aby věřil `diff.tex` lze kompilovat. To funguje, protože proces kompilace Overleafu kontroluje aktuálně otevřený soubor na přítomnost `\documentclass`. Pokud ho nenajde, Overleaf zkompiluje soubor uvedený v nabídce jako **Hlavní** souboru. Pokud vyberete **Překompilovat** s `diff.tex` otevřít v editoru, vysází výsledky porovnání. Můžete vybrat a kompilovat `main.tex` nebo `main2.tex` protože oba obsahují `\documentclass` příkaz. Další informace o `latexdiff` podívejte se na [oficiální dokumentaci](http://mirrors.ctan.org/support/latexdiff/doc/latexdiff-man.pdf). --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://overleaf-pro.ayaka.space/latex/cs/clanky-do-hloubky/27-how-to-use-latexdiff-on-overleaf.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.