debiandoc2html - Online in de cloud

PROGRAMMA:

NAAM

debiandoc-sgml - overzicht van de DebianDoc-SGML opmaaktools

KORTE INHOUD

debiandoc2* [-H] [-B basisnaam] [-X aangepaste map] [-S script] [-C] [-C] [-NS verklaring]
[-e verlenging] [-k] [-l lokaal] [-N onsgmls_options] [--] [Bron]

debiandoc2html [-L] [-X aangepaste map] [-S script] [-M] [-T topnaam] [-1] [gedeeld opties]
debiandoc2tekst [-O] [-X aangepaste map] [-S script] [-M] [gedeeld opties]
debiandoc2textov [-O] [-X aangepaste map] [-S script] [-M] [gedeeld opties]
debiandoc2latex [-O] [-X aangepaste map] [-S script] [gedeeld opties]
debiandoc2latexdvi [-O] [-X aangepaste map] [-S script] [-P papiergrootte] [-v] [gedeeld opties]
debiandoc2latexp [-O] [-X aangepaste map] [-S script] [-P papiergrootte] [-v] [-1] [gedeeld
opties]
debiandoc2latexpdf [-O] [-X aangepaste map] [-S script] [-P papiergrootte] [-v] [gedeeld opties]
debiandoc2dvi [-O] [-X aangepaste map] [-S script] [-P papiergrootte] [-v] [gedeeld opties]
debiandoc2ps [-O] [-X aangepaste map] [-S script] [-P papiergrootte] [-v] [-1] [gedeeld opties]
debiandoc2pdf [-O] [-X aangepaste map] [-S script] [-P papiergrootte] [-v] [gedeeld opties]
debiandoc2texinfo [-O] [-X aangepaste map] [-S script] [gedeeld opties]
debiandoc2info [-X aangepaste map] [-S script] [-v] [gedeeld opties]
debiandoc2dbk [-S script] [gedeeld opties]
debiandoc2wiki [-O] [-S script] [-M] [gedeeld opties]

PRODUCTBESCHRIJVING

DebianDoc-SGML is een SGML-DTD en een set opmaakhulpmiddelen. Deze tools converteren (bron),
een SGML-document dat voldoet aan de DebianDoc-SGML DTD, in verschillende uitvoerformaten.

Elke opmaaktool debiandoc2foo stuurt zijn output naar basisnaam.uitbreiding WAAR basisnaam
is (bron) met alle leidende directorycomponenten en eventuele trailing .sgml VERWIJDERD. Indien (bron)
is - dan wordt de invoer overgenomen van de standaardinvoer. Deze optie is niet beschikbaar met
debiandoc2html, debiandoc2latexdvi, debiandoc2latexp, debiandoc2latexpdf, debiandoc2dvi,
debiandoc2ps, debiandoc2pdf, debiandoc2info en debiandoc2dbk.

debiandoc2html produceert een submap basisnaam. Html met een HTML-representatie van
de invoer in een set van . Html bestanden. De `topniveau'-pagina heet
basisnaam.html/index.html.

debiandoc2tekst produceert een gewoon ASCII-tekstbestand basisnaam. Txt geformatteerd tot een breedte van 79
kolommen.

debiandoc2textov produceert een ASCII-tekstbestand basisnaam.tov geformatteerd tot een breedte van 79
kolommen, met doorhalingen om te markeren (met behulp van backspaces en herhaalde tekens of
onderstrepingstekens). Dit is dezelfde ASCII-tekstuitvoerstijl die wordt gegenereerd door troff.

debiandoc2latex produceert een invoerbestand basisnaam.tex voor het LaTeX-zetsysteem.
Dit kan worden gebruikt om PostScript-uitvoer en PDF-uitvoer te produceren.

debiandoc2latexdvi produceert een DVI-bestand basisnaam.dvi via het LaTeX zetsysteem.
Dit kan worden gebruikt om PostScript-uitvoer te produceren.

debiandoc2latexp produceert een PostScript-bestand basisnaam.ps via het LaTeX zetsysteem.

debiandoc2latexpdf produceert een PDF-bestand basisnaam.pdf via LaTeX zetsysteem.

debiandoc2dvi produceert een DVI-bestand basisnaam.dvi. Momenteel gebeurt dit via de LaTeX
zet systeem. Dit kan worden gebruikt om PostScript-uitvoer te produceren.

debiandoc2ps produceert een PostScript-bestand basisnaam.ps. Momenteel gebeurt dit via de LaTeX
zet systeem.

debiandoc2pdf produceert een PDF-bestand basisnaam.pdf. Momenteel gebeurt dit via de LaTeX
zet systeem.

debiandoc2texinfo produceert een invoerbestand basisnaam.texinfo voor de Texinfo documentatie
systeem. Dit kan worden gebruikt om een ​​Info-bestand te maken.

debiandoc2info produceert een Info-bestand basisnaam. Info via het Texinfo documentatiesysteem.

debiandoc2dbk produceert een submap basisnaam.dbk met een DocBook XML
representatie van de invoer in een set van .dbk bestanden. De `topniveau'-pagina heet
basisnaam.dbk/index.dbk. Indien -1 optie wordt gebruikt, produceert het a basisnaam.dbk bestand in plaats daarvan
dezelfde map zonder een submap aan te maken.

