a2x - ออนไลน์ในคลาวด์

โครงการ:

ชื่อ

a2x - ตัวจัดการ toolchain สำหรับ AsciiDoc (แปลงไฟล์ข้อความ Asciidoc เป็นไฟล์อื่น
รูปแบบ)

เรื่องย่อ

a2x [OPTIONS] แหล่งที่มา_FILE

DESCRIPTION

ตัวจัดการชุดเครื่องมือ DocBook ที่แปลไฟล์ข้อความ AsciiDoc แหล่งที่มา_FILE เป็น PDF,
EPUB, DVI, PS, LaTeX, XHTML (หน้าเดียวหรือแบบแยกส่วน), หน้าคน, วิธีใช้ HTML หรือข้อความธรรมดา
รูปแบบโดยใช้ แอสซิอิดอค(1) และแอปพลิเคชันอื่น ๆ (ดูหัวข้อข้อกำหนด) แหล่งที่มา_FILE สามารถ
ยังเป็นไฟล์ DocBook ที่มีนามสกุล .xml

OPTIONS

-NS, --คุณลักษณะ=คุณสมบัติ
ชุด แอสซิอิดอค(1) ค่าแอตทริบิวต์ (ทางลัดสำหรับ --asciidoc-ตัวเลือก="-NS คุณลักษณะ" ตัวเลือก)
ตัวเลือกนี้อาจระบุได้มากกว่าหนึ่งครั้ง

--asciidoc-ตัวเลือก=ASCIIDOC_OPTS
เพิ่มเติม แอสซิอิดอค(1) ตัวเลือก. ตัวเลือกนี้อาจระบุได้มากกว่าหนึ่งครั้ง

--conf-ไฟล์=CONF_FILE
โหลดไฟล์การกำหนดค่า ดูส่วนไฟล์ CONF

-NS, --ปลายทาง-ผบ=DESTINATION_DIR
ไดเร็กทอรีเอาต์พุต ค่าเริ่มต้นเป็น แหล่งที่มา_FILE ไดเร็กทอรี ตัวเลือกนี้ใช้ได้เฉพาะกับ
รูปแบบเอาต์พุตตาม HTML (หั่นเป็นชิ้น, EPUB, htmlวิธีใช้, xhtml).

-NS, --doctype=DOCTYPE
ประเภทเอกสาร DocBook: บทความ, หน้าจัดการ or หนังสือ. ประเภทเอกสารเริ่มต้นคือ บทความ
เว้นแต่รูปแบบเป็น หน้าจัดการ (ในกรณีนี้ ค่าเริ่มต้นจะเป็น หน้าจัดการ).

-NS, --แบ็กเอนด์=ย้อนกลับ
ย้อนกลับ เป็นชื่อของปลั๊กอินแบ็กเอนด์ที่ติดตั้ง เมื่อระบุตัวเลือกนี้ a2x
พยายามโหลดชื่อไฟล์ a2x-backend.py จาก ย้อนกลับ ไดเร็กทอรีปลั๊กอิน แล้ว
แปลงไฟล์ แหล่งที่มา_FILE ไปยัง ย้อนกลับ ไฟล์เอาต์พุตที่จัดรูปแบบโดยใช้ฟังก์ชันส่วนกลาง
กำหนดไว้ใน a2x-backend.py ที่เรียกว่า ถึง_BACKEND.

-NS, --รูปแบบ=FORMAT
รูปแบบผลลัพธ์: หั่นเป็นชิ้น, เอกสาร, DVI, EPUB, htmlวิธีใช้, หน้าจัดการ, รูปแบบไฟล์ PDF (Default) ps,
tex, ข้อความ, xhtml. AsciiDoc รูปแบบ a2x ค่าแอตทริบิวต์ถูกตั้งค่าเป็น FORMAT.

-ชม, --ช่วยด้วย
พิมพ์ไวยากรณ์บรรทัดคำสั่งและตัวเลือกโปรแกรมไปที่ stdout

