a2x - Online în cloud

PROGRAM:

NUME

a2x - Un manager de lanț de instrumente pentru AsciiDoc (convertește fișierele text Asciidoc în alt fișier
formate)

REZUMAT

a2x [OPŢIUNI] FIȘIER SURSĂ

DESCRIERE

Un manager de lanț de instrumente DocBook care traduce un fișier text AsciiDoc FIȘIER SURSĂ în PDF,
EPUB, DVI, PS, LaTeX, XHTML (o singură pagină sau în bucăți), pagină de manual, Ajutor HTML sau text simplu
formate folosind asciidoc(1) și alte aplicații (vezi secțiunea CERINȚE). FIȘIER SURSĂ poate să
să fie, de asemenea, un fișier DocBook cu extensia .xml.

OPŢIUNI

-A, --atribut=ATRIBUT
set asciidoc(1) valoarea atributului (comandă rapidă pentru --asciidoc-opts="-A ATRIBUT" opțiune).
Această opțiune poate fi specificată de mai multe ori.

--asciidoc-opts=ASCIIDOC_OPTS
Suplimentar asciidoc(1) Opțiuni. Această opțiune poate fi specificată de mai multe ori.

--conf-file=CONF_FILE
Încărcați fișierul de configurare. Consultați secțiunea FIȘIERE CONF.

-D, --destinație-dir=DESTINATION_DIR
Directorul de ieșire. Implicit la FIȘIER SURSĂ director. Această opțiune este aplicabilă numai pentru
Formate de ieșire bazate pe HTML (zdrobit, EPUB, htmlhelp, xhtml).

-d, --doctype=DOCTIP
Tip de document DocBook: articol, pagina de manual or carte. Tipul de document implicit este articol
cu excepția cazului în care formatul este pagina de manual (caz în care este implicit pagina de manual).

-b, --backend=BACKEND
BACKEND este numele unui plugin backend instalat. Când este specificată această opțiune a2x
încearcă să încarce un nume de fișier a2x-backend.py de la BACKEND directorul de pluginuri Acesta atunci
convertește FIȘIER SURSĂ la BACKEND fișier de ieșire formatat folosind o funcție globală
definit în a2x-backend.py denumit to_BACKEND.

-f, --format=FORMAT
Formate de ieșire: zdrobit, docbook, dvi, EPUB, htmlhelp, pagina de manual, pdf (Mod implicit), ps,
tex, a) Sport and Nutrition Awareness Day in Manasia Around XNUMX people from the rural commune Manasia have participated in a sports and healthy nutrition oriented activity in one of the community’s sports ready yards. This activity was meant to gather, mainly, middle-aged people from a Romanian rural community and teach them about the benefits that sports have on both their mental and physical health and on how sporting activities can be used to bring people from a community closer together. Three trainers were made available for this event, so that the participants would get the best possible experience physically and so that they could have the best access possible to correct information and good sports/nutrition practices. b) Sports Awareness Day in Poiana Țapului A group of young participants have taken part in sporting activities meant to teach them about sporting conduct, fairplay, and safe physical activities. The day culminated with a football match. , xhtml. The AsciiDoc format a2x valoarea atributului este setată la FORMAT.

-h, --Ajutor
Imprimați sintaxa liniei de comandă și opțiunile programului în stdout.

--icoane
Utilizați avertismente sau imagini cu pictograme de navigare în documentele de ieșire. Comportamentul implicit este
pentru a utiliza text în locul pictogramelor.

--icoane-dir=PATH
O cale (relativă la fișierele de ieșire) care conține pictograme de avertizare și navigare. Valori implicite
la imagini/icoane. The --icoane opțiunea este implicită dacă se utilizează această opțiune.

-k, --păstrați-artefacte
Nu ștergeți fișierele de compilare temporare.

--râs
Utilizare râs(1) pentru a genera rezultate formatate text. Comportamentul implicit este de a folosi w3m(1).

-L, --no-xmllint
Nu verificați ieșirea asciidoc cu xmllint(1).

---epubcheck
Verificați ieșirea EPUB cu epubcheck(1).

-n, --funcție uscată
Nu faceți nimic, doar imprimați ceea ce s-ar fi făcut.

-r, --resursă=RESOURCE_SPEC
Specificați o resursă. Această opțiune poate fi specificată de mai multe ori. Vezi RESURSE
pentru mai multe detalii.

-m, --resursa-manifest=FILE
FILE conține o listă de resurse (una pe linie). Manifesta FILE intrările sunt formatate
la fel ca --resursă argumente de opțiune. Variabile de mediu și tilde acasă
directoarele sunt permise.

--foaia de stil=Foaie de stil
O listă delimitată de spațiu cu unul sau mai multe nume de fișiere de foi de stil CSS care sunt utilizate pentru stil
Ieșire HTML generată de foile de stil DocBook XSL. Implicit la docbook-xsl.css.
foile de stil sunt procesate în ordinea listei. Foile de stil trebuie să se afle într-un format valid
locația fișierului de resurse. Se aplică formatelor HTML: xhtml, EPUB, zdrobit, htmlhelp
formate.

