Ito ang command na docbook2texi na maaaring patakbuhin sa OnWorks na libreng hosting provider gamit ang isa sa aming maramihang libreng online na workstation gaya ng Ubuntu Online, Fedora Online, Windows online emulator o MAC OS online emulator
PROGRAMA:
NAME
jw, docbook2dvi, docbook2html, docbook2man, docbook2pdf, docbook2ps, docbook2rtf,
docbook2tex, docbook2texi, docbook2txt - (Jade Wrapper) nagko-convert ng mga SGML file sa iba
format
SINOPSIS
jw [ -f frontend | --frontend frontend ]
[ -b backend | --backend backend ]
[ -c file | --pusa file ]
[ -n | --nostd ]
[ -d file|default|wala | --dsl file|default|wala ]
[ -l file | --dcl file ]
[ -s landas | --sgmlbase landas ]
[ -p programa | --parser programa ]
[ -o direktoryo | --output direktoryo ]
[ -V nagbabago[=halaga] ]
[ -u | --nochunks ] [ -i seksyon | --isama seksyon ]
[ -w uri|listahan | --babala uri|listahan ]
[ -e uri|listahan | --mali uri|listahan ]
[ -h | - Tumulong ] [ -v | --bersyon ]
SGML-file
docbook2dvi SGML-file
docbook2html SGML-file
docbook2man SGML-file
docbook2pdf SGML-file
docbook2ps SGML-file
docbook2rtf SGML-file
docbook2tex SGML-file
docbook2texi SGML-file
docbook2txt SGML-file
DESCRIPTION
Ang jw pinahihintulutan ng shell script na i-convert ang isang DocBook file (o iba pang format na nakabatay sa SGML) sa
iba pang mga format (kabilang ang HTML, RTF, PS at PDF) na may madaling maunawaang syntax. Ito
Itinatago ang karamihan sa pagiging kumplikado ni Jade o OpenJade at nagdaragdag ng mga kumportableng tampok.
Iba pang mga script tulad ng docbook2html, docbook2rtf or docbook2ps magbigay ng iba't ibang paraan ng
pagtatawag jw na maaaring mas madaling tandaan.
Sa ngayon, hindi XML ang pinangangasiwaan ng jw, ngunit SGML lamang.
Ipinapalagay ng utility na ito na maraming iba pang mga bahagi ang naka-install. Kasama sa listahan ang:
· ang mga entity ng character na ISO para sa SGML
· Ang DSSSL engine ni James Clark, jade, o isang katumbas na parser tulad ng OpenJade
· ang DocBook DTD mula sa OASIS consortium
· Mga modular style sheet ng DocBook ni Norman Walsh (o ilang iba pang hanay ng mga style sheet ng DSSSL)
· Ang jadetex set ni Sebastian Rahtz ng TeX macros para sa jade (para sa mga backend na nilalayong
"pag-print" na mga format tulad ng PDF, RTF o PostScript)
· Isang perl interpreter (para sa mga backend na gumagamit ng perl)
· SGMLSpm mula sa CPAN (para sa mga backend na gumagamit ng sgmls)
· Lynx HTML browser (para sa txt backend)
Ang jw script ay karaniwang tinatawag na ganito:
jw mydoc.sgml
saan mydoc.sgml ay isang SGML file.
Ang command line sa itaas ay gumagamit ng mga default na opsyon: nagko-convert ito mula sa DocBook (ang default
frontend) sa HTML (ang default na backend), ay hindi naglalagay ng resulta sa isang subdirectory (maliban kung
tinukoy kung hindi man sa mga style sheet), atbp.
Sa halimbawang ito, ang "mydoc" file name pati na rin ang ".sgml" extension ay maaaring palitan ng
kahit ano pa. Kasama sa mga kasalukuyang extension para sa SGML DocBook file ang ".sgml", ".sgm",
".docbook", at ".db". Ang naprosesong file mydoc.sgml maaaring nasa ibang direktoryo kaysa sa
ang kasalukuyang.
Dito pinili naming bumuo ng HTML na output. Sa katunayan maaari naming gamitin ang alinman sa mga backend na nakaimbak
nasa backends/ subdirectory ng DocBook-utils distribution directory (karaniwang
/usr/share/docbook-utils). Katulad nito, maaari mong gamitin ang anumang frontend na tinukoy sa frontends/
subdirectory upang i-convert mula sa isa pang format ng pag-input.
Ang sample na command na ito ay lumilikha ng isa o maraming HTML file na may mga arbitrary na pangalan ng file sa
kasalukuyang direktoryo. Maaaring baguhin ang default na gawi na ito sa pamamagitan ng mga opsyon sa command line
at/o customization style sheet.
Opsyon
Nalalapat ang mga sumusunod na opsyon sa script ng conversion:
-f frontend | --frontend frontend
Nagbibigay-daan na tumukoy ng isa pang frontend kaysa sa default docbook. Ang listahan ng kasalukuyang
ang mga available na frontend ay:
docbook
Kino-convert ang docbook gamit ang mga style sheet ni Norman Walsh. Ang frontend na ito ay naghahanap sa
ang mga subdirectory ng base SGML na direktoryo para sa isang file na pinangalanan
html/docbook.dsl or print/docbook.dsl (depende sa uri ng backend: html
o i-print).
-b backend | --backend backend
Nagbibigay-daan na tumukoy ng isa pang backend kaysa sa default HTML. Ang listahan ng kasalukuyang
ang mga available na backend ay:
dalawa Nagko-convert sa DVI (DeVice Independant file) sa pamamagitan ng pagtawag magpapagod or OpenJade.
html Nagko-convert sa HTML (HyperText Markup Language) sa pamamagitan ng pagtawag magpapagod or OpenJade.
lalaki Kino-convert ang isang refentry sa isang Unix manual page sa pamamagitan ng pagtawag sa docbook2man. Ay hindi
gumana sa iba pang mga uri ng dokumento ng SGML kaysa sa DocBook.
pdf Nagko-convert sa PDF (Portable Document Format) sa pamamagitan ng pagtawag magpapagod or OpenJade.
ps Nagko-convert sa PostScript sa pamamagitan ng pagtawag magpapagod or OpenJade.
rtf Nagko-convert sa RTF (Rich Text Format) sa pamamagitan ng pagtawag magpapagod or OpenJade. ang
ang resultang file ay maaaring mai-inport sa MS Salita o isa sa Linux nito
kapalit na mga programa.
tex Nagko-convert sa TeX sa pamamagitan ng pagtawag magpapagod or OpenJade.
texi Nagko-convert sa mga pahina ng GNU TeXinfo sa pamamagitan ng pagtawag sa docbook2texi. Hindi gumagana sa
iba pang mga uri ng dokumento ng SGML kaysa sa DocBook.
txt Nagko-convert sa isang hubad na text file sa pamamagitan ng pagtawag magpapagod or OpenJade, Pagkatapos musang.
-c file | --pusa file
Nagbibigay-daan na gumamit ng karagdagang SGML Open Catalog na maglilista ng iba pang mga file tulad ng
mga style sheet ng pagpapasadya, mga adaptasyon sa DocBook Document Type Definition,
mga espesyal na character na entity, atbp. Ang catalog na ito ay idinagdag sa listahan ng mga katalogo
tinutukoy ng script (tingnan ang opsyon --nostd sa ibaba)
-n | --nostd
Huwag gamitin ang karaniwang SGML Open Catalogs. Karaniwan, ang karaniwang listahan ng mga katalogo ay
tinutukoy tulad nito:
· kung umiiral ang sentralisadong katalogo, pagkatapos ay gamitin ito. Ang sentralisadong katalogo ay isang listahan
ng lahat ng mga katalogo na maaaring kailanganin na karaniwang naninirahan sa /etc/sgml. Nito
pangalan ay ibinigay ng frontend, halimbawa ang docbook pagbabalik ng frontend
/etc/sgml/sgml-docbook.cat.
· Kung hindi, kunin ang lahat ng mga file na pinangalanan katalogo mula sa mga subdirectory ng SGML
base na direktoryo (karaniwan /usr/share/sgml).
Ang pagpipiliang ito ay kapaki-pakinabang kasabay ng --pusa opsyon na gamitin lamang ang mga katalogo na
ay tinukoy sa command line.
-d file|default|wala | --dsl file|default|wala
Nagbibigay-daan na gumamit ng naka-customize na style sheet sa halip na ang default.
Ang isang "target" na nagsisimula sa isang hash mark na "#" ay maaaring idagdag sa pangalan ng file. Bilang isang
resulta, tanging ang kaukulang bahagi ng style sheet ang ipapatupad (ang "style
specification" na ang "identificator" ay katumbas ng pangalan ng target). Isang karaniwang gamit
ng mekanismong ito ay upang tukuyin ang "#html" at "#print" na mga target upang ma-trigger ang
kaukulang bahagi ng isang kapalit na style sheet na karaniwan para sa parehong HTML at
conversion ng printout.
Sa pamamagitan ng pagpapalit sa pangalan ng file ng "default", ang default na style sheet na ibinigay kasama
ginagamit ang frontend. Halimbawa, ang docbook pagbabalik ng frontend ./docbook.dsl#html
(O ./docbook.dsl#print) sa SGML base na direktoryo.
Sa pamamagitan ng pagpapalit ng pangalan ng file ng "wala", walang kapalit na style sheet ang ginagamit, hindi
kahit ang default na style sheet. Ang style sheet na ginagamit ay tinutukoy din ng
ang frontend. Halimbawa, ang docbook ibinalik ng frontend ang kay Norman Walsh
html/docbook.dsl (O print/docbook.dsl) na matatagpuan sa isang lugar sa ibaba ng base ng SGML
direktoryo.
Kung walang --dsl na opsyon ang tinukoy, pagkatapos ay "--dsl default" ang gagamitin.
-l file | --dcl file
Nagbibigay-daan na gumamit ng naka-customize na deklarasyon ng SGML sa halip na ang default. Ang file
Ang pangalan ng default na deklarasyon ng SGML ay hindi nakatakda para sa mga SGML file, at nakatakda sa
xml.dcl sa SGML base na direktoryo para sa mga XML file.
-s landas | --sgmlbase landas
Nagbibigay-daan na gumamit ng isa pang lokasyon para sa baseng direktoryo ng SGML. Ito ang direktoryo
sa ibaba kung saan naka-install ang lahat ng SGML DTD, style sheet, entity, atbp. Ang default
ang halaga ay /usr/share/sgml.
-p programa | --parser programa
Tukuyin ang parser na gagamitin (magpapagod or OpenJade) kung marami ang naka-install. Kung ito
hindi tinukoy ang opsyon, sinubukan muna ng script na gamitin si Jade, pagkatapos ay sinubukan nito
OpenJade.
-o direktoryo | --output direktoryo
Itakda ang direktoryo ng output kung saan maiimbak ang lahat ng mga resultang file. Kung ang istilo
Tinutukoy ng mga sheet ang isang subdirectory kung saan iimbak din ang mga resultang file, ang
Ang subdirectory na tinukoy ng mga style sheet ay ilalagay sa ibaba ng subdirectory
tinukoy ng opsyong ito.
-V nagbabago=[halaga]
Magtakda ng isang variable (sa isang halaga, kung ang isa ay tinukoy).
-u | --nochunks
Output lamang ng isang malaking file. Ang pagpipiliang ito ay kapaki-pakinabang lamang kapag bumubuo ng HTML, dahil
ang output ay maaaring hatiin sa ilang mga file. Ino-override ng opsyong ito ang setting na iyon
maaaring gawin sa mga style sheet.
-i seksyon | --isama seksyon
Ideklara ang isang seksyong may markang SGML bilang "isama". Ang seksyong may markang SGML ay isang uri ng
may kondisyong bahagi ng isang dokumento. Kung idineklara itong "ignore", maiiwan ito
hindi pinansin, kung hindi, ito ay ipoproseso. Ang isang halimbawa ng naturang minarkahang seksyon ay
maging:
<DOCTYPE mydoc [
]>
...
...
-w uri|listahan | --babala uri|listahan
Pinapagana o hindi pinapagana ang pagpapakita ng mga ibinigay na uri ng mga babala. Maraming mga pagpipilian -w
maaaring maipasok sa command line. Mga uri ng babala na nagsisimula sa "hindi-" hindi paganahin
ang kaukulang mga babala, ang iba pang mga uri ay nagbibigay-daan sa kanila.
Kung ang uri ng babala ay pinalitan ng "listahan", pagkatapos ay isang listahan ng mga pinapayagang uri ng babala
ay ipinapakita.
-e uri|listahan | --mali uri|listahan
Hindi pinapagana ang mga ibinigay na uri ng mga error. Maraming -e na opsyon ang maaaring ilagay sa command
linya. Lahat ng uri ng error ay nagsisimula sa "no-".
Kung ang uri ng error ay pinalitan ng "listahan", kung gayon ang isang listahan ng mga pinapayagang uri ng error ay
ipinakita
-h | - Tumulong
Mag-print ng maikling mensahe ng tulong at lumabas
-v | --bersyon
I-print ang identifier ng bersyon at lumabas
Gamitin ang docbook2texi online gamit ang mga serbisyo ng onworks.net
