InglesPransesAlemanItalyanoPortugesRusoEspanyol

OnWorks favicon

a2x - Online sa Cloud

Magpatakbo ng a2x sa OnWorks na libreng hosting provider sa Ubuntu Online, Fedora Online, Windows online emulator o MAC OS online emulator

Ito ang command na a2x na maaaring patakbuhin sa OnWorks na libreng hosting provider gamit ang isa sa aming maramihang libreng online na workstation gaya ng Ubuntu Online, Fedora Online, Windows online emulator o MAC OS online emulator

PROGRAMA:

NAME


a2x - Isang toolchain manager para sa AsciiDoc (nag-convert ng Asciidoc text file sa ibang file
mga format)

SINOPSIS


a2x [Opsyon] SOURCE_FILE

DESCRIPTION


Isang DocBook toolchain manager na nagsasalin ng AsciiDoc text file SOURCE_FILE sa PDF,
EPUB, DVI, PS, LaTeX, XHTML (isang pahina o chunked), man page, HTML Help o plain text
mga format gamit ang asciidoc(1) at iba pang mga aplikasyon (tingnan ang seksyong KINAKAILANGAN). SOURCE_FILE maaari
maging isang DocBook file na may extension na .xml.

Opsyon


-a, --katangian=KATANGIAN
Itakda asciidoc(1) halaga ng katangian (shortcut para sa --asciidoc-opts="-a KATANGIAN" pagpipilian).
Maaaring tukuyin ang opsyong ito nang higit sa isang beses.

--asciidoc-opts=ASCIIDOC_OPTS
karagdagan asciidoc(1) mga pagpipilian. Maaaring tukuyin ang opsyong ito nang higit sa isang beses.

--conf-file=CONF_FILE
I-load ang configuration file. Tingnan ang seksyong CONF FILES.

-D, --destinasyon-dir=DESTINATION_DIR
Direktoryo ng output. Default sa SOURCE_FILE direktoryo. Ang pagpipiliang ito ay naaangkop lamang sa
HTML based na mga format ng output (tipak, EPUB, htmltulong, xhtml).

-d, --doctype=DOKTO
Uri ng dokumento ng DocBook: artikulo, manpage or libro. Default na uri ng dokumento ay artikulo
maliban kung ang format ay manpage (kung saan ito ay default sa manpage).

-b, --backend=BACKEND
BACKEND ay ang pangalan ng isang naka-install na backend plugin. Kapag tinukoy ang pagpipiliang ito a2x
mga pagtatangkang mag-load ng pangalan ng file a2x-backend.py mula sa BACKEND direktoryo ng plugin Ito pagkatapos
nag-convert ng SOURCE_FILE sa isang BACKEND na-format na output file gamit ang isang global function
tinukoy sa a2x-backend.py tinatawag to_BACKEND.

-f, --format=FORMAT
Mga format ng output: tipak, docbook, dvi, EPUB, htmltulong, manpage, pdf (default), ps,
tex, teksto, xhtml. Ang AsciiDoc a2x-format ang value ng attribute ay nakatakda sa FORMAT.

-h, - Tumulong
I-print ang command-line na syntax at mga opsyon sa programa sa stdout.

--mga icon
Gumamit ng babala o mga imahe ng icon ng nabigasyon sa mga dokumento ng output. Ang default na pag-uugali ay
upang gumamit ng teksto bilang kapalit ng mga icon.

--icons-dir=PATH
Isang landas (na may kaugnayan sa mga output file) na naglalaman ng mga icon ng paalala at nabigasyon. Mga Default
sa mga larawan/icon. Ang --mga icon ang opsyon ay implicit kung gagamitin ang opsyong ito.

-k, --panatilihin ang mga artifact
Huwag tanggalin ang mga pansamantalang build file.

--lynx
paggamit musang(1) para makabuo ng text formatted na output. Ang default na gawi ay ang paggamit w3m(1).

-L, --no-xmllint
Huwag suriin ang asciidoc output sa xmllint(1).