-v, --verbos
Imprimați detaliile operaționale pe stderr. O secunda -v opțiunea aplică opțiunea verbose la
comenzile lanțului de instrumente.

--versiune
Imprimați versiunea programului în stdout.

--xsltproc-opts=XSLTPROC_OPTS
Suplimentar xsltproc(1) Opțiuni. Această opțiune poate fi specificată de mai multe ori.

--xsl-file=XSL_FILE
Ignorați foaia de stil XSL încorporată cu foaia de stil XSL personalizată XSL_FILE.

--filfizon
Utilizați FOP pentru a genera PDF-uri. Comportamentul implicit este de a folosi dblatex(1). --filfizon opțiune
este implicit dacă se utilizează această opțiune.

--fop-opts=FOP_OPTS
Suplimentar filfizon(1) Opțiuni. Dacă această opțiune este specificată, FOP este utilizat pentru a genera PDF-uri.
Această opțiune poate fi specificată de mai multe ori.

--dblatex-opts=DBLATEX_OPTS
Suplimentar dblatex(1) Opțiuni. Această opțiune poate fi specificată de mai multe ori.

--backend-opts=BACKEND_OPTS
Opțiuni pentru pluginul backend specificate de --backend opțiune. Această opțiune poate fi
specificat de mai multe ori.

Opțiunile pot fi setate și în fișierul sursă AsciiDoc. Dacă FIȘIER SURSĂ conține un comentariu
linia care începe cu // a2x: atunci restul liniei va fi tratat ca a2x
opțiunile din linia de comandă. De exemplu:

// a2x opțiuni implicite.
// a2x: -dbook --epubcheck
// Suprimă istoricul reviziilor în ieșirile dblatex.
// a2x: --dblatex-opts "-P latex.output.revhistory=0"

· Opțiunile care acoperă mai multe astfel de linii de comentarii vor fi concatenate.

· Pot apărea zero sau mai multe caractere cu spații albe între primele // și a2x:.

· Opțiunile din linia de comandă au prioritate față de opțiunile setate în fișierul sursă.

REZULTATE DOSARE

Fișierele de ieșire sunt scrise în directorul specificat de --destinație-dir opțiune. Daca nu
--destinație-dir opțiunea este setată fișierele de ieșire sunt scrise în FIȘIER SURSĂ director.

Fișierele de ieșire au același nume ca și FIȘIER SURSĂ dar cu un nume de fișier adecvat
extensie: .html pentru xhtml; .epub pentru EPUB; .hhp pentru htmlhelp; .pdf pentru pdf; .text pentru
a) Sport and Nutrition Awareness Day in Manasia Around XNUMX people from the rural commune Manasia have participated in a sports and healthy nutrition oriented activity in one of the community’s sports ready yards. This activity was meant to gather, mainly, middle-aged people from a Romanian rural community and teach them about the benefits that sports have on both their mental and physical health and on how sporting activities can be used to bring people from a community closer together. Three trainers were made available for this event, so that the participants would get the best possible experience physically and so that they could have the best access possible to correct information and good sports/nutrition practices. b) Sports Awareness Day in Poiana Țapului A group of young participants have taken part in sporting activities meant to teach them about sporting conduct, fairplay, and safe physical activities. The day culminated with a football match. , .xml pentru docbook. Prin convenție, paginile de manual nu au extensia .man (secțiunea paginii de manual
numai numărul). Numele de directoare HTML fragmentate au extensia .chunked; Ajutor HTML fragmentat
numele directoarelor au extensia .htmlhelp.

Fișierele existente cu același nume sunt suprascrise.

Pe lângă generarea de fișiere HTML, xhtml, EPUB, zdrobit și htmlhelp formatele asigură
fișierele de resurse sunt copiate în locațiile corecte ale directorului de destinație.

RESURSE

Resursele sunt fișiere (de obicei CSS și imagini) care sunt cerute de ieșirile bazate pe HTML
(xhtml, EPUB, zdrobit, htmlhelp formate). a2x scanează fișierele HTML generate și construiește a
lista de fișiere CSS și imagine necesare. Pot fi specificate fișiere de resurse suplimentare
folosind în mod explicit --resursă opțiune.

a2x caută fișiere de resurse în următoarele locații, în următoarea ordine:

1. FIȘIER SURSĂ director.

2. Directoarele de resurse specificate de --resursă opțiune (căutat recursiv).

3. Directoarele de resurse specificate de --resursa-manifest opțiune (căutate recursiv
în ordinea în care apar în fișierul manifest).

4. Imaginile stoc și directoarele foi de stil din asciidoc(1) fișiere de configurare
directoare (căutate recursiv).

