stx2any - Online sa Cloud

PROGRAMA:

NAME

stx2any - converter mula sa structured text patungo sa maraming format

SINOPSIS

stx2any [ -T format ] [ stx at m4 pagpipilian ] [ file file ... ]

DESCRIPTION

Ang stx2any ay nagko-convert ng mga file sa structured text (Stx) na format sa ibang mga format. Mga format
kasalukuyang ipinapatupad ay HTML, man, raw text, PostScript, LaTeX, XHTML at DocBook XML.

Ang source format, structured text, ay isang uri ng plain text na format na may karaniwang markup
para sa kumakatawan sa mga heading, listahan, diin atbp. Ang markup ay parehong mas mabilis na isulat at
mas madaling matandaan kaysa sa mga karaniwang tag-based na markup language, at maganda
nababasa din sa source form. Stx markup ay mas mahusay na ipinaliwanag sa stx trabahong ginawang mabilis at walang sanay gabayan, Na
ay magagamit sa direktoryo ng mga halimbawa.

Karamihan sa conversion ay nangyayari sa m4, at maaari mong tukuyin ang sarili mong mga macro at iba pang bagay
para sa pagbibigay ng istraktura sa iyong mga dokumento. Ang stx2any ay nagbibigay ng LaTeX-like extensible
environment system at isang diversion system para sa muling pagsasaayos ng input. (Tårta på tårta, bilang sila
sabihin sa Swedish.)

Dahil ang stx2any ay hindi nagsasagawa ng anumang uri ng pag-quote sa input, markup na hindi
magagamit ay maaaring direktang isulat sa patutunguhang wika (nawawalan ng convertibility sa
maramihang wika). Sa ganitong paraan, kung interesado ka lamang sa isang format ng output (hal.
LaTeX), maaari mong gamitin ang Stx bilang isang format ng pagdadaglat para sa pinakakaraniwang mga konstruksyon.

Ang ilang pag-format ay hindi available bilang mga pagdadaglat, ngunit sa pamamagitan ng pagtawag sa m4 macros. Kailangan mo
medyo bihira ang mga macro: halimbawa, mga floats (materyal na maaaring "lumulutang" sa paligid sa
dokumento) ay nilikha ng mga macro.

Opsyon

Tinatanggap ng stx2any ang lahat ng mga opsyon sa command line ng m4, direktang ipinapasa ang mga ito. Sa mga ito, ang
-D argument ay sapat na mahalaga upang banggitin dito nang hiwalay.

-DNAME=VALUE
Tukuyin ang macro NAME upang magkaroon ng pagpapalawak na VALUE. Ito ay nagpapahintulot sa iyo na makapasa
impormasyon sa dokumento mula sa command line.

-T format
Itinatakda ang format ng output. Ang default na format ay html. format dapat isa sa:

Ang html ay gumagawa ng pangunahing HTML (hypertext markup language) na output.

ang tao ay gumagawa ng tao macro output. Ang output na ito ay magagamit bilang isang man page nang direkta
(bagaman tingnan ang WRITING MAN PAGES sa ibaba), o maaaring ipakain sa troff / groff para sa
pag-format sa hal. postscript.

ang latex ay gumagawa ng LaTeX na output ng wika sa paghahanda ng dokumento. Maaari mong patakbuhin ang latex
ang resulta upang makabuo eg mataas na kalidad na mga pdf.

ang text ay gumagawa ng hilaw na text output sa pamamagitan ng postprocessing HTML output na may w3m. Ang
ang resultang output ay napakasimple, tulad ng pagtanggal ng karamihan sa Stx markup; kung ikaw
gusto ng mas naka-format na output, isaalang-alang ang piping man output sa nroff -man.

Ang ps ay gumagawa ng simpleng postscript output sa pamamagitan ng postprocessing man output na may groff.
Kung gusto mong gumawa ng totoong pag-publish, isaalang-alang ang LaTeX na format sa halip.

Ang xhtml ay gumagawa ng XHTML na output sa pamamagitan ng postprocessing HTML output na may W3C na malinis. Sa pamamagitan ng
paraan, suriin http://hixie.ch/advocacy/xhtml para sa talakayan tungkol sa HTML at
XHTML.

docbook-xml
gumagawa ng panimulang DocBook XML na output. Tingnan ang mga BUGS sa ibaba para sa higit pang talakayan
ukol dito.

--link-abbrevs
Gamitin ang abbreviation syntax ng link. Tandaan na dahil ang link abbreviation
Ang pagpoproseso ay nangyayari sa dalawang yugto, hindi ito ganap na gumagana kapag dumating ang input
mula sa karaniwang input (halimbawa, kung gumagamit ka ng stx2any bilang gitnang bahagi ng a
pipeline).

