a2x - آنلاین در ابر

برنامه:

نام

a2x - یک مدیر زنجیره ابزار برای AsciiDoc (فایل های متنی Asciidoc را به فایل های دیگر تبدیل می کند
قالب ها)

خلاصه

a2x [OPTIONS] منبع فایل

شرح

یک مدیر زنجیره ابزار DocBook که یک فایل متنی AsciiDoc را ترجمه می کند منبع فایل به PDF،
EPUB، DVI، PS، LaTeX، XHTML (تک صفحه یا تکه تکه شده)، صفحه اصلی، راهنمای HTML یا متن ساده
با استفاده از فرمت ها آسیدوک(1) و سایر برنامه ها (به بخش الزامات مراجعه کنید). منبع فایل می توان
همچنین یک فایل DocBook با پسوند xml. باشد.

OPTIONS

-آ، --صفت=صفت
تنظیم آسیدوک(1) مقدار ویژگی (میانبر برای --asciidoc-opts="-آ صفت" گزینه).
این گزینه ممکن است بیش از یک بار مشخص شود.

--asciidoc-opts=ASCIIDOC_OPTS
اضافی آسیدوک(1) گزینه ها. این گزینه ممکن است بیش از یک بار مشخص شود.

--conf-file=CONF_FILE
فایل پیکربندی را بارگیری کنید. بخش CONF FILES را ببینید.

-دی، -- مقصد - کارگردان=DESTINATION_DIR
دایرکتوری خروجی پیش فرض به منبع فایل فهرست راهنما. این گزینه فقط برای
فرمت های خروجی مبتنی بر HTML (تکه تکه شده, EPUB, html راهنما, xhtml).

-د، --doctype=دوبله
نوع سند DocBook: مقاله, صفحه مدیریت or کتاب. نوع سند پیش فرض است مقاله
مگر اینکه فرمت آن باشد صفحه مدیریت (در این صورت پیش فرض می شود صفحه مدیریت).

-ب، -- پس زمینه=پس زمینه
پس زمینه نام یک افزونه باطن نصب شده است. وقتی این گزینه مشخص شده باشد a2x
تلاش می کند نام فایل را بارگیری کند a2x-backend.py از پس زمینه دایرکتوری پلاگین آن را سپس
تبدیل می کند منبع فایل به پس زمینه فایل خروجی فرمت شده با استفاده از یک تابع سراسری
تعریف شده در a2x-backend.py نام به_BACKEND.

-f، --قالب=FORMAT
فرمت های خروجی: تکه تکه شده, کتاب مستند, دو, EPUB, html راهنما, صفحه مدیریت, پی دی اف (به طور پیش فرض) ps,
تگزاس, متن, xhtml. AsciiDoc فرمت a2x مقدار ویژگی تنظیم شده است FORMAT.

-h، --کمک
دستور خط فرمان و گزینه های برنامه را در stdout چاپ کنید.

-- نمادها
در اسناد خروجی از تصاویر نماد پیمایش یا هشدار استفاده کنید. رفتار پیش فرض است
استفاده از متن به جای نمادها

--icons-dir=PATH
یک مسیر (نسبت به فایل های خروجی) حاوی آیکون های هشدار و ناوبری. پیش فرض ها
به تصاویر/آیکون ها را -- نمادها اگر از این گزینه استفاده شود، گزینه ضمنی است.

-k، -- نگهداری - مصنوعات
فایل های ساخت موقت را حذف نکنید.

-- سیاهگوش
استفاده کنید سیاهگوش(1) برای تولید خروجی فرمت متنی رفتار پیش فرض استفاده است w3m(1).

-ل، --no-xmllint
خروجی asciidoc را با xmllint(1).

---epubcheck
خروجی EPUB را با epubcheck(1).

-n، -- خشک اجرا شود
کاری را انجام ندهید فقط آنچه را که انجام می شد چاپ کنید.

-r، -- منبع=RESOURCE_SPEC
یک منبع را مشخص کنید. این گزینه ممکن است بیش از یک بار مشخص شود. را ببینید منابع
بخش برای جزئیات بیشتر

-m، --منبع-نمایه=فایل
فایل شامل یک فهرست منابع (یکی در هر خط). آشکار فایل ورودی ها قالب بندی شده اند
درست مثل -- منبع آرگومان های گزینه متغیرهای محیطی و خانه تایلد
دایرکتوری ها مجاز هستند

