# Czech translation of gtk-doc. # Copyright (C) 2009 gtk-doc's COPYRIGHT HOLDER # This file is distributed under the same license as the gtk-doc package. # Marek Černocký , 2009, 2015, 2016, 2017, 2018, 2020. # msgid "" msgstr "" "Project-Id-Version: gtk-doc master\n" "POT-Creation-Date: 2020-10-01 20:17+0000\n" "PO-Revision-Date: 2020-10-05 20:45+0200\n" "Last-Translator: Marek Černocký \n" "Language-Team: čeština \n" "Language: cs\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" "Plural-Forms: nplurals=3; plural=(n==1) ? 0 : (n>=2 && n<=4) ? 1 : 2;\n" "X-Generator: Gtranslator 2.91.7\n" #. Put one translator per line, in the form NAME , YEAR1, YEAR2 msgctxt "_" msgid "translator-credits" msgstr "Marek Černocký " #. (itstool) path: bookinfo/title #: C/index.docbook:12 msgid "GTK-Doc Manual" msgstr "Příručka ke GTK-Doc" #. (itstool) path: bookinfo/edition #: C/index.docbook:13 msgid "1.24.1" msgstr "1.24.1" #. (itstool) path: abstract/para #: C/index.docbook:14 msgid "User manual for developers with instructions of GTK-Doc usage." msgstr "Uživatelská příručka pro vývojáře s instrukcemi k používání GTK-Doc." #. (itstool) path: authorgroup/author #: C/index.docbook:16 msgid "" "Chris Lyttle " "
chris@wilddev.net
" msgstr "" "Chris Lyttle " "
chris@wilddev.net
" #. (itstool) path: authorgroup/author #: C/index.docbook:25 msgid "" "Dan Mueth
" "d-mueth@uchicago.edu
" msgstr "" "Dan Mueth " "
d-mueth@uchicago.edu
" #. (itstool) path: authorgroup/author #: C/index.docbook:34 msgid "" "Stefan Sauer (Kost) " "
ensonic@users.sf.net
" msgstr "" "Stefan Sauer (Kost) " "
ensonic@users.sf.net
" #. (itstool) path: publisher/publishername #: C/index.docbook:45 msgid "GTK-Doc project" msgstr "Projekt GTK-Doc" #. (itstool) path: bookinfo/publisher #: C/index.docbook:44 msgid "" "<_:publishername-1/>
gtk-doc-list@gnome.org
" msgstr "" "<_:publishername-1/>
gtk-doc-list@gnome.org
" #. (itstool) path: bookinfo/copyright #: C/index.docbook:48 msgid "2000, 2005 Dan Mueth and Chris Lyttle" msgstr "2000, 2005 Dan Mueth and Chris Lyttle" #. (itstool) path: bookinfo/copyright #: C/index.docbook:52 msgid "2007-2019 Stefan Sauer (Kost)" msgstr "2007-2019 Stefan Sauer (Kost)" #. (itstool) path: legalnotice/para #: C/index.docbook:65 msgid "" "Permission is granted to copy, distribute and/or modify this document under " "the terms of the GNU Free Documentation License, " "Version 1.1 or any later version published by the Free Software Foundation " "with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A " "copy of the license is included." msgstr "" "Je povoleno kopírovat, šířit a/nebo upravovat tento dokument za podmínek " "GNU Free Documentation License ve verzi 1.1 nebo v " "jakékoli další verzi vydané nadací Free Software Foundation, s neměnnými " "oddíly, bez textů předních desek a bez textů zadních desek. Kopie licence je " "součástí." #. (itstool) path: legalnotice/para #: C/index.docbook:73 msgid "" "Many of the names used by companies to distinguish their products and " "services are claimed as trademarks. Where those names appear in any GNOME " "documentation, and those trademarks are made aware to the members of the " "GNOME Documentation Project, the names have been printed in caps or initial " "caps." msgstr "" "Mnoho názvů použitých firmami k zviditelnění produktů nebo služeb jsou " "ochranné známky. Na místech, kde jsou tyto názvy v dokumentaci použity a " "členové Dokumentačního projektu GNOME jsou si vědomi skutečnosti, že se " "jedná o ochrannou známku, je takovýto název psán velkými písmeny celý nebo s " "velkým písmenem na začátku." #. (itstool) path: revhistory/revision #: C/index.docbook:83 msgid "" "1.33.0 1 Oct 2020 mc gtk4 version" msgstr "" "1.33.0 1. října 2020 " "mc verze gtk4" #. (itstool) path: revhistory/revision #: C/index.docbook:89 msgid "" "1.32.1 15 Aug 2019 ss dev version" msgstr "" "1.32.1 15. srpna 2019 " "ss vývojová verze" #. (itstool) path: revhistory/revision #: C/index.docbook:95 msgid "" "1.32 15 Aug 2019 ss hotfix release" msgstr "" "1.32 15. srpna 2019 ss opravné vydání" #. (itstool) path: revhistory/revision #: C/index.docbook:101 msgid "" "1.31 05 Aug 2019 ss refactorings and more test coverage" msgstr "" "1.31 5. srpna 2019 ss přepracování a větší pokrytí testy" #. (itstool) path: revhistory/revision #: C/index.docbook:107 msgid "" "1.30 08 May 2019 ss more test coverage" msgstr "" "1.30 8. května 2019 ss větší pokrytí testy" #. (itstool) path: revhistory/revision #: C/index.docbook:113 msgid "" "1.29 28 Aug 2018 ss bug fixes" msgstr "" "1.29 28. srpna 2018 ss opravy chyb" #. (itstool) path: revhistory/revision #: C/index.docbook:119 msgid "" "1.28 24 Mar 2018 ss bug fixes" msgstr "" "1.28 24. března 2018 ss opravy chyb" #. (itstool) path: revhistory/revision #: C/index.docbook:125 msgid "" "1.27 07 Dec 2017 ss fine tuning of the python port" msgstr "" "1.27 7. prosince 2017 " "ss detailní vyladění portu v " "jazyce Python" #. (itstool) path: revhistory/revision #: C/index.docbook:131 msgid "" "1.26 11 Aug 2017 ss port all tools from perl/bash to python" msgstr "" "1.26 11. srpen 2017 ss přenesení všech nástrojů z jazyků Perl/Bash do " "jazyka Python" #. (itstool) path: revhistory/revision #: C/index.docbook:137 msgid "" "1.25 21 March 2016 ss bug fixes, test cleanups" msgstr "" "1.25 21. březen 2016 ss opravy chyb, pročištění testů" #. (itstool) path: revhistory/revision #: C/index.docbook:143 msgid "" "1.24 29 May 2015 ss bug fix" msgstr "" "1.24 29. května 2015 ss oprava chyby" #. (itstool) path: revhistory/revision #: C/index.docbook:149 msgid "" "1.23 17 May 2015 ss bug fix" msgstr "" "1.23 17. květen 2015 ss oprava chyby" #. (itstool) path: revhistory/revision #: C/index.docbook:155 msgid "" "1.22 07 May 2015 ss bug fixes, dropping deprecated features" msgstr "" "1.22 07. květen 2015 ss opravy chyb, odstranění zastaralých věcí" #. (itstool) path: revhistory/revision #: C/index.docbook:161 msgid "" "1.21 17 Jul 2014 ss bug fixes, dropping deprecated features" msgstr "" "1.21 17. červenec 2014 " "ss opravy chyb, odstranění " "zastaralých věcí" #. (itstool) path: revhistory/revision #: C/index.docbook:167 msgid "" "1.20 16 Feb 2014 ss bug fixes, markdown support, style improvements" msgstr "" "1.20 16. únor 2014 ss opravy chyb, podpora značkovacího jazyka, " "vylepšení stylů" #. (itstool) path: revhistory/revision #: C/index.docbook:173 msgid "" "1.19 05 Jun 2013 ss bug fixes" msgstr "" "1.19 05. červen 2013 ss opravy chyb" #. (itstool) path: revhistory/revision #: C/index.docbook:179 msgid "" "1.18 14 Sep 2011 ss bug fixes, speedups, markdown support" msgstr "" "1.18 14. září 2011 ss opravy chyb, zrychlení, podpora značkovacího " "jazyka" #. (itstool) path: revhistory/revision #: C/index.docbook:185 msgid "" "1.17 26 Feb 2011 sk urgent bug fix update" msgstr "" "1.17 26. únor 2011 sk aktualizace kvůli neodkladné opravě chyby" #. (itstool) path: revhistory/revision #: C/index.docbook:191 msgid "" "1.16 14 Jan 2011 sk bugfixes, layout improvements" msgstr "" "1.16 14. leden 2011 sk opravy chyb, vylepšení vzhledu" #. (itstool) path: revhistory/revision #: C/index.docbook:197 msgid "" "1.15 21 May 2010 sk bug and regression fixes" msgstr "" "1.15 21. květen 2010 sk opravy chyb a regresí" #. (itstool) path: revhistory/revision #: C/index.docbook:203 msgid "" "1.14 28 March 2010 sk bugfixes and performance improvements" msgstr "" "1.14 28. březen 2010 sk opravy chyb a vylepšení výkonu" #. (itstool) path: revhistory/revision #: C/index.docbook:209 msgid "" "1.13 18 December 2009 " "sk broken tarball update" msgstr "" "1.13 18. prosinec 2009 " "sk aktualizace poškozeného " "balíčku" #. (itstool) path: revhistory/revision #: C/index.docbook:215 msgid "" "1.12 18 December 2009 " "sk new tool features and " "bugfixes" msgstr "" "1.12 18. prosinec 2009 " "sk nové funkce nástroje a opravy " "chyb" #. (itstool) path: revhistory/revision #: C/index.docbook:221 msgid "" "1.11 16 November 2008 " "mal GNOME doc-utils migration" msgstr "" "1.11 16. listopad 2008 " "mal přechod na doc-utils z " "GNOME" #. (itstool) path: chapter/title #: C/index.docbook:234 msgid "Introduction" msgstr "Úvod" #. (itstool) path: chapter/para #: C/index.docbook:236 msgid "" "This chapter introduces GTK-Doc and gives an overview of what it is and how " "it is used." msgstr "" "Tato kapitola je úvodem do GTK-Doc a podává přehled o tom, co to je a jak to " "použít." #. (itstool) path: sect1/title #: C/index.docbook:242 msgid "What is GTK-Doc?" msgstr "Co je to GTK-Doc?" #. (itstool) path: sect1/para #: C/index.docbook:244 msgid "" "GTK-Doc is used to document C code. It is typically used to document the " "public API of libraries, such as the GTK+ and GNOME libraries. But it can " "also be used to document application code." msgstr "" "GTK-Doc se používá k dokumentaci kódu jazyka C. Typické použití je pro " "dokumentaci veřejného API knihoven, jako jsou knihovny GTK+ a GNOME. Lze jej " "ale použít i k dokumentaci aplikačního kódu." #. (itstool) path: sect1/title #: C/index.docbook:252 msgid "How Does GTK-Doc Work?" msgstr "Jak GTK-Doc pracuje?" #. (itstool) path: sect1/para #: C/index.docbook:254 msgid "" "GTK-Doc works by using documentation of functions placed inside the source " "files in specially-formatted comment blocks, or documentation added to the " "template files which GTK-Doc uses (though note that GTK-Doc will only " "document functions that are declared in header files; it won't produce " "output for static functions)." msgstr "" "GTK-Doc pracuje na základě dokumentace funkcí umístěné přímo v souborech se " "zdrojovým kódem ve speciálně formátovaných komentářových blocích, nebo " "dokumentace přidané do souborů šablon, které GTK-Doc používá (ačkoliv je " "nutno poznamenat, že GTK-Doc dokumentuje pouze funkce, které jsou " "deklarované v hlavičkových souborech; pro statické funkce žádný výstup " "nevytváří)." #. (itstool) path: sect1/para #: C/index.docbook:261 msgid "" "GTK-Doc consists of a number of python scripts, each performing a different " "step in the process." msgstr "" "GTK-Doc sestává z řady skriptů v jazyce Python, z nichž každý provádí jinou " "část procesu." #. (itstool) path: sect1/para #: C/index.docbook:266 msgid "There are 5 main steps in the process:" msgstr "Celý proces se skládá z pěti hlavních kroků:" #. (itstool) path: listitem/para #: C/index.docbook:273 msgid "" "Writing the documentation. The author fills in the " "source files with the documentation for each function, macro, structs or " "unions, etc." msgstr "" "Psaní dokumentace. Autor doplní soubory se zdrojovým " "kódem s dokumentací pro každou funkci, makro, strukturu, výčet atd." #. (itstool) path: listitem/para #: C/index.docbook:282 msgid "" "Gathering information about the code. " "gtkdoc-scan scans the header files of the code " "looking for declarations of functions, macros, enums, structs, and unions. " "It creates the file <module>-decl-list.txt " "containing a list of the declarations, placing them into sections according " "to which header file they are in. On the first run this file is copied to " "<module>-sections.txt. The author can rearrange " "the sections, and the order of the declarations within them, to produce the " "final desired order. The second file it generates is <" "module>-decl.txt. This file contains the full declarations " "found by the scanner. If for some reason one would like some symbols to show " "up in the docs, where the full declaration cannot be found by the scanner or " "the declaration should appear differently, one can place entities similar to " "the ones in <module>-decl.txt into <" "module>-overrides.txt." msgstr "" "Shromáždění informací o kódu. gtkdoc-scan projde hlavičkové soubory kódu a vyhledá při tom deklarace " "funkcí, maker, výčtů, struktur a sjednocení. Tím se vytvoří soubor " "<module>-decl-list.txt obsahující seznam " "deklarací, které jsou rozdělené do oddílů podle hlavičkového souboru, ze " "kterého pochází. Při prvním spuštění se tento soubor zkopíruje do " "<module>-sections.txt. Autor může změnit " "uspořádání oddílů a jejich pořadí v rámci deklarací tak, jak to požaduje ve " "výsledku. Druhý soubor, který se vytvoří, je <module>-decl." "txt. Tento soubor obsahuje úplné deklarace nalezené při " "procházení. Pokud byste z nějakého důvodu chtěli v dokumentaci zahrnout " "symbol, který při procházení nebyl nalezen, nebo jeho deklarace vypadá " "jinak, můžete jej umístit podobně jako v <module>-decl.txt do <module>-overrides.txt." #. (itstool) path: listitem/para #: C/index.docbook:299 msgid "" "gtkdoc-scangobj can also be used to dynamically " "query a library about any GObject subclasses it exports. It saves " "information about each object's position in the class hierarchy and about " "any GObject properties and signals it provides." msgstr "" "Dá se také použít gtkdoc-scanobj k dynamickým " "dotazům do knihoven na podtřídy objektu GObject, které exportují. Tím se " "uloží informace o pozici každého objektu v hierarchii tříd a o argumentech a " "signálech objektu GObject, které poskytují." #. (itstool) path: listitem/para #: C/index.docbook:305 msgid "" "gtkdoc-scanobj should not be used anymore. It was " "needed in the past when GObject was still GtkObject inside gtk+." msgstr "" "gtkdoc-scanobj by se ale již používat nemělo. " "Bylo zapotřebí v minulosti, kdy byl GObject ještě GtkObject v rámci gtk+." #. (itstool) path: listitem/para #: C/index.docbook:312 msgid "" "Generating the XML and HTML/PDF. gtkdoc-" "mkdb turns the template files into XML files in the xml/ subdirectory. If the source code " "contains documentation on functions, using the special comment blocks, it " "gets merged in here. If there are no tmpl files used it only reads docs from " "sources and introspection data." msgstr "" "Generování XML a HTML/PDF. gtkdoc-mkdb přemění soubory šablon na soubory XML v podsložce xml/. Pokud zdrojový kód obsahuje dokumentaci " "funkcí za použití speciálních komentářových bloků, tak zde se sloučí. V " "případě, že není použitý žádný soubor šablon, načte se dokumentace pouze ze " "zdrojového kódu a introspektivních dat." #. (itstool) path: listitem/para #: C/index.docbook:321 msgid "" "gtkdoc-mkhtml turns the XML files into HTML files " "in the html/ subdirectory. Likewise " "gtkdoc-mkpdf turns the XML files into a PDF " "document called <package>.pdf." msgstr "" "gtkdoc-mkhtml převádí soubory XML na soubory HTML " "v podsložce html/. Obdobně " "gtkdoc-mkpdf převádí soubory XML na dokument PDF " "nazvaný <balíček>.pdf." #. (itstool) path: listitem/para #: C/index.docbook:327 msgid "" "Files in xml/ and html/ directories are always overwritten. One " "should never edit them directly." msgstr "" "Soubory ve složkách xml/ a " "html/ jsou vždy přepsány. Nikdy by " "neměly být upravovány přímo." #. (itstool) path: listitem/para #: C/index.docbook:335 msgid "" "Fixing up cross-references between documents. After " "installing the HTML files, gtkdoc-fixxref can be " "run to fix up any cross-references between separate documents. For example, " "the GTK+ documentation contains many cross-references to types documented in " "the GLib manual. When creating the source tarball for distribution, " "gtkdoc-rebase turns all external links into web-" "links. When installing distributed (pregenerated) docs the same application " "will try to turn links back to local links (where those docs are installed)." msgstr "" "Opravy křížových odkazů mezi dokumenty. Po " "nainstalování souborů HTML můžete spustit gtkdoc-fixxref, aby se opravily křížové odkazy mezi samostanými dokumenty. " "Například dokumentace GTK+ obsahuje křížové odkazy na typy zdokumentované v " "příručce GLib. Když vytváříte zdrojový balíček pro distribuci, " "gtkdoc-rebase předělá všechny externí odkazy na " "webové odkazy. Když se distribuovaná (předgenerovaná) dokumentace instaluje, " "pokusí se tatáž aplikace předělat odkazy zpátky na místní odkazy (na " "dokumenty, které jsou nainstalované)." #. (itstool) path: sect1/title #: C/index.docbook:353 msgid "Getting GTK-Doc" msgstr "Jak získat GTK-Doc?" #. (itstool) path: sect2/title #: C/index.docbook:356 msgid "Requirements" msgstr "Požadavky" #. (itstool) path: sect2/para #: C/index.docbook:357 msgid "" "python 2/3 - the main scripts are written in python." msgstr "Python 2/3 – hlavní skripty jsou v jazyce Python." #. (itstool) path: sect2/para #: C/index.docbook:360 msgid "" "xsltproc - the xslt processor from libxslt xmlsoft.org/XSLT/" msgstr "" "xsltproc – procesor xslt z knihovny libxslt xmlsoft.org/XSLT/" #. (itstool) path: sect2/para #: C/index.docbook:364 msgid "" "docbook-xsl - the docbook xsl stylesheets sourceforge.net/projects/docbook/files/docbook-xsl" msgstr "" "docbook-xsl – stylopisy XSL pro docbook sourceforge.net/projects/docbook/files/docbook-xsl" #. (itstool) path: sect2/para #: C/index.docbook:368 msgid "" "One of source-highlight, highlight " "or vim - optional - used for syntax highlighting of " "examples" msgstr "" "Něco z source-highlight, highlight " "nebo vim – (volitelné) používá se pro zvýraznění " "syntaxe u příkladů" #. (itstool) path: sect1/title #: C/index.docbook:376 msgid "About GTK-Doc" msgstr "O aplikaci GTK-Doc" #. (itstool) path: sect1/para #: C/index.docbook:378 msgid "" "Historically GTK-Doc was used to generate template files from the sources " "code. These template files could be used by developers to enter the API " "documentation. This approach was rather inconvenient because it required to " "keep the generated files under version control. Since GTK-Doc 1.9 it became " "possible to place all API information into source comments, which made the " "template support obsolete. In version 1.26 template support has been removed." msgstr "" "Historicky se GTK-Doc používalo ke generování šablonových souborů ze " "zdrojových kódů. Tyto šablonové soubory pak mohli vývojáři používat ke " "vkládání dokumentace k API. Tento postup byl dosti nepohodlný, protože " "vyžadovat udržování vygenerovaných souborů ve správě verzí. Proto od verze " "1.9 přichází GTK-Doc s možností vkládat všechny informace o API do komentářů " "ve zdrojových kódech, čímž se podpora šablon stává nadbytečnou. Ve verzi " "1.26 byla podpora šablon odstraněna." #. (itstool) path: sect1/para #: C/index.docbook:388 C/index.docbook:402 msgid "(FIXME)" msgstr "(DOPLNIT)" #. (itstool) path: sect1/para #: C/index.docbook:392 msgid "" "(authors, web pages, mailing list, license, future plans, comparison with " "other similar systems.)" msgstr "" "(autoři, webové stránky, poštovní konference, licence, plány do budoucna, " "srovnání s ostatními podobnými systémy.)" #. (itstool) path: sect1/title #: C/index.docbook:400 msgid "About this Manual" msgstr "O této příručce" #. (itstool) path: sect1/para #: C/index.docbook:406 msgid "(who it is meant for, where you can get it, license)" msgstr "(k čemu je určená, kde ji můžete získat, licence)" #. (itstool) path: chapter/title #: C/index.docbook:415 msgid "Project Setup" msgstr "Nastavení projektu" #. (itstool) path: chapter/para #: C/index.docbook:417 msgid "" "This Chapter describes the steps that are necessary to integrate GTK-Doc " "into your project. The integration of GTK-Doc into a project includes the " "following steps:" msgstr "" "Tato kapitola popisuje kroky, které jsou nutné pro integraci GTK-Doc do " "vašeho projektu. Integrace GTK-Doc do projektu zahrnuje následující kroky:" #. (itstool) path: listitem/para #: C/index.docbook:425 msgid "" "Preparation of the directory structure and creating required configuration " "files for your GTK-Doc documentation (see Setting up a skeleton documentation)." msgstr "" "Přípravu struktury složek a vytvoření požadovaných konfiguračních souborů " "pro dokumentaci GTK-Doc (viz Nastavení " "kostry dokumentace)." #. (itstool) path: listitem/para #: C/index.docbook:433 msgid "" "Adjusting the build system to build your documentation using the GTK-Doc " "tools. Multiple build systems are supported, in this manual we describe how " "to integrate GTK-Doc with Autotools, CMake, and plain Makefiles." msgstr "" "Přizpůsobení sestavovacího systému, aby sestavoval vaši dokumentaci pomocí " "nástrojů GTK-Doc. Je podporováno více sestavovacích systémů, v této příručce " "je popsáno, jak integrovat GTK-Doc s Autotools, CMake a prostými soubory Makefiles." #. (itstool) path: listitem/para #: C/index.docbook:443 msgid "" "Adding GTK-Doc specific files to version control and deciding which files to " "ignore (see Integration with version " "control systems)." msgstr "" "Přidání souborů specifických pro GTK-Doc do správy verzí a rozhodnutí, které " "soubory se mají ignorovat (viz Integrace se " "systémem správy verzí)." #. (itstool) path: chapter/para #: C/index.docbook:451 msgid "" "The following sections assume we work on a project called meep. " "This project contains two packages (or modules), a library called " "libmeep and an end-user app called meeper." msgstr "" "Následující oddíly předpokládají, že pracujeme na projektu nazvaném " "meep. Tento projekt obsahuje dva balíčky (nebo moduly), " "knihovnu nazvanou libmeep a uživatelskou aplikaci nazvanou " "meeper." #. (itstool) path: sect1/title #: C/index.docbook:460 msgid "Setting up a skeleton documentation" msgstr "Nastavení kostry dokumentace" #. (itstool) path: sect1/para #: C/index.docbook:462 msgid "" "A common convention is to place documentation into a folder called " "docs inside your top-level project directory. We usually " "distinguish between reference documentation intended " "for developers and an user manual intended for end-" "users. Again the convention is to have separate folders for both. We usually " "place the reference documentation in a folder named reference " "and the end-user manual in a folder named help as. According to " "the above convention the documentation for our libmeep package " "would be placed into: docs/reference/libmeep. For packages with " "just one library or application the documentation could also be placed " "directly into docs/reference. It is not mandatory to use the " "above convention, but if you choose to use a different directory structure " "you must adjust your build system configuration to match your directory " "structure." msgstr "" "Zaběhnutým zvykem je umístit dokumentaci do složky nazvané docs " "ve složce nejvyšší úrovně projektu. Obvykle rozlišujeme mezi " "referenční dokumentací zaměřenou na vývojáře a " "uživatelskou příručkou zaměřenou na koncového " "uživatele. Opět je zvykem mít zvláštní složku pro každou z obou zmíněných. " "Obvykle umisťujeme referenční dokumentaci do složky nazvané reference a uživatelskou příručku do složky nazvané help. V souladu " "se zmíněnými zvyky by dokumentace pro naši knihovnu libmeep " "byla umístěna do docs/reference/libmeep. U balíčků s jedinou " "knihovnou nebo referenční dokumentací by bylo možné ji umístit přímo do " "docs/reference. Není povinné použít uvedenou konvenci, ale " "pokud se rozhodnete použít jinou strukturu složek, musíte upravit " "konfiguraci sestavovacího systému, aby se s ní shodoval." #. (itstool) path: example/title #: C/index.docbook:493 msgid "Example directory structure of meep project" msgstr "Příklad struktury složek projektu meep" #. (itstool) path: example/programlisting #: C/index.docbook:495 #, no-wrap msgid "" "\n" "meep/\n" " docs/\n" " reference/ # reference documentation\n" " libmeep/\n" " meeper/\n" " help/ # optional: user manual\n" " meeper/\n" " src/\n" " libmeep/\n" " meeper/\n" msgstr "" "\n" "meep/\n" " docs/\n" " reference/ # referenční dokumentace\n" " libmeep/\n" " meeper/\n" " help/ # volitelné: uživatelská příručka\n" " meeper/\n" " src/\n" " libmeep/\n" " meeper/\n" #. (itstool) path: sect1/para #: C/index.docbook:487 msgid "" "In the following sections we will assume a directory structure for our " "meep project that uses the above conventions. <_:" "example-1/>" msgstr "" "V následujících oddílech budeme uvažovat strukturu složek pro náš projekt " "meep, který používá výše uvedené konvence. <_:example-1/" ">" #. (itstool) path: sect1/title #: C/index.docbook:512 msgid "Integration with Autotools" msgstr "Integrace s Autotools" #. (itstool) path: sect1/para #: C/index.docbook:513 msgid "" "Integration of GTK-Doc into an autotools-based build system requires the " "following steps:" msgstr "" "Integrace GTK-Doc do sestavovacího systému založeného na Autotools vyžaduje " "následující kroky:" #. (itstool) path: listitem/para #: C/index.docbook:519 msgid "" "Ensure that gtkdocize is run once before the " "configure script. If an autogen.sh " "script is present, adjust it to check for GTK-Doc and add a call to " "gtkdocize." msgstr "" "Zajistit, že gtkdocize se spustí právě jednou " "před skriptem configure. Pokud je přítomen skript " "autogen.sh, upravte jej, aby kontroloval GTK-Doc a " "přidejte volání gtkdocize." #. (itstool) path: listitem/para #: C/index.docbook:527 msgid "" "The main purpose of gtkdocize is to make the " "gtk-doc.make Makefile and the gtk-doc.m4 macro definition file available to the build system, either by " "copying or linking it into the project." msgstr "" "Hlavním účelem gtkdocize je vytvořit Makefile " "gtk-doc.make a definici makra gtk-doc.m4 dostupnou sestavovacímu systému, buď zkopírováním do projektu nebo " "vytvořením odkazu." #. (itstool) path: listitem/para #: C/index.docbook:536 msgid "" "Add the necessary autoconf macros to " "configure.ac to enable GTK-Doc in your build system to " "allow configuration of GTK-Doc via the generated configure script." msgstr "" "Přidat potřebná makra autoconf do " "configure.ac, abyste povolili GTK-Doc v sestavovacím " "systému a konfigurace GTK-Doc mohla jít přes generovaný skript " "configure." #. (itstool) path: listitem/para #: C/index.docbook:542 msgid "" "Among others with registers the --enable-gtk-doc option with " "the configure script." msgstr "" "Mimo jiné pomocí registrace přepínače --enable-gtk-doc ve " "skriptu configure." #. (itstool) path: listitem/para #: C/index.docbook:548 msgid "" "Create an automake script for each application or " "library in your project. In the example used in this documentation this step " "applies to both meeper and libmeep." msgstr "" "Vytvořit skript automake pro jednotlivé aplikace " "a knihovny ve svém projektu. V příkladu použitém v této dokumentaci je tento " "krok použit jak pro meeper, tak pro libmeep." #. (itstool) path: sect1/para #: C/index.docbook:557 msgid "" "In the following sections, we will perform the above steps in reverse order. " "We start with the automake scripts and work our " "way up to configure.ac and autogen.sh. Then we show how enable Gtk-Doc in the build system and how to " "build the documentation." msgstr "" "V následujícím oddíle provedeme výše zmíněné kroky v opačném pořadí. Začneme " "se skripty automake a budeme postupovat až k " "configure.ac a autogen.sh. Pak si " "ukážeme, jak povolit GTK-Doc v sestavovacím systému a jak sestavit " "dokumentaci." #. (itstool) path: sect2/title #: C/index.docbook:567 msgid "Integration with automake" msgstr "Integrace s automake" #. (itstool) path: sect2/para #: C/index.docbook:569 msgid "" "First copy the Makefile.am from the examples sub-directory of the gtkdoc-" "sources to your project's reference documentation directory (e.g. " "docs/reference/<package>). A " "local copy should be available under e.g. /usr/share/doc/gtk-doc-" "tools/examples/Makefile.am. If you have multiple packages repeat " "this for each one." msgstr "" "Jako první nakopírujte Makefile.am z podsložky " "examples ve složce gtkdoc-sources do složky s referenční dokumentací svého projektu " "(např. ./docs/reference/<package>). Místní kopie by měla být k dispozici např. pod /usr/" "share/doc/gtk-doc-tools/examples/Makefile.am. Pokud máte více " "balíčků s dokumentací, opakujte tento krok pro každý z nich." #. (itstool) path: note/simpara #: C/index.docbook:582 msgid "" "Do not forget to add each Makefile.am to the " "AC_CONFIG_FILES macro in configure.ac. For docs/reference/libmeep/Makefile.am you " "will need to add the entry docs/reference/libmeep/Makefile to AC_CONFIG_FILES." msgstr "" "Nezapomeňte přidat jednotlivé Makefile.am do makra " "AC_CONFIG_FILES v configure.ac. " "Pro docs/reference/libmeep/Makefile.am budete " "potřebovat přidat záznam docs/reference/libmeep/Makefile do AC_CONFIG_FILES." #. (itstool) path: example/title #: C/index.docbook:594 msgid "Example directory structure with Makefiles.am" msgstr "Příklad struktury složek s Makefiles.am" #. (itstool) path: example/programlisting #: C/index.docbook:597 #, no-wrap msgid "" "\n" "meep/\n" " docs/\n" " reference/ # reference documentation\n" " libmeep/\n" " Makefile.am\n" " meeper/\n" " Makefile.am\n" " help/ # optional: user manual\n" " meeper/\n" " src/\n" " libmeep/\n" " meeper/\n" msgstr "" "\n" "meep/\n" " docs/\n" " reference/ # referenční dokumentace\n" " libmeep/\n" " Makefile.am\n" " meeper/\n" " Makefile.am\n" " help/ # volitelné: uživatelská příručka\n" " meeper/\n" " src/\n" " libmeep/\n" " meeper/\n" #. (itstool) path: sect2/para #: C/index.docbook:613 msgid "" "Next, you need to customize the copied Makefiles and provide values for the " "various parameters in each Makefile.am. All settings " "have a comment above them that describes their purpose and how to customize " "the setting. Most settings are used to supply extra flags to the respective " "tools to which they apply. Every tool has a variable of the form (e.g. the tool gtkdoc-mkhtml has an option named MKHTML_OPTIONS). All the tools " "support to list the supported options." msgstr "" "Dále je třeba přizpůsobit zkopírované soubory Makefile a dodat hodnoty pro " "různé parametry v jednotlivých Makefile.am. Všechna " "nastavení mají komentáře s popisem svého účelu a jak nastavení přizpůsobit. " "Většina nastavení má doplňující příznaky předávané do dotyčných nástrojů, " "které je umí použít. Každý nástroj má proměnnou ve formátu (např. nástroj gtkdoc-" "mkhtml má volbu nazvanou MKHTML_OPTIONS). Všechny " "nástroje podporují pro vypsání podporovaných " "přepínačů." #. (itstool) path: listitem/para #: C/index.docbook:637 msgid "" " is used to provide the name of the package that " "is being documentated (e.g. meeper, or libmeep)." msgstr "" " se používá k poskytnutí názvu balíčku, který je " "dokumentován (např. meeper nebo libmeep)." #. (itstool) path: listitem/para #: C/index.docbook:644 msgid "" " is used to specify the location of source " "directory which GTK-Doc searches for your API documentation. This will " "usually be DOC_SOURCE_DIR=$(top_srcdir)/src or a sub-" "directory of that directory." msgstr "" " se používá k určení umístění zdrojové " "složky, ve které GTK-Doc hledá dokumentaci API. Obvykle to je " "DOC_SOURCE_DIR=$(top_srcdir)/src nebo podsložka této složky." #. (itstool) path: listitem/para #: C/index.docbook:657 msgid "" " and are used for " "dependencies. Each option take a file-glob (e.g. HFILE_GLOB=" "$(top_srcdir)/src/*.c). The documentation will be rebuilt if any of " "the matched files change." msgstr "" " a se používají pro " "závislosti. Obě volby přebírají file-glob (např. HFILE_GLOB=" "$(top_srcdir)/src/*.c). Dokumentace se znovu sestaví, když se " "kterýkoliv z odpovídajících souborů změní." #. (itstool) path: listitem/para #: C/index.docbook:669 msgid "" " allows to specify extra header files to " "include when scanning for API documentation, which are not found under " "DOC_SOURCE_DIR (e.g. EXTRA_HFILES=$(top_srcdir}/contrib/" "extra.h)." msgstr "" " umožňuje určit dodatečné hlavičkové soubory, " "které se mají zahrnout při procházení pro dokumentaci k API, a které nejsou " "k nalezení pod složkou DOC_SOURCE_DIR (např. EXTRA_HFILES=" "$(top_srcdir}/contrib/extra.h)." #. (itstool) path: listitem/para #: C/index.docbook:679 msgid "" " allows to specify header files or directories " "to ignore when scanning for API documentation. Use the basename of the file " "or directory (e.g. IGNORE_HFILES=gtkdebug.h gtkintl.h " "private_code_folder)." msgstr "" " umožňuje určit dodatečné hlavičkové soubory " "nebo složky, které se mají ignorovat při procházení pro dokumentaci k API. " "Použijte základní název ze souboru nebo složky (např. " "IGNORE_HFILES=gtkdebug.h gtkintl.h private_code_folder)." #. (itstool) path: listitem/para #: C/index.docbook:689 msgid "" " allows to specify images files which will be " "copied into the html/ directory of the generated " "documentation. If your API documentation includes any images they need to be " "added to this option (e.g. HTML_IMAGES=$(top_srcdir)/gtk/stock-icons/" "stock_about_24.png)." msgstr "" " umožňuje určit soubory s obrázky, které se " "zkopírují do složky s generovanou dokumentací. Pokud " "jsou součástí vaší dokumentace API nějaké obrázky, je třeba je přidat do " "této volby (např. HTML_IMAGES=$(top_srcdir)/gtk/stock-icons/" "stock_about_24.png)." #. (itstool) path: listitem/para #: C/index.docbook:702 msgid "" " allows to specify extra files that are " "included by $(DOC_MAIN_SGML_FILE) (e.g. " "content_files=running.xml building.xml changes-2.0.xml)." msgstr "" " umožňuje určit dodatečné soubory, které se " "mají vložit pomocí $(DOC_MAIN_SGML_FILE) (např. " "content_files=running.xml building.xml changes-2.0.xml)." #. (itstool) path: listitem/para #: C/index.docbook:713 msgid "" " allows to specify files where " "gtk-doc abbreviations such as #GtkWidget " "are expanded (e.g. expand_content_files=running.xml)." msgstr "" " umožňuje určit soubory, ve kterých " "jsou rozvinuty zkratky gtk-doc, jako je třeba " "#GtkWidget (např. expand_content_files=running.xml)." #. (itstool) path: sect2/para #: C/index.docbook:631 msgid "" "The following list explains the most relevant options. Check the example " "Makefile.am for additional options. <_:itemizedlist-1/>" msgstr "" "Následující seznam vysvětluje nejpodstatnější volby. Na další volby se " "podívejte do ukázkového Makefile.am. <_:itemizedlist-1/>" #. (itstool) path: sect2/title #: C/index.docbook:728 msgid "Integration with autoconf" msgstr "Integrace s autoconf" #. (itstool) path: sect2/para #: C/index.docbook:730 msgid "" "Integration with autoconf is very simple and " "includes one required step and an additional optional (but recommended) " "step. The first step is to add the GTK_DOC_CHECK macro " "to your configure.ac script. This registers several " "configure options to enable GTK-Doc and allows you to set default arguments " "for gtkdocize." msgstr "" "Integrace s autoconf je velmi jednoduchá a skládá " "se z jednoho povinného kroku a dalšího volitelného (ale doporučeného) kroku. " "Prvním krokem je přidat makro GTK_DOC_CHECK do skriptu " "configure.ac. Tím se zaregistruje několik " "konfiguračních voleb, které povolí GTK-Doc a umožní vám nastavit výchozí " "argumenty pro gtkdocize." #. (itstool) path: warning/simpara #: C/index.docbook:742 msgid "" "Make sure that the GTK_DOC_CHECK macro is not indented. The " "macro must start at the beginning of the line and should not start with " "whitespace." msgstr "" "Ujistěte se, že makro GTK_DOC_CHECK není odsazené od kraje. " "Makro musí začínat na začátku řádku a nesmí začínat bílými znaky." #. (itstool) path: sect2/para #: C/index.docbook:749 msgid "" "The second step is to add the AC_CONFIG_MACRO_DIR(m4) to your " "configure.ac. This is not required but helps " "gtkdocize to automatically copy the macro " "definition (e.g gtk-doc.m4) which contains the " "GTK_DOC_CHECK macro to your project's macro directory. " "Without this, the GTK_DOC_CHECK macro might not be found and you would need " "to explicitly tell the aclocal tool where to find " "the macro definition file." msgstr "" "Druhým krokem je přidat do configure.ac makro " "AC_CONFIG_MACRO_DIR(m4). Není to sice nutné, ale pomůže to " "gtkdocize automaticky zkopírovat definici makra " "(např. gtk-doc.m4), která obsahuje makro " "GTK_DOC_CHECK, do složky s makry ve vašem projektu. Bez " "toho se může stát, že makro GTK_DOC_CHECK nemusí být " "nalezeno a budete muset nástroji aclocal výslovně " "uvést, kde soubor s definicí makra najít." #. (itstool) path: example/title #: C/index.docbook:762 msgid "Minimal integration with autoconf" msgstr "Minimální integrace s autoconf" #. (itstool) path: example/programlisting #: C/index.docbook:763 #, no-wrap msgid "" "\n" "# recommended: set m4 directory\n" "AC_CONFIG_MACRO_DIR(m4)\n" "# optional: register gtk-doc in configure\n" "GTK_DOC_CHECK([1.28])\n" msgstr "" "\n" "# doporučeno: nastaví složku m4\n" "AC_CONFIG_MACRO_DIR(m4)\n" "# volitelné: zaregistruje gtk-doc v configure\n" "GTK_DOC_CHECK([1.28])\n" #. (itstool) path: example/title #: C/index.docbook:778 msgid "Integration with optional gtk-doc dependency" msgstr "Integrace s volitelnými závislostttmi gtk-doc" #. (itstool) path: example/programlisting #: C/index.docbook:779 #, no-wrap msgid "" "\n" "m4_ifdef([GTK_DOC_CHECK], [\n" "# recommended: set m4 directory\n" "AC_CONFIG_MACRO_DIR(m4)\n" "# optional: register gtk-doc in configure\n" "GTK_DOC_CHECK([1.28])\n" "],[\n" "AM_CONDITIONAL([ENABLE_GTK_DOC], false)\n" "])\n" msgstr "" "\n" "m4_ifdef([GTK_DOC_CHECK], [\n" "# doporučeno: nastaví složku m4\n" "AC_CONFIG_MACRO_DIR(m4)\n" "# volitelné: zaregistruje gtk-doc v configure\n" "GTK_DOC_CHECK([1.28])\n" "],[\n" "AM_CONDITIONAL([ENABLE_GTK_DOC], false)\n" "])\n" #. (itstool) path: sect2/para #: C/index.docbook:772 msgid "" "The above example works, but will require all developers to have gtk-doc " "installed. A better way is to make building the documentation optional as " "shown in the next example: <_:example-1/>" msgstr "" "Výše uvedený příklad funguje, ale vyžaduje, aby všichni vývojáři měli " "nainstalováno gtk-doc. Lepším způsobem je zařídit, aby sestavení dokumentace " "bylo volitelné, jak je ukázáno v následujícím příkladu: <_:example-1/>" #. (itstool) path: sect2/para #: C/index.docbook:792 msgid "" "The first argument is used to check for the Gtk-Doc version at configure " "time. The 2nd, optional argument is used by gtkdocize. The GTK_DOC_CHECK macro also adds several " "configure switches:" msgstr "" "První argument se používá ke kontrole verze GTK-Doc v průběhu konfigurace. " "Druhý, volitelný argument používá nástroj gtkdocize. Makro GTK_DOC_CHECK také přidává několik " "přepínačů pro configure:" #. (itstool) path: listitem/para #: C/index.docbook:801 msgid "--with-html-dir=PATH : path to installed docs" msgstr "--with-html-dir=CESTA: cesta, kam se má dokumentace nainstalovat" #. (itstool) path: listitem/para #: C/index.docbook:802 msgid "--enable-gtk-doc : use gtk-doc to build documentation [default=no]" msgstr "" "--enable-gtk-doc: použít k sestavení dokumentace gtk-doc [výchozí je ne]" #. (itstool) path: listitem/para #: C/index.docbook:803 msgid "" "--enable-gtk-doc-html : build documentation in html format [default=yes]" msgstr "" "--enable-gtk-doc-html: sestavit dokumentaci ve formátu HTML [výchozí je ano]" #. (itstool) path: listitem/para #: C/index.docbook:804 msgid "--enable-gtk-doc-pdf : build documentation in pdf format [default=no]" msgstr "" "--enable-gtk-doc-pdf: sestavit dokumentaci ve formátu PDF [výchozí je ne]" #. (itstool) path: important/para #: C/index.docbook:808 msgid "" "GTK-Doc is disabled by default! Remember to pass the option to the next configure run. " "Otherwise pregenerated documentation is installed (which makes sense for " "users but not for developers)." msgstr "" "GTK-Doc je standardně vypnuté! Nezapomeňte zadat přepínač „“ při dalším spuštění configure. Jinak " "se nainstaluje předgenerovaná dokumentace (která může mít význam pro " "uživatele, ale ne pro vývojáře)." #. (itstool) path: sect2/para #: C/index.docbook:816 msgid "" "After all changes to configure.ac are made, update the " "configure file. This can be done by re-running " "autogen.sh." msgstr "" "Po provedení změn v configure.ac aktualizujte soubor " "configure. To se dá udělat opětovným spuštěním " "autogen.sh." #. (itstool) path: sect2/title #: C/index.docbook:824 msgid "Integration with autogen" msgstr "Integrace s autogen" #. (itstool) path: sect2/para #: C/index.docbook:826 msgid "" "Most projects will have an autogen.sh script to setup " "the build infrastructure after the project was checked out from a version " "control system (such as git or svn). GTK-Doc comes with a script called " "gtkdocize which can be used to copy the necessary " "files needed by Gtk-Doc to the source directory." msgstr "" "Většina projektů má skript autogen.sh, který po stažení " "projektu ze systému pro správu verzí (jako je Git nebo SVN), nastaví " "infrastrukturu pro sestavení. GTK-Doc se dodává se skriptem nazvaným " "gtkdocize, který lze použít ke zkopírování " "nezbytných souborů požadovaných GTK-Doc do zdrojové složky." #. (itstool) path: sect2/para #: C/index.docbook:834 msgid "It should be run before autoreconf, autoheader, automake or autoconf." msgstr "Měl by být spuštěn před autoheader, automake nebo autoconf." #. (itstool) path: example/title #: C/index.docbook:839 msgid "Running gtkdocize from autogen.sh" msgstr "Spuštění gtkdocize z autogen.sh" #. (itstool) path: example/programlisting #: C/index.docbook:840 #, no-wrap msgid "" "\n" "gtkdocize || exit 1\n" msgstr "" "\n" "gtkdocize || exit 1\n" #. (itstool) path: example/title #: C/index.docbook:848 msgid "Conditionally run gtkdocize from autogen.sh" msgstr "Podmíněné spuštění gtkdocize z autogen.sh" #. (itstool) path: example/programlisting #: C/index.docbook:849 #, no-wrap msgid "" "\n" "GTKDOCIZE=$(which gtkdocize 2>/dev/null)\n" "if test $? -ne 0; then\n" " echo \"No gtk-doc support found. You can't build the docs.\"\n" "else\n" " $GTKDOCIZE || exit 1\n" "fi\n" msgstr "" "\n" "GTKDOCIZE=$(which gtkdocize 2>/dev/null)\n" "if test $? -ne 0; then\n" " echo \"No gtk-doc support found. You can't build the docs.\"\n" "else\n" " $GTKDOCIZE || exit 1\n" "fi\n" #. (itstool) path: sect2/para #: C/index.docbook:860 msgid "" "When running gtkdocize it copies gtk-" "doc.make to your project root (or any directory specified by the " " option)." msgstr "" "Když spustíte gtkdocize, tak nakopíruje do kořenové " "složky vašeho projektu (nebo složky určené přepínačem