--quote
Humiling ng pagsipi ng mga character (maliban sa mga underscore at dollar sign) na
kahit papaano magical sa hiniling na format ng output. Gagawin nitong lubos
mahirap maglagay ng markup sa format ng output nang direkta sa iyong dokumento, ngunit gagawin
lubos na pinapataas ang posibilidad na magiging tama ang iyong dokumento (ibig sabihin, ginagawa
walang mga syntax error) sa format ng output.

--quote-me-harder
Humiling ng pagsipi ng mga salungguhit at mga palatandaan ng dolyar. Ito ay maaaring gumawa ng ilang LaTeX
gumagana ang mga dokumento ngunit maaaring masira ang ilang mga dokumento kung saan ginagamit ang mga salungguhit
mga macro name o dollar sign sa mga macro definition.

--numbering { sa | off }
Humiling ng numero ng mga heading ng seksyon. Ang default ay nag-iiba ayon sa format ng output:
Bilang default, naka-off ang pagnunumero ng seksyon para sa HTML, DocBook XML at man, naka-on para sa LaTeX.

--table-of-contents { sa | off }
Humiling ng paggawa ng talaan ng mga nilalaman mula sa mga heading. Ang default ay sa
gumawa ng TOC kapag naka-on ang pagnunumero. Hindi ipinatupad para sa DocBook XML.

--make-title { sa | off }
Humiling ng "pahina ng pamagat". Ang default ay "naka-on". Ang setting na ito ay walang anumang
epekto sa ilang mga format. Sa HTML, gumagawa ito ng malaking heading sa simula ng
ang dokumento. Sa LaTeX, gumagawa ito ng canonical maketitle.

--walang-template
Huwag gumawa ng template ng dokumento, tanging ang naka-format na input text. Ikaw
malamang na kailangan ito kung ang iyong dokumento ay isasama bilang bahagi ng isang mas malaki
dokumento. Kung ang mas malaking dokumentong iyon ay ganap na nakasulat sa Stx, gayunpaman, ito ay gagawin
maging mas malinis na ibigay ang lahat ng mga source file nang direkta bilang mga argumento sa stx2any sa halip
kaysa pagsamahin ang mga resulta pagkatapos.

--symmetric-crossrefs
Sa mga format ng dokumento na sumusuporta sa pag-link (HTML, DocBook), gumawa ng mga reverse link
mula sa mga label hanggang sa mga referrer gayundin sa mga link mula sa mga referrer patungo sa mga label.

--latex-params param
Itakda ang mga parameter ng klase ng dokumento para sa mga dokumento ng LaTeX. Ang default ay apektado
ayon sa laki ng papel ng system; halimbawa, sa isang European system ito ay karaniwang
a4paper, walang pamagat na pahina. (Tingnan ang “KAPALIGIRAN” sa ibaba.)

--html-params param
Itakda ang mga parameter ng body tag para sa mga HTML na dokumento. Ang default ay walang mga parameter.

--larawan-panlapi suffix
Ang mga inline na larawan ay tumutukoy sa mga file na may suffix suffix. Ang default ay png para sa
HTML at DocBook, eps para sa LaTeX at man.

--no-emdash-separate
Sa output, huwag paghiwalayin ang mga gitling mula sa katabing teksto na may mga puwang. Ito ay
alinsunod sa tradisyunal na typography ng Ingles (kung naiintindihan ko nang tama), ngunit
ay hindi pamantayan sa maraming iba pang mga wika — kabilang ang Finnish, ang aking sariling wika.

--mas sigurado
Huwag paganahin ang ilang mga hindi secure na tampok ng m4 at suriin ang ilang mga argumento ng command line na
ay ipinasa sa shell para sa mga may problemang character. Ito ay maaaring maging kanais-nais kung
natanggap mo ang dokumento mula sa ibang lugar at gusto mong tiyaking hindi ito matatanggap
gumawa ng anumang nakakapinsala kapag napagbagong loob. Sa kasalukuyan, tinatanggihan nito ang pagpapatupad ng shell
makatakas.

Tandaan na malinaw na walang pagpapatupad ng m4 ang idinisenyo nang may seguridad
isip. Bilang kinahinatnan, hindi mapipigilan ng opsyong ito ang bawat potensyal na nakakapinsala
bagay. Ang mga bagay na hindi napigilan na alam ko ay kasama ang mga nilalaman ng
di-makatwirang mga file sa output at pagsulat ng mga abalang loop (upang ang conversion
gagamitin ang lahat ng oras ng processor na makukuha nito, hanggang sa wakasan).