---epubcheck
Suriin ang output ng EPUB gamit ang epubcheck(1).

-n, --dry-run
Huwag gumawa ng kahit ano i-print lamang kung ano ang gagawin.

-r, --pinagkukunan=RESOURCE_SPEC
Tukuyin ang isang mapagkukunan. Maaaring tukuyin ang opsyong ito nang higit sa isang beses. Tingnan ang Kayamanan
seksyon para sa karagdagang detalye.

-m, --resource-manifest=FILE
FILE naglalaman ng listahan ng mga mapagkukunan (isa bawat linya). Manifest FILE na-format ang mga entry
katulad ng --pinagkukunan mga argumento ng opsyon. Mga variable ng kapaligiran at tilde home
pinahihintulutan ang mga direktoryo.

--stylesheet=STYLESHEET
Isang listahan na nililimitahan ng espasyo ng isa o higit pang CSS stylesheet na mga pangalan ng file na ginagamit sa istilo
HTML na output na nabuo ng DocBook XSL Stylesheets. Default sa docbook-xsl.css. ang
Ang mga stylesheet ay pinoproseso sa pagkakasunud-sunod ng listahan. Ang mga stylesheet ay dapat na nasa isang wastong
lokasyon ng resource file. Nalalapat sa mga format ng HTML: xhtml, EPUB, tipak, htmltulong
format.

-v, --verbose
I-print ang mga detalye ng pagpapatakbo sa stderr. Isang segundo -v inilalapat ng opsyon ang verbose na opsyon sa
mga utos ng toolchain.

--bersyon
I-print ang bersyon ng program sa stdout.

--xsltproc-opts=XSLTPROC_OPTS
karagdagan xsltproc(1) mga pagpipilian. Maaaring tukuyin ang opsyong ito nang higit sa isang beses.

--xsl-file=XSL_FILE
I-override ang built-in na XSL stylesheet gamit ang custom na XSL stylesheet XSL_FILE.

--fop
Gamitin ang FOP upang bumuo ng mga PDF. Ang default na gawi ay ang paggamit dblatex(1). ang --fop opsyon
ay implicit kung gagamitin ang opsyong ito.

--fop-opts=FOP_OPTS
karagdagan fop(1) mga pagpipilian. Kung tinukoy ang opsyong ito, ang FOP ay ginagamit upang bumuo ng mga PDF.
Maaaring tukuyin ang opsyong ito nang higit sa isang beses.

--dblatex-opts=DBLATEX_OPTS
karagdagan dblatex(1) mga pagpipilian. Maaaring tukuyin ang opsyong ito nang higit sa isang beses.

--backend-opts=BACKEND_OPTS
Mga opsyon para sa backend na plugin na tinukoy ng --backend opsyon. Ang pagpipiliang ito ay maaaring
tinukoy ng higit sa isang beses.

Maaari ding itakda ang mga opsyon sa AsciiDoc source file. Kung SOURCE_FILE naglalaman ng komento
linya na nagsisimula sa // a2x: pagkatapos ay ang natitira sa linya ay ituturing bilang a2x
mga pagpipilian sa command-line. Halimbawa:

// a2x default na mga opsyon.
// a2x: -dbook --epubcheck
// Pigilan ang kasaysayan ng rebisyon sa mga output ng dblatex.
// a2x: --dblatex-opts "-P latex.output.revhistory=0"

· Pagsasama-samahin ang mga opsyon na sumasaklaw sa maraming ganoong linya ng komento.

· Maaaring lumitaw ang zero o higit pang mga white space sa pagitan ng nangungunang // at a2x:.

· Nangunguna ang mga opsyon sa command-line kaysa sa mga opsyong itinakda sa source file.

oUTPUT MGA FILE


Ang mga output na file ay nakasulat sa direktoryo na tinukoy ng --destinasyon-dir opsyon. Kung hindi
--destinasyon-dir ang pagpipilian ay nakatakda ang mga output file ay nakasulat sa SOURCE_FILE direktoryo.

