Date: Sat, 20 Dec 2008 14:16:24 GMT From: Gabor Pali <pgj@FreeBSD.org> To: Perforce Change Reviews <perforce@FreeBSD.org> Subject: PERFORCE change 155054 for review Message-ID: <200812201416.mBKEGOms038034@repoman.freebsd.org>
next in thread | raw e-mail | index | archive | help
http://perforce.freebsd.org/chv.cgi?CH=155054 Change 155054 by pgj@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@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@example.com</email></address> + <address><email>]]>ize@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@example.com</email></address> + <address><email>ize@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>
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?200812201416.mBKEGOms038034>