--sed-preprocessor scriptname
Patakbuhin ang sed script scriptname para sa lahat ng input. Binibigyang-daan ka nitong magdagdag ng custom
abbreviation markups. Ito ay halos kapareho ng preprocessing input na may sed,
pagkatapos ay i-pipe ito sa stx2any, ngunit mas mahusay na nakikipag-ugnayan sa --link-abbrevs (tingnan ang
paliwanag para sa mga detalye).

--bersyon, -V
Ipakita lamang ang impormasyon ng bersyon at lumabas.

--tulong, -?
Magpakita lamang ng maikling mensahe ng tulong at lumabas.

PAGSULAT Tao Mga pahina

Karaniwan, ang mga man page ay mga file lamang sa man macro na format. Gayunpaman, may ilan
mga program (una at pangunahin mandb) na nangangailangan ng mga bahagi ng man page na nasa isang partikular
format, at ang mga man page ay karaniwang dapat sumunod sa karaniwang sectioning at form (tingnan ang man
(1) at lexgrog (1) para sa mga detalye).

Kapag nagsusulat ng man page, ang pamagat (w_title) ng pahina ay dapat na ang
program/file/format/utility name, at dapat mong tukuyin ang seksyon (w_section). Gumawa
ang pahinang angkop para sa pag-parse ng mandb, dapat mong simulan ang pahina sa isa o higit pang mga tawag sa
w_man_desc. Gagawa ito ng tamang seksyong "NAME" para sa iyo. (Bagaman maaari kang sumulat
isa sa iyong sarili.)

DIAGNOSTICS

Maaaring magbigay ang stx2any ng anumang mensahe ng error na maaaring ibigay ng m4, hal sa malformatted input (isang macro
tawag na may nawawalang pagsasara ng panaklong atbp). Bilang karagdagan, mayroon itong sumusunod na sariling error
mga mensahe:

hindi kilalang format ng output: "X"
Humiling ka ng hindi sinusuportahang format ng output X gamit ang -T na opsyon.

hindi kilalang macro "X" na tinatawag
Nakatagpo ang stx2any ng isang macro na nagsisimula sa w_, ngunit walang alam na kahulugan para dito.
Ito ay isang babala, hindi isang error — ang nakakasakit na macro at ang mga argumento nito ay
Nakuha mula sa output.

kapaligiran "X" na isinara ng "Y" sa layer N
Ang mga kapaligiran sa stx2any ay dapat na maayos na naka-nest. stx2any encountered w_end(Y)
kung kailan inaasahan ang w_end(X). Kadalasan ito ay tanda ng isang nakalimutang w_end(X).

If N (ang layer) ay isang bagay maliban sa 0, kung gayon ang problema ay malamang na nasa iyong
mga kahulugan ng kapaligiran, hindi sa puntong pinoproseso ng stx2any noong ito
nakatagpo ng error.

hindi kilalang kapaligiran "X"
Nagkaroon ng isang pagtatangka upang simulan ang isang kapaligiran na ang pangalan ay hindi kilala sa stx2any,
ibig sabihin, walang ganitong kapaligiran ang natukoy.

diversion "X" na isinara ng "Y"

hindi kilalang diversion "X"
Pareho sa itaas, ngunit para sa mga diversion (w_begdiv at w_enddiv).

subukang gamitin ang "X" sa ligtas na kapaligiran
Humiling ka ng secure na pagproseso gamit ang --more-secure at ang dokumento ay naglalaman ng isang
"hindi secure" na macro. Ito ay isang mensahe ng babala, hindi isang error — ang nagiging sanhi ng macro
ay naiwan sa text verbatim.

hindi kilalang cross link sa "X"
Nagkaroon ng cross link sa dokumento X, ngunit hindi alam ni stx2any ang tungkol sa naturang a
dokumento. Malamang na hindi ka nakalap ng data ni /X/ na may gather_stx_titles o ikaw
mali ang spelling ng reference ng dokumento. Ito ay isang babala, hindi isang error — ang
reference ay naiwan sa output verbatim, nang walang anumang uri ng link.

Ang return value ng stx2any ay zero sa tagumpay, isa kung may ilang problema.

Kapaligiran

PAPERCONF

LAKI NG PAPEL
ginagamit para sa pagtukoy ng default na laki ng papel para sa mga dokumento ng LaTeX.

Gumamit ng stx2any online gamit ang mga serbisyo ng onworks.net