debiandoc2wiki produceert een tekstbestand basisnaam.wiki , waarvan een deel kan worden gebruikt voor creatie
van een Wiki-pagina.

GEDEELDE OPTIES

De volgende opdrachtregelopties worden door alle opmaaktools ondersteund:

-b basisnaam
Gebruik de aangegeven basisnaam in plaats van de standaard. Indien toegepast op:
debiandoc2html en gegeven met een of meer directory-componenten, de aangegeven
basisnaam wordt geïnterpreteerd als basisnaam/voorvoegsel Met basisnaam nu bestaande uit de
gegeven directory-componenten. Het resultaat basisnaam wordt gebruikt zoals hierboven beschreven.
De voorvoegsel wordt gebruikt als voorvoegsel van de verzameling van . Html bestanden met de HTML
weergave van de invoer, inclusief de `top level' pagina.

-c Schakel content-onderhandeling met coderingsachtervoegsel in. Dit zorgt ervoor dat de gegenereerde output
genoemd worden basisnaam.taal[.codering].uitbreiding gebaseerd op het -l optie argument.
De optionele codering bestaat alleen wanneer -l optie argument bevat expliciet
codering.

-C Schakel content-onderhandeling in zonder coderingsachtervoegsel. Dit zorgt ervoor dat de gegenereerde
uitvoer te noemen basisnaam.taal.uitbreiding alleen gebaseerd op het taalgedeelte van
-l optie argument. (Goed voor UTF-8-landinstellingen zoals 'fr.UTF-8'.)

-d verklaring
Gebruik de aangegeven SGML verklaring in plaats van de standaard (
/usr/share/sgml/debiandoc/dtd/sgml/1.0/debiandoc.dcl ). Indien gegeven zonder enige
toonaangevende directory-componenten, verklaring wordt verondersteld in een van de
verklaring mappen in de SGML-zoekpaden.

-e uitbreiding
Gebruik de aangegeven uitbreiding in plaats van de standaard.

-h Druk het helpbericht af op stdout.

-k Bewaar de tussenbestanden in de directory met het (de) uitvoerbestand(en). Dit
bevat bestanden in onsgmls(1)'s uitvoerformaat basisnaam.sasp en basisnaam.sasp-foo.
Voor op LaTeX gebaseerde uitvoer omvat dit ook de bestanden basisnaam.aux, basisnaam.log,
basisnaam.tex en basisnaam.toc, en voor PostScript-uitvoer het bestand basisnaam.dvi as
goed. Verder, als de -O optie en/of de -c optie en/of de -e optie(s)
worden/wordt gebruikt om respectievelijk een DVI-, een PDF- of een PS-bestand te genereren basisnaam.dvi,
basisnaam.pdf or basisnaam.ps is ook een tussenbestand.

-l lokaal
Gebruik de aangegeven lokaal om de gegenereerde output te lokaliseren. Als deze optie niet is
gebruikt of een niet-ondersteunde landinstelling wordt aangegeven, de landinstelling 'en' die een alias is van
'en_US.ISO8859-1' wordt gebruikt. Gebruik in plaats daarvan 'en.UTF-8' voor generieke Engelse UTF-8.
Deze worden gebruikt als onderdeel van de bestandsnaam wanneer: -c or -C opties worden gebruikt. Voor
HTML, inhoudsonderhandelingsgedeelte van bestandsnaam wordt gegenereerd door de landinstelling te wijzigen
waarde zoals 'pt_BR' naar een kleine letter 'pt-br'. De landinstellingswaarde zoals 'pt-
br' worden ook geaccepteerd als een alias voor pt_BR' om buildscripts schoner te maken. Dit
zal ervoor zorgen dat niet-HTML-uitvoer hetzelfde achtervoegsel gebruikt als HTML. Zien
/usr/share/perl5/DebianDoc_SGML/Locale/Alias.pm voor exacte locale namen geaccepteerd
(waarden aan de linkerkant).

-n onsgmls_options
Geef de aangegeven opties direct door aan onsgmls(1). Mag meer dan eens worden gebruikt.

-- Scheidt opties van de (bron) voor het geval dat laatste met een koppelteken begint.

SPECIFIEK OPTIES

De volgende opdrachtregelopties worden alleen ondersteund door sommige opmaaktools (zie de
synopsis hierboven voor welke tool welke optie ondersteunt):

-1 Genereer één pagina voor HTML-uitvoer. Genereer 1 pagina per pagina (standaard) voor
PostScript-uitvoer (aangezien dit de standaard is, is de optie nu verouderd en zal
waarschijnlijk in de toekomst worden verwijderd).

-L Niet toevoegen tags toe aan de header van het/de gegenereerde HTML-bestand(en).

-m Zet de opmerkingen in voetnootstijl in de uitvoer.

-O Uitvoer naar standaarduitvoer in plaats van naar het bestand basisnaam.uitbreiding. Dit is
geïmpliceerd wanneer invoer wordt overgenomen van standaardinvoer.

-p papiergrootte
Produceer output in de aangegeven papiergrootte. Zien papiergrootte(5) voor details.

-P Extra toevoegen tags naar de geregenereerde SGML-bestand(en) rondom , ,
, , ... om met Debiandoc SGML-syntaxis te werken.

-s script
Pas het opgegeven script toe op het tussenliggende .latex- of .texinfo-bestand voordat
verdere verwerking maken. (Of pas het opgegeven script toe op het gegenereerde bestand)

Het script wordt aangeroepen met het argument ingesteld op [ -l lokaal ] Invoer bestand uitvoerbestand .

Momenteel is de standaardwaarde voor deze scripthook voor het .tex-bestand ingesteld op:
/usr/share/debiandoc-sgml/fixlatex waarmee problemen met Chinese Big5-codering worden opgelost.

-S Gebruik maken van , , , ... in plaats van standaard voor DocBook XML
conversie.

-t topnaam
Gebruik de aangegeven topnaam (zonder extensie) als de naam van de `top level' pagina
in plaats van de standaard.

