diff options
Diffstat (limited to 'hu_HU.ISO8859-2/books/fdp-primer/doc-build/chapter.xml')
| -rw-r--r-- | hu_HU.ISO8859-2/books/fdp-primer/doc-build/chapter.xml | 110 |
1 files changed, 54 insertions, 56 deletions
diff --git a/hu_HU.ISO8859-2/books/fdp-primer/doc-build/chapter.xml b/hu_HU.ISO8859-2/books/fdp-primer/doc-build/chapter.xml index 656768384c..70e4a55c4c 100644 --- a/hu_HU.ISO8859-2/books/fdp-primer/doc-build/chapter.xml +++ b/hu_HU.ISO8859-2/books/fdp-primer/doc-build/chapter.xml @@ -30,14 +30,12 @@ $FreeBSD$ --> - <!-- The FreeBSD Hungarian Documentation Project Translated by: PALI, Gabor <pgj@FreeBSD.org> %SOURCE% en_US.ISO8859-1/books/fdp-primer/doc-build/chapter.xml %SRCID% 1.16 --> - -<chapter id="doc-build" lang="hu"> +<chapter xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0" xml:id="doc-build" xml:lang="hu"> <title>A dokumentáció előállításának folyamata</title> @@ -79,7 +77,7 @@ </listitem> </itemizedlist> - <sect1 id="doc-build-toolset"> + <sect1 xml:id="doc-build-toolset"> <title>A &os; dokumentáció előállításának eszközei</title> @@ -134,7 +132,7 @@ </note> </sect1> - <sect1 id="doc-build-makefiles"> + <sect1 xml:id="doc-build-makefiles"> <title>A dokumentációt tároló könyvtárban található <filename>Makefile</filename> állományok</title> @@ -165,12 +163,12 @@ állományok</link> segítik valamilyen formában a dokumentumok előállítását. Többnyire - <filename>doc.<replaceable>xxx</replaceable>.mk</filename> + <filename>doc.xxx.mk</filename> névvel láthatóak.</para> </listitem> </itemizedlist> - <sect2 id="sub-make"> + <sect2 xml:id="sub-make"> <title>Az alkönyvtári <filename>Makefile</filename> állományok</title> @@ -189,41 +187,41 @@ DOC_PREFIX?= ${.CURDIR}/.. <para>Röviden összefoglalva: az első négy nem üres sorban ún. <command>make</command> változókat definiálunk. Ezek rendre a - <makevar>SUBDIR</makevar>, <makevar>COMPAT_SYMLINK</makevar> - és <makevar>DOC_PREFIX</makevar>.</para> + <varname>SUBDIR</varname>, <varname>COMPAT_SYMLINK</varname> + és <varname>DOC_PREFIX</varname>.</para> - <para>Az első <makevar>SUBDIR</makevar> sornál, - illetve a <makevar>COMPAT_SYMLINK</makevar> sorában + <para>Az első <varname>SUBDIR</varname> sornál, + illetve a <varname>COMPAT_SYMLINK</varname> sorában láthatjuk hogyan kell egy új értéket beállítani egy ilyen változónak.</para> - <para>A második <makevar>SUBDIR</makevar> sorban azt + <para>A második <varname>SUBDIR</varname> sorban azt láthatjuk, hogyan tudunk a változó aktuális értékéhez továbbiakat hozzáfűzni. Ebben az esetben tehát az utasítás végrehajtása után a - <makevar>SUBDIR</makevar> értéke <literal>articles + <varname>SUBDIR</varname> értéke <literal>articles books</literal> lesz.</para> - <para>A <makevar>DOC_PREFIX</makevar> esetében pedig olyan + <para>A <varname>DOC_PREFIX</varname> esetében pedig olyan értékadást figyelhetünk meg, amelyik csak akkor hajtódik végre ténylegesen, ha a változónak addig még nem volt értéke. Ez olyankor tud kapóra jönni, - amikor a <makevar>DOC_PREFIX</makevar> nem pontosan az, amire a + amikor a <varname>DOC_PREFIX</varname> nem pontosan az, amire a <filename>Makefile</filename> számít — a felhasználó ekkor meg tudja adni a helyes értéket.</para> <para>Ez így együttesen tehát mit is jelent? A - <makevar>SUBDIR</makevar> összefoglalja azokat a + <varname>SUBDIR</varname> összefoglalja azokat a könyvtárakat, amelyekben a dokumentumok előállításának folyamatának folytatódnia kell majd.</para> - <para>A <makevar>COMPAT_SYMLINK</makevar> a kompatibilitás + <para>A <varname>COMPAT_SYMLINK</varname> a kompatibilitás céljából létrehozott szimbolikus linkekre vonatkozik, amelyek (valamilyen csoda folytán) az adott nyelv hivatalos kódolására @@ -232,13 +230,13 @@ DOC_PREFIX?= ${.CURDIR}/.. <filename>en_US.ISO8859-1</filename> könyvtárra).</para> - <para>A <makevar>DOC_PREFIX</makevar> a &os; + <para>A <varname>DOC_PREFIX</varname> a &os; Dokumentációs Projekt főkönyvtárához vezető utat adja meg. Ezt nem mindig egyszerű megtalálni, ezért a rugalmasság kedvéért könnyedén felül is definiálható. - A <makevar>.CURDIR</makevar> a <command>make</command> egyik + A <varname>.CURDIR</varname> a <command>make</command> egyik saját belső változója, amelyben az aktuális könyvtár elérési útját tárolja.</para> @@ -254,7 +252,7 @@ DOC_PREFIX?= ${.CURDIR}/.. pontos menete.</para> </sect2> - <sect2 id="doc-make"> + <sect2 xml:id="doc-make"> <title>A dokumentumokra vonatkozó <filename>Makefile</filename> állományok</title> @@ -284,17 +282,17 @@ DOC_PREFIX?= ${.CURDIR}/../../.. .include "$(DOC_PREFIX)/share/mk/docproj.docbook.mk"</programlisting> - <para>A <makevar>MAINTAINER</makevar> változó nagyon + <para>A <varname>MAINTAINER</varname> változó nagyon fontos. A &os; Dokumentációs Projekten belül ezen a változón keresztül jelezhetjük a dokumentum birtoklását, vagyis karbantartási kötelezettségünket.</para> - <para>A <makevar>DOC</makevar> hivatkozik (az + <para>A <varname>DOC</varname> hivatkozik (az <filename>.xml</filename> kiterjesztés nélkül) az adott könyvtárban található dokumentum fő - forrására. Emellett az <makevar>SRCS</makevar> + forrására. Emellett az <varname>SRCS</varname> változóban kell összefoglalnunk a dokumentumot alkotó források neveit. Ebben érdemes megadni minden olyan állományt, @@ -302,14 +300,14 @@ DOC_PREFIX?= ${.CURDIR}/../../.. elő kell állítani az érintett dokumentumot.</para> - <para>A <makevar>FORMATS</makevar> + <para>A <varname>FORMATS</varname> segítségével definiáljuk a dokumentum alapértelmezetten előállítandó - formátumait. A <makevar>INSTALL_COMPRESSED</makevar> + formátumait. A <varname>INSTALL_COMPRESSED</varname> változóban a dokumentum elkészítésekor felhasználandó tömörítési formákat adhatjuk meg. - A <makevar>INSTALL_ONLY_COMPRESSED</makevar> + A <varname>INSTALL_ONLY_COMPRESSED</varname> változó alapból üres, de ha adunk neki valamilyen egyéb értéket, akkor a dokumentumoknak csak a tömörített @@ -322,14 +320,14 @@ DOC_PREFIX?= ${.CURDIR}/../../.. szakaszban</link>.</para> </note> - <para>A <makevar>DOC_PREFIX</makevar> változó + <para>A <varname>DOC_PREFIX</varname> változó és az <literal>.include</literal> utasítás a korábbiak alapján már ismerős lehet.</para> </sect2> </sect1> - <sect1 id="make-includes"> + <sect1 xml:id="make-includes"> <title>A &os; Dokumentációs Projekt <filename>.mk</filename> állományai</title> @@ -365,9 +363,9 @@ DOC_PREFIX?= ${.CURDIR}/../../.. <listitem> <para>A <filename>doc.docbook.mk</filename> állomány csak akkor kerül - feldolgozásra, ha a <makevar>DOCFORMAT</makevar> + feldolgozásra, ha a <varname>DOCFORMAT</varname> értéke <literal>docbook</literal> és a - <makevar>DOC</makevar> változónak van + <varname>DOC</varname> változónak van értéke.</para> </listitem> </itemizedlist> @@ -399,11 +397,11 @@ PRI_LANG?= en_US.ISO8859-1 <para>Ha nem állítjuk be a dokumentum <filename>Makefile</filename> állományában, akkor a - <makevar>DOCFORMAT</makevar> és a - <makevar>MAINTAINER</makevar> változók ezen a + <varname>DOCFORMAT</varname> és a + <varname>MAINTAINER</varname> változók ezen a helyen kapnak értéket.</para> - <para>A <makevar>PREFIX</makevar> adja azt a + <para>A <varname>PREFIX</varname> adja azt a könyvtárat, amelyen belül elérhetőek <link linkend="tools">a dokumentáció @@ -412,7 +410,7 @@ PRI_LANG?= en_US.ISO8859-1 A csomagok és portok átlagos használata esetén ez a <filename>/usr/local</filename>.</para> - <para>A <makevar>PRI_LANG</makevar> adja meg azt a nyelvet + <para>A <varname>PRI_LANG</varname> adja meg azt a nyelvet és kódolást, amely a dokumentációt olvasó felhasználó számára @@ -421,7 +419,7 @@ PRI_LANG?= en_US.ISO8859-1 angol.</para> <note> - <para>A <makevar>PRI_LANG</makevar> változó + <para>A <varname>PRI_LANG</varname> változó semmilyen hatással nincs a dokumentumok előállítására. Egyedül a &os; dokumentáció @@ -451,7 +449,7 @@ PRI_LANG?= en_US.ISO8859-1 <para>A következő elágazásban, vagyis az <literal>.if ${DOCFORMAT} == "docbook"</literal> utasításban azt vizsgáljuk meg, hogy a - <makevar>DOCFORMAT</makevar> változó + <varname>DOCFORMAT</varname> változó értéke <literal>"docbook"</literal> vagy sem. Amennyiben a válasz erre igen (vagyis <quote>igaz</quote>), beemeljük a @@ -479,23 +477,23 @@ PRI_LANG?= en_US.ISO8859-1 <itemizedlist> <listitem> - <para>A <makevar>SUBDIR</makevar> tartalmazza azokat az + <para>A <varname>SUBDIR</varname> tartalmazza azokat az alkönyvtárakat, amelyeket a feldolgozás során be kell járnunk.</para> </listitem> <listitem> - <para>A <makevar>ROOT_SYMLINKS</makevar> a + <para>A <varname>ROOT_SYMLINKS</varname> a dokumentáció főkönyvtárából szimbolikusan linkelendő könyvtárak neveit adja meg, amennyiben az adott nyelv (a - <makevar>PRI_LANG</makevar> változó szerint) + <varname>PRI_LANG</varname> változó szerint) az elsődleges.</para> </listitem> <listitem> - <para>A <makevar>COMPAT_SYMLINK</makevar> + <para>A <varname>COMPAT_SYMLINK</varname> változót már korábban bemutattuk <link linkend="sub-make">az alkönyvtári <filename>Makefile</filename> @@ -509,9 +507,9 @@ PRI_LANG?= en_US.ISO8859-1 <title>Célok és makrók</title> <para>A függőségi viszonyokat - <literal><replaceable>cél</replaceable>: - <replaceable>függőség1 - függőség2 ...</replaceable></literal> + <literal>cél: + függőség1 + függőség2 ...</literal> formában írjuk fel, ahol így megmondjuk, hogy a <literal>cél</literal> létrehozásához először milyen @@ -543,7 +541,7 @@ PRI_LANG?= en_US.ISO8859-1 .endfor</programlisting> <para>A fenti kódrészletben tehát a - <maketarget>_SUBDIRUSE</maketarget> most már egy + <buildtarget>_SUBDIRUSE</buildtarget> most már egy <quote>makró</quote> lesz, amely ha megjelenik a függőségek között, akkor a törzsében megadott parancsokat hajtja @@ -560,18 +558,18 @@ PRI_LANG?= en_US.ISO8859-1 fognak lefutni, másrészt nem befolyásolja a jelenleg feldolgozás alatt álló cél nevét tároló - <makevar>.TARGET</makevar> változó + <varname>.TARGET</varname> változó értékét.</para> <programlisting>clean: _SUBDIRUSE rm -f ${CLEANFILES}</programlisting> <para>Ebben a kódrészletben a tehát - <maketarget>clean</maketarget> esetében csak az + <buildtarget>clean</buildtarget> esetében csak az <command>rm -r ${CLEANFILES}</command> parancs lefutása után fog végrehajtódni a - <maketarget>_SUBDIRUSE</maketarget> makró tartalma. - Ennek hatására a <maketarget>clean</maketarget> + <buildtarget>_SUBDIRUSE</buildtarget> makró tartalma. + Ennek hatására a <buildtarget>clean</buildtarget> megy egyre lentebb és lentebb a könyvtárszerkezetben, <emphasis>miközben</emphasis> törli a @@ -583,24 +581,24 @@ PRI_LANG?= en_US.ISO8859-1 <itemizedlist> <listitem> - <para>Az <maketarget>install</maketarget> és a - <maketarget>package</maketarget> célok + <para>Az <buildtarget>install</buildtarget> és a + <buildtarget>package</buildtarget> célok egyaránt folyamatosan haladnak lefelé a könyvtárszerkezetben és az alkönyvtárakban hívják saját maguk tényleges változatát (ezek a - <maketarget>realinstall</maketarget> és - <maketarget>realpackage</maketarget>).</para> + <buildtarget>realinstall</buildtarget> és + <buildtarget>realpackage</buildtarget>).</para> </listitem> <listitem> - <para>A <maketarget>clean</maketarget> + <para>A <buildtarget>clean</buildtarget> eltávolítja a folyamat során keletkezett állományokat (és az előbbiekhez hasonlóan lefele halad a könyvtárszerkezetben). A - <maketarget>cleandir</maketarget> ugyanezt + <buildtarget>cleandir</buildtarget> ugyanezt csinálja, de ha talál a tárgykódokhoz tartozó könyvtárat, akkor azt is törli.</para> @@ -659,13 +657,13 @@ PRI_LANG?= en_US.ISO8859-1 .endfor</programlisting> <para>A fenti kódrészletben ha a - <makevar>SUBDIR</makevar> üres, akkor nem + <varname>SUBDIR</varname> üres, akkor nem történik semmi. Ha viszont egy vagy több elemet is tartalmaz, akkor a <literal>.for</literal> és az <literal>.endfor</literal> között megadott utasítások megismétlődnek minden egyes elem esetén. Ezek értékét a - ciklus belsejében rendre a <makevar>entry</makevar> + ciklus belsejében rendre a <varname>entry</varname> változóban veszi fel.</para> </sect3> </sect2> |