po4a-build - آنلاین در ابر

برنامه:

نام

po4a-build - ساخت اسناد ترجمه شده

خلاصه

po4a-build [-f | --فایل فایل] [---فقط قابلمه]

po4a-build [-? | -h | --کمک | - نسخه]

شرح

po4a-build در نظر گرفته شده است که تولید اسناد ترجمه شده را تا حد ممکن آسان کند
برای تولید محتوای فعلی ترجمه نشده

چه زمانی po4a محتوای ترجمه شده را به صورت POD یا DocBook XML، مستندات نهایی، آماده می کند
سپس می توان با استفاده از po4a-build. هر دو محتوای ترجمه نشده و ترجمه شده ساخته شده است
به عنوان یک فرآیند واحد، به روز رسانی فایل های POT در همان زمان.

دستورالعمل های ساخت موجود با یک تماس واحد جایگزین می شوند po4a-build و یک ساده
فایل پیکربندی برای گفتن استفاده می شود po4a-build نحوه ساخت هر عنصر و کدام باینری
بسته ها شامل محتوای ترجمه شده و ترجمه نشده خواهد بود.

پس از ساخته شدن، محتوا در دایرکتوری های مخصوص بسته در زیر آن قرار می گیرد BASEDIR
در فایل پیکربندی مشخص شده است. برای یک بسته باینری foo، با ترجمه به
آلمانی و فرانسوی، این منجر به:

BASEDIR/foo/man/man1/foo.1
BASEDIR/foo/man/de/man1/foo.1
BASEDIR/foo/man/fr/man1/foo.1

این باعث می‌شود که به راحتی بتوان تمام محتوای تولید شده را در بسته باینری با a اضافه کرد
محل نصب تک:

doc/foo/man/*./ usr / share / man /
doc/foo/html/* ./usr/share/doc/foo/

وقتی ترجمه‌های جدید اضافه می‌شوند و ترجمه دوم اضافه می‌شود، این قانون نیازی به به‌روزرسانی نخواهد داشت
بسته باینری (نوار) ​​به محتوای آن بسته اجازه می دهد تا جداگانه نگه داشته شود.

پشتیبانی فرمت
در حال حاضر، po4a-build از ترکیبات زیر پشتیبانی می کند:

1. DocBook XML برای بخش 1.

2. DocBook XML برای بخش 3.

3. DocBook XML برای HTML.

4. POD برای بخش 1.

5. POD برای بخش 3.

6. POD برای بخش 5.

7. POD برای بخش 7.

همه فرمت های پشتیبانی شده، در تمام ترکیب های پشتیبانی شده، می توانند در یک واحد مدیریت شوند
فایل پیکربندی po4a-build.conf و در یک تماس به po4a-buildاست. دیدن po4a-
build.conf(5).

پیکربندی

po4a-build از یک فایل پیکربندی پیش فرض، po4a-build.conf استفاده می کند که باید در بالا باشد
دایرکتوری سطح بسته VCS شما. (از -f گزینه ای برای تعیین یک فایل متفاوت.) ببینید
po4a-build.conf(5).

مثال 1. مثال پیکر بندی پرونده

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

/usr/share/doc/po4a/examples/po4a-build.conf.example

پیکر بندی پرونده طرح
فایل پیکربندی شامل چندین بخش است، کلی، پشتیبانی XML/XSL، پشتیبانی POD
و پشتیبانی از HTML

General شامل نام و محل فایل پیکربندی po4a است (احتمالاً بهترین کار برای ترک
این به عنوان po4a.config)، دایرکتوری po حاوی فایل های PO مستندات (اغلب
doc/po)، نام کامل فایل POT مورد استفاده برای ایجاد ترجمه ها، BASEDIR برای
خروجی تولید شده، اینکه آیا بسته شامل manpages در بخش 3 است نه فقط
بخش 1 و نام بسته های باینری که باید حاوی خروجی تولید شده باشند.

پشتیبانی XML/XSL شامل تعیین اینکه کدام یک از بسته های باینری از پشتیبانی XSL در آن استفاده می کند
متغیر XMLPACKAGES، فایل DocBook سطح بالا برای انتقال به xsltproc و محل قرارگیری
فایل های XML یا DocBook در صورت لزوم می توان XSLFILE را لغو کرد.

پشتیبانی POD شامل تعیین اینکه کدام یک از بسته های باینری از پشتیبانی POD در آن استفاده می کند
متغیر PODPACKAGES و نام کامل فایل POD.

پشتیبانی HTML زیر شاخه ای را برای ایجاد زیر BASEDIR برای ترجمه نشده و
محتوای HTML ترجمه شده و فایل DocBook برای تولید HTML. فایل HTMLXSL می تواند باشد
در صورت لزوم لغو می شود.

دستورات

---فقط قابلمه
فقط فایل(های) POT را به روز می کند. ---فقط قابلمه برای پشتیبانی از بسته ها از جمله در نظر گرفته شده است
تمام فایل های POT در منبع بسته. بسته هایی که از Autotools استفاده می کنند به راحتی می توانند POT را اضافه کنند
فایل را از طریق EXTRA_DIST انجام دهید اما بسته‌ها را فقط با استفاده از Makefile یا کمک‌کننده‌های ساخت VCS خاص بسته‌بندی می‌کند
اضافه کردن فایل POT (که یک فایل تولید شده است) بدون قرار دادن، ممکن است برایتان سخت باشد
فایل POT در VCS. برای جلوگیری از این کار زشت و غیر ضروری، po4a-build می توان
فایل(های) POT را در ابتدای ساخت به روز رسانی کنید، به طوری که dpkg-source آنها را شامل می شود
به منبع تربال.

مثال 2. svn-buildpackage مثال

svn-buildpackage پشتیبانی صریح از این نوع افزودن، با استفاده از
useNativeDist دارایی SVN و بومی-منطقه هدف گذاری کنید

# فایل POT را به تاربال منبع اضافه می کند
native-dist: Makefile
po4a-build ---pot-only

$ svn propset useNativeDist 1 debian

-h|--کمک
پیام استفاده را چاپ کنید و خارج شوید.

- نسخه
پیام استفاده را چاپ کنید و خارج شوید.

OPTIONS

-f|--فایل فایل
رد کردن po4a-build فایل تنظیمات پیش فرض (po4a-build.conf) و خود را تهیه کنید
خودت

با استفاده از خدمات onworks.net از po4a-build آنلاین استفاده کنید