a2x - क्लाउड में ऑनलाइन

कार्यक्रम:

नाम

a2x - AsciiDoc के लिए एक टूलचेन प्रबंधक (Asciidoc टेक्स्ट फ़ाइलों को अन्य फ़ाइल में कनवर्ट करता है
प्रारूप)

SYNOPSIS

a2x [विकल्प] स्रोत दस्तावेज

वर्णन

एक DocBook टूलचेन प्रबंधक जो AsciiDoc टेक्स्ट फ़ाइल का अनुवाद करता है स्रोत दस्तावेज पीडीएफ के लिए,
EPUB, DVI, PS, LaTeX, XHTML (एकल पृष्ठ या खंडित), मैन पेज, HTML सहायता या सादा पाठ
प्रारूपों का उपयोग आस्कीडोक(1) और अन्य एप्लिकेशन (आवश्यक अनुभाग देखें)। स्रोत दस्तावेज कर सकते हैं
एक .xml एक्सटेंशन वाली DocBook फ़ाइल भी हो।

विकल्प

-ए --गुण=गुण
सेट आस्कीडोक(1) विशेषता मान (के लिए शॉर्टकट --asciidoc-opts="-ए गुण" विकल्प)।
यह विकल्प एक से अधिक बार निर्दिष्ट किया जा सकता है।

--asciidoc-opts=ASCIIDOC_OPTS
अतिरिक्त आस्कीडोक(1) विकल्प। यह विकल्प एक से अधिक बार निर्दिष्ट किया जा सकता है।

--conf-फ़ाइल=CONF_फ़ाइल
कॉन्फ़िगरेशन फ़ाइल लोड करें। कॉन्फ़ फ़ाइलें अनुभाग देखें।

-डी, --गंतव्य-दिरो=DESTINATION_DIR
उत्पादन निर्देशिका। डिफ़ॉल्ट करने के लिए स्रोत दस्तावेज निर्देशिका। यह विकल्प केवल पर लागू होता है
एचटीएमएल आधारित आउटपुट स्वरूप (ठगा हुआ, ePub, htmlसहायता, एक्सएचटीएमएल).

-डी, --डॉक्ट टाइप=DOCTYPE
डॉकबुक दस्तावेज़ प्रकार: लेख, मैनपेज or किताब. डिफ़ॉल्ट दस्तावेज़ प्रकार है लेख
जब तक प्रारूप नहीं है मैनपेज (किस मामले में यह चूक करता है मैनपेज).

-बी, --बैकएंड=बैकएंड
बैकएंड एक स्थापित बैकएंड प्लगइन का नाम है। जब यह विकल्प निर्दिष्ट किया जाता है a2x
फ़ाइल नाम लोड करने का प्रयास a2x-backend.py से बैकएंड प्लगइन निर्देशिका यह तो
धर्मान्तरित स्रोत दस्तावेज एक करने के लिए बैकएंड वैश्विक फ़ंक्शन का उपयोग करके स्वरूपित आउटपुट फ़ाइल
में परिभाषित किया गया a2x-backend.py बुलाया to_BACKEND.

-एफ, --प्रारूप=FORMAT
आउटपुट स्वरूप: ठगा हुआ, डॉकबुक, डीवीआई, ePub, htmlसहायता, मैनपेज, पीडीएफ (डिफ़ॉल्ट), ps,
tex, टेक्स्ट, एक्सएचटीएमएल. AsciiDoc a2x-प्रारूप विशेषता मान पर सेट है FORMAT.

-एच, --मदद
कमांड लाइन सिंटैक्स और प्रोग्राम विकल्प को स्टडआउट में प्रिंट करें।

--आइकन
आउटपुट दस्तावेज़ों में चेतावनी या नेविगेशन आइकन छवियों का उपयोग करें। डिफ़ॉल्ट व्यवहार है
आइकन के स्थान पर टेक्स्ट का उपयोग करने के लिए।

--आइकन-दिरो=पथ
एक पथ (आउटपुट फ़ाइलों के सापेक्ष) जिसमें चेतावनी और नेविगेशन आइकन होते हैं। चूक
छवियों / चिह्नों के लिए। NS --आइकन विकल्प निहित है यदि इस विकल्प का उपयोग किया जाता है।

-क, --रखने-कलाकृतियों
अस्थायी बिल्ड फ़ाइलों को न हटाएं।

--लिंक्स
उपयोग बनबिलाव(1) पाठ स्वरूपित आउटपुट उत्पन्न करने के लिए। डिफ़ॉल्ट व्यवहार का उपयोग करना है w3m(1).

-एल, --no-xmlint
के साथ asciidoc आउटपुट की जांच न करें एक्सएमएललिंट(1).

---एपबचेक
EPUB आउटपुट की जाँच करें एपबचेक(1).

