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

برنامه:

نام

stx2any - مبدل از متن ساختاریافته به فرمت های متعدد

خلاصه

stx2any [ -T قالب ] [ stx و m4 گزینه های ] [ پرونده پرونده ...]

شرح

stx2any فایل ها را در قالب متن ساختاریافته (Stx) به فرمت های دیگر تبدیل می کند. فرمت ها
در حال حاضر HTML، man، متن خام، PostScript، LaTeX، XHTML و DocBook XML اجرا شده اند.

فرمت منبع، متن ساختاریافته، نوعی قالب متن ساده با نشانه گذاری استاندارد است
برای نشان دادن سرفصل ها، لیست ها، تاکید و غیره. نشانه گذاری هم سریعتر برای نوشتن است و هم
به خاطر سپردن آسان تر از زبان های نشانه گذاری مبتنی بر برچسب معمولی و زیبایی است
خوانا نیز به صورت منبع نشانه گذاری Stx بهتر در توضیح داده شده است STX فست فود راهنمایی، که
در فهرست نمونه ها موجود است.

بیشتر تبدیل در m4 اتفاق می افتد، و شما می توانید ماکروهای خود و موارد دیگر را تعریف کنید
برای ساختار دادن به اسناد شما stx2any یک توسعه پذیر مانند LaTeX ارائه می دهد
سیستم محیطی و یک سیستم انحراف برای تنظیم مجدد ورودی. (Tårta på tårta، همانطور که آنها
به سوئدی بگو.)

از آنجا که stx2any هیچ نوع نقل قولی را در ورودی انجام نمی دهد، نشانه گذاری که نیست
موجود را می توان مستقیماً به زبان مقصد نوشت (از دست دادن قابلیت تبدیل به
چندین زبان). به این ترتیب، اگر فقط به یک فرمت خروجی علاقه دارید (مثلاً
LaTeX)، می توانید از Stx به عنوان یک فرمت اختصاری برای رایج ترین ساختارها استفاده کنید.

برخی از قالب‌بندی‌ها به صورت مخفف در دسترس نیستند، اما با فراخوانی ماکروهای m4 در دسترس هستند. تو نیاز داری
ماکروها نسبتاً به ندرت: به عنوان مثال، شناورها (موادی که می توانند در اطراف "شناور" شوند
سند) توسط ماکروها ایجاد می شوند.

OPTIONS

stx2any تمام گزینه های خط فرمان m4 را می پذیرد و مستقیماً آنها را ارسال می کند. از این میان،
استدلال -D به اندازه کافی مهم است که در اینجا جداگانه ذکر شود.

-DNAME=VALUE
ماکرو NAME را برای داشتن VALUE بسط تعریف کنید. این به شما اجازه عبور می دهد
اطلاعات از خط فرمان وارد سند می شود.

-T قالب
فرمت خروجی را تنظیم می کند. فرمت پیش فرض html است. قالب باید یکی از:

html خروجی اولیه HTML (زبان نشانه گذاری فرامتن) را تولید می کند.

انسان خروجی کلان انسان را تولید می کند. این خروجی به صورت مستقیم به عنوان صفحه مرد قابل استفاده است
(اگرچه WRITING MAN PAGES را در زیر ببینید)، یا می توان به troff / groff برای
قالب بندی به عنوان مثال پس اسکریپت.

لاتکس خروجی زبان آماده سازی سند LaTeX را تولید می کند. می توانید لاتکس را روی آن اجرا کنید
نتیجه برای تولید به عنوان مثال pdf با کیفیت بالا.

متن خروجی متن خام را با پس پردازش خروجی HTML با w3m تولید می کند. در
خروجی حاصل بسیار ابتدایی است، مانند حذف اکثر نشانه گذاری های Stx. اگر شما
خروجی فرمت شده بیشتری می خواهید، خروجی man piping را به nroff -man در نظر بگیرید.

ps خروجی ساده پس‌اسکریپت را با پس‌پردازش خروجی مرد با groff تولید می‌کند.
اگر می خواهید انتشار واقعی انجام دهید، به جای آن فرمت LaTeX را در نظر بگیرید.

xhtml خروجی XHTML را با پس پردازش خروجی HTML با W3C مرتب تولید می کند. توسط
راه، بررسی کنید http://hixie.ch/advocacy/xhtml برای بحث در مورد HTML و
XHTML.