-v Wees uitgebreid bij het aanroepen van secundaire processors zoals latex of makeinfo.

-x Genereer XHTML-compatibele HTML-uitvoer.

-X aangepaste_dir.
U kunt de van de landinstelling afhankelijke gegevensmap wijzigen van de standaard
/usr/share/perl5/DebianDoc_SGML/Locale/ naar aangepaste_map directory door dit in te stellen
optie.

Dit kan worden gebruikt als een hook voor de gebruiker om nieuwe locale-ondersteuning toe te voegen of om LaTeX te wijzigen
headerdefinitie gemaakt door het pakket debiandoc-sgml zonder roottoegang
naar het systeem.

DIAGNOSE

Foutmeldingen van de validerende SGML-parser onsgmls(1) aangeven dat er iets mis is met
(bron). Zorg ervoor dat (bron) voldoet aan de DebianDoc-SGML DTD.

Foutmeldingen van saspconverteren (een intern gebruikt script van het DebianDoc-SGML-pakket)
geeft aan dat er een probleem is met het pakket zelf. Rapporteer ze a.u.b. aan de pakketbeheerder
via het bugrapportagesysteem van Debian.

If debiandoc2latexdvi, debiandoc2latexp, debiandoc2latexpdf, debiandoc2dvi, debiandoc2ps,
debiandoc2pdfof debiandoc2info een fout tegenkomen bij het aanroepen van hun secundaire
processors, geven ze een passende foutmelding en geven aan dat ze de -v optie om
zie de output die door deze secundaire processors wordt gegenereerd (wat veel kan zijn!). Het laatste
drie geven ook aan om het logbestand te controleren basisnaam.log.

Als er een fout is opgetreden, worden geen van de reeds gegenereerde tussenbestanden verwijderd. Zij
worden verwijderd bij de volgende succesvolle conversie van hetzelfde (bron) door dezelfde debiandoc2foo
(Tenzij de -k optie wordt gebruikt).

OPMERKINGEN

If debiandoc2foo staat op het punt een reeds bestaand tussenbestand te overschrijven, geeft het een
juiste waarschuwingsbericht (behalve voor bestanden in onsgmls(1)'s uitvoerformaat). Zie de
beschrijving van de -k optie voor een compleet overzicht van de tussenbestanden.

MILIEU

De uitvoer van de tag kan worden overschreven door de waarde van de omgevingsvariabele
DEBIANDOC_DATE indien gedefinieerd.

Debiandoc2html online gebruiken met onworks.net-services