-एन, --पूर्वाभ्यास
कुछ मत करो बस जो हो गया होता उसे छाप दो।

-आर, --संसाधन=संसाधन_SPEC
एक संसाधन निर्दिष्ट करें। यह विकल्प एक से अधिक बार निर्दिष्ट किया जा सकता है। देखें संसाधन
अधिक जानकारी के लिए अनुभाग।

-एम, --संसाधन-प्रकट=फ़ाइल
फ़ाइल एक सूची संसाधन (प्रति पंक्ति एक) शामिल है। घोषणापत्र फ़ाइल प्रविष्टियां स्वरूपित हैं
बिलकुल इसके जैसा --संसाधन विकल्प तर्क। पर्यावरण चर और टिल्ड होम
निर्देशिकाओं की अनुमति है।

--शैली पत्रक=शैली पत्रक
एक या एक से अधिक CSS स्टाइलशीट फ़ाइल नामों की एक स्पेस सीमांकित सूची जो स्टाइल करने के लिए उपयोग की जाती है
DocBook XSL Stylesheets द्वारा जेनरेट किया गया HTML आउटपुट। डिफ़ॉल्ट करने के लिए docbook-xsl.css।
स्टाइलशीट को सूची क्रम में संसाधित किया जाता है। स्टाइलशीट को वैध में रहना चाहिए
संसाधन फ़ाइल स्थान। एचटीएमएल प्रारूपों पर लागू होता है: एक्सएचटीएमएल, ePub, ठगा हुआ, htmlसहायता
प्रारूपों.

-में, --शब्दशः
परिचालन विवरण को stderr पर प्रिंट करें। एक दूसरा -v विकल्प क्रिया विकल्प को लागू करता है
टूलचेन कमांड।

--संस्करण
प्रोग्राम संस्करण को स्टडआउट पर प्रिंट करें।

--xsltproc-opts=XSLTPROC_OPTS
अतिरिक्त xsltpro(1) विकल्प। यह विकल्प एक से अधिक बार निर्दिष्ट किया जा सकता है।

--xsl-फ़ाइल=XSL_फ़ाइल
कस्टम XSL स्टाइलशीट के साथ बिल्ट-इन XSL स्टाइलशीट को ओवरराइड करें XSL_फ़ाइल.

--fop
PDF बनाने के लिए FOP का उपयोग करें। डिफ़ॉल्ट व्यवहार का उपयोग करना है dblatex(1)। --fop विकल्प
निहित है यदि इस विकल्प का उपयोग किया जाता है।

--फॉप-ऑप्स=FOP_OPTS
अतिरिक्त बांका(1) विकल्प। यदि यह विकल्प निर्दिष्ट है तो FOP का उपयोग PDF बनाने के लिए किया जाता है।
यह विकल्प एक से अधिक बार निर्दिष्ट किया जा सकता है।

--dblatex-opts=डीबीएलएटीएक्स_ओपीटीएस
अतिरिक्त dblatex(1) विकल्प। यह विकल्प एक से अधिक बार निर्दिष्ट किया जा सकता है।

--बैकएंड-ऑप्ट्स=वापसEND_OPTS
द्वारा निर्दिष्ट बैकएंड प्लगइन के लिए विकल्प --बैकएंड विकल्प। यह विकल्प हो सकता है
एक से अधिक बार निर्दिष्ट।

विकल्प AsciiDoc स्रोत फ़ाइल में भी सेट किए जा सकते हैं। अगर स्रोत दस्तावेज एक टिप्पणी है
से शुरू होने वाली रेखा // a2x: तो शेष पंक्ति को के रूप में माना जाएगा a2x
कमांड लाइन विकल्प। उदाहरण के लिए:

// a2x डिफ़ॉल्ट विकल्प।
// a2x: -dbook --epubcheck
// dblatex आउटपुट में संशोधन इतिहास को दबाएं।
// a2x: --dblatex-opts "-Platex.output.revhistory=0"

· ऐसी कई टिप्पणी पंक्तियों में फैले विकल्पों को जोड़ा जाएगा।

अग्रणी के बीच शून्य या अधिक सफेद स्थान वर्ण दिखाई दे सकते हैं // और a2x:.

स्रोत फ़ाइल में सेट किए गए विकल्पों पर कमांड-लाइन विकल्प प्राथमिकता लेते हैं।

आउटपुट फ़ाइलें

आउटपुट फ़ाइलें किसके द्वारा निर्दिष्ट निर्देशिका में लिखी जाती हैं --गंतव्य-दिरो विकल्प। अगर नहीं
--गंतव्य-दिरो विकल्प सेट है आउटपुट फाइल को लिखा जाता है स्रोत दस्तावेज निर्देशिका.