docbook-xml
خروجی اولیه DocBook XML را تولید می کند. برای بحث بیشتر به اشکالات زیر مراجعه کنید
در مورد این.

-- پیوندهای اختصاری
از نحو مخفف پیوند استفاده کنید. توجه داشته باشید که به دلیل مخفف پیوند
پردازش در دو مرحله انجام می شود، زمانی که ورودی می آید کاملاً کار نمی کند
از ورودی استاندارد (به عنوان مثال، اگر از stx2any به عنوان قسمت میانی a استفاده کنید
خط لوله).

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

-- نقل قول-من-سخت تر
درخواست نقل قول زیرخط و علامت دلار. این ممکن است مقداری LaTeX ایجاد کند
اسناد کار می کنند اما ممکن است برخی از اسناد را که در آن از خط زیر استفاده شده است، خراب کنند
نام های کلان یا علائم دلار در تعاریف کلان.

-- شماره گذاری { در | خاموش }
درخواست شماره گذاری سرفصل های بخش پیش فرض بر اساس فرمت خروجی متفاوت است:
شماره گذاری بخش به طور پیش فرض برای HTML، DocBook XML و man خاموش است و برای LaTeX روشن است.

--table-of-contents { در | خاموش }
درخواست تهیه فهرست مطالب از سرفصل ها. پیش فرض به است
زمانی که شماره گذاری روشن است یک TOC تولید کنید. برای DocBook XML اجرا نشده است.

--make-title { در | خاموش }
درخواست یک "صفحه عنوان". پیش فرض "روشن" است. این تنظیم هیچگونه ندارد
اثر در برخی فرمت ها در HTML، یک عنوان بزرگ در آغاز ایجاد می کند
سند. در LaTeX، عنوان متعارف را تولید می کند.

--بدون الگو
به هیچ وجه یک الگوی سند تولید نکنید، فقط متن ورودی فرمت شده را تولید کنید. شما
اگر سند شما به عنوان بخشی از یک بزرگتر گنجانده شود، احتمالاً به این نیاز دارید
سند با این حال، اگر آن سند بزرگتر به طور کامل در Stx نوشته شده باشد، می شود
تمیزتر باشید تا همه فایل های منبع را مستقیماً به عنوان آرگومان در اختیار stx2any قرار دهید
از ترکیب نتایج پس از آن.

-- متقارن-تقاطع
در قالب‌های سندی که از پیوند (HTML، DocBook) پشتیبانی می‌کنند، پیوندهای معکوس تولید کنید
از برچسب ها به ارجاع دهنده ها و همچنین پیوند از ارجاع دهنده ها به برچسب ها.

--latex-params پارام ها
پارامترهای کلاس سند را برای اسناد LaTeX تنظیم کنید. پیش فرض تحت تأثیر قرار می گیرد
بر اساس اندازه کاغذ سیستم؛ به عنوان مثال، در یک سیستم اروپایی معمولاً چنین است
a4paper,ntitlepage. (به «محیط زیست» در زیر مراجعه کنید.)

--html-params پارام ها
پارامترهای تگ بدنه را برای اسناد HTML تنظیم کنید. پیش فرض بدون پارامتر است.

--تصویر-پسوند پسوند
تصاویر درون خطی به فایل هایی با پسوند اشاره می کنند پسوند. پیش فرض png برای است
HTML و DocBook، eps برای LaTeX و man.

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

--ایمن تر
برخی از ویژگی های ناامن m4 را غیرفعال کنید و برخی از آرگومان های خط فرمان را بررسی کنید
برای شخصیت های مشکل دار به پوسته منتقل می شوند. این ممکن است مطلوب باشد اگر
شما سند را از جای دیگری دریافت کرده اید و می خواهید مطمئن شوید که دریافت نمی کند
هنگام تبدیل هر کار مخربی انجام دهید. در حال حاضر این اعدام پوسته را رد می کند
فرار می کند.

توجه داشته باشید که به وضوح هیچ پیاده سازی m4 با امنیت طراحی نشده است
ذهن در نتیجه، این گزینه نمی تواند از هر مضر بالقوه جلوگیری کند
چیز. مواردی که از آنها جلوگیری نشده است و من از آنها مطلع هستم شامل محتویات آن است
فایل های دلخواه در خروجی و نوشتن حلقه های مشغول (به طوری که تبدیل
از تمام زمان پردازشگر که می تواند دریافت کند، استفاده می کند، تا زمانی که خاتمه یابد).