Ang mga output na file ay may parehong pangalan ng SOURCE_FILE ngunit may naaangkop na pangalan ng file
extension: .html para sa xhtml; .epub para sa EPUB; .hhp para sa htmltulong; .pdf para sa pdf; .text para sa
teksto, .xml para sa docbook. Sa pamamagitan ng convention manpages ay walang .man extension (man page section
numero lamang). May .chunked extension ang mga pangalan ng direktoryo ng chunked HTML; chunked HTML Help
ang mga pangalan ng direktoryo ay may extension na .htmlhelp.

Ang parehong pinangalanang umiiral na mga file ay na-overwrite.

Bilang karagdagan sa pagbuo ng mga HTML file ang xhtml, EPUB, tipak at htmltulong tinitiyak ng mga format
ang mga mapagkukunang file ay kinopya sa kanilang mga tamang lokasyon ng direktoryo ng patutunguhan.

Kayamanan


Ang mga mapagkukunan ay mga file (karaniwang CSS at mga larawan) na kinakailangan ng mga output na batay sa HTML
(xhtml, EPUB, tipak, htmltulong mga format). a2x sinusuri ang nabuong mga HTML na file at bumubuo ng isang
listahan ng kinakailangang CSS at mga file ng imahe. Maaaring tukuyin ang mga karagdagang mapagkukunang file
tahasang gamit ang --pinagkukunan pagpipilian.

a2x naghahanap ng mga mapagkukunang file sa mga sumusunod na lokasyon sa sumusunod na pagkakasunud-sunod:

1. Ang SOURCE_FILE direktoryo.

2. Mga direktoryo ng mapagkukunan na tinukoy ng --pinagkukunan opsyon (hinanap nang paulit-ulit).

3. Mga direktoryo ng mapagkukunan na tinukoy ng --resource-manifest opsyon (hinanap nang paulit-ulit
sa pagkakasunud-sunod ng paglitaw ng mga ito sa manifest file).

4. Ang mga stock na imahe at stylesheet na mga direktoryo sa asciidoc(1) mga file ng pagsasaayos
mga direktoryo (hinanap nang paulit-ulit).

5. Ang direktoryo ng patutunguhan.

Kapag natagpuan ang isang mapagkukunang file, kinokopya ito sa tamang direktoryo ng patutunguhan.
Ang mga nawawalang patutunguhang sub-directory ay awtomatikong nagagawa.

Mayroong dalawang natatanging mekanismo para sa pagtukoy ng mga karagdagang mapagkukunan:

1. Isang resource directory na hahanapin ng recursively para sa mga nawawalang resource file.

2. Isang mapagkukunang file na makokopya sa direktoryo ng patutunguhan ng output.

Ang mga mapagkukunan ay tinukoy sa --pinagkukunan mga halaga ng opsyon na maaaring isa sa mga sumusunod
mga format:


[= ]
. =

Saan:


Tinutukoy ang isang direktoryo (ganap o nauugnay sa SOURCE_FILE) na hinahanap
recursively para sa mga nawawalang resource file. Upang maalis ang kalabuan ang pangalan
dapat magtapos sa isang character na separator ng direktoryo.


Tinutukoy ang isang mapagkukunang file (ganap o nauugnay sa SOURCE_FILE) na kung saan ay
kinopya sa . Kung ay hindi tinukoy kung gayon ito ay ang
katulad ng sa .


Tinutukoy ang patutunguhan ng nakopyang source file. Ang ang landas ay
kaugnay sa direktoryo ng patutunguhan (hindi pinapayagan ang mga ganap na landas). Ang lokasyon
ng patutunguhang direktoryo ay depende sa output FORMAT (Tingnan ang oUTPUT MGA FILE
seksyon para sa mga detalye):

chunked, htmlhelp
Ang chunked output directory.

EPUB
Ang naka-archive na direktoryo ng OEBPS.

xhtml
Ang output DESTINATION_DIR.