आउटपुट फाइलों का वही नाम है जो स्रोत दस्तावेज लेकिन एक उपयुक्त फ़ाइल नाम के साथ
एक्सटेंशन: .html for एक्सएचटीएमएल; .epub के लिए ePub; .hhp के लिए htmlसहायता; .पीडीएफ के लिए पीडीएफ; .पाठ्यक्रम
टेक्स्ट, .xml के लिए डॉकबुक. कन्वेंशन द्वारा मैनपेज में कोई .मैन एक्सटेंशन नहीं है (मैन पेज सेक्शन
केवल संख्या)। खंडित HTML निर्देशिका नामों में एक .chunked एक्सटेंशन होता है; खंडित HTML सहायता
निर्देशिका नामों में एक .htmlसहायता एक्सटेंशन होता है।

समान नामित मौजूदा फ़ाइलें अधिलेखित हैं।

HTML फ़ाइलें जनरेट करने के अलावा एक्सएचटीएमएल, ePub, ठगा हुआ और htmlसहायता प्रारूप सुनिश्चित करते हैं
संसाधन फ़ाइलों को उनके सही गंतव्य निर्देशिका स्थानों पर कॉपी किया जाता है।

संसाधन

संसाधन फाइलें (आमतौर पर सीएसएस और छवियां) हैं जो HTML आधारित आउटपुट के लिए आवश्यक हैं
(एक्सएचटीएमएल, ePub, ठगा हुआ, htmlसहायता प्रारूप)। a2x जेनरेट की गई HTML फ़ाइलों को स्कैन करता है और एक बनाता है
आवश्यक CSS और छवि फ़ाइलों की सूची। अतिरिक्त संसाधन फ़ाइलें निर्दिष्ट की जा सकती हैं
स्पष्ट रूप से का उपयोग करना --संसाधन विकल्प.

a2x निम्नलिखित स्थानों में संसाधन फ़ाइलों की खोज निम्न क्रम में करता है:

1. स्रोत दस्तावेज निर्देशिका.

2. संसाधन निर्देशिका द्वारा निर्दिष्ट --संसाधन विकल्प (पुनरावर्ती रूप से खोजा गया)।

3. संसाधन निर्देशिका द्वारा निर्दिष्ट --संसाधन-प्रकट विकल्प (पुनरावर्ती खोजा गया)
क्रम में वे मेनिफेस्ट फ़ाइल में दिखाई देते हैं)।

4. स्टॉक छवियों और स्टाइलशीट निर्देशिकाओं में आस्कीडोक(1) कॉन्फ़िगरेशन फ़ाइलें
निर्देशिका (पुनरावर्ती रूप से खोजा गया)।

5. गंतव्य निर्देशिका।

जब कोई संसाधन फ़ाइल मिलती है तो उसे सही सापेक्ष गंतव्य निर्देशिका में कॉपी किया जाता है।
गुम गंतव्य उप-निर्देशिकाएं स्वचालित रूप से बनाई जाती हैं।

अतिरिक्त संसाधनों को निर्दिष्ट करने के लिए दो अलग-अलग तंत्र हैं:

1. एक संसाधन निर्देशिका जिसे लापता संसाधन फ़ाइलों के लिए पुनरावर्ती रूप से खोजा जाएगा।

2. एक संसाधन फ़ाइल जिसे आउटपुट गंतव्य निर्देशिका में कॉपी किया जाएगा।

संसाधनों के साथ निर्दिष्ट हैं --संसाधन विकल्प मान जो निम्न में से एक हो सकते हैं
प्रारूप:


[= ]
. =

कहा पे:


एक निर्देशिका निर्दिष्ट करता है (पूर्ण या सापेक्ष स्रोत दस्तावेज) जो खोजा गया है
लापता संसाधन फ़ाइलों के लिए पुनरावर्ती रूप से। अस्पष्टता को दूर करने के लिए नाम
एक निर्देशिका विभाजक चरित्र के साथ समाप्त होना चाहिए।


एक संसाधन फ़ाइल निर्दिष्ट करता है (पूर्ण या संबंधित स्रोत दस्तावेज) कौनसा
को कॉपी किया गया . अगर निर्दिष्ट नहीं है तो यह है
के समान .


कॉपी की गई स्रोत फ़ाइल का गंतव्य निर्दिष्ट करता है। NS पथ है
गंतव्य निर्देशिका के सापेक्ष (पूर्ण पथ की अनुमति नहीं है)। स्थान
गंतव्य निर्देशिका का आउटपुट पर निर्भर करता है FORMAT (देखें आउटपुट फ़ाइलें
विवरण के लिए अनुभाग):

खंडित, htmlhelp
खंडित आउटपुट निर्देशिका।

ePub
संग्रहीत OEBPS निर्देशिका।

एक्सएचटीएमएल
उत्पादन DESTINATION_DIR.