-- شیوه نامه=STYLESHEET
فهرستی با فاصله از یک یا چند نام فایل شیوه نامه CSS که برای استایل استفاده می شود
خروجی HTML ایجاد شده توسط DocBook XSL Stylesheets. پیش فرض به docbook-xsl.css.
شیوه نامه ها به ترتیب فهرست پردازش می شوند. شیوه نامه ها باید در یک صفحه معتبر باشند
محل فایل منبع برای فرمت های HTML اعمال می شود: xhtml, EPUB, تکه تکه شده, html راهنما
فرمت.

-v، -- پرحرف
جزئیات عملیاتی را در stderr چاپ کنید. یک لحظه -v گزینه گزینه verbose را اعمال می کند
دستورات زنجیره ابزار

- نسخه
نسخه برنامه را در stdout چاپ کنید.

--xsltproc-opts=XSLTPROC_OPTS
اضافی xsltproc(1) گزینه ها. این گزینه ممکن است بیش از یک بار مشخص شود.

--xsl-فایل=XSL_FILE
صفحه سبک XSL داخلی را با شیوه نامه XSL سفارشی لغو کنید XSL_FILE.

--fop
از FOP برای تولید PDF استفاده کنید. رفتار پیش فرض استفاده است dblatex(1). --fop انتخاب
در صورت استفاده از این گزینه، ضمنی است.

--fop-opts=FOP_OPTS
اضافی فوپ کردن(1) گزینه ها. اگر این گزینه مشخص شده باشد از FOP برای تولید PDF استفاده می شود.
این گزینه ممکن است بیش از یک بار مشخص شود.

--dblatex-opts=DBLATEX_OPTS
اضافی dblatex(1) گزینه ها. این گزینه ممکن است بیش از یک بار مشخص شود.

----انتخاب=BACKEND_OPTS
گزینه های پلاگین backend مشخص شده توسط -- پس زمینه گزینه. این گزینه ممکن است
بیش از یک بار مشخص شده است.

گزینه ها را می توان در فایل منبع AsciiDoc نیز تنظیم کرد. اگر منبع فایل حاوی یک نظر است
خط شروع با // a2x: سپس بقیه خط به عنوان رفتار خواهد شد a2x
گزینه های خط فرمان مثلا:

// گزینه های پیش فرض a2x.
// a2x: -dbook --epubcheck
// سرکوب تاریخچه ویرایش در خروجی های dblatex.
// a2x: --dblatex-opts "-P latex.output.revhistory=0"

· گزینه های پوشا از خطوط نظر متعدد خواهد شد الحاق.

· صفر یا بیشتر کاراکترهای فضای سفید می توانند بین پیشرو ظاهر شوند // و a2x:.

· گزینه های خط فرمان بر گزینه های تنظیم شده در فایل منبع اولویت دارند.

OUTPUT فایل ها

فایل های خروجی در دایرکتوری مشخص شده توسط -- مقصد - کارگردان گزینه. اگر نه
-- مقصد - کارگردان گزینه تنظیم شده است فایل های خروجی به نوشته می شوند منبع فایل دایرکتوری.

فایل های خروجی هم نامی دارند منبع فایل اما با نام فایل مناسب
پسوند: html برای xhtml; .epub برای EPUB; .hp برای html راهنما; .pdf برای پی دی اف; .متن برای
متن، .xml برای کتاب مستند. طبق قرارداد، manpages پسوند .man ندارند (بخش man page
فقط شماره). نام دایرکتوری های HTML تکه تکه شده دارای پسوند .chunked هستند. راهنمای HTML تکه تکه شده
نام دایرکتوری ها دارای پسوند htmlhelp هستند.

فایل های موجود با همان نام رونویسی می شوند.

علاوه بر تولید فایل های HTML xhtml, EPUB, تکه تکه شده و html راهنما فرمت ها را تضمین می کند
فایل های منبع در مکان های دایرکتوری مقصد صحیح خود کپی می شوند.

منابع

منابع فایل هایی هستند (معمولاً CSS و تصاویر) که توسط خروجی های مبتنی بر HTML مورد نیاز هستند
(xhtml, EPUB, تکه تکه شده, html راهنما فرمت ها) a2x فایل های HTML تولید شده را اسکن می کند و a را می سازد
لیست CSS و فایل های تصویری مورد نیاز فایل های منبع اضافی را می توان مشخص کرد
به صراحت با استفاده از -- منبع گزینه.

a2x فایل های منبع را در مکان های زیر به ترتیب زیر جستجو می کند:

1. منبع فایل دایرکتوری.

2. فهرست منابع مشخص شده توسط -- منبع گزینه (جستجوی بازگشتی).

3. فهرست منابع مشخص شده توسط --منبع-نمایه گزینه (به صورت بازگشتی جستجو شد
به ترتیبی که در فایل مانیفست ظاهر می شوند).

4. فهرست تصاویر استوک و برگه های سبک در آسیدوک(1) پرونده های پیکربندی
دایرکتوری ها (جستجوی بازگشتی).

5. فهرست مقصد.

هنگامی که یک فایل منبع یافت می شود، در فهرست مقصد نسبی صحیح کپی می شود.
دایرکتوری های فرعی مقصد گم شده به طور خودکار ایجاد می شوند.

دو مکانیسم متمایز برای تعیین منابع اضافی وجود دارد:

1. دایرکتوری منبعی که به صورت بازگشتی برای فایل های منبع گم شده جستجو می شود.

2. یک فایل منبع که در فهرست مقصد خروجی کپی می شود.

منابع با مشخص شده است -- منبع مقادیر گزینه که می تواند یکی از موارد زیر باشد
فرمت ها:


[= ]
. =

جایی که:


یک دایرکتوری (مطلق یا نسبی به) را مشخص می کند منبع فایل) که جستجو می شود
به صورت بازگشتی برای فایل های منبع از دست رفته. برای رفع ابهام نام
باید با یک کاراکتر جداکننده دایرکتوری به پایان برسد.


یک فایل منبع (مطلق یا نسبی به) را مشخص می کند منبع فایل) کدام خواهد بود
کپی شده به . اگر مشخص نیست پس آن است
همان .


مقصد فایل منبع کپی شده را مشخص می کند. را مسیر است
نسبت به فهرست مقصد (مسیرهای مطلق مجاز نیستند). موقعیت
دایرکتوری مقصد به خروجی بستگی دارد FORMAT (نگاه کنید به OUTPUT فایل ها
بخش برای جزئیات):

تکه تکه شده، html help
دایرکتوری خروجی تکه تکه شده

EPUB
دایرکتوری OEBPS بایگانی شده

xhtml
خروجی DESTINATION_DIR.

. =
هنگام افزودن منابع به فایل های EPUB، نوع mime از روی استنباط می شود
file> پسوند، اگر نمی توان mimetype را حدس زد، خطایی رخ می دهد. در
. = از نحو منبع می توان برای تنظیم صریح mimetypes استفاده کرد. است
پسوند نام فایل، نوع MIME مربوطه است.

نمونه های گزینه منبع:

--منبع ../تصاویر/
--resource doc/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
ایجاد صفحه manpage doc/asciidoc.1.

ملزومات

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/

· FOP (فرمت pdf - تولید کننده فایل PDF جایگزین): http://xmlgraphics.apache.org/fop/

· w3m (فرمت متن): http://w3m.sourceforge.net/index.en.html

· سیاهگوش (فرمت متن - تولید کننده فایل متنی جایگزین): http://lynx.isc.org/

· epubcheck (فرمت epub - اعتبار سنجی فایل EPUB): http://code.google.com/p/epubcheck/

همچنین آخرین فایل README را ببینید.

تأیید فایل ها

یک فایل پیکربندی حاوی کد پایتون اجرایی است که سراسری را لغو می کند
پارامترهای پیکربندی در a2x.py. فایل های پیکربندی اختیاری در بارگذاری می شوند
ترتیب زیر

1. a2x.conf از دایرکتوری حاوی a2x.py قابل اجرا

2. a2x.conf از فهرست پیکربندی جهانی AsciiDoc. اگر ما هستیم از این مرحله بگذریم
اجرای یک کپی نصب شده محلی (غیر سیستمی).

3. a2x.conf از فهرست تنظیمات AsciiDoc $HOME/.asciidoc.

4. CONF_FILE مشخص شده در --conf-file گزینه.

در اینجا مقادیر گزینه فایل پیکربندی پیش فرض آمده است:

# فرهنگ لغت متغیر محیطی اختیاری به
# اجرای برنامه اگر روی None تنظیم شود موجود است
# محیط استفاده می شود.
ENV = هیچ

# فایل های اجرایی خارجی
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 آنلاین استفاده کنید