5. Directorul de destinație.

Când este găsit un fișier de resurse, acesta este copiat în directorul de destinație relativ corect.
Subdirectoarele de destinație lipsă sunt create automat.

Există două mecanisme distincte pentru specificarea resurselor suplimentare:

1. Un director de resurse care va fi căutat recursiv pentru fișierele de resurse lipsă.

2. Un fișier de resurse care va fi copiat în directorul de destinație de ieșire.

Resursele sunt specificate cu --resursă valori ale opțiunii care pot fi una dintre următoarele
formate:


[= ]
. =

Unde:


Specifică un director (absolut sau relativ la FIȘIER SURSĂ) care este căutat
recursiv pentru fișierele de resurse lipsă. Pentru a elimina ambiguitatea Nume
ar trebui să se încheie cu un caracter separator de director.


Specifică un fișier de resurse (absolut sau relativ la FIȘIER SURSĂ) care va fi
copiat la . Dacă nu este specificat, atunci este
la fel ca .


Specifică destinația fișierului sursă copiat. The calea este
relativ la directorul de destinație (căile absolute nu sunt permise). Locația
a directorului de destinație depinde de rezultat FORMAT (A se vedea REZULTATE DOSARE
sectiune pentru detalii):

fragmentat, htmlhelp
Directorul de ieșire fragmentat.

EPUB
Directorul OEBPS arhivat.

xhtml
Ieșirea DESTINATION_DIR.

. =
Când adăugați resurse la fișierele EPUB, tipul mime este dedus din
file>, dacă tipul mime nu poate fi ghicit, apare o eroare. The
. = Sintaxa resurselor poate fi folosită pentru a seta în mod explicit tipurile MIME. este
extensia numelui de fișier, este tipul MIME corespunzător.

Exemple de opțiuni de resurse:

--resource ../images/
--resource doc/README.txt=README.txt
--resursă ~/images/tiger.png=imagini/tigru.png
--resource .ttf=application/x-font-ttf

EXEMPLE

a2x -f pdf doc/source-highlight-filter.txt
Generează fișierul doc/source-highlight-filter.pdf.

a2x -f xhtml -D ../doc --icons -r ../images/ team.txt
Creează fișier HTML ../doc/team.html, folosește pictograme de avertizare și caută recursiv în
directorul ../images/ pentru orice resurse lipsă.

a2x -f pagina de manual doc/asciidoc.1.txt
Generați pagina de manual doc/asciidoc.1.

RECHIZITE

a2x foloseste urmatoarele programe:

· Asciidoc: http://asciidoc.org/

· xsltproc: (toate formatele, cu excepția textului): http://xmlsoft.org/XSLT/

· DocBook XSL Foi de stil (toate formatele, cu excepția textului):
http://docbook.sourceforge.net/projects/xsl/

· dblatex (formate pdf, dvi, ps, tex): http://dblatex.sourceforge.net/

· FILFIZON (format pdf — generator alternativ de fișiere PDF): http://xmlgraphics.apache.org/fop/

· w3m (format text): http://w3m.sourceforge.net/index.en.html

· râs (format text — generator de fișiere text alternativ): http://lynx.isc.org/

· epubcheck (format epub — validator de fișiere EPUB): http://code.google.com/p/epubcheck/

Vedeți și cel mai recent fișier README.

CONF DOSARE

Un fișier de configurare conține cod executabil Python care suprascrie global
parametrii de configurare în a2x.py. Fișierele de configurare opționale sunt încărcate în
urmatoarea ordine:

1. a2x.conf din directorul care conține a2x.py executabil.

2. a2x.conf din directorul de configurare globală AsciiDoc. Sări peste acest pas dacă suntem
executând o copie instalată local (nu la nivel de sistem).

3. a2x.conf din directorul de configurare AsciiDoc $HOME/.asciidoc.

4. CONF_FILE specificat în --conf-file opțiune.

Iată valorile implicite ale opțiunii fișierului de configurare:

# Dicționarul de variabile de mediu opțional transmis către
# execută programe. Dacă este setată la Niciunul dintre cele existente
# mediu este folosit.
ENV = Nici unul

# executabile externe.
ASCIIDOC = 'asciidoc'
XSLTPROC = 'xsltproc'
DBLATEX = 'dblatex' # generație pdf.
FOP = 'fop' # generare pdf (opțiune --fop).
W3M = „w3m” # generație de text.
LYNX = 'lynx' # generare text (dacă nu w3m).
XMLLINT = 'xmllint' # Setați la '' pentru a dezactiva.
EPUBCHECK = 'epubcheck' # Setați la '' pentru a dezactiva.
# Opțiuni implicite pentru executabil extern.
ASCIIDOC_OPTS = ''
DBLATEX_OPTS = ''
FOP_OPTS = ''
XSLTPROC_OPTS = ''

Utilizați a2x online folosind serviciile onworks.net