--ไอคอน
ใช้ภาพไอคอนคำเตือนหรือการนำทางในเอกสารส่งออก พฤติกรรมเริ่มต้นคือ
เพื่อใช้ข้อความแทนไอคอน

--icons-ผบ=เส้นทาง
เส้นทาง (เทียบกับไฟล์เอาต์พุต) ที่มีไอคอนคำเตือนและการนำทาง ค่าเริ่มต้น
ไปที่รูปภาพ/ไอคอน NS --ไอคอน option เป็นนัยถ้าใช้ตัวเลือกนี้

-เค --เก็บสิ่งประดิษฐ์
อย่าลบไฟล์บิลด์ชั่วคราว

--คม
ใช้ แมวป่าชนิดหนึ่ง(1) เพื่อสร้างผลลัพธ์ในรูปแบบข้อความ พฤติกรรมเริ่มต้นคือการใช้ w3m(1).

-แอล, --no-xmllint
อย่าตรวจสอบเอาต์พุต asciidoc ด้วย xmllint.xmllint(1).

---epubcheck
ตรวจสอบเอาต์พุต EPUB ด้วย epub ตรวจสอบ(1).

-NS, --ดรายรัน
อย่าทำอะไรเพียงแค่พิมพ์สิ่งที่จะทำ

-NS, --ทรัพยากร=ทรัพยากร_SPEC
ระบุทรัพยากร ตัวเลือกนี้อาจระบุได้มากกว่าหนึ่งครั้ง ดู ทรัพยากร
สำหรับรายละเอียดเพิ่มเติม

-NS, --ทรัพยากร-รายการ=ไฟล์
ไฟล์ มีรายการทรัพยากร (หนึ่งรายการต่อบรรทัด) ประจักษ์ ไฟล์ มีการจัดรูปแบบรายการ
เหมือนกับ --ทรัพยากร อาร์กิวเมนต์ตัวเลือก ตัวแปรสภาพแวดล้อมและบ้านตัวหนอน
ไดเร็กทอรีได้รับอนุญาต

--สไตล์ชีต=สไตล์ชีต
รายการที่คั่นด้วยช่องว่างของชื่อไฟล์สไตล์ชีต CSS หนึ่งชื่อขึ้นไปที่ใช้กับ style
เอาต์พุต HTML ที่สร้างโดย DocBook XSL Stylesheets ค่าเริ่มต้นเป็น docbook-xsl.css.
สไตล์ชีตจะได้รับการประมวลผลตามลำดับรายการ สไตล์ชีตต้องอยู่ใน valid
ตำแหน่งไฟล์ทรัพยากร ใช้กับรูปแบบ HTML: xhtml, EPUB, หั่นเป็นชิ้น, htmlวิธีใช้
รูปแบบ

-ใน, --รายละเอียด
พิมพ์รายละเอียดการดำเนินการไปที่ stderr วินาที -v option ใช้ตัวเลือก verbose เพื่อ
คำสั่ง toolchain

--รุ่น
พิมพ์เวอร์ชันของโปรแกรมไปที่ stdout

--xsltproc-ตัวเลือก=XSLTPROC_OPTS
เพิ่มเติม xsltproc(1) ตัวเลือก. ตัวเลือกนี้อาจระบุได้มากกว่าหนึ่งครั้ง

--xsl-ไฟล์=XSL_FILE
แทนที่สไตล์ชีต XSL ในตัวด้วยสไตล์ชีต XSL แบบกำหนดเอง XSL_FILE.

--ฟป
ใช้ FOP เพื่อสร้าง PDF พฤติกรรมเริ่มต้นคือการใช้ dblatex(1). --ฟป ตัวเลือก
เป็นนัยถ้าใช้ตัวเลือกนี้

--fop-ตัวเลือก=FOP_OPTS
เพิ่มเติม คนขี้แฅ่งฅัว(1) ตัวเลือก. หากระบุตัวเลือกนี้ FOP จะใช้เพื่อสร้าง PDF
ตัวเลือกนี้อาจระบุได้มากกว่าหนึ่งครั้ง