--sed-پیش پردازنده نام اسکریپت
اسکریپت sed را اجرا کنید نام اسکریپت برای همه ورودی ها این به شما امکان می دهد سفارشی را اضافه کنید
نشانه گذاری های اختصاری تقریباً مشابه پیش پردازش ورودی با sed است،
سپس آن را در stx2any قرار دهید، اما با --link-abbrevs بهتر تعامل دارد (به آن مراجعه کنید
توضیح برای جزئیات).

--نسخه، -V
فقط اطلاعات نسخه را نشان دهید و خارج شوید.

--کمک، -؟
فقط یک پیام راهنمایی کوتاه نشان داده و خارج شوید.

نوشتن MAN صفحات

اصولاً صفحات man به سادگی فایل هایی با فرمت man macro هستند. با این حال، برخی وجود دارد
برنامه‌هایی (اول و مهم‌تر از همه mandb) که نیاز دارند بخش‌هایی از صفحه‌های man در یک مشخص باشند
قالب، و صفحات man به طور کلی باید به بخش بندی و فرم استاندارد پایبند باشند (به man مراجعه کنید
(1) و lexgrog (1) برای جزئیات).

هنگام نوشتن یک صفحه مرد، عنوان (w_title) صفحه باید همان باشد
نام program/file/format/utility، و باید بخش (w_section) را تعریف کنید. ساختن
صفحه ای که برای تجزیه mandb مناسب است، باید صفحه را با یک یا چند تماس شروع کنید
w_man_desc. این یک بخش "NAME" مناسب برای شما ایجاد می کند. (اگرچه می توانید بنویسید
یکی توسط خودت.)

عیب یابی

stx2any ممکن است هر پیغام خطایی را که m4 بدهد، به عنوان مثال در ورودی نادرست (یک ماکرو) بدهد.
تماس با پرانتز بسته مفقود و غیره). علاوه بر این، خطای زیر را دارد
پیام ها:

فرمت خروجی ناشناخته: "X"
فرمت خروجی پشتیبانی نشده را درخواست کردید X با گزینه -T

ماکرو ناشناخته "X" فراخوانی شد
stx2any با یک ماکرو که با w_ شروع می شود مواجه شد، اما هیچ تعریفی برای آن نمی داند.
این یک هشدار است، نه یک خطا - ماکرو توهین آمیز و استدلال های آن هستند
از خروجی حذف شده است.

محیط "X" توسط "Y" در لایه N بسته شده است
محیط‌ها در stx2any باید به‌درستی تودرتو باشند. stx2 هر برخوردی با w_end(Y)
زمانی که انتظارش را داشت w_end(X). اغلب این نشانه یک w_end فراموش شده است(X).

If N (لایه) چیزی غیر از 0 است، پس احتمالاً مشکل در شماست
تعاریف محیطی، نه در نقطه‌ای که stx2any در حال پردازش آن بود
با خطا مواجه شد

محیط ناشناخته "X"
تلاشی برای شروع محیطی وجود داشت که نام آن برای stx2any ناشناخته است،
یعنی چنین محیطی تعریف نشده است.

انحراف "X" بسته شده توسط "Y"

انحراف ناشناخته "X"
مانند بالا، اما برای انحرافات (w_begdiv و w_enddiv).

سعی کنید از "X" در محیط امن استفاده کنید
شما درخواست پردازش ایمن با --more-secure کردید و سند حاوی یک علامت بود
کلان "ناامن". این یک پیام هشدار است، نه یک خطا - ماکرو ایجاد کننده
کلمه به کلمه در متن باقی مانده است.

پیوند متقابل ناشناخته به "X"
یک پیوند متقابل به سند وجود داشت X، اما stx2any در مورد چنین چیزی نمی داند
سند احتمالاً شما یا شما داده های /X/ را با collect_stx_titles جمع آوری نکرده اید
مرجع سند را اشتباه نوشتید این یک هشدار است، نه یک خطا -
مرجع در خروجی کلمه به کلمه، بدون هیچ گونه پیوندی باقی می ماند.

مقدار بازگشتی stx2any در صورت موفقیت صفر است، اگر مشکلی وجود داشت یک.

محیط زیست

PAPERCONF

کاغذی کردن
برای تعیین اندازه کاغذ پیش فرض برای اسناد LaTeX استفاده می شود.

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