. =
Kapag nagdaragdag ng mga mapagkukunan sa mga EPUB file ang mimetype ay hinuhulaan mula sa
file> extension, kung ang mimetype ay hindi mahulaan na may naganap na error. Ang
. = maaaring gamitin ang resource syntax upang tahasang magtakda ng mga mimetype. ay
ang extension ng pangalan ng file, ay ang kaukulang uri ng MIME.

Mga halimbawa ng opsyon sa mapagkukunan:

--resource ../images/
--resource doc/README.txt=README.txt
--pinagkukunan ~/images/tiger.png=images/tiger.png
--resource .ttf=application/x-font-ttf

HALIMBAWA


a2x -f pdf doc/source-highlight-filter.txt
Bumubuo ng doc/source-highlight-filter.pdf file.

a2x -f xhtml -D ../doc --icons -r ../images/ team.txt
Lumilikha ng HTML file ../doc/team.html, gumagamit ng mga icon ng babala at paulit-ulit na naghahanap sa
../images/ direktoryo para sa anumang nawawalang mapagkukunan.

a2x -f manpage doc/asciidoc.1.txt
Bumuo ng doc/asciidoc.1 manpage.

KINAKAILANGAN


a2x gumagamit ng mga sumusunod na programa:

· Asciidoc: http://asciidoc.org/

· xsltproc: (lahat ng mga format maliban sa teksto): http://xmlsoft.org/XSLT/

· DocBook XSL Mga Stylesheet (lahat ng mga format maliban sa teksto):
http://docbook.sourceforge.net/projects/xsl/

· dblatex (pdf, dvi, ps, tex na mga format): http://dblatex.sourceforge.net/

· FOP (pdf format — alternatibong PDF file generator): http://xmlgraphics.apache.org/fop/

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

· musang (format ng text — alternatibong text file generator): http://lynx.isc.org/

· epubcheck (format ng epub — validator ng file ng EPUB): http://code.google.com/p/epubcheck/

Tingnan din ang pinakabagong README file.

CONF MGA FILE


Ang isang configuration file ay naglalaman ng executable Python code na nag-o-override sa global
mga parameter ng pagsasaayos sa a2x.py. Ang mga opsyonal na configuration file ay na-load sa
sumusunod na pagkakasunud-sunod:

1. a2x.conf mula sa direktoryo na naglalaman ng a2x.py maipapatupad.

2. a2x.conf mula sa AsciiDoc global configuration directory. Laktawan ang hakbang na ito kung tayo nga
pagsasagawa ng lokal na naka-install (hindi malawak na sistema) na kopya.

3. a2x.conf mula sa AsciiDoc $HOME/.asciidoc configuration directory.

4. Ang CONF_FILE tinukoy sa --conf-file pagpipilian.

Narito ang mga default na halaga ng opsyon sa configuration file:

# Ang opsyonal na environment variable na diksyunaryo ay ipinasa sa
# nagsasagawa ng mga programa. Kung nakatakda sa Wala ang umiiral
# environment ang ginagamit.
ENV = Wala

# Mga panlabas na executable.
ASCIIDOC = 'asciidoc'
XSLTPROC = 'xsltproc'
DBLATEX = 'dblatex' # henerasyon ng pdf.
FOP = 'fop' # pdf generation (--fop na opsyon).
W3M = 'w3m' # pagbuo ng teksto.
LYNX = 'lynx' # pagbuo ng teksto (kung walang w3m).
XMLLINT = 'xmllint' # Itakda sa '' upang huwag paganahin.
EPUBCHECK = 'epubcheck' # Itakda sa '' upang huwag paganahin.
# Panlabas na maipapatupad na mga default na opsyon.
ASCIIDOC_OPTS = ''
DBLATEX_OPTS = ''
FOP_OPTS = ''
XSLTPROC_OPTS = ''

Gumamit ng a2x online gamit ang mga serbisyo ng onworks.net


Ad


Ad

Pinakabagong Linux at Windows online na mga programa