. =
EPUB फ़ाइलों में संसाधन जोड़ते समय mimetype का अनुमान लगाया जाता है
फ़ाइल> एक्सटेंशन, यदि माइमटाइप का अनुमान नहीं लगाया जा सकता है तो कोई त्रुटि होती है। NS
. = माइमटाइप को स्पष्ट रूप से सेट करने के लिए संसाधन सिंटैक्स का उपयोग किया जा सकता है। है
फ़ाइल नाम एक्सटेंशन, संबंधित MIME प्रकार है।

संसाधन विकल्प उदाहरण:

--संसाधन ../छवियां/
--संसाधन दस्तावेज़/README.txt=README.txt
--संसाधन ~/छवियां/टाइगर.png=छवियां/बाघ.पीएनजी
--संसाधन .ttf=application/x-font-ttf

उदाहरण

a2x -f पीडीएफ 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 मैनपेज doc/asciidoc.1.txt
doc/asciidoc.1 मैनपेज जेनरेट करें।

आवश्यक वस्तुएँ

a2x निम्नलिखित कार्यक्रमों का उपयोग करता है:

· आस्कीडोक: http://asciidoc.org/

· xsltpro: (पाठ को छोड़कर सभी प्रारूप): http://xmlsoft.org/XSLT/

· DocBook Segretario generale, in un messaggio per la Giornata Mondiale, sollecita investimenti nelle sani Suoli a Secure alimentare, Diritti d'acqua dolce, controlli i cambiamenti climatici - Sud-Sud Notizie स्टाइलशीट (पाठ को छोड़कर सभी प्रारूप):
http://docbook.sourceforge.net/projects/xsl/

· dblatex (पीडीएफ, डीवीआई, पीएस, टेक्स प्रारूप): http://dblatex.sourceforge.net/

· एफओपी (पीडीएफ प्रारूप - वैकल्पिक पीडीएफ फाइल जनरेटर): http://xmlgraphics.apache.org/fop/

· w3m (पाठ प्रारूप): http://w3m.sourceforge.net/index.en.html

· बनबिलाव (पाठ प्रारूप - वैकल्पिक पाठ फ़ाइल जनरेटर): http://lynx.isc.org/

· एपबचेक (epub प्रारूप - EPUB फ़ाइल सत्यापनकर्ता): http://code.google.com/p/epubcheck/

नवीनतम रीडमे फ़ाइल भी देखें।

सम्मेलन फ़ाइलें

कॉन्फ़िगरेशन फ़ाइल में निष्पादन योग्य पायथन कोड होता है जो वैश्विक को ओवरराइड करता है
a2x.py में कॉन्फ़िगरेशन पैरामीटर। वैकल्पिक कॉन्फ़िगरेशन फ़ाइलें लोड की जाती हैं
निम्नलिखित आदेश:

1. a2x.conf निर्देशिका से युक्त a2x.py निष्पादन योग्य।

2. a2x.conf AsciiDoc वैश्विक विन्यास निर्देशिका से। अगर हम हैं तो इस चरण को छोड़ दें
स्थानीय रूप से स्थापित (गैर सिस्टम वाइड) प्रतिलिपि निष्पादित करना।

3. a2x.conf AsciiDoc $HOME/.asciidoc कॉन्फ़िगरेशन निर्देशिका से।

4. CONF_फ़ाइल में निर्दिष्ट है --conf-फ़ाइल विकल्प.

यहाँ डिफ़ॉल्ट कॉन्फ़िगरेशन फ़ाइल विकल्प मान हैं:

# वैकल्पिक पर्यावरण चर शब्दकोश को पास किया गया
#कार्यक्रमों का निष्पादन। यदि कोई मौजूदा पर सेट नहीं है
#पर्यावरण का उपयोग किया जाता है।
ईएनवी = कोई नहीं

# बाहरी निष्पादन योग्य।
ASCIIDOC = 'asciidoc'
XSLTPROC = 'xsltproc'
DBLATEX = 'dblatex' # pdf जेनरेशन।
FOP = 'fop' # pdf जनरेशन (--fop विकल्प)।
W3M = 'w3m' # टेक्स्ट जनरेशन।
LYNX = 'lynx' # टेक्स्ट जनरेशन (यदि नहीं तो w3m)।
XMLLINT = 'xmllint' # अक्षम करने के लिए '' पर सेट करें।
EPUBCHECK = 'epubcheck' # अक्षम करने के लिए '' पर सेट करें।
# बाहरी निष्पादन योग्य डिफ़ॉल्ट विकल्प।
ASCIIDOC_OPTS = ''
DBLATEX_OPTS = ''
FOP_OPTS = ''
XSLTPROC_OPTS = ''

onworks.net सेवाओं का उपयोग करके a2x ऑनलाइन का उपयोग करें