PERFORCE change 155054 for review
Gabor Pali
pgj at FreeBSD.org
Sat Dec 20 06:16:24 PST 2008
http://perforce.freebsd.org/chv.cgi?CH=155054
Change 155054 by pgj at kolbasz on 2008/12/20 14:15:25
Add Hungarian translation of appendix "Examples" from FDP
Primer. Translation finished. Heh!
Affected files ...
.. //depot/projects/docproj_hu/doc/hu_HU.ISO8859-2/books/fdp-primer/examples/appendix.sgml#2 edit
Differences ...
==== //depot/projects/docproj_hu/doc/hu_HU.ISO8859-2/books/fdp-primer/examples/appendix.sgml#2 (text+ko) ====
@@ -31,34 +31,54 @@
-->
<!-- The FreeBSD Hungarian Documentation Project
+ Translated by: PALI, Gabor <pgj at FreeBSD.org>
%SOURCE% en_US.ISO8859-1/books/fdp-primer/examples/appendix.sgml
%SRCID% 1.17
-->
<appendix id="examples" lang="hu">
- <title>Examples</title>
+ <title>Példatár</title>
- <para>This appendix contains example SGML files and command lines you can
- use to convert them from one output format to another. If you have
- successfully installed the Documentation Project tools then you should
- be able to use these examples directly.</para>
+ <para>Ebben a függelékben bemutatunk néhány
+ minta SGML forrást, illetve azokat a parancsokat, amelyekkel
+ egyik formátumból a másikba lehet ezeket
+ alakítani. Amennyiben sikeresen telepítettük
+ rendszerünkre a Dokumentációs Projektben
+ használt segédprogramokat, akkor az itt megadott minta
+ forrásokat akár közvetlenül is fel tudjuk
+ használni.</para>
- <para>These examples are not exhaustive—they do not contain all the
- elements you might want to use, particularly in your document's front
- matter. For more examples of DocBook markup you should examine the SGML
- source for this and other documents, available in the
- <application>CVSup</application> <literal>doc</literal> collection, or
- available online starting at
- <ulink url="http://www.FreeBSD.org/cgi/cvsweb.cgi/doc/"></ulink>.</para>
+ <para>A mintáképp mellékelt források nem
+ fednek le mindent — nem tartalmazzák az összes
+ korábban ismertetett elemet, és
+ egyáltalán nem térnek ki a rövidebb
+ részek, például bevezetés,
+ elõszó,
+ köszönetnyilvánítás stb.
+ jelölésére. Ha konkrét
+ jelölési megoldásokra lenne
+ szükségünk, akkor kérjük le a
+ repositoryból a <literal>doc</literal>
+ <application>CVSup</application> gyûjteményt, és
+ nézzük át a benne szereplõ SGML
+ forrásokat, vagy böngésszük ezeket
+ közvetlenül a <ulink
+ url="http://www.FreeBSD.org/cgi/cvsweb.cgi/doc/"></ulink> honlapon
+ keresztül.</para>
- <para>To avoid confusion, these examples use the standard DocBook 4.1 DTD
- rather than the FreeBSD extension. They also use the stock stylesheets
- distributed by Norm Walsh, rather than any customizations made to those
- stylesheets by the FreeBSD Documentation Project. This makes them more
- useful as generic DocBook examples.</para>
+ <para>A félreértések elkerülése
+ végett ezek a példák a szabvány DocBook
+ 4.1 DTD szerint íródtak, mellõzik a &os;
+ kiterjesztéseit. Ugyanúgy nem
+ építkeznek a &os; Dokumentációs Projekt
+ által módosított stíluslapokra sem,
+ hanem a Norm Walsh eredetileg kiadott stíluslapjait
+ használják. Ennek köszönhetõen
+ általános DocBook mintáknak is
+ tekinthetõek.</para>
<sect1 id="examples-docbook-book">
- <title>DocBook <sgmltag>book</sgmltag></title>
+ <title>DocBook könyv, a <sgmltag>book</sgmltag> elem</title>
<example>
<title>DocBook <sgmltag>book</sgmltag></title>
@@ -67,42 +87,43 @@
<book>
<bookinfo>
- <title>An Example Book</title>
-
+ <title>]]>Könyvminta<![ CDATA [</title>
+
<author>
- <firstname>Your first name</firstname>
- <surname>Your surname</surname>
+ <surname>]]>Vezetéknév<![ CDATA [</surname>
+ <firstname>]]>Keresztnév<![ CDATA [</firstname>
<affiliation>
- <address><email>foo at example.com</email></address>
+ <address><email>]]>ize at minta.hu<![ CDATA [</email></address>
</affiliation>
</author>
<copyright>
- <year>2000</year>
- <holder>Copyright string here</holder>
+ <year>2008</year>
+ <holder>]]>A copyright szövege<![ CDATA [</holder>
</copyright>
<abstract>
- <para>If your book has an abstract then it should go here.</para>
+ <para>]]>Ha tartozik a könyvhöz rövid tartalmi összefoglaló
+ (absztrakt), akkor azt ide írjuk.<![ CDATA [</para>
</abstract>
</bookinfo>
<preface>
- <title>Preface</title>
+ <title>]]>Elõszó<![ CDATA [</title>
- <para>Your book may have a preface, in which case it should be placed
- here.</para>
+ <para>]]>A könyvhöz tartozhat elõszó is, amelyet itt kell
+ szerepeltetnünk.<![ CDATA [</para>
</preface>
-
+
<chapter>
- <title>My first chapter</title>
+ <title>]]>Elsõ fejezet<![ CDATA [</title>
- <para>This is the first chapter in my book.</para>
+ <para>]]>Ez a könyv elsõ fejezetének tartalma.<![ CDATA [</para>
<sect1>
- <title>My first section</title>
+ <title>]]>Az elsõ szakasz<![ CDATA [</title>
- <para>This is the first section in my book.</para>
+ <para>]]>Ez a könyv elsõ szakasza.<![ CDATA [</para>
</sect1>
</chapter>
</book>]]></programlisting>
@@ -110,7 +131,7 @@
</sect1>
<sect1 id="examples-docbook-article">
- <title>DocBook <sgmltag>article</sgmltag></title>
+ <title>DocBook cikk, az <sgmltag>article</sgmltag> elem</title>
<example>
<title>DocBook <sgmltag>article</sgmltag></title>
@@ -119,230 +140,301 @@
<article>
<articleinfo>
- <title>An example article</title>
+ <title>]]>Cikkminta<![ CDATA [</title>
<author>
- <firstname>Your first name</firstname>
- <surname>Your surname</surname>
+ <surname>]]>Vezetéknév<![ CDATA [</surname>
+ <firstname>]]>Keresztnév<![ CDATA [</firstname>
<affiliation>
- <address><email>foo at example.com</email></address>
+ <address><email>ize at minta.hu</email></address>
</affiliation>
</author>
<copyright>
- <year>2000</year>
- <holder>Copyright string here</holder>
+ <year>2008</year>
+ <holder>]]>A copyright szövege<![ CDATA [</holder>
</copyright>
<abstract>
- <para>If your article has an abstract then it should go here.</para>
+ <para>]]>Ha tartozik a cikkhez rövid tartalmi összefoglalás
+ (absztrakt), akkor annak ide kell kerülnie.<![ CDATA [</para>
</abstract>
</articleinfo>
<sect1>
- <title>My first section</title>
+ <title>]]>Elsõ szakasz<![ CDATA [</title>
- <para>This is the first section in my article.</para>
+ <para>]]>Ez a cikk elsõ szakasza.<![ CDATA [</para>
<sect2>
- <title>My first sub-section</title>
+ <title>]]>Elsõ alszakasz<![ CDATA [</title>
- <para>This is the first sub-section in my article.</para>
- </sect2>
+ <para>]]>Ez a cikk elsõ alszakasza.<![ CDATA [</para>
+ </sect2>
</sect1>
</article>]]></programlisting>
</example>
</sect1>
<sect1 id="examples-formatted">
- <title>Producing formatted output</title>
+ <title>A formázott kimenet
+ elõállítása</title>
- <para>This section assumes that you have installed the software listed in
- the <filename role="package">textproc/docproj</filename> port, either by hand, or by
- using the port. Further, it is assumed that your software is installed
- in subdirectories under <filename>/usr/local/</filename>, and the
- directory where binaries have been installed is in your
- <envar>PATH</envar>. Adjust the paths as necessary for your
- system.</para>
+ <para>Ebben a szakaszban feltételezzük, hogy már
+ vagy kézzel vagy pedig a hozzátartozó port
+ segítségével telepítettük a
+ <filename
+ role="package">textproc/docproj</filename> portban szereplõ
+ segédeszközöket. Emellett továbbá
+ még feltesszük, hogy az összes eszközt a
+ <filename class="directory">/usr/local</filename>
+ könyvtár alá telepítettük és
+ a binárisok elérési útvonala
+ része a <envar>PATH</envar> környezeti
+ változónak. Amennyiben ezektõl a
+ feltételezésektõl valamilyen módon
+ eltértünk, akkor a példákat
+ értelemszerûen a saját környezetünkre
+ alkalmazva kell végrehajtani.</para>
<sect2>
- <title>Using Jade</title>
+ <title>A Jade használata</title>
<example>
- <title>Converting DocBook to HTML (one large file)</title>
-
+ <title>DocBook forrás átalakítása
+ HTML formátumúra (egyetlen nagy
+ állomány)</title>
+
<screen>&prompt.user; <userinput>jade -V nochunks \ <co id="examples-co-jade-1-nochunks">
-c /usr/local/share/sgml/docbook/dsssl/modular/catalog \ <co id="examples-co-jade-1-catalog">
-c /usr/local/share/sgml/docbook/catalog \
-c /usr/local/share/sgml/jade/catalog \
-d /usr/local/share/sgml/docbook/dsssl/modular/html/docbook.dsl \<co id="examples-co-jade-1-dsssl">
- -t sgml <co id="examples-co-jade-1-transform"> file.sgml > file.html <co id="examples-co-jade-1-filename"></userinput></screen>
+ -t sgml <co id="examples-co-jade-1-transform"> <replaceable>állomány</replaceable>.sgml > <replaceable>állomány</replaceable>.html <co id="examples-co-jade-1-filename"></userinput></screen>
<calloutlist>
<callout arearefs="examples-co-jade-1-nochunks">
- <para>Specifies the <literal>nochunks</literal> parameter to the
- stylesheets, forcing all output to be written to
- <abbrev>STDOUT</abbrev> (using Norm Walsh's stylesheets).</para>
+ <para>A <literal>nochunks</literal> paramétert adja
+ át a stíluslapoknak és az
+ eredményt a szabványos kimenetre
+ irányítattja át (Norm Walsh
+ stíluslapjait használjuk).</para>
</callout>
<callout arearefs="examples-co-jade-1-catalog">
- <para>Specifies the catalogs that Jade will need to process.
- Three catalogs are required. The first is a catalog that
- contains information about the DSSSL stylesheets. The second
- contains information about the DocBook DTD. The third contains
- information specific to Jade.</para>
+ <para>Megadjuk a <application>Jade</application>
+ által feldolgozandó katalógusokat. Itt
+ három katalógust kell megadni. Az elsõ
+ katalógus a DSSSL stíluslapok, a
+ második a DocBook DTD és a harmadik a
+ <application>Jade</application> számára
+ tartalmaz információkat.</para>
</callout>
<callout arearefs="examples-co-jade-1-dsssl">
- <para>Specifies the full path to the DSSSL stylesheet that Jade
- will use when processing the document.</para>
+ <para>A <application>Jade</application> a dokumentum
+ feldolgozásához az itt megadott DSSSL
+ stíluslapot fogja felhasználni.</para>
</callout>
<callout arearefs="examples-co-jade-1-transform">
- <para>Instructs Jade to perform a
- <emphasis>transformation</emphasis> from one DTD to another. In
- this case, the input is being transformed from the DocBook DTD
- to the HTML DTD.</para>
+ <para>A <application>Jade</application> itt kap
+ utasítást arra, hogy az egyik DTD-ból a
+ másikba <emphasis>alakítsa
+ át</emphasis> a dokumentumot. Ebben a
+ példában most a DocBook DTD-ból
+ alakítunk át a HTML DTD-ba.</para>
</callout>
<callout arearefs="examples-co-jade-1-filename">
- <para>Specifies the file that Jade should process, and redirects
- output to the specified <filename>.html</filename> file.</para>
+ <para>Megadjuk a feldolgozandó
+ állományt a <application>Jade</application>
+ számára és
+ átirányítjuk a kimenetet egy
+ <filename>.html</filename> kiterjesztésû
+ állományba.</para>
</callout>
</calloutlist>
</example>
<example>
- <title>Converting DocBook to HTML (several small files)</title>
-
+ <title>DocBook forrás átalakítása
+ HTML formátumúra (több kisebb
+ állomány)</title>
+
<screen>&prompt.user; <userinput>jade \
-c /usr/local/share/sgml/docbook/dsssl/modular/catalog \ <co id="examples-co-jade-2-catalog">
-c /usr/local/share/sgml/docbook/catalog \
-c /usr/local/share/sgml/jade/catalog \
-d /usr/local/share/sgml/docbook/dsssl/modular/html/docbook.dsl \<co id="examples-co-jade-2-dsssl">
- -t sgml <co id="examples-co-jade-2-transform"> <replaceable>file</replaceable>.sgml <co id="examples-co-jade-2-filename"></userinput></screen>
+ -t sgml <co id="examples-co-jade-2-transform"> <replaceable>állomány</replaceable>.sgml <co id="examples-co-jade-2-filename"></userinput></screen>
<calloutlist>
<callout arearefs="examples-co-jade-2-catalog">
- <para>Specifies the catalogs that Jade will need to process.
- Three catalogs are required. The first is a catalog that
- contains information about the DSSSL stylesheets. The second
- contains information about the DocBook DTD. The third contains
- information specific to Jade.</para>
+ <para>Megadjuk a <application>Jade</application>
+ által feldolgozandó katalógusokat. Itt
+ három katalógust kell megadni. Az elsõ
+ katalógus a DSSSL stíluslapok, a
+ második a DocBook DTD és a harmadik a
+ <application>Jade</application> számára
+ tartalmaz információkat.</para>
</callout>
<callout arearefs="examples-co-jade-2-dsssl">
- <para>Specifies the full path to the DSSSL stylesheet that Jade
- will use when processing the document.</para>
+ <para>A <application>Jade</application> a dokumentum
+ feldolgozásához az itt megadott DSSSL
+ stíluslapot fogja felhasználni.</para>
</callout>
<callout arearefs="examples-co-jade-2-transform">
- <para>Instructs Jade to perform a
- <emphasis>transformation</emphasis> from one DTD to another. In
- this case, the input is being transformed from the DocBook DTD
- to the HTML DTD.</para>
+ <para>A <application>Jade</application> itt kap
+ utasítást arra, hogy az egyik DTD-ból a
+ másikba <emphasis>alakítsa
+ át</emphasis> a dokumentumot. Ebben a
+ példában most a DocBook DTD-ból
+ alakítunk át a HTML DTD-ba.</para>
</callout>
<callout arearefs="examples-co-jade-2-filename">
- <para>Specifies the file that Jade should process. The
- stylesheets determine how the individual HTML files will be
- named, and the name of the <quote>root</quote> file (i.e., the
- one that contains the start of the document.</para>
+ <para>Megadjuk a feldolgozandó
+ állományt a <application>Jade</application>
+ számára. A stíluslap fogja majd
+ eldönteni, hogy mi legyen a neve a menet közben
+ keletkezõ egyes HTML állományoknak,
+ illetve a <quote>gyökérnek</quote> (ez az az
+ állomány, ahonnan a dokumentum
+ kezdõdik).</para>
</callout>
</calloutlist>
- <para>This example may still only generate one HTML file, depending on
- the structure of the document you are processing, and the
- stylesheet's rules for splitting output.</para>
+ <para>Elõfordulhat, hogy ez a parancs szintén csak
+ egyetlen HTML állományt generál. Ez
+ függ a feldolgozandó dokumentum
+ szerkezetétõl és a stíluslap
+ feldarabolást vezérlõ
+ szabályaitól.</para>
</example>
<example id="examples-docbook-postscript">
- <title>Converting DocBook to Postscript</title>
+ <title>DocBook forrás átalakítása
+ Postscript formátumúra</title>
- <para>The source SGML file must be converted to a &tex; file.</para>
+ <para>Az SGML forrást &tex;
+ állománnyá akarjuk alakítani.</para>
- <screen>&prompt.user; <userinput>jade -Vtex-backend \ <co id="examples-co-jade-3-tex-backend">
+ <screen>&prompt.user; <userinput>jade -V tex-backend \ <co id="examples-co-jade-3-tex-backend">
-c /usr/local/share/sgml/docbook/dsssl/modular/catalog \ <co id="examples-co-jade-3-catalog">
-c /usr/local/share/sgml/docbook/catalog \
-c /usr/local/share/sgml/jade/catalog \
-d /usr/local/share/sgml/docbook/dsssl/modular/print/docbook.dsl \<co id="examples-co-jade-3-dsssl">
- -t tex <co id="examples-co-jade-3-tex"> <replaceable>file</replaceable>.sgml</userinput></screen>
+ -t tex <co id="examples-co-jade-3-tex"> <replaceable>állomány</replaceable>.sgml</userinput></screen>
<calloutlist>
<callout arearefs="examples-co-jade-3-tex-backend">
- <para>Customizes the stylesheets to use various options
- specific to producing output for &tex;.</para>
+ <para>Felparaméterezzük a stíluslapot a
+ &tex; formátumú kimenet
+ elõállításához.</para>
</callout>
-
+
<callout arearefs="examples-co-jade-3-catalog">
- <para>Specifies the catalogs that Jade will need to process. Three
- catalogs are required. The first is a catalog that contains
- information about the DSSSL stylesheets. The second contains
- information about the DocBook DTD. The third contains
- information specific to Jade.</para>
+ <para>Megadjuk a <application>Jade</application>
+ által feldolgozandó katalógusokat. Itt
+ három katalógust kell megadni. Az elsõ
+ katalógus a DSSSL stíluslapok, a
+ második a DocBook DTD és a harmadik a
+ <application>Jade</application> számára
+ tartalmaz információkat.</para>
</callout>
<callout arearefs="examples-co-jade-3-dsssl">
- <para>Specifies the full path to the DSSSL stylesheet that
- Jade will use when processing the document.</para>
+ <para>A <application>Jade</application> a dokumentum
+ feldolgozásához az itt megadott DSSSL
+ stíluslapot fogja felhasználni.</para>
</callout>
<callout arearefs="examples-co-jade-3-tex">
- <para>Instructs Jade to convert the output to &tex;.</para>
+ <para>Megadjuk a <application>Jade</application>
+ számára, hogy &tex; formátumú
+ kimenetet készítsen.</para>
</callout>
</calloutlist>
- <para>The generated <filename>.tex</filename> file must now be run
- through <command>tex</command>, specifying the
- <literal>&jadetex</literal> macro package.</para>
-
- <screen>&prompt.user; <userinput>tex "&jadetex" <replaceable>file</replaceable>.tex</userinput></screen>
+ <para>Az így keletkezõ <filename>.tex</filename>
+ kiterjesztésû állomány aztán a
+ <literal>&jadetex</literal> makrócsomaggal
+ együtt átadható bemenetként a
+ <command>tex</command> parancsnak.</para>
+
+ <screen>&prompt.user; <userinput>tex "&jadetex" <replaceable>állomány</replaceable>.tex</userinput></screen>
+
+ <para>A <command>tex</command> parancsot
+ <emphasis>legalább</emphasis> háromszor le kell
+ futtatni. Elõször feldolgozza a dokumentumot,
+ és szétválogatja az egyes részeit,
+ hogy meg tudja állapítani részeit
+ hivatkoztuk valahonnan máshonnan, hogyan indexelje
+ stb.</para>
+
+ <para>Ha ebben a fázbisban különbözõ
+ figyelmeztetéseket látunk, mint
+ például <errorname>LaTeX Warning: Reference
+ `136' on page 5 undefined on input line 728.</errorname>,
+ akkor még ilyenkor ne foglalkozzunk
+ különösebben velük.</para>
+
+ <para>A második futtatás során újra
+ feldolgozza a dokumentumot a korábbi
+ feldolgozásból származó bizonyos
+ elõismeretek (például a dokumentum
+ oldalszámának) alapján. Ekkor az indexek
+ és a kereszthivatkozások már gond
+ nélkül feloldhatóak.</para>
- <para>You have to run <command>tex</command> <emphasis>at
- least</emphasis> three times. The first run processes the
- document, and determines areas of the document which are referenced
- from other parts of the document, for use in indexing, and so
- on.</para>
+ <para>A harmadik menetben elvégzi az utolsó
+ simításokat, amennyiben szükség van
+ rájuk.</para>
- <para>Do not be alarmed if you see warning messages such as
- <literal>LaTeX Warning: Reference `136' on page 5 undefined on input
- line 728.</literal> at this point.</para>
-
- <para>The second run reprocesses the document now that certain pieces
- of information are known (such as the document's page length). This
- allows index entries and other cross-references to be fixed
- up.</para>
+ <para>Ebben a fázisban egy
+ <filename><replaceable>állomány</replaceable>.dvi</filename>
+ alakú eredményt kapunk.</para>
- <para>The third pass performs any final cleanup necessary.</para>
-
- <para>The output from this stage will be
- <filename><replaceable>file</replaceable>.dvi</filename>.</para>
-
- <para>Finally, run <command>dvips</command> to convert the
- <filename>.dvi</filename> file to Postscript.</para>
+ <para>Végezetül az imént kapott
+ <filename>.dvi</filename> állomány Postscript
+ formátumúra alakításához
+ futtassuk le a <command>dvips</command> parancsot:</para>
- <screen>&prompt.user; <userinput>dvips -o <replaceable>file</replaceable>.ps <replaceable>file.dvi</replaceable></userinput></screen>
+ <screen>&prompt.user; <userinput>dvips -o <replaceable>állomány</replaceable>.ps <replaceable>állomány.dvi</replaceable></userinput></screen>
</example>
<example>
- <title>Converting DocBook to PDF</title>
+ <title>DocBook forrás átalakítása
+ PDF formátumúra</title>
- <para>The first part of this process is identical to that when
- converting DocBook to Postscript, using the same
- <command>jade</command> command line (<xref
- linkend="examples-docbook-postscript">).</para>
+ <para>A feldolgozási folyamat elsõ része
+ hasonló ahhoz, amikor DocBook forrásból
+ akarunk Postscript formátumú
+ állományt készíteni, tehát
+ elegendõ a <command>jade</command> parancsot az
+ elõbb megadott paraméterekkel meghívni
+ (lásd <xref linkend="examples-docbook-postscript">).</para>
- <para>When the <filename>.tex</filename> file has been generated you
- run pdfTeX. However, use the &pdfjadetex macro package
- instead.</para>
+ <para>Amikor viszont megkaptuk a <filename>.tex</filename>
+ állományt, akkor a
+ <application>pdfTeX</application> programot futtassuk le
+ rá. Ügyeljünk arra, hogy ekkor már a
+ <literal>&pdfjadetex</literal> makrócsomagot kell
+ használnunk:</para>
- <screen>&prompt.user; <userinput>pdftex "&pdfjadetex" <replaceable>file</replaceable>.tex</userinput></screen>
+ <screen>&prompt.user; <userinput>pdftex "&pdfjadetex" <replaceable>állomány</replaceable>.tex</userinput></screen>
- <para>Again, run this command three times.</para>
+ <para>Ebben az esetben is háromszor kell lefuttatnunk a
+ parancsot.</para>
- <para>This will generate
- <filename><replaceable>file</replaceable>.pdf</filename>, which does
- not need to be processed any further.</para>
+ <para>Ennek eredményeképpen aztán
+ végül elõáll egy további
+ feldolgozást már nem igénylõ
+ <filename><replaceable>állomány</replaceable>.pdf</filename>
+ állomány.</para>
</example>
</sect2>
</sect1>
More information about the p4-projects
mailing list