.\" -*- coding: UTF-8 -*- .\" Process this file with .\" groff -man -Tascii linuxdoc.1 .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH LINUXDOC 1 "27 iulie 2000" .SH NUME linuxdoc \- convertor de LinuxDoc DTD SGML în alt format de ieșire .SH SINOPSIS \fBlinuxdoc\fP \fB\-\-backend=\fP\fIformat\fP .br \fB\-\-papersize=\fP\fIdimensiune\fP \fB\-\-language=\fP\fIlimbă\fP \fB\-\-charset=\fP\fIset\-caractere\fP \fB\-\-style=\fP\fIfișier\fP \fB\-\-debug\fP \fB\-\-define\fP\fI\ atribut=valoare\fP \fB\-\-include\fP\fI\ entitate\fP \fB[opțiuni\-procesor...]\fP \fIfișier(.sgml)\fP .PP sau (utilizarea veche, învechită) .br \fBsgmlxxxx [opțiuni\-generice...] [opțiuni\-procesor...] \ \ \fP\fIfișier(.sgml)\fP .SH DESCRIERE Suita \fBlinuxdoc\fP este o colecție de formatatori de text care înțelege un fișier sursă LinuxDoc DTD SGML. Fiecare formatator (sau „procesor”) redă fișierul sursă într\-o varietate de formate de ieșire, inclusiv HTML, TeX, DVI, PostScript, text simplu și sursa \fBgroff\fP(1) în format de pagină manuală. Suita linuxdoc este furnizată pentru compatibilitate retroactivă, deoarece există încă multe documente utile scrise în sursa LinuxDoc DTD sgml. .LP Limbajele de marcaje acceptate de aceste formatoare sunt descrise în \fILinuxdoc\-Tools\fP User's \fIGuide\fP. Acestea sunt variante ale unei definiții a tipului de document SGML concepute inițial de Matt Welsh pentru documentația Linux. .SH "OPȚIUNI GENERICE" Majoritatea opțiunilor din linia de comandă sunt acceptate de toate procesoarele. Unele procesoare au opțiuni specifice suplimentare pentru a controla redarea în formatul de ieșire specific. Iată care sunt opțiunile comune: .IP "\-\-backend=\fIformat\fP, \-B" Stabilește procesorul pentru formatul specificat. Valoarea implicită este că nu se utilizează niciun format real, ci doar se afișează utilizarea acestei suite. Formatele disponibile sunt: html, info, latex, lyx, rtf, txt, check. .IP "\-\-papersize=\fIdimensiune\fP, \-p" Stabilește dimensiunea hârtiei. Valoarea implicită este „a4” (hârtie europeană de 297x210 mm). De asemenea, puteți specifica dimensiunea „letter”. .IP "\-\-language=\fIlimbă\fP, \-l" Specifică limba documentului (acest lucru poate schimba fișierele de stil utilizate pentru formatare de către un procesor). Limba implicită este engleza. Rulați o comandă LinuxDoc\-tools fără argumente pentru a vedea lista codurilor de limbă valabile. .IP "\-\-charset=\fIset\-caractere\fP, \-c" Specifică codificarea caracterelor de ieșire. Valoarea implicită este„ascii” care selectează setul ASCII; puteți specifica „latin” pentru a specifica setul de caractere ISO 8859\-1 (Latin\-1). De asemenea, „nippon” și „euc\-kr” sunt necesare pentru a gestiona fișierul sgml codificat euc\-jp și euc\-kr. Este acceptat și „utf\-8”, deși este doar parțial compatibil. .IP "\-\-style=\fIfișier\fP, \-S" Include o definiție a tipului de document („Document Type Definition”: DTD) auxiliară din „/usr/share/linuxdoc\-tools/dtd”. .IP "\-\-tabsize=\fIn\fP, \-t" Stabilește spațierea tabulatoarelor presupusă pentru generarea documentului de ieșire. Spațierea implicită a tabulatoarelor este 8. .IP "\-\-debug, \-d" Nu șterge fișierele intermediare (cum ar fi fișierele .TeX generate în procesul de creare a unui fișier .dvi sau fișierele .man șterse în procesul de creare a textului simplu). .IP "\-\-define, \-D" Pasează perechi atribut/valoare pentru a fi comparate cu condiționalele „if” și „unless”. Consultați Ghidul utilizatorului pentru o discuție mai amplă despre această caracteristică. Această condiționare este gestionată de comanda «sgmlpre». A se vedea sgmlpre(1), precum și Ghidul utilizatorului. .IP "\-\-include, \-i" Pasează o opțiune „\-i” la \fBnsgmls\fP(1). Aceasta poate fi utilizată pentru includerea condiționată. Pentru detalii, consultați pagina de manual \fBnsgmls\fP(1). .IP "\-\-pass, \-P" Pasează un șir de opțiuni către procesor. Semantica exactă a acestei opțiuni depinde de procesorul folosit și ar trebui să fie explicată în paginile de manual individuale pentru fiecare dintre aceștia. .IP file Fișierul sursă SGML, denumit fie \fIfișier\fP, fie \fIfișier.sgml\fP. .LP Rularea unui procesor fără argumente va face ca acesta să listeze toate opțiunile sale (mesajul de eroare „no filenames given” (niciun nume de fișier nu a fost dat) poate fi ignorat în siguranță în acest caz). Printre procesoarele disponibile se numără (numele din paranteze sunt formele vechi și obsolete): .IP linuxdoc\ \-B\ html\ (sgml2html) convertește în HTML .IP linuxdoc\ \-B\ info\ (sgml2info) convertește în GNU info .IP linuxdoc\ \-B\ lyx\ (sgml2lyx) convertește în macros Lyx .IP linuxdoc\ \-B\ latex\ (sgml2latex) convertește în LaTeX 2e .IP linuxdoc\ \-B\ rtf\ (sgml2rtf) convertește în formatul de text îmbogățit (*.rtf) de la Microsoft .IP linuxdoc\ \-B\ txt\ (sgml2txt) convertește în text simplu sau în marcaje de pagină de manual Unix .LP Există, de asemenea, un instrument de \fBverficare\fP a \fBlinuxdoc\fP (sgmlcheck) disponibil pentru verificarea sintaxei Linuxdoc DTD SGML a surselor de documente fără a genera efectiv o versiune convertită. .SH "CONTROLORI PROCESOARE" Iată descrierea pentru fiecare controlor de procesare: .LP **************************************************** .LP \fBlinuxdoc \-B html \fP (sgml2html) convertește un fișier sursă LinuxDoc DTD SGML în format HTML. Ieșirea va apărea în fișierul de nivel superior \fIfișier.html\fP și \fIfișier\-n.html\fP pentru fiecare secțiune (acțiune implicită, dar poate fi modificată prin opțiune), unde \fIfișier\fP este numele fișierului sursă SGML și \fIn\fP este numele secțiunii. .LP Perechea atribut/valoare „output=html” este definită pentru condiționale. .LP \fBlinuxdoc \-B html\fP acceptă următoarele opțiuni: \fB[\-[\-\-split\fP \fI0|1|2\fP \fB] [\-\-dosnames] [\-\-imagebuttons]\fP \fB[\-\-toc\fP \fI0|1|2\fP \fB]\fP. .LP Semnificațiile acestora sunt: .IP "\-\-split, \-s" La ce nivel se împart documentele sursă. 0 = nu se împart, 1 = se împart pe secțiuni majore, 2 = se împart pe subsecțiuni. .IP "\-\-toc, \-T" La ce nivel se generează cuprinsul („Table of contents”: TOC). 0 = nu se generează niciun cuprins „toc”, 1 = include secțiuni majore(/capitole/părți), 2 = include subsecțiunile. .IP "\-\-dosnames, \-h" Utilizează „.htm” în loc de „.html” ca extensie a fișierului .IP "\-\-imagebuttons, \-I" Utilizează pictogramele de imagine cu săgeți „next” (înainte), „previous” (înapoi) și „contents” (cuprins) incluse în „/usr/share/linuxdoc\-tools” ca butoane de navigare. .IP "\-\-footer, \-F" Folosește fișierul specificat ca subsol de pagină în fiecare fișier html rezultat. Subsolul de pagină implicit este doar text simplu .nh .nf .ad l \en \en .hy .fi .IP "\-\-header, \-H" Utilizează fișierul specificat ca parte superioară a antetului în fiecare fișier html rezultat. Rețineți că aceasta nu este partea completă a antetului. (de exemplu, titlul și legăturile („next” (înainte), „previous” (înapoi) și „contents” (cuprins)) din antetul implicit sunt păstrate. Valoarea implicită este .nh .nf .ad l \en \en \en .hy .fi .LP **************************************************** .LP \fBlinuxdoc \-B info \fP (sgml2info) convertește un fișier sursă LinuxDoc DTD SGML în format GNU info. Rezultatul va apărea în \fIfișier.info\fP, unde \fIfișier\fP este numele fișierului sursă SGML. .LP Perechea atribut/valoare „output=info” este definită pentru condiționale. .LP \fBlinuxdoc \-B info\fP nu are opțiuni specifice pentru procesor. .LP **************************************************** .LP \fBlinuxdoc \-B latex \fP (sgml2latex) convertește un fișier sursă LinuxDoc DTD SGML în LaTeX, utilizând analizatorul \fBnsgmls\fP(1) sau \fBonsgmls\fP(1) și convertorul \fBsgmlsasp\fP(1). Utilizând ieșirea LaTeX și formatorul (procesorul) de text \fBlatex\fP(1), puteți crea apoi o ieșire DVI și o ieșire PostScript utilizând convertorul \fBdvips\fP(1). Rezultatul va apărea în \fIfișier.tex\fP pentru ieșirea LaTeX, \fIfișier.dvi\fP pentru ieșirea DVI sau \fIfișier.ps\fP pentru ieșirea PostScript, unde \fIfișier\fP este numele fișierului sursă SGML. .LP Folosind ieșirea LaTeX și formatorul de text \fBpdflatex\fP(1), puteți crea apoi o ieșire PDF plăcută, potrivită pentru a fi vizualizată cu programe de vizualizare PDF ca \fBxpdf\fP(1), \fBacroread\fP(1) sau \fBghostview\fP(1). .LP Perechea atribut/valoare „output=latex2e” este definită pentru condiționale. .LP \fBlinuxdoc \-B latex\fP acceptă următoarele opțiuni specifice procesorului: \fB[\-\-output=\fP\fItex\fP\fB|\fP\fIdvi\fP\fB|\fP\fIps\fP\fB|\fP\fIpdf]\fP \fB[\-\-bibtex] [\-\-makeindex]\fP \fB[\-\-pagenumber=\fP\fIn\fP\fB]\fP \fB\-\-quick\fP \fB[\-[\- \-latex=\fP\fIlatex\fP\fB|\fP\fIhlatexp\fP\fB|\fP\fIplatex\fP\fB|\fP\fIjlatex]\fP \fB[\-\-dvips=\fP\fIdvips\fP\fB|\fP\fIdvi2ps]\fP \fB[\-\-verbosity=n]\fP \fB[\-\-verbosity=n]\fP .LP Semnificațiile acestora sunt: .IP "\-\-output=\fIformat\fP, \-o" Specifică formatul de ieșire dorit. Specificatorul \fIformat\fP poate fi „tex”, „dvi”, „ps” sau „pdf”. .PP Notă: Această versiune nu suprascrie/elimină fișierele intermediare: fișierul tex pentru ieșirea dvi sau fișierele tex/dvi pentru ieșirea ps. Acesta este un comportament diferit față de versiunea originală SGML\-Tools 1.0.9, așa că sunteți avertizat aici. .IP "\-\-bibtex, \-b" Procesează TeX\-ul generat cu \fBbibtex\fP(1). .IP "\-\-makeindex, \-m" Generează un fișier de index TeX adecvat pentru procesarea cu \fBmakeindex\fP(1) și din etichetele și prezente în sursa SGML. .IP "\-\-pagenumber, \-n" Stabilește numărul paginii de început din fișierul DVI sau PS de ieșire. .IP "\-\-quick, \-q" Efectuează doar o singură trecere de formatare LaTeX. Adesea, acest lucru nu este suficient pentru a produce rezultatul final (din cauza referințelor etc.), dar este util pentru a identifica erorile TeX și problemele de aliniere. .IP "\-\-pass, \-P" Argumentul opțiunii pass este inserat imediat după preambulul LaTeX generat de eticheta document\-type. Specifică formatul de ieșire dorit. Specificatorul \fIformat\fP poate fi „tex”, „dvi”, „ps”, sau „pdf”. .IP "\-\-latex=\fIcomandă_latex_alternativă\fP, \-x" Această opțiune este disponibilă în prezent pentru coreeană și japoneză. \fIcomanda_latex_alternativă\fP. poate fi „latex” (implicit), „hlatexp” (pentru coreeană), „platex” sau „jlatex” (pentru japoneză). Această opțiune poate fi utilizată pentru a reda un document coreean folosind HLaTeXp sau pentru a reda un document japonez folosind pLaTeX/jLaTeX. În caz contrar, trebuie instalat HLaTeX pentru a reda un document coreean. Pe de altă parte, documentul japonez poate fi redat cu jLaTeX (care este opțiunea implicită atunci când este specificată „\-c nippon”), astfel încât, dacă aveți deja jLaTeX, s\-ar putea să nu fie nevoie să instalați pLaTeX. .IP "\-\-dvips=\fIcomandă_dvips_alternativă\fP, \-s" Această opțiune este în prezent pentru japoneză. \fIcomanda_dvips_alternativă\fP poate fi «dvips» sau «dvi2ps». Dacă nu cunoașteți acest lucru, atunci este posibil să nu aveți nevoie de această opțiune. .IP "\-\-verbosity, \-V" Stabilește nivelul de detaliere. „0” (valoarea implicită) va afișa informații despre rularea LaTeX numai în cazul unor erori. „1” va afișa întotdeauna informații despre ultima execuție. „2” va afișa informații pentru toate execuțiile. .LP **************************************************** .LP \fBlinuxdoc \-B lyx \fP (sgml2lyx) convertește un fișier sursă LinuxDoc DTD SGML în LyX. Rezultatul va apărea în \fIfișier.lyx\fP, unde \fIfișier\fP este numele fișierului sursă SGML. .LP Perechea atribut/valoare „output=lyx” este definită pentru condiționale. .LP \fBlinuxdoc \-B lyx\fP nu are opțiuni specifice pentru procesor. .LP **************************************************** .LP \fBlinuxdoc \-B rtf \fP (sgml2rtf) convertește un fișier sursă LinuxDoc DTD SGML în RTF, Rich Text Format utilizat de sistemul de ajutor Microsoft Windows. Rezultatul va apărea în fișierul de nivel superior \fIfișier.rtf\fP și \fIfișier\-n.rtf\fP pentru fiecare secțiune, unde \fIfișier\fP este numele fișierului sursă SGML. Ieșirea RTF este adaptată pentru compilarea de către Windows Help Compiler (hc31.exe). .LP Perechea atribut/valoare „output=rtf” este definită pentru condiționale. .LP \fBlinuxdoc \-B rtf\fP acceptă \fB[\-\-twosplit]\fP ca o opțiune specifică procesorului. În cele ce urmează este semnificația acestei opțiuni: .IP "\-\-twosplit, \-2" Împarte fișierele atât la n. secțiuni, cât și la n.m. subsecțiuni .LP **************************************************** .LP \fBlinuxdoc \-B txt \fP (sgml2txt) convertește un fișier sursă LinuxDoc DTD SGML în format ASCII, ISO\-8859\-1 sau EUC\-JP. Rezultatul va apărea în \fIfișier.txt\fP, unde \fIfișier\fP este numele fișierului sursă SGML. .LP Perechea atribut/valoare „output=txt” este definită pentru condiționale. .LP \fBlinuxdoc \-B txt\fP acceptă următoarele opțiuni de procesor: \fB[\-\-manpage] [\-\-filter] [\-\-blanks=\fP\fIn\fP\fB]\fP .LP Semnificația acestor opțiuni este următoarea: .IP "\-\-manpage, \-m" Produce un fișier sursă groff, potrivit pentru formatare cu \fBgroff \-man\fP pentru pagini de manual .IP "\-\-filter, \-f" Elimină suprapunerile de spații din forma intermediară generată de \fBgroff\fP(1). .IP "\-\-pass, \-P" Argumentul opțiunii pass se adaugă la opțiunile din linia de comandă transmise lui \fBgroff\fP(1). .IP "\-\-blanks=\fIn\fP, \-b" Stabilește limita de linii goale continue pentru generarea documentului de ieșire. Limita implicită este 3. Dacă se specifică 0 (zero), rezultatul are multe linii goale continue. .LP **************************************************** .LP \fBlinuxdoc \-B check \fP (sgmlcheck) execută o analiză SGML pe sursa de document specificată. Eventualele erori sunt raportate la ieșirea standard. Nu se produce nicio versiune formatată a sursei. .LP Rețineți că \fBlinuxdoc \-B check\fP preprocesează sursa LinuxDoc DTD SGML, făcând condiționarea descrisă de orice etichete <#if> și <#unless>. Sursele de documente care conțin aceste etichete vor crea confuzie într\-un analizator SGML independent. \fBlinuxdoc \-B check\fP nu are opțiuni specifice pentru procesor. **************************************************** .SH FIȘIERE Sunt utilizate multe fișiere și executabile din /usr/share/linuxdoc\-tools și /usr/bin. .SH ERORI Poate că au mai rămas câteva. Nu ezitați să trimiteți un raport la actualul responsabil cu menținerea. .SH RESPONSABIL Acesta a fost întreținut de Cees de Groot în SGML\-Tools (v1). În prezent este întreținut de Taketoshi Sano pentru Linuxdoc\-Tools. .PP .SH TRADUCERE Traducerea în limba română a acestui manual a fost făcută de Remus-Gabriel Chelu . .PP Această traducere este documentație gratuită; citiți .UR https://www.gnu.org/licenses/gpl-3.0.html Licența publică generală GNU Versiunea 3 .UE sau o versiune ulterioară cu privire la condiții privind drepturile de autor. NU se asumă NICIO RESPONSABILITATE. .PP Dacă găsiți erori în traducerea acestui manual, vă rugăm să trimiteți un e-mail la .MT translation-team-ro@lists.sourceforge.net .ME .