# Hungarian translation for gtk-doc. # Copyright (C) 2023, 2024, 2026 Free Software Foundation, Inc. # This file is distributed under the same license as the gtk-doc package. # # Balázs Úr , 2023, 2024, 2026. msgid "" msgstr "" "Project-Id-Version: gtk-doc master\n" "POT-Creation-Date: 2026-03-10 19:37+0000\n" "PO-Revision-Date: 2026-03-11 01:42+0100\n" "Last-Translator: Balázs Úr \n" "Language-Team: Hungarian \n" "Language: hu\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" "Plural-Forms: nplurals=2; plural=(n != 1);\n" "X-Generator: Lokalize 25.08.1\n" #. Put one translator per line, in the form NAME , YEAR1, YEAR2 msgctxt "_" msgid "translator-credits" msgstr "Úr Balázs , 2023, 2024, 2026." #. (itstool) path: bookinfo/title #: C/index.docbook:12 msgid "GTK-Doc Manual" msgstr "GTK-Doc kézikönyv" #. (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 "" "Felhasználói kézikönyv fejlesztők számára a GTK-Doc használatára vonatkozó " "utasításokkal." #. (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 "GTK-Doc projekt" #. (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 és 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 "" "Engedélyt adunk Önnek a jelen dokumentum sokszorosítására, terjesztésére és/" "vagy módosítására a Free Software Foundation által kiadott GNU " "Free Documentation License 1.2-es, vagy bármely azt követő " "verziójának feltételei alapján. Nincs Nem Változtatható szakasz, nincs " "Címlapszöveg, nincs Hátlapszöveg. A jelen licenc egy példányát mellékelve találja." #. (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 "" "A vállalatok által termékeik és szolgáltatásaik megkülönböztetésére használt " "nevek közül sokan védjegyként vannak bejegyezve. Ahol ezek a nevek " "megjelennek a GNOME dokumentációban, és a GNOME dokumentációs projekt " "tagjainak tudomásuk van ezekről a védjegyekről, ott a nevek nagybetűvel vagy " "nagy kezdőbetűvel vannak kiírva." #. (itstool) path: revhistory/revision #: C/index.docbook:83 msgid "" "1.33.0 1 Oct 2020 mc gtk4 version" msgstr "" "1.33.0 2020. október 1. " "mc gtk4 verzió" #. (itstool) path: revhistory/revision #: C/index.docbook:89 msgid "" "1.32.1 15 Aug 2019 ss dev version" msgstr "" "1.32.1 2019. augusztus 15. " "ss fejlesztői verzió" #. (itstool) path: revhistory/revision #: C/index.docbook:95 msgid "" "1.32 15 Aug 2019 ss hotfix release" msgstr "" "1.32 2019. augusztus 15. " "ss gyorsjavítási kiadás" #. (itstool) path: revhistory/revision #: C/index.docbook:101 msgid "" "1.31 05 Aug 2019 ss refactorings and more test coverage" msgstr "" "1.31 2019. augusztus 5. " "ss újratervezések és jobb " "tesztlefedettség" #. (itstool) path: revhistory/revision #: C/index.docbook:107 msgid "" "1.30 08 May 2019 ss more test coverage" msgstr "" "1.30 2019. május 8. ss jobb tesztlefedettség" #. (itstool) path: revhistory/revision #: C/index.docbook:113 msgid "" "1.29 28 Aug 2018 ss bug fixes" msgstr "" "1.29 2018. augusztus 28. " "ss hibajavítások" #. (itstool) path: revhistory/revision #: C/index.docbook:119 msgid "" "1.28 24 Mar 2018 ss bug fixes" msgstr "" "1.28 2018. március 24. " "ss hibajavítások" #. (itstool) path: revhistory/revision #: C/index.docbook:125 msgid "" "1.27 07 Dec 2017 ss fine tuning of the python port" msgstr "" "1.27 2017. december 7. " "ss a Pythonra történő átírás " "finomhangolása" #. (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 2017. augusztus 11. " "ss az összes eszköz átírása Perl " "és Bash nyelvekről Pythonra" #. (itstool) path: revhistory/revision #: C/index.docbook:137 msgid "" "1.25 21 March 2016 ss bug fixes, test cleanups" msgstr "" "1.25 2016. március 21. " "ss hibajavítások, " "teszttisztítások" #. (itstool) path: revhistory/revision #: C/index.docbook:143 msgid "" "1.24 29 May 2015 ss bug fix" msgstr "" "1.24 2015. május 29. ss hibajavítás" #. (itstool) path: revhistory/revision #: C/index.docbook:149 msgid "" "1.23 17 May 2015 ss bug fix" msgstr "" "1.23 2015. május 17. ss hibajavítás" #. (itstool) path: revhistory/revision #: C/index.docbook:155 msgid "" "1.22 07 May 2015 ss bug fixes, dropping deprecated features" msgstr "" "1.22 2015. május 7. ss hibajavítások, elavult funkciók kidobása" #. (itstool) path: revhistory/revision #: C/index.docbook:161 msgid "" "1.21 17 Jul 2014 ss bug fixes, dropping deprecated features" msgstr "" "1.21 2014. július 17. " "ss hibajavítások, elavult " "funkciók kidobása" #. (itstool) path: revhistory/revision #: C/index.docbook:167 msgid "" "1.20 16 Feb 2014 ss bug fixes, markdown support, style improvements" msgstr "" "1.20 2014. február 16. " "ss hibajavítások, Markdown-" "támogatás, stílusjavítások" #. (itstool) path: revhistory/revision #: C/index.docbook:173 msgid "" "1.19 05 Jun 2013 ss bug fixes" msgstr "" "1.19 2013. június 5. ss hibajavítások" #. (itstool) path: revhistory/revision #: C/index.docbook:179 msgid "" "1.18 14 Sep 2011 ss bug fixes, speedups, markdown support" msgstr "" "1.18 2011. szeptember 14. " "ss hibajavítások, gyorsítások, " "Markdown-támogatás" #. (itstool) path: revhistory/revision #: C/index.docbook:185 msgid "" "1.17 26 Feb 2011 sk urgent bug fix update" msgstr "" "1.17 2011. február 26. " "sk sürgős hibajavító frissítés" #. (itstool) path: revhistory/revision #: C/index.docbook:191 msgid "" "1.16 14 Jan 2011 sk bugfixes, layout improvements" msgstr "" "1.16 2011. január 14. " "sk hibajavítások, elrendezési " "továbbfejlesztések" #. (itstool) path: revhistory/revision #: C/index.docbook:197 msgid "" "1.15 21 May 2010 sk bug and regression fixes" msgstr "" "1.15 2010. május 21. sk hibajavítások és regressziójavítások" #. (itstool) path: revhistory/revision #: C/index.docbook:203 msgid "" "1.14 28 March 2010 sk bugfixes and performance improvements" msgstr "" "1.14 2010. március 28. " "sk hibajavítások és " "teljesítményjavítások" #. (itstool) path: revhistory/revision #: C/index.docbook:209 msgid "" "1.13 18 December 2009 " "sk broken tarball update" msgstr "" "1.13 2009. december 18. " "sk törött forráscsomag-" "frissítés" #. (itstool) path: revhistory/revision #: C/index.docbook:215 msgid "" "1.12 18 December 2009 " "sk new tool features and " "bugfixes" msgstr "" "1.12 2009. december 18. " "sk új eszközfunkciók és " "hibajavítások" #. (itstool) path: revhistory/revision #: C/index.docbook:221 msgid "" "1.11 16 November 2008 " "mal GNOME doc-utils migration" msgstr "" "1.11 2008. november 16. " "mal GNOME doc-utils költöztetés" #. (itstool) path: chapter/title #: C/index.docbook:234 msgid "Introduction" msgstr "Bevezetés" #. (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 "" "Ez a fejezet bemutatja a GTK-Doc dokumentációs eszközt, és áttekintést ad " "arról, hogy mi is ez, és hogyan használják." #. (itstool) path: sect1/title #: C/index.docbook:242 msgid "What is GTK-Doc?" msgstr "Mi a 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." msgid "" "GTK-Doc is used to document C code. It is typically used to document the " "public API of libraries, such as GLib-based libraries, but it can also be " "used to document application code." msgstr "" "A GTK-Doc a C kód dokumentálására szolgál. Általában programkönyvtárak " "nyilvános API-jának dokumentálására használják, mint például a GLib-alapú " "programkönyvtárak, de használható az alkalmazás kódjának dokumentálására is." #. (itstool) path: sect1/title #: C/index.docbook:252 msgid "How Does GTK-Doc Work?" msgstr "Hogyan működik a GTK-Doc?" #. (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)." msgid "" "GTK-Doc works by reading specially-formatted comment blocks placed inside " "the source files to document symbols such as functions, macros, structs, " "enums, etc. (though note that for most kind of symbols GTK-Doc will only " "document the symbols that are declared in header files; for example it won't " "produce output for static functions)." msgstr "" "A GTK-Doc úgy működik, hogy beolvassa a forrásfájlokon belül elhelyezett " "különlegesen formázott megjegyzésblokkokat, hogy dokumentálja a " "szimbólumokat, mint például a függvényeket, makrókat, struktúrákat, " "felsorolásokat stb. (habár ne feledje, hogy a legtöbb szimbólumtípusnál a " "GTK-Doc csak a fejlécfájlokban deklarált szimbólumokat fogja dokumentálni, " "például nem fog kimenetet előállítani statikus függvényekhez)." #. (itstool) path: sect1/para #: C/index.docbook:262 msgid "" "GTK-Doc also reads template files where documentation can be added there as " "well." msgstr "" "A GTK-Doc a sablonfájlokat is olvassa, amelyekbe dokumentáció is hozzáadható." #. (itstool) path: sect1/para #: C/index.docbook:267 #| msgid "" #| "GTK-Doc consists of a number of python scripts, each performing a " #| "different step in the process." msgid "" "GTK-Doc consists of a number of programs, each performing a different step " "in the process." msgstr "" "A GTK-Doc számos programból áll, amelyek mindegyike más-más lépést hajt " "végre a folyamatban." #. (itstool) path: sect1/para #: C/index.docbook:272 #| msgid "There are 5 main steps in the process:" msgid "The main steps are:" msgstr "A fő lépések a következők:" #. (itstool) path: listitem/para #: C/index.docbook:279 msgid "" "Writing the documentation. The author fills in the " "source files with the documentation for each function, macro, structs or " "unions, etc." msgstr "" "A dokumentáció megírása. A szerző kitölti a " "forrásfájlokat minden egyes függvény, makró, struktúra, unió és egyéb " "szerkezetek dokumentációjával." #. (itstool) path: listitem/para #: C/index.docbook:288 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 "" "Információgyűjtés a kódról. A gtkdoc-scan átvizsgálja a kód fejlécfájljait függvények, makrók, " "felsorolások, struktúrák és uniók deklarációit keresve. Létrehozza a " "deklarációk listáját tartalmazó <modul>-decl-list.txt fájlt, és szakaszokba helyezi azokat aszerint, hogy melyik " "fejlécfájlban vannak. Az első futáskor ez a fájl a <modul>-" "sections.txt fájlba lesz másolva. A szerző átrendezheti a " "szakaszokat és az azokon belüli deklarációk sorrendjét, hogy a kívánt végső " "sorrendet állítsa elő. A második fájl, amelyet előállít, a " "<modul>-decl.txt. Ez a fájl tartalmazza az " "átvilágító által talált összes deklarációt. Ha valamilyen oknál fogva valaki " "azt szeretné, hogy néhány szimbólum megjelenjen a dokumentációban, ahol a " "teljes deklarációt nem találja meg az átvizsgáló, vagy a deklarációnak " "másképp kellene megjelennie, akkor a <modul>-decl.txt fájlban lévőhöz hasonló entitásokat helyezhet el a " "<modul>-overrides.txt fájlba." #. (itstool) path: listitem/para #: C/index.docbook:308 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 "" "A gtkdoc-scangobj arra is használható, hogy " "dinamikusan lekérdezzen egy programkönyvtárat az általa exportált GObject " "alosztályokról. Információt tárol az egyes objektumok osztályhierarchiában " "elfoglalt pozíciójáról, valamint az általa biztosított GObject-" "tulajdonságokról és szignálokról." #. (itstool) path: listitem/para #: C/index.docbook:314 #| msgid "" #| "gtkdoc-scanobj should not be used anymore. It " #| "was needed in the past when GObject was still GtkObject inside gtk+." msgid "" "gtkdoc-scanobj should not be used anymore. It was " "needed in the past when GObject was still GtkObject inside GTK." msgstr "" "A gtkdoc-scanobj függvényt nem szabad többé " "használni. Régebben volt rá szükség, amikor a GObject még GtkObject volt a " "GTK-n belül." #. (itstool) path: listitem/para #: C/index.docbook:322 #| 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." 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 for symbols, 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 "" "Az XML és a HTML/PDF előállítása. A gtkdoc-" "mkdb átalakítja a sablonfájlokat XML-fájlokká az xml/ alkönyvtárban. Ha a forráskód tartalmaz " "dokumentációt a szimbólumokhoz a különleges megjegyzésblokkok használatával, " "akkor az beolvasztásra kerül ide. Ha nem használnak tmpl-fájlokat, akkor " "csak a forrásokból és a betekintési adatokból olvassa be a dokumentációt." #. (itstool) path: listitem/para #: C/index.docbook:332 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 "" "A gtkdoc-mkhtml átalakítja az XML-fájlokat HTML-" "fájlokká a html/ alkönyvtárban. " "Hasonlóképpen a gtkdoc-mkpdf átalakítja az XML-" "fájlokat <csomag>.pdf nevű PDF-dokumentummá." #. (itstool) path: listitem/para #: C/index.docbook:339 msgid "" "Files in xml/ and html/ directories are always overwritten. One " "should never edit them directly." msgstr "" "Az xml/ és a html/ könyvtárakban lévő fájlok mindig " "felülírásra kerülnek. Soha sem szabad közvetlenül szerkeszteni azokat." #. (itstool) path: listitem/para #: C/index.docbook:347 #| 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)." 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." msgstr "" "A dokumentumok közötti kereszthivatkozások javítása. A " "HTML-fájlok telepítése után a gtkdoc-fixxref " "futtatható a különálló dokumentumok közötti kereszthivatkozások javításához. " "Például a GTK dokumentáció számos kereszthivatkozást tartalmaz a GLib " "kézikönyvben dokumentált típusokra." #. (itstool) path: listitem/para #: C/index.docbook:356 #| 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)." msgid "" "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 "" "A terjesztésre szánt forráscsomag létrehozásakor a gtkdoc-" "rebase az összes külső hivatkozást webes hivatkozásokká " "alakítja. A terjesztett (előre előállított) dokumentumok telepítésekor " "ugyanez az alkalmazás megpróbálja a hivatkozásokat visszaalakítani helyi " "hivatkozásokká (ahová az adott dokumentumok telepítve vannak)." #. (itstool) path: sect1/title #: C/index.docbook:369 msgid "Getting GTK-Doc" msgstr "A GTK-Doc beszerzése" #. (itstool) path: sect2/title #: C/index.docbook:372 msgid "Requirements" msgstr "Követelmények" #. (itstool) path: sect2/para #: C/index.docbook:373 msgid "" "python 2/3 - the main scripts are written in python." msgstr "" "python 2/3 – a fő parancsfájlok Python nyelven lettek " "írva." #. (itstool) path: sect2/para #: C/index.docbook:376 msgid "" "xsltproc - the xslt processor from libxslt xmlsoft.org/XSLT/" msgstr "" "xsltproc – az XSLT-feldolgozó a libxslt csomagból, " "xmlsoft.org/XSLT/" #. (itstool) path: sect2/para #: C/index.docbook:380 msgid "" "docbook-xsl - the docbook xsl stylesheets sourceforge.net/projects/docbook/files/docbook-xsl" msgstr "" "docbook-xsl – a Docbook XSL-stíluslapjai, sourceforge.net/projects/docbook/files/docbook-xsl" #. (itstool) path: sect2/para #: C/index.docbook:384 msgid "" "One of source-highlight, highlight " "or vim - optional - used for syntax highlighting of " "examples" msgstr "" "A source-highlight, highlight vagy " "vim egyike – nem kötelező – a példák szintaxis-" "kiemeléséhez van használva" #. (itstool) path: sect1/title #: C/index.docbook:392 msgid "About GTK-Doc" msgstr "A GTK-Doc története" #. (itstool) path: sect1/para #: C/index.docbook:394 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 "" "Történetileg a GTK-Doc programot arra használták, hogy sablonfájlokat " "állítsanak elő a forráskódból. Ezeket a sablonfájlokat a fejlesztők " "használhatták az API-dokumentáció bevitelére. Ez a megközelítés meglehetősen " "kényelmetlen volt, mivel az előállított fájlokat verziókövetés alatt kellett " "tartani. A GTK-Doc 1.9 óta lehetővé vált, hogy az összes API-információ " "forrásmegjegyzésekbe kerüljön, ami elavulttá tette a sablontámogatást. Az " "1.26-os verzióban a sablontámogatás eltávolításra került." #. (itstool) path: sect1/para #: C/index.docbook:404 C/index.docbook:418 msgid "(FIXME)" msgstr "(JAVÍTS KI)" #. (itstool) path: sect1/para #: C/index.docbook:408 msgid "" "(authors, web pages, mailing list, license, future plans, comparison with " "other similar systems.)" msgstr "" "(szerzők, weboldalak, levelezőlista, licenc, jövőbeli tervek, " "összehasonlítás más, hasonló rendszerekkel)" #. (itstool) path: sect1/title #: C/index.docbook:416 msgid "About this Manual" msgstr "Erről a kézikönyvről" #. (itstool) path: sect1/para #: C/index.docbook:422 msgid "(who it is meant for, where you can get it, license)" msgstr "(kinek szánják, hol lehet hozzájutni, licenc)" #. (itstool) path: chapter/title #: C/index.docbook:431 msgid "Project Setup" msgstr "Projekt beállítása" #. (itstool) path: chapter/para #: C/index.docbook:433 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 "" "Ez a fejezet azokat a lépéseket írja le, amelyek a GTK-Doc projektbe való " "integrálásához szükségesek. A GTK-Doc projektbe való integrálása a következő " "lépéseket tartalmazza:" #. (itstool) path: listitem/para #: C/index.docbook:441 msgid "" "Preparation of the directory structure and creating required configuration " "files for your GTK-Doc documentation (see Setting up a skeleton documentation)." msgstr "" "A könyvtárszerkezet előkészítése és a GTK-Doc dokumentációhoz szükséges " "beállítási fájlok létrehozása (nézze meg a Dokumentációvázlat beállítása " "szakaszt)." #. (itstool) path: listitem/para #: C/index.docbook:449 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 "" "Az összeállítási rendszer beállítása a dokumentáció összeállításához a GTK-" "Doc eszközök használatával. Több összeállítási rendszer is támogatott, ebben " "a kézikönyvben azt mutatjuk be, hogy hogyan integrálható a GTK-Doc az Autotools, a CMake és az egyszerű Makefile megoldásokkal." #. (itstool) path: listitem/para #: C/index.docbook:459 msgid "" "Adding GTK-Doc specific files to version control and deciding which files to " "ignore (see Integration with version " "control systems)." msgstr "" "GTK-Doc specifikus fájlok hozzáadása a verziókövetéshez és annak eldöntése, " "hogy mely fájlokat kell figyelmen kívül hagyni (nézze meg az Integráció verziókövető rendszerekkel " "szakaszt)." #. (itstool) path: chapter/para #: C/index.docbook:467 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 "" "A következő szakaszok azt feltételezik, hogy egy meep nevű " "projekten dolgozunk. Ez a projekt két csomagot (vagy modult) tartalmaz, egy " "libmeep nevű programkönyvtárat és egy meeper nevű " "végfelhasználói alkalmazást." #. (itstool) path: sect1/title #: C/index.docbook:476 msgid "Setting up a skeleton documentation" msgstr "Dokumentációvázlat beállítása" #. (itstool) path: sect1/para #: C/index.docbook:478 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 "" "Általános gyakorlat, hogy a dokumentáció a docs nevű mappába " "kerül a legfelső szintű projektkönyvtáron belül. Általában különbséget " "teszünk a fejlesztőknek szánt hivatkozási dokumentáció " "és a végfelhasználóknak szánt felhasználói kézikönyv " "között. Megint csak az a gyakorlat, hogy mindkettőhöz külön mappák " "tartoznak. A hivatkozási dokumentációt általában a reference " "nevű mappába, a végfelhasználói kézikönyvet pedig a help nevű " "mappába tesszük. A fenti gyakorlat szerint a libmeep csomagunk " "dokumentációja a következő helyre kerülne: docs/reference/libmeep. A csak egy programkönyvtárat vagy alkalmazást tartalmazó csomagok " "esetében a dokumentációt közvetlenül a docs/reference mappában " "is elhelyezhetjük. Nem kötelező a fenti gyakorlatot használni, de ha más " "könyvtárszerkezet használatát választja, akkor a könyvtárszerkezetnek " "megfelelően kell beállítania az összeállítási rendszer beállításait." #. (itstool) path: example/title #: C/index.docbook:509 msgid "Example directory structure of meep project" msgstr "A meep projekt könyvtárszerkezeti példája" #. (itstool) path: example/programlisting #: C/index.docbook:511 #, 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/ # hivatkozási dokumentáció\n" " libmeep/\n" " meeper/\n" " help/ # elhagyható: felhasználói kézikönyv\n" " meeper/\n" " src/\n" " libmeep/\n" " meeper/\n" #. (itstool) path: sect1/para #: C/index.docbook:503 msgid "" "In the following sections we will assume a directory structure for our " "meep project that uses the above conventions. " "<_:example-1/>" msgstr "" "A következő szakaszokban olyan könyvtárszerkezetet feltételezünk a " "meep projektünkhöz, amely a fenti gyakorlatokat " "használja. <_:example-1/>" #. (itstool) path: sect1/title #: C/index.docbook:528 msgid "Integration with Autotools" msgstr "Integráció az Autotools programmal" #. (itstool) path: sect1/para #: C/index.docbook:529 msgid "" "Integration of GTK-Doc into an autotools-based build system requires the " "following steps:" msgstr "" "A GTK-Doc integrálása egy autotools alapú összeállítási rendszerbe a " "következő lépéseket igényli:" #. (itstool) path: listitem/para #: C/index.docbook:535 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 "" "Győződjön meg arról, hogy a gtkdocize egyszer " "lefusson a configure parancsfájl előtt. Ha egy " "autogen.sh parancsfájl is jelen van, akkor állítsa be " "úgy, hogy ellenőrizze a GTK-Doc eszközt, és adjon hozzá egy " "gtkdocize hívást." #. (itstool) path: listitem/para #: C/index.docbook:543 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 "" "A gtkdocize fő célja, hogy elkészítse az " "összeállítási rendszerhez elérhető gtk-doc.make " "Makefile-t és gtk-doc.m4 makródefiníciós fájlt a " "projektbe történő másolással vagy a projekthez történő kapcsolással." #. (itstool) path: listitem/para #: C/index.docbook:552 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 "" "Adja hozzá a szükséges autoconf makrókat a " "configure.ac fájlhoz, hogy engedélyezze a GTK-Doc " "eszközt az összeállítási rendszerben a GTK-Doc beállításainak az előállított " "configure parancsfájl általi engedélyezéséhez." #. (itstool) path: listitem/para #: C/index.docbook:558 msgid "" "Among others with registers the --enable-gtk-doc option with " "the configure script." msgstr "" "Többek között a --enable-gtk-doc kapcsoló regisztrálásával a " "configure parancsfájlban." #. (itstool) path: listitem/para #: C/index.docbook:564 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 "" "Hozzon létre egy automake parancsfájlt a projekt " "minden egyes alkalmazásához vagy programkönyvtárához. Az ebben a " "dokumentációban használt példában ez a lépés mind a meeper " "alkalmazásra, mind a libmeep programkönyvtárra vonatkozik." #. (itstool) path: sect1/para #: C/index.docbook:573 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 "" "A következő szakaszokban a fenti lépéseket fordított sorrendben hajtjuk " "végre. Az automake parancsfájlokkal kezdjük, és " "folytatjuk a munkát a configure.ac és " "autogen.sh parancsfájlokig. Ezután megmutatjuk, hogyan " "engedélyezzük a GTK-Doc használatát az összeállítási rendszerben, és hogyan " "állítsuk össze a dokumentációt." #. (itstool) path: sect2/title #: C/index.docbook:583 msgid "Integration with automake" msgstr "Integráció az automake programmal" #. (itstool) path: sect2/para #: C/index.docbook:585 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 "" "Először másolja át a Makefile.am fájlt a gtkdoc-sources examples alkönyvtárából a projektje hivatkozási dokumentációs könyvtárába " "(például docs/reference/<csomag>). Egy helyi másolatnak az /usr/share/doc/gtk-doc-tools/" "examples/Makefile.am alatt kell elérhetőnek lennie. Ha több " "csomagja van, akkor ezt ismételje meg mindegyiknél." #. (itstool) path: note/simpara #: C/index.docbook:598 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 "" "Ne felejtsen el hozzáadni minden Makefile.am fájlt az " "AC_CONFIG_FILES makróhoz a configure.ac fájlban. A docs/reference/libmeep/Makefile.am " "esetén a docs/reference/libmeep/Makefile bejegyzést " "kell hozzáadnia az AC_CONFIG_FILES makróhoz." #. (itstool) path: example/title #: C/index.docbook:610 msgid "Example directory structure with Makefiles.am" msgstr "Könyvtárszerkezeti példa a Makefile.am fájlokkal" #. (itstool) path: example/programlisting #: C/index.docbook:613 #, 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/ # hivatkozási dokumentáció\n" " libmeep/\n" " Makefile.am\n" " meeper/\n" " Makefile.am\n" " help/ # elhagyható: felhasználói kézikönyv\n" " meeper/\n" " src/\n" " libmeep/\n" " meeper/\n" #. (itstool) path: sect2/para #: C/index.docbook:629 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 "" "Ezután személyre kell szabnia a lemásolt Makefile-okat, és meg kell adnia a " "különböző paraméterek értékeit az egyes Makefile.am " "fájlokban. Az összes beállítás fölött található egy megjegyzés, amely leírja " "a céljukat és a beállítás személyre szabását. A legtöbb beállítás arra " "szolgál, hogy további jelzőket adjon azokhoz az eszközökhöz, amelyekre " "vonatkozik. Minden eszköz rendelkezik egy