LINUXDOC(1)                 General Commands Manual                LINUXDOC(1)

NUME
       linuxdoc - convertor de LinuxDoc DTD SGML in alt format de ie<?>ire

SINOPSIS
       linuxdoc --backend=format
       --papersize=dimensiune --language=limba --charset=set-caractere
       --style=fi<?>ier --debug --define atribut=valoare --include entitate
       [op<?>iuni-procesor...] fi<?>ier(.sgml)

       sau (utilizarea veche, invechita)
       sgmlxxxx [op<?>iuni-generice...] [op<?>iuni-procesor...]
       fi<?>ier(.sgml)

DESCRIERE
       Suita linuxdoc este o colec<?>ie de formatatori de text care in<?>elege
       un fi<?>ier sursa LinuxDoc DTD SGML. Fiecare formatator (sau
       ,,procesor") reda fi<?>ierul sursa intr-o varietate de formate de
       ie<?>ire, inclusiv HTML, TeX, DVI, PostScript, text simplu <?>i sursa
       groff(1) in format de pagina manuala. Suita linuxdoc este furnizata
       pentru compatibilitate retroactiva, deoarece exista inca multe
       documente utile scrise in sursa LinuxDoc DTD sgml.

       Limbajele de marcaje acceptate de aceste formatoare sunt descrise in
       Linuxdoc-Tools User's Guide.  Acestea sunt variante ale unei
       defini<?>ii a tipului de document SGML concepute ini<?>ial de Matt
       Welsh pentru documenta<?>ia Linux.

OP<?>IUNI GENERICE
       Majoritatea op<?>iunilor din linia de comanda sunt acceptate de toate
       procesoarele. Unele procesoare au op<?>iuni specifice suplimentare
       pentru a controla redarea in formatul de ie<?>ire specific. Iata care
       sunt op<?>iunile comune:

       --backend=format, -B
              Stabile<?>te procesorul pentru formatul specificat. Valoarea
              implicita este ca nu se utilizeaza niciun format real, ci doar
              se afi<?>eaza utilizarea acestei suite. Formatele disponibile
              sunt: html, info, latex, lyx, rtf, txt, check.

       --papersize=dimensiune, -p
              Stabile<?>te dimensiunea hartiei. Valoarea implicita este ,,a4"
              (hartie europeana de 297x210 mm). De asemenea, pute<?>i
              specifica dimensiunea ,,letter".

       --language=limba, -l
              Specifica limba documentului (acest lucru poate schimba
              fi<?>ierele de stil utilizate pentru formatare de catre un
              procesor). Limba implicita este engleza. Rula<?>i o comanda
              LinuxDoc-tools fara argumente pentru a vedea lista codurilor de
              limba valabile.

       --charset=set-caractere, -c
              Specifica codificarea caracterelor de ie<?>ire. Valoarea
              implicita este,,ascii" care selecteaza 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.

       --style=fi<?>ier, -S
              Include o defini<?>ie a tipului de document (,,Document Type
              Definition": DTD) auxiliara din
              ,,/usr/share/linuxdoc-tools/dtd".

       --tabsize=n, -t
              Stabile<?>te spa<?>ierea tabulatoarelor presupusa pentru
              generarea documentului de ie<?>ire.  Spa<?>ierea implicita a
              tabulatoarelor este 8.

       --debug, -d
              Nu <?>terge fi<?>ierele intermediare (cum ar fi fi<?>ierele .TeX
              generate in procesul de creare a unui fi<?>ier .dvi sau
              fi<?>ierele .man <?>terse in procesul de creare a textului
              simplu).

       --define, -D
              Paseaza perechi atribut/valoare pentru a fi comparate cu
              condi<?>ionalele ,,if" <?>i ,,unless". Consulta<?>i Ghidul
              utilizatorului pentru o discu<?>ie mai ampla despre aceasta
              caracteristica. Aceasta condi<?>ionare este gestionata de
              comanda <<sgmlpre>>. A se vedea sgmlpre(1), precum <?>i Ghidul
              utilizatorului.

       --include, -i
              Paseaza o op<?>iune ,,-i" la nsgmls(1). Aceasta poate fi
              utilizata pentru includerea condi<?>ionata. Pentru detalii,
              consulta<?>i pagina de manual nsgmls(1).

       --pass, -P
              Paseaza un <?>ir de op<?>iuni catre procesor. Semantica exacta a
              acestei op<?>iuni depinde de procesorul folosit <?>i ar trebui
              sa fie explicata in paginile de manual individuale pentru
              fiecare dintre ace<?>tia.

       file   Fi<?>ierul sursa SGML, denumit fie fi<?>ier, fie fi<?>ier.sgml.

       Rularea unui procesor fara argumente va face ca acesta sa listeze toate
       op<?>iunile sale (mesajul de eroare ,,no filenames given" (niciun nume
       de fi<?>ier nu a fost dat) poate fi ignorat in siguran<?>a in acest
       caz). Printre procesoarele disponibile se numara (numele din paranteze
       sunt formele vechi <?>i obsolete):

       linuxdoc -B html (sgml2html)
              converte<?>te in HTML

       linuxdoc -B info (sgml2info)
              converte<?>te in GNU info

       linuxdoc -B lyx (sgml2lyx)
              converte<?>te in macros Lyx

       linuxdoc -B latex (sgml2latex)
              converte<?>te in  LaTeX 2e

       linuxdoc -B rtf (sgml2rtf)
              converte<?>te in formatul de text imboga<?>it (*.rtf) de la
              Microsoft

       linuxdoc -B txt (sgml2txt)
              converte<?>te in text simplu sau in marcaje de pagina de manual
              Unix

       Exista, de asemenea, un instrument de verficare a linuxdoc
        (sgmlcheck) disponibil pentru verificarea sintaxei Linuxdoc DTD SGML a
       surselor de documente fara a genera efectiv o versiune convertita.

CONTROLORI PROCESOARE
       Iata descrierea pentru fiecare controlor de procesare:

        ****************************************************

       linuxdoc -B html  (sgml2html) converte<?>te un fi<?>ier sursa LinuxDoc
       DTD SGML in format HTML. Ie<?>irea va aparea in fi<?>ierul de nivel
       superior fi<?>ier.html <?>i fi<?>ier-n.html pentru fiecare sec<?>iune
       (ac<?>iune implicita, dar poate fi modificata prin op<?>iune), unde
       fi<?>ier este numele fi<?>ierului sursa SGML <?>i n este numele
       sec<?>iunii.

       Perechea atribut/valoare ,,output=html" este definita pentru
       condi<?>ionale.

       linuxdoc -B html accepta urmatoarele op<?>iuni: [-[--split 0|1|2 ]
       [--dosnames] [--imagebuttons] [--toc 0|1|2 ].

       Semnifica<?>iile acestora sunt:

       --split, -s
              La ce nivel se impart documentele sursa. 0 = nu se impart, 1 =
              se impart pe sec<?>iuni majore, 2 = se impart pe subsec<?>iuni.

       --toc, -T
              La ce nivel se genereaza cuprinsul (,,Table of contents": TOC).
                0 = nu se genereaza niciun cuprins ,,toc",
                1 = include sec<?>iuni majore(/capitole/par<?>i),
                2 = include subsec<?>iunile.

       --dosnames, -h
              Utilizeaza ,,.htm" in loc de ,,.html" ca extensie a fi<?>ierului

       --imagebuttons, -I
              Utilizeaza pictogramele de imagine cu sage<?>i ,,next"
              (inainte), ,,previous" (inapoi) <?>i ,,contents" (cuprins)
              incluse in ,,/usr/share/linuxdoc-tools" ca butoane de navigare.

       --footer, -F
              Folose<?>te fi<?>ierul specificat ca subsol de pagina in fiecare
              fi<?>ier html rezultat. Subsolul de pagina implicit este doar
              text simplu

               </BODY>\n </HTML>\n

       --header, -H
              Utilizeaza fi<?>ierul specificat ca parte superioara a antetului
              in fiecare fi<?>ier html rezultat. Re<?>ine<?>i ca aceasta nu
              este partea completa a antetului.  (de exemplu, titlul <?>i
              legaturile (,,next" (inainte), ,,previous" (inapoi) <?>i
              ,,contents" (cuprins)) din antetul implicit sunt pastrate.
              Valoarea implicita este

               <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">\n
               <HTML>\n <HEAD>\n

        ****************************************************

       linuxdoc -B info  (sgml2info) converte<?>te un fi<?>ier sursa LinuxDoc
       DTD SGML in format GNU info. Rezultatul va aparea in fi<?>ier.info,
       unde fi<?>ier este numele fi<?>ierului sursa SGML.

       Perechea atribut/valoare ,,output=info" este definita pentru
       condi<?>ionale.

       linuxdoc -B info nu are op<?>iuni specifice pentru procesor.

        ****************************************************

       linuxdoc -B latex  (sgml2latex) converte<?>te un fi<?>ier sursa
       LinuxDoc DTD SGML in LaTeX, utilizand analizatorul nsgmls(1) sau
       onsgmls(1) <?>i convertorul sgmlsasp(1). Utilizand ie<?>irea LaTeX <?>i
       formatorul (procesorul) de text latex(1), pute<?>i crea apoi o ie<?>ire
       DVI <?>i o ie<?>ire PostScript utilizand convertorul dvips(1).
       Rezultatul va aparea in fi<?>ier.tex pentru ie<?>irea LaTeX,
       fi<?>ier.dvi pentru ie<?>irea DVI sau fi<?>ier.ps pentru ie<?>irea
       PostScript, unde fi<?>ier este numele fi<?>ierului sursa SGML.

       Folosind ie<?>irea LaTeX <?>i formatorul de text pdflatex(1), pute<?>i
       crea apoi o ie<?>ire PDF placuta, potrivita pentru a fi vizualizata cu
       programe de vizualizare PDF ca xpdf(1), acroread(1) sau ghostview(1).

       Perechea atribut/valoare ,,output=latex2e" este definita pentru
       condi<?>ionale.

       linuxdoc -B latex accepta urmatoarele op<?>iuni specifice procesorului:
       [--output=tex|dvi|ps|pdf] [--bibtex] [--makeindex] [--pagenumber=n]
       --quick [-[- -latex=latex|hlatexp|platex|jlatex] [--dvips=dvips|dvi2ps]
       [--verbosity=n] [--verbosity=n]

       Semnifica<?>iile acestora sunt:

       --output=format, -o
              Specifica formatul de ie<?>ire dorit. Specificatorul format
              poate fi ,,tex", ,,dvi", ,,ps" sau ,,pdf".

       Nota: Aceasta versiune nu suprascrie/elimina 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<?>a de versiunea
       originala SGML-Tools 1.0.9, a<?>a ca sunte<?>i avertizat aici.

       --bibtex, -b
              Proceseaza TeX-ul generat cu bibtex(1).

       --makeindex, -m
              Genereaza un fi<?>ier de index TeX adecvat pentru procesarea cu
              makeindex(1) <?>i din etichetele <idx> <?>i <cdx> prezente in
              sursa SGML.

       --pagenumber, -n
              Stabile<?>te numarul paginii de inceput din fi<?>ierul DVI sau
              PS de ie<?>ire.

       --quick, -q
              Efectueaza doar o singura 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.

       --pass, -P
              Argumentul op<?>iunii pass este inserat imediat dupa preambulul
              LaTeX generat de eticheta document-type. Specifica formatul de
              ie<?>ire dorit. Specificatorul format poate fi ,,tex", ,,dvi",
              ,,ps", sau ,,pdf".

       --latex=comanda_latex_alternativa, -x
              Aceasta op<?>iune este disponibila in prezent pentru coreeana
              <?>i japoneza.  comanda_latex_alternativa.  poate fi ,,latex"
              (implicit), ,,hlatexp" (pentru coreeana), ,,platex" sau
              ,,jlatex" (pentru japoneza).  Aceasta op<?>iune poate fi
              utilizata pentru a reda un document coreean folosind HLaTeXp sau
              pentru a reda un document japonez folosind pLaTeX/jLaTeX.  In
              caz contrar, trebuie instalat HLaTeX pentru a reda un document
              coreean.  Pe de alta parte, documentul japonez poate fi redat cu
              jLaTeX (care este op<?>iunea implicita atunci cand este
              specificata ,,-c nippon"), astfel incat, daca ave<?>i deja
              jLaTeX, s-ar putea sa nu fie nevoie sa instala<?>i pLaTeX.

       --dvips=comanda_dvips_alternativa, -s
              Aceasta op<?>iune este in prezent pentru japoneza.
              comanda_dvips_alternativa poate fi <<dvips>> sau <<dvi2ps>>.
              Daca nu cunoa<?>te<?>i acest lucru, atunci este posibil sa nu
              ave<?>i nevoie de aceasta op<?>iune.

       --verbosity, -V
              Stabile<?>te nivelul de detaliere. ,,0" (valoarea implicita) va
              afi<?>a informa<?>ii despre rularea LaTeX numai in cazul unor
              erori. ,,1" va afi<?>a intotdeauna informa<?>ii despre ultima
              execu<?>ie. ,,2" va afi<?>a informa<?>ii pentru toate
              execu<?>iile.

        ****************************************************

       linuxdoc -B lyx  (sgml2lyx) converte<?>te un fi<?>ier sursa LinuxDoc
       DTD SGML in LyX.  Rezultatul va aparea in fi<?>ier.lyx, unde fi<?>ier
       este numele fi<?>ierului sursa SGML.

       Perechea atribut/valoare ,,output=lyx" este definita pentru
       condi<?>ionale.

       linuxdoc -B lyx nu are op<?>iuni specifice pentru procesor.

        ****************************************************

       linuxdoc -B rtf  (sgml2rtf) converte<?>te un fi<?>ier sursa LinuxDoc
       DTD SGML in RTF, Rich Text Format utilizat de sistemul de ajutor
       Microsoft Windows. Rezultatul va aparea in fi<?>ierul de nivel superior
       fi<?>ier.rtf <?>i fi<?>ier-n.rtf pentru fiecare sec<?>iune, unde
       fi<?>ier este numele fi<?>ierului sursa SGML.  Ie<?>irea RTF este
       adaptata pentru compilarea de catre Windows Help Compiler (hc31.exe).

       Perechea atribut/valoare ,,output=rtf" este definita pentru
       condi<?>ionale.

       linuxdoc -B rtf accepta [--twosplit] ca o op<?>iune specifica
       procesorului. In cele ce urmeaza este semnifica<?>ia acestei op<?>iuni:

       --twosplit, -2
              Imparte fi<?>ierele atat la n. sec<?>iuni, cat <?>i la n.m.
              subsec<?>iuni

        ****************************************************

       linuxdoc -B txt  (sgml2txt) converte<?>te un fi<?>ier sursa LinuxDoc
       DTD SGML in format ASCII, ISO-8859-1 sau EUC-JP. Rezultatul va aparea
       in fi<?>ier.txt, unde fi<?>ier este numele fi<?>ierului sursa SGML.

       Perechea atribut/valoare ,,output=txt" este definita pentru
       condi<?>ionale.

       linuxdoc -B txt accepta urmatoarele op<?>iuni de procesor: [--manpage]
       [--filter] [--blanks=n]

       Semnifica<?>ia acestor op<?>iuni este urmatoarea:

       --manpage, -m
              Produce un fi<?>ier sursa groff, potrivit pentru formatare cu
              groff -man pentru pagini de manual

       --filter, -f
              Elimina suprapunerile de spa<?>ii din forma intermediara
              generata de groff(1).

       --pass, -P
              Argumentul op<?>iunii pass se adauga la op<?>iunile din linia de
              comanda transmise lui groff(1).

       --blanks=n, -b
              Stabile<?>te limita de linii goale continue pentru generarea
              documentului de ie<?>ire. Limita implicita este 3. Daca se
              specifica 0 (zero), rezultatul are multe linii goale continue.

        ****************************************************

       linuxdoc -B check  (sgmlcheck) executa o analiza SGML pe sursa de
       document specificata. Eventualele erori sunt raportate la ie<?>irea
       standard. Nu se produce nicio versiune formatata a sursei.

       Re<?>ine<?>i ca linuxdoc -B check preproceseaza sursa LinuxDoc DTD
       SGML, facand condi<?>ionarea descrisa de orice etichete <#if></#if>
       <?>i <#unless></#unless>.  Sursele de documente care con<?>in aceste
       etichete vor crea confuzie intr-un analizator SGML independent.
       linuxdoc -B check nu are op<?>iuni specifice pentru procesor.
        ****************************************************

FI<?>IERE
       Sunt utilizate multe fi<?>iere <?>i executabile din
       /usr/share/linuxdoc-tools <?>i /usr/bin.

ERORI
       Poate ca au mai ramas cateva. Nu ezita<?>i sa trimite<?>i un raport la
       actualul responsabil cu men<?>inerea.

RESPONSABIL
       Acesta a fost intre<?>inut de Cees de Groot <cg@cdegroot.com> in
       SGML-Tools (v1). In prezent este intre<?>inut de Taketoshi Sano
       <sano@debian.org> pentru Linuxdoc-Tools.

TRADUCERE
       Traducerea in limba romana a acestui manual a fost facuta de Remus-
       Gabriel Chelu <remusgabriel.chelu@disroot.org>

       Aceasta traducere este documenta<?>ie gratuita; citi<?>i Licen<?>a
       publica generala GNU Versiunea 3
       <https://www.gnu.org/licenses/gpl-3.0.html> sau o versiune ulterioara
       cu privire la condi<?>ii privind drepturile de autor.  NU se asuma
       NICIO RESPONSABILITATE.

       Daca gasi<?>i erori in traducerea acestui manual, va rugam sa
       trimite<?>i un e-mail la <translation-team-ro@lists.sourceforge.net>.

                                 27 iulie 2000                     LINUXDOC(1)