--dlatex-opts=DBLATEX_OPTS
เพิ่มเติม dblatex(1) ตัวเลือก. ตัวเลือกนี้อาจระบุได้มากกว่าหนึ่งครั้ง

--backend-ตัวเลือก=BACKEND_OPTS
ตัวเลือกสำหรับปลั๊กอินแบ็กเอนด์ที่ระบุโดย --แบ็กเอนด์ ตัวเลือก. ตัวเลือกนี้อาจจะเป็น
ระบุมากกว่าหนึ่งครั้ง

นอกจากนี้ยังสามารถตั้งค่าตัวเลือกในไฟล์ต้นทาง AsciiDoc ถ้า แหล่งที่มา_FILE มีความคิดเห็น
บรรทัดที่ขึ้นต้นด้วย // a2x: จากนั้นส่วนที่เหลือของบรรทัดจะถือว่าเป็น a2x
ตัวเลือกบรรทัดคำสั่ง ตัวอย่างเช่น:

// ตัวเลือกเริ่มต้น a2x
// a2x: -dbook --epubcheck
// ระงับประวัติการแก้ไขในเอาต์พุต dlatex
// a2x: --dlatex-opts "-P latex.output.revhistory=0"

· ตัวเลือกที่ครอบคลุมหลายบรรทัดความคิดเห็นจะถูกต่อเข้าด้วยกัน

· อักขระช่องว่างศูนย์หรือมากกว่าสามารถปรากฏขึ้นระหว่างนำหน้า // และ a2x:.

· ตัวเลือกบรรทัดคำสั่งมีความสำคัญเหนือตัวเลือกที่ตั้งค่าไว้ในไฟล์ต้นทาง

เอาท์พุท ไฟล์

ไฟล์เอาต์พุตถูกเขียนไปยังไดเร็กทอรีที่ระบุโดย the --ปลายทาง-ผบ ตัวเลือก. ถ้าไม่
--ปลายทาง-ผบ ตัวเลือกถูกตั้งค่าไฟล์เอาต์พุตถูกเขียนไปยัง แหล่งที่มา_FILE ไดเรกทอรี

ไฟล์เอาต์พุตมีชื่อเหมือนกับ the แหล่งที่มา_FILE แต่มีชื่อไฟล์ที่เหมาะสม
นามสกุล: .html สำหรับ xhtml; .epub สำหรับ EPUB; .hhp สำหรับ htmlวิธีใช้; .pdf สำหรับ รูปแบบไฟล์ PDF; .text สำหรับ
ข้อความ, .xml สำหรับ เอกสาร. โดยการประชุม manpages ไม่มีนามสกุล .man (ส่วนหน้าคน
เบอร์เท่านั้น) ชื่อไดเร็กทอรี HTML แบบเป็นกลุ่มมีนามสกุล .chunked วิธีใช้ HTML แบบแบ่งส่วน
ชื่อไดเร็กทอรีมีนามสกุล .htmlhelp

ไฟล์ที่มีอยู่ที่มีชื่อเดียวกันจะถูกเขียนทับ

นอกเหนือจากการสร้างไฟล์ HTML แล้ว xhtml, EPUB, หั่นเป็นชิ้น และ htmlวิธีใช้ รูปแบบมั่นใจ
ไฟล์ทรัพยากรถูกคัดลอกไปยังตำแหน่งไดเร็กทอรีปลายทางที่ถูกต้อง

ทรัพยากร

ทรัพยากรคือไฟล์ (โดยทั่วไปคือ CSS และรูปภาพ) ที่จำเป็นสำหรับเอาต์พุตที่ใช้ HTML
(xhtml, EPUB, หั่นเป็นชิ้น, htmlวิธีใช้ รูปแบบ) a2x สแกนไฟล์ HTML ที่สร้างและสร้าง a
รายการ CSS และไฟล์รูปภาพที่จำเป็น สามารถระบุไฟล์ทรัพยากรเพิ่มเติมได้
อย่างชัดเจนโดยใช้ --ทรัพยากร ตัวเลือก

a2x ค้นหาไฟล์ทรัพยากรในตำแหน่งต่อไปนี้ตามลำดับต่อไปนี้:

ในปี 1 แหล่งที่มา_FILE ไดเรกทอรี

2. ไดเรกทอรีทรัพยากรที่ระบุโดย --ทรัพยากร ตัวเลือก (ค้นหาซ้ำ)

3. ไดเรกทอรีทรัพยากรที่ระบุโดย --ทรัพยากร-รายการ ตัวเลือก (ค้นหาซ้ำ
ตามลำดับที่ปรากฏในไฟล์รายการ)

4. ภาพสต็อกและไดเร็กทอรีสไตล์ชีตใน แอสซิอิดอค(1) ไฟล์การกำหนดค่า
ไดเร็กทอรี (ค้นหาซ้ำ)

5. ไดเร็กทอรีปลายทาง

เมื่อพบไฟล์ทรัพยากร ไฟล์นั้นจะถูกคัดลอกไปยังไดเร็กทอรีปลายทางสัมพัทธ์ที่ถูกต้อง
ไดเรกทอรีย่อยปลายทางที่ขาดหายไปจะถูกสร้างขึ้นโดยอัตโนมัติ

มีสองกลไกที่แตกต่างกันสำหรับการระบุแหล่งข้อมูลเพิ่มเติม:

1. ไดเร็กทอรีทรัพยากรซึ่งจะถูกค้นหาซ้ำสำหรับไฟล์ทรัพยากรที่ขาดหายไป

2. ไฟล์ทรัพยากรซึ่งจะถูกคัดลอกไปยังไดเร็กทอรีปลายทางของเอาต์พุต

มีการระบุทรัพยากรด้วย --ทรัพยากร ค่าตัวเลือกที่สามารถเป็นหนึ่งในต่อไปนี้
รูปแบบ:


[= ]
. =

ที่ไหน:


ระบุไดเร็กทอรี (สัมบูรณ์หรือสัมพันธ์กับ แหล่งที่มา_FILE) ซึ่งถูกค้นหา
ซ้ำสำหรับไฟล์ทรัพยากรที่ขาดหายไป เพื่อขจัดความคลุมเครือ ชื่อ
ควรลงท้ายด้วยตัวคั่นไดเร็กทอรี


ระบุไฟล์ทรัพยากร (สัมบูรณ์หรือสัมพันธ์กับ แหล่งที่มา_FILE) ซึ่งจะ
คัดลอกไปที่ . ถ้า ไม่ได้ระบุไว้แล้วมันคือ
เช่นเดียวกับ .


ระบุปลายทางของไฟล์ต้นทางที่คัดลอก NS เส้นทางคือ
สัมพันธ์กับไดเร็กทอรีปลายทาง (ไม่อนุญาตให้ใช้เส้นทางสัมบูรณ์) สถานที่
ของไดเร็กทอรีปลายทางขึ้นอยู่กับเอาต์พุต FORMAT (โปรดดู เอาท์พุท ไฟล์
ส่วนรายละเอียด):

แบ่ง, htmlhelp
ไดเร็กทอรีเอาต์พุตแบบแบ่งส่วน

EPUB
ไดเร็กทอรี OEBPS ที่เก็บถาวร

xhtml
ผลลัพธ์ DESTINATION_DIR.

. =
เมื่อเพิ่มทรัพยากรลงในไฟล์ EPUB ประเภท mime จะอนุมานจาก
file> นามสกุล หากไม่สามารถเดาประเภท mime ได้ จะเกิดข้อผิดพลาด NS
. = ไวยากรณ์ของทรัพยากรสามารถใช้เพื่อตั้งค่า mimetypes อย่างชัดเจน เป็น
นามสกุลไฟล์, เป็นประเภท MIME ที่สอดคล้องกัน

ตัวอย่างตัวเลือกทรัพยากร:

--ทรัพยากร ../ภาพ/
--เอกสารทรัพยากร/README.txt=README.txt
--ทรัพยากร ~/images/tiger.png=images/tiger.png
--resource .ttf=application/x-font-ttf

ตัวอย่าง

a2x -f pdf doc/source-highlight-filter.txt
สร้างไฟล์ doc/source-highlight-filter.pdf

a2x -f xhtml -D ../doc --icons -r ../images/ team.txt
สร้างไฟล์ HTML ../doc/team.html ใช้ไอคอนคำเตือนและค้นหา .ซ้ำๆ
../images/ ไดเร็กทอรีสำหรับทรัพยากรที่ขาดหายไป

a2x -f manpage doc/asciidoc.1.txt
สร้าง doc/asciidoc.1 manpage

ข้อกำหนด

a2x ใช้โปรแกรมต่อไปนี้:

· แอสซิอิดอค: http://asciidoc.org/

· xsltproc: (ทุกรูปแบบยกเว้นข้อความ): http://xmlsoft.org/XSLT/

· DocBook XSL สไตล์ชีต (ทุกรูปแบบยกเว้นข้อความ):
http://docbook.sourceforge.net/projects/xsl/

· dblatex (รูปแบบ pdf, dvi, ps, tex): http://dblatex.sourceforge.net/

· ฟป (รูปแบบ pdf — ตัวสร้างไฟล์ PDF ทางเลือก): http://xmlgraphics.apache.org/fop/

· w3m (รูปแบบข้อความ): http://w3m.sourceforge.net/index.en.html

· แมวป่าชนิดหนึ่ง (รูปแบบข้อความ — ตัวสร้างไฟล์ข้อความทางเลือก): http://lynx.isc.org/

· epub ตรวจสอบ (รูปแบบ epub — โปรแกรมตรวจสอบไฟล์ EPUB): http://code.google.com/p/epubcheck/

ดูไฟล์ README ล่าสุดด้วย

คอนเฟิม ไฟล์

ไฟล์คอนฟิกูเรชันมีโค้ด Python ที่สามารถเรียกใช้งานได้ซึ่งจะแทนที่ global
พารามิเตอร์การกำหนดค่าใน a2x.py ไฟล์คอนฟิกูเรชันทางเลือกถูกโหลดใน
คำสั่งดังต่อไปนี้:

1. a2x.conf จากไดเร็กทอรีที่มี a2x.py ปฏิบัติการ

2. a2x.conf จากไดเร็กทอรีการกำหนดค่าสากลของ AsciiDoc ข้ามขั้นตอนนี้ถ้าเราเป็น
ดำเนินการคัดลอกที่ติดตั้งในเครื่อง (ไม่ใช่ทั้งระบบ)

3. a2x.conf จากไดเร็กทอรีการกำหนดค่า AsciiDoc $HOME/.asciidoc

ในปี 4 CONF_FILE ระบุไว้ใน --conf-ไฟล์ ตัวเลือก

ต่อไปนี้คือค่าตัวเลือกไฟล์การกำหนดค่าเริ่มต้น:

# พจนานุกรมตัวแปรสภาพแวดล้อมที่เป็นตัวเลือกส่งผ่านไปยัง
#การรันโปรแกรม หากตั้งค่าเป็นไม่มีที่มีอยู่
#สิ่งแวดล้อมถูกนำมาใช้
ENV = ไม่มี

# ปฏิบัติการภายนอก
ASCIIDOC = 'asciidoc'
XSLTPROC = 'xsltproc'
DBLATEX = 'dlatex' # การสร้าง pdf
FOP = 'fop' # การสร้าง pdf (ตัวเลือก --fop)
W3M = 'w3m' # การสร้างข้อความ
LYNX = 'lynx' # text generation (ถ้าไม่มี w3m)
XMLLINT = 'xmllint' # ตั้งค่าเป็น '' เพื่อปิดการใช้งาน
EPUBCHECK = 'epubcheck' # ตั้งค่าเป็น '' เพื่อปิดการใช้งาน
# ตัวเลือกเริ่มต้นภายนอกที่ปฏิบัติการได้
ASCIIDOC_OPTS = ''
DBLATEX_OPTS = ''
FOP_OPTS = ''
XSLTPROC_OPTS = ''

ใช้ a2x ออนไลน์โดยใช้บริการ onworks.net