a2x - Dalam talian di Awan

JADUAL:

NAMA

a2x - Pengurus rantai alat untuk AsciiDoc (menukar fail teks Asciidoc kepada fail lain
format)

SINOPSIS

a2x [PILIHAN] FAIL SUMBER

DESCRIPTION

Pengurus rantai alat DocBook yang menterjemah fail teks AsciiDoc FAIL SUMBER ke PDF,
EPUB, DVI, PS, LaTeX, XHTML (halaman tunggal atau bongkah), halaman manual, Bantuan HTML atau teks biasa
format menggunakan asciidoc(1) dan aplikasi lain (lihat bahagian KEPERLUAN). FAIL SUMBER boleh
juga menjadi fail DocBook dengan sambungan .xml.

PILIHAN

-A, --atribut=Atribut
Tetapkan asciidoc(1) nilai atribut (pintasan untuk --asciidoc-opts="-a Atribut" pilihan).
Pilihan ini boleh ditentukan lebih daripada sekali.

--asciidoc-opts=ASCIIDOC_OPTS
Tambahan asciidoc(1) pilihan. Pilihan ini boleh ditentukan lebih daripada sekali.

--conf-file=CONF_FILE
Muatkan fail konfigurasi. Lihat bahagian CONF FILES.

-D, --destination-dir=DESTINATION_DIR
Direktori output. Lalai kepada FAIL SUMBER direktori. Pilihan ini hanya terpakai untuk
Format output berasaskan HTML (tergelincir, ePub, htmlbantuan, xhtml).

-d, --doctype=DOCTYPE
Jenis dokumen DocBook: artikel, halaman rumah or buku. Jenis dokumen lalai ialah artikel
melainkan formatnya halaman rumah (dalam hal ini ia lalai kepada halaman rumah).

-b, --belakang=KEMBALI
KEMBALI ialah nama pemalam bahagian belakang yang dipasang. Apabila pilihan ini ditentukan a2x
percubaan memuatkan nama fail a2x-backend.py daripada KEMBALI direktori plugin Ia kemudian
menukar FAIL SUMBER kepada KEMBALI fail output diformat menggunakan fungsi global
ditakrifkan dalam a2x-backend.py dipanggil to_BACKEND.

-f, --format=FORMAT
Format output: tergelincir, buku dokumen, dvi, ePub, htmlbantuan, halaman rumah, pdf (lalai), ps,
tex, teks, xhtml. AsciiDoc format a2x nilai atribut ditetapkan kepada FORMAT.

-h, - membantu
Cetak sintaks baris arahan dan pilihan program untuk stdout.

--ikon
Gunakan imej ikon peringatan atau navigasi dalam dokumen output. Tingkah laku lalai ialah
untuk menggunakan teks sebagai ganti ikon.

--ikon-dir=PATH
Laluan (berbanding dengan fail output) yang mengandungi ikon peringatan dan navigasi. Lalai
kepada imej/ikon. The --ikon pilihan adalah tersirat jika pilihan ini digunakan.

-k, --simpan-artifak
Jangan padamkan fail binaan sementara.

--lynx
Penggunaan Lynx(1) untuk menjana output berformat teks. Tingkah laku lalai adalah menggunakan w3m(1).

-L, --no-xmlint
Jangan semak output asciidoc dengan xmlint(1).

---epubcheck
Semak output EPUB dengan epubcheck(1).

-n, --lari kering
Jangan buat apa-apa cuma cetak apa yang sepatutnya dilakukan.

-r, --sumber=RESOURCE_SPEC
Nyatakan sumber. Pilihan ini boleh ditentukan lebih daripada sekali. Lihat SUMBER
bahagian untuk maklumat lebih lanjut.

-m, --sumber-manifes=FAIL
FAIL mengandungi sumber senarai (satu setiap baris). Nyata FAIL entri diformatkan
seperti --sumber hujah pilihan. Pembolehubah persekitaran dan rumah tilde
direktori dibenarkan.

--stylesheet=LEMBARAN GAYA
Senarai terhad ruang bagi satu atau lebih nama fail lembaran gaya CSS yang digunakan untuk menggayakan
Output HTML yang dijana oleh DocBook XSL Stylesheets. Lalai kepada docbook-xsl.css. Yang
lembaran gaya diproses dalam susunan senarai. Lembaran gaya mesti berada dalam lembaran yang sah
lokasi fail sumber. Digunakan untuk format HTML: xhtml, ePub, tergelincir, htmlbantuan
format.

-v, --verbose
Cetak butiran operasi ke stderr. Sesaat -v pilihan menggunakan pilihan verbose untuk
arahan rantai alat.

--versi
Cetak versi program ke stdout.

--xsltproc-opts=XSLTPROC_OPTS
Tambahan xsltproc(1) pilihan. Pilihan ini boleh ditentukan lebih daripada sekali.

--xsl-file=XSL_FILE
Gantikan helaian gaya XSL terbina dalam dengan helaian gaya XSL tersuai XSL_FILE.

--fop
Gunakan FOP untuk menjana PDF. Tingkah laku lalai adalah menggunakan dblatex(1). Yang --fop pilihan
adalah tersirat jika pilihan ini digunakan.

--fop-opts=FOP_OPTS
Tambahan fop(1) pilihan. Jika pilihan ini ditentukan FOP digunakan untuk menjana PDF.
Pilihan ini boleh ditentukan lebih daripada sekali.

--dblatex-opts=DBLATEX_OPTS
Tambahan dblatex(1) pilihan. Pilihan ini boleh ditentukan lebih daripada sekali.

--pilihan-belakang=KEMBALIEND_OPTS
Pilihan untuk pemalam bahagian belakang yang ditentukan oleh --belakang pilihan. Pilihan ini mungkin
dinyatakan lebih daripada sekali.

Pilihan juga boleh ditetapkan dalam fail sumber AsciiDoc. Jika FAIL SUMBER mengandungi komen
baris bermula dengan // a2x: maka baki barisan akan dianggap sebagai a2x
pilihan baris arahan. Sebagai contoh:

// pilihan lalai a2x.
// a2x: -dbook --epubcheck
// Sekat sejarah semakan dalam output dblatex.
// a2x: --dblatex-opts "-P latex.output.revhistory=0"

· Pilihan yang merangkumi berbilang baris ulasan tersebut akan digabungkan.

· Sifar atau lebih aksara ruang putih boleh muncul di antara yang terkemuka // and a2x:.

· Pilihan baris perintah diutamakan daripada pilihan yang ditetapkan dalam fail sumber.

OUTPUT FILES

Fail output ditulis ke direktori yang ditentukan oleh --destination-dir pilihan. Jika tidak
--destination-dir pilihan ditetapkan fail output ditulis ke FAIL SUMBER direktori.

Fail output mempunyai nama yang sama dengan FAIL SUMBER tetapi dengan nama fail yang sesuai
sambungan: .html untuk xhtml; .epub untuk ePub; .hhp untuk htmlbantuan; .pdf untuk pdf; .teks untuk
teks, .xml untuk buku dokumen. Mengikut konvensyen halaman manual tidak mempunyai sambungan .man (bahagian halaman lelaki
nombor sahaja). Nama direktori HTML terpotong mempunyai sambungan .chunked; Bantuan HTML ketulan
nama direktori mempunyai sambungan .htmlhelp.

Nama fail sedia ada yang sama akan ditimpa.

Selain menjana fail HTML xhtml, ePub, tergelincir and htmlbantuan format memastikan
fail sumber disalin ke lokasi direktori destinasi yang betul.

SUMBER

Sumber ialah fail (biasanya CSS dan imej) yang diperlukan oleh output berasaskan HTML
(xhtml, ePub, tergelincir, htmlbantuan format). a2x mengimbas fail HTML yang dijana dan membina a
senarai fail CSS dan imej yang diperlukan. Fail sumber tambahan boleh ditentukan
secara eksplisit menggunakan --sumber pilihan.

a2x mencari fail sumber di lokasi berikut dalam susunan berikut:

1. The FAIL SUMBER direktori.

2. Direktori sumber yang ditentukan oleh --sumber pilihan (dicari secara rekursif).

3. Direktori sumber yang ditentukan oleh --sumber-manifes pilihan (dicari secara rekursif
mengikut susunan ia muncul dalam fail manifes).

4. Imej stok dan direktori helaian gaya dalam asciidoc(1) fail konfigurasi
direktori (dicari secara rekursif).

5. Direktori destinasi.

Apabila fail sumber ditemui, ia disalin ke direktori destinasi relatif yang betul.
Subdirektori destinasi yang tiada dibuat secara automatik.

Terdapat dua mekanisme yang berbeza untuk menentukan sumber tambahan:

1. Direktori sumber yang akan dicari secara rekursif untuk fail sumber yang hilang.

2. Fail sumber yang akan disalin ke direktori destinasi output.

Sumber ditentukan dengan --sumber nilai pilihan yang boleh menjadi salah satu daripada berikut
format:


[= ]
. =

Di mana:


Menentukan direktori (mutlak atau relatif kepada FAIL SUMBER) yang dicari
secara rekursif untuk kehilangan fail sumber. Untuk menghapuskan kekaburan nama
hendaklah berakhir dengan watak pemisah direktori.


Menentukan fail sumber (mutlak atau relatif kepada FAIL SUMBER) yang akan
disalin ke . Jika tidak dinyatakan maka ia adalah
sama seperti .


Menentukan destinasi fail sumber yang disalin. The jalan adalah
berbanding dengan direktori destinasi (laluan mutlak tidak dibenarkan). Lokasi
direktori destinasi bergantung pada output FORMAT (Lihat OUTPUT FILES
bahagian untuk butiran):

chunked, htmlhelp
Direktori keluaran terpotong.

ePub
Direktori OEBPS yang diarkibkan.

xhtml
Keluarannya DESTINATION_DIR.

. =
Apabila menambahkan sumber pada fail EPUB, jenis mime disimpulkan daripada
file> sambungan, jika mimetype tidak dapat diteka ralat berlaku. The
. = sintaks sumber boleh digunakan untuk menetapkan mimetype secara eksplisit. ialah
sambungan nama fail, ialah jenis MIME yang sepadan.

Contoh pilihan sumber:

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

CONTOH

a2x -f pdf doc/source-highlight-filter.txt
Menghasilkan fail doc/source-highlight-filter.pdf.

a2x -f xhtml -D ../doc --icons -r ../images/ team.txt
Mencipta fail HTML ../doc/team.html, menggunakan ikon peringatan dan mencari secara rekursif
../images/ direktori untuk sebarang sumber yang hilang.

a2x -f halaman manual doc/asciidoc.1.txt
Hasilkan halaman manual doc/asciidoc.1.

SYARAT

a2x menggunakan program berikut:

· Asciidoc: http://asciidoc.org/

· xsltproc: (semua format kecuali teks): http://xmlsoft.org/XSLT/

· DocBook XSL Lembaran gaya (semua format kecuali teks):
http://docbook.sourceforge.net/projects/xsl/

· dblatex (format pdf, dvi, ps, teks): http://dblatex.sourceforge.net/

· FOP (format pdf - penjana fail PDF alternatif): http://xmlgraphics.apache.org/fop/

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

· lynx (format teks — penjana fail teks alternatif): http://lynx.isc.org/

· epubcheck (format epub — pengesah fail EPUB): http://code.google.com/p/epubcheck/

Lihat juga fail README terkini.

SULIT FILES

Fail konfigurasi mengandungi kod Python boleh laku yang mengatasi kod global
parameter konfigurasi dalam a2x.py. Fail konfigurasi pilihan dimuatkan dalam
perintah berikut:

1. a2x.conf daripada direktori yang mengandungi a2x.py boleh laku.

2. a2x.conf daripada direktori konfigurasi global AsciiDoc. Langkau langkah ini jika kita
melaksanakan salinan yang dipasang secara tempatan (bukan seluruh sistem).

3. a2x.conf daripada direktori konfigurasi AsciiDoc $HOME/.asciidoc.

4. The CONF_FILE dinyatakan dalam --conf-file pilihan.

Berikut ialah nilai pilihan fail konfigurasi lalai:

# Kamus pembolehubah persekitaran pilihan diserahkan kepada
# melaksanakan program. Jika ditetapkan kepada Tiada yang sedia ada
# persekitaran digunakan.
ENV = Tiada

# Boleh laku luaran.
ASCIIDOC = 'asciidoc'
XSLTPROC = 'xsltproc'
DBLATEX = 'dblatex' # penjanaan pdf.
FOP = 'fop' # penjanaan pdf (--fop pilihan).
W3M = 'w3m' # penjanaan teks.
LYNX = 'lynx' # penjanaan teks (jika tiada w3m).
XMLLINT = 'xmllint' # Tetapkan kepada '' untuk melumpuhkan.
EPUBCHECK = 'epubcheck' # Tetapkan kepada '' untuk melumpuhkan.
# Pilihan lalai boleh laku luaran.
ASCIIDOC_OPTS = ''
DBLATEX_OPTS = ''
FOP_OPTS = ''
XSLTPROC_OPTS = ''

Gunakan a2x dalam talian menggunakan perkhidmatan onworks.net