docbook-2-ps - آنلاین در ابر

برنامه:

نام

sgml2x - به راحتی اسناد SGML/XML را با استفاده از شیوه نامه های DSSSL قالب بندی می کند.

خلاصه

sgml2x [گزینه های] [sgmlfile | xmlfile ]

کلاس درس-2قالب هدف [گزینه های] [sgmlfile | xmlfile ]

توضیحات:

sgml2x اجازه می دهد تا به راحتی یک سند SGML یا XML را با استفاده از شیوه نامه های DSSSL قالب بندی کنید و
ویژگی های زیر را ارائه می دهد:

· چندین شیوه نامه ممکن در هر کلاس سند

· مشخصات آسان شیوه نامه ها با استفاده از نام مستعار، با پشتیبانی از پارامتر
وراثت

· ادغام آسان شیوه نامه های جدید با افزودن یک فایل تعریف ساده جدید در a
دایرکتوری پیکربندی

تماس گیرنده می تواند فهرستی مانند PATH از دایرکتوری های پیکربندی را مشخص کند که به صورت پیش فرض تنظیم می شود
دایرکتوری های پیکربندی در سراسر سیستم، هر کاربر و هر پروژه

· انتخاب خودکار یک شیوه نامه پیش فرض برای استفاده، بر اساس اختصاص داده شده
اولویت

· گزینه های دلخواه را به یشم(1)

کلاس سند که برای جستجوی شیوه نامه ها استفاده می شد و فرمت خروجی در حال حاضر است
فقط از نامی که برنامه با آن فراخوانی می شود مشتق شده است، بنابراین می خواهید این را صدا بزنید
برنامه از طریق پیوندهای نمادین مانند docbook-2-pdf.

sgml2x به عنوان یک پوشش پوسته در اطراف اجرا می شود یشم(1) (یا ترجیحاً openjade(1),
اگرچه ما از نام عمومی استفاده می کنیم یشم در سراسر این مستندات)، jadetex(1) و دیگر
ابزار.

در صورت عدم وجود jadetex.cfg فایل نزدیک سند، یک پیش فرض کپی شده است که فعال می کند
تولید نشانک های PDF

گزینه

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

-C|-- confdirs dir-list
از فهرست دایرکتوری‌های پیکربندی (جدا شده با فضای خالی) استفاده کنید. این گزینه است
تجمعی، یعنی می توانید از چند مورد استفاده کنید -C گزینه ها و لیست ها خواهد بود
بهم پیوسته

عناصر لیست باید از عمومی ترین پیکربندی مرتب شوند (مثلاً در کل سیستم)
به خاص ترین (به عنوان مثال در کل پروژه).

اگر هر دایرکتوری از طریق این گزینه ارائه شود، فهرست دایرکتوری پیش فرض خواهد بود
نادیده گرفته شد

-D|--dssslproc dsssl-پردازنده
استفاده کنید dsssl-پردازنده برای اعمال شیوه نامه، به جای حالت پیش فرض. این
پردازنده باید پشتیبانی کند یشمگزینه های مانند، مانند -V.

هنگامی که این گزینه وجود ندارد، اولین مورد در dssslproc فایل از confdirs است
گرفته شده. دیدن "فایل ها" برای جزئیات بیشتر.

-h|--کمک پیام راهنما را نمایش دهید و از آن خارج شوید.

-j|--یشم dsssl-پردازنده
مترادف منسوخ برای --dssslproc.

-- فیلتر jadetex پرل-فیلتر
خروجی jadetex را با استفاده از فیلتر perl پس پردازش کنید.

این می تواند برای مجبور کردن صفحه شکستن در برخی مکان های خاص برای غلبه بر شیوه نامه مفید باشد
مشکلات، یا به اجبار خط فاصله در جایی که TeX الگوهای کافی ندارد، یا هیچ کدام را انجام نمی دهد
تحول هوشمندانه دیگری که در مورد آن فکر می کنید.

مشاهده نمونه ها / خطوط فرمان فایل برای استفاده های احتمالی

-n|-- بدون عمل
دستورات را به جای اجرای آنها چاپ کنید. برای یادگیری در مورد سطح پایین مفید است
ابزارها و برای رفع اشکال خط فرمان.

-o|--openjade
این انتخاب is منسوخ. openjade اکنون در صورت موجود بودن پیش فرض است. استفاده کنید
--dssslproc یا یک dssslproc فایل پیکربندی برای اجبار یک پردازنده خاص.

از این گزینه استفاده می شد openjade(1) به عنوان یک پردازنده DSSSL به جای یشم(1).

-O|-- jadeopts گزینه های یشم
گزینه های اضافی برای عبور یشم(1). این گزینه تجمعی است، شما می توانید
چندین مورد از آنها را مشخص کنید، گزینه های ارائه شده به هم متصل می شوند.

-q|--ساکت
پرحرفی را روی ساکت

-r|--ملاحظات
ارائه محتوای اظهارات سند در سند (اظهار نظر عناصر در
DocBook 4, توضیح عناصر موجود در DocBook 3)، خروجی تولید شده را تبدیل می کند
تنها استفاده داخلی سند، چاپ اخطار پررنگ روی جلد.

این یک ویژگی خاص برای کلاس مستند و شیوه نامه است و همه شیوه نامه ها از آن استفاده نمی کنند
این.

-s|--سبک سبک
یک سبک خروجی را برای لغو پیش‌فرض (در نهایت برگرفته از سند) انتخاب کنید.

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

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

-v|-- پرحرف
پرحرفی را افزایش دهید. این گزینه را می توان چندین بار مشخص کرد.

-- پرحرفی N
پرحرفی را روی N. سطوح پرحرفی به صورت زیر تعریف می شود:

ساکت فقط خطاهای چاپ

به طور پیش فرض فقط خطاها و هشدارهای چاپی

واژگان همچنین اطلاعیه ها را چاپ کنید

رد همچنین دستورات مهم را هنگام اجرا چاپ کنید (به عنوان -- بدون عمل میکند).

اشکال زدایی کردن همچنین پیام های اشکال زدایی را چاپ کنید

-V|- نسخه
نسخه برنامه را پرینت بگیرید و خارج شوید.

پیکر بندی

sgml2x از درخت دایرکتوری پیکربندی به جای فایل پیکربندی استفاده می کند، به طوری که می شود
وصل شدن بسته‌های دیگر با خطر پایین شکستن تنظیمات موجود آسان است.

سلسله مراتب سبک ها در فهرست های نامگذاری شده قرار دارند سبک در هر پیکربندی
فهرست راهنما. نسخه های قدیمی این برنامه برای قرار دادن این سلسله مراتب ها به طور مستقیم در برنامه استفاده می شد
دایرکتوری های پیکربندی

دایرکتوری پیکربندی شامل یک دایرکتوری برای هر کلاس سند شناخته شده به نام با
نام مستعار کلاس سند (مثلا کتاب مستند). این دایرکتوری‌های doccclas شامل یک زیر
دایرکتوری برای هر کلاس از فرمت خروجی (در حال حاضر فقط اچ تی ام ال و چاپ پشتیبانی می شوند).

در حال حاضر، مسائل مربوط به پیاده سازی، محدودیتی را در نام مستعار برای کلاس های سند اعمال می کند
و شیوه نامه: آنها فقط می توانند شامل نویسه های حروف عددی و زیرخط باشند. این
محدودیت ممکن است در نسخه بعدی حذف شود، اما این قبل از این اتفاق نخواهد افتاد
فیلمنامه به زبان دیگری بازنویسی می شود.

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

Id شناسه عمومی برای شیوه نامه

نزولی توضیح کوتاهی از سبک‌ها که در پیام راهنما نمایش داده می‌شود

pdf لغو, ps Override,
rtfOverride, mifOverride" 10 نماد dsssl از شیوه نامه چاپی که باید تنظیم شود
به #t (یا یک نماد=ارزش جفت، مناسب به عنوان آرگومان برای یشم's -V گزینه)،
برای فرمت چاپ داده شده استفاده شود.

فقط یک نماد در هر خط لغو مجاز است. برای تعریف مقادیر برای چندین نماد، استفاده کنید
چند خط

وراثت نام مستعار شیوه نامه ای که این برگه از آن به ارث می برد تا از بی نیازی آن جلوگیری شود
تکراری بودن تعاریف سبک

در حال حاضر، این تنها باعث ارث بردن از * نادیده گرفتن پارامترها.

اولویت یک عدد صحیح مثبت برای کمک به انتخاب سبک پیش‌فرض زمانی که نمی‌توان آن را انتخاب کرد
برگرفته از سند مقادیر بالاتر شانس بیشتری برای در نظر گرفتن به عنوان
پیش فرض مراقب استفاده از اولویت های کم برای سبک های فوق تخصصی برای الف باشید
نوع سند عمومی، به طوری که با خطا مورد استفاده قرار نگیرد.

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

10 شیوه نامه های پایه، که معمولاً باید سفارشی شوند.

0 هر شیوه نامه ای که برای یک هدف فوق تخصصی نوشته شده باشد (مثلاً
برگه محصول بازاریابی).

1000 یک سبک پیش فرض برای تمام اسناد تولید شده توسط یک سازمان. معمولا یک
سفارشی سازی سبک، دارای اولویت های چیدمان، سازمان
لوگو یا این چیزها

10-100 سفارشی سازی عمومی متفرقه از شیوه نامه های پایه.

وقتی نسخه بهبودیافته یک شیوه نامه را با اولویت می نویسید n، شما
معمولاً می خواهید اولویت بالاتری را انتخاب کنید.

فایل ها

/etc/sgml/sgml2x/

~/.sgml2x/

./sgml2x/ دایرکتوری های پیکربندی پیش فرض که فایل های پیکربندی در آن قرار دارند
جستجو کرد. برای مشاهده مستندات -- confdirs برای جزئیات بیشتر.

confdir/سبک/
سلسله مراتبی که سبک های قابل استفاده را تعریف می کند. دیدن "پیکربندی" برای اطلاعات بیشتر
جزئیات.

confdir/dssslproc
فایلی حاوی لیست مرتب شده ای از پردازنده های dsssl برای جست و جو، جدا شده با
خطوط جدید و/یا فضای خالی خطوطی که با a شروع می شوند # شخصیت به عنوان
نظرات. ارزش های مشترک شامل openjade و یشم.

پردازنده های DSSSL مشخص شده در اینجا باید این را بپذیرند -V و -D سازگار با یشم
گزینه های خط فرمان

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

ارزش ویژه غلط می توان از آن برای توقف جستجو و جلوگیری از جستجو استفاده کرد
فهرست های عمومی تر اگر برای مثال یک پروژه باید از
openjade-1.4devel فرمان و هیچ چیز دیگری، می تواند مشخص کند openjade-1.4devel غلط
در آن dssslproc فایل.

هشدارهای

هنگام استفاده از openjade-1.4devel به عنوان پردازنده DSSSL، شکایتی در مورد بالا مشاهده خواهید کرد
سطح جریان شی تولید شده توسط doctype.dslو تعیین خودکار سند
نوع شکست خواهد خورد. این خطا در غیر این صورت بی ضرر است. ایده هایی در مورد چگونگی مقابله با این، یا
تاییدیه که openjade-1.4devel خیلی سخت گیر است، قدردانی خواهد شد :)

La آینده

ویژگی های برنامه ریزی شده برای نسخه های آینده عبارتند از:

· ادغام یک مولد شاخص

· ادغام یک موتور چاپ زیبا برای نمونه کد

· مشخصات تبدیل هایی که باید زنجیر شوند

· اعلام زیرمجموعه docclass برای اجازه استفاده با هر doccclass از سبک
برگه هایی که برای کلاس های سوپرست آن اعمال می شود.

· در یک مکان موقت کار کنید تا دایرکتوری کار را با آن آلوده نکنید
فایل های موقت این به آن راحتی که به نظر می رسد نیست، زیرا یک سند را می شکند
به فایل های تصویری با استفاده از مسیرهای نسبی اشاره دارد. که ممکن است به عنوان یک حشره یشم دیده شود،
با این حال.

فهرست کامل TODO را مرور کنید و ایده های بیشتری را برای ما ارسال کنید!

حق طبع و نشر

حق چاپ © 2001-2003 Alcove & Yann Dirson.

sgml2x تحت مجوز عمومی عمومی گنو، نسخه 2 مجوز دارد.

این اسناد تحت مجوز مستندات آزاد گنو، نسخه 1 مجوز دارد.

تماس us

sgml2x بخشی از AlcoveBook پروژه (لینک به URL http://www.alcove-
labs.org/en/software/alcovebook/) . لطفا استفاده کنید AlcoveBook پستی liste (لینک به URL
https://savannah.gnu.org/mail/?group_id=533) برای ارتباط با توسعه دهندگان و کاربران

لیست اشکالات و درخواست های ویژگی در دسترس است از طریق a وب رابط (لینک به URL
https://savannah.gnu.org/support/?group_id=533) . لطفا از آن برای ارسال مشکلات و
ایده ها.

دیدن همچنین

openjade(1), یشم(1), jadetex(1), collateindex.pl(1).

sgml2x(1)

با استفاده از خدمات onworks.net از docbook-2-ps به صورت آنلاین استفاده کنید