hypertocp - Online sa Cloud

PROGRAMA:

NAME

hypertoc - bumuo ng isang talaan ng mga nilalaman para sa mga HTML na dokumento

VERSION

bersyon 3.20

SINOPSIS

hypertoc --tulong | --manpage | --man_help | --lalaki

hypertoc [--bak pisi ] [ --debug ] [ --entrysep pisi ] [ --footer file ] [ --header
file ] [ --ignore_only_one ] [ --ignore_sole_first ] [ --inline ] [ --make_anchors ] [
--make_toc ] [ --notoc_match pisi ] [ --ol | --nool ] [ --ol_num_levels ] [ --outfile
file ] [ --overwrite ] [ --tahimik ] [ --textonly ] [ --title pisi ] { --toc_after
tag=suffix } { --toc_before tag=prefix } { --toc_end tag=endtag } { --toc_entry tag=level
} [ --toc_label pisi ] [ --toc_only | --notoc_only ] [ --toc_tag pisi ] [
--toc_tag_replace ] [ --use_id ] [ --useorg ] file ...

DESCRIPTION

Hinahayaan ka ng hypertoc na tukuyin ang "mga makabuluhang elemento" na i-hyperlink sa a
"Table of Contents" (ToC) para sa isang naibigay na hanay ng mga HTML na dokumento.

Karaniwan, ang nabuong ToC ay isang multi-level na listahan ng antas na naglalaman ng mga link sa
makabuluhang elemento. ipinapasok ng hypertoc ang mga link sa ToC sa mahahalagang elemento sa a
antas na tinukoy ng gumagamit.

Halimbawa:

Kung ang mga H1 ay tinukoy bilang antas 1, lalabas ang mga ito sa unang antas ng listahan ng ToC. Kung
Ang mga H2 ay tinukoy bilang isang antas 2, kaysa sa lumilitaw ang mga ito sa isang listahan ng pangalawang antas sa ToC.

Mayroong dalawang aspeto sa henerasyon ng ToC: (1) paglalagay ng mga angkop na anchor sa HTML
mga dokumento (--make_anchors), at (2) pagbuo ng ToC mula sa mga HTML na dokumento na mayroon
anchor sa mga ito para sa ToC na maiugnay sa (--make_toc). Maaaring piliin ng isa na gawin ang isa o pareho ng
ang mga ito

Sinusuportahan din ng hypertoc ang kakayahang isama ang ToC sa mismong HTML na dokumento
sa pamamagitan ng --inline na opsyon.

Upang masuportahan ng hypertoc ang pag-link sa mahahalagang elemento, naglalagay ang hypertoc ng mga anchor
sa mga makabuluhang elemento. Ang isa ay maaaring gumamit ng hypertoc bilang isang filter, na naglalabas ng resulta sa
isa pang file, o maaaring i-overwrite ng isa ang orihinal na file, na may naka-back up na orihinal na may a
suffix (default: "org") na idinagdag sa filename.

Maaari ding tukuyin ng isa ang mga opsyon sa isang config file pati na rin sa command-line.

Opsyon

Maaaring magsimula ang mga opsyon sa "--" o "-"; Ang mga opsyon sa boolean ay maaaring balewalain sa pamamagitan ng pag-uuna sa kanila
"hindi"; ang mga opsyon na may hash o array value ay maaaring idagdag sa pamamagitan ng pagbibigay muli ng opsyon para sa
bawat halaga.

Tingnan ang Getopt::Long para sa karagdagang impormasyon.

--argfile filename
Ang pangalan ng isang file kung saan magbabasa ng higit pang mga opsyon. Ito ay maaaring gamitin nang higit sa isang beses. Para sa
halimbawa:

--argfile your.args --argfile my.args

Tingnan ang "Mga File ng Opsyon" para sa higit pang impormasyon.

--bak
--bak pisi

Kung ang input file/mga file ay na-overwrite (--o-overwrite ay naka-on), kopyahin ang
orihinal na file sa "filename.pisi". Kung walang laman ang value, walang backup na file
nakasulat. (default:org)

--debug
Paganahin ang verbose debugging output. Ginagamit para sa pag-debug ng modyul na ito; sa ibang salita,
huwag kang mag-abala. (default: off)

--entrysep
--entrysep pisi

Separator string para sa hindi mga entry ng item (default: ", ")

--footer
--footer file

File na naglalaman ng footer text para sa talaan ng nilalaman.

--header
--header file

File na naglalaman ng teksto ng header para sa talaan ng mga nilalaman.

- Tumulong
Mag-print ng maikling mensahe ng tulong at lumabas.

--ignore_only_one
Kung magkakaroon lang ng isang item sa ToC, huwag gumawa ng ToC.

--ignore_sole_first
Kung ang unang item sa ToC ay nasa pinakamataas na antas, AT ito lang ang isa doon
antas, huwag pansinin ito. Ito ay kapaki-pakinabang sa mga web-page kung saan mayroon lamang isang H1 header ngunit
ang isa ay hindi alam muna kung magkakaroon lamang ng isa.

--nasa linya
Ilagay ang ToC sa dokumento sa isang naibigay na punto. Tingnan ang "Inlining the ToC" para sa higit pang impormasyon.

--make_anchors | --gen_anchors
Gumawa ng mga anchor para sa table-of-contents na ili-link.

--make_toc | --gen_toc
Gumawa ng Talaan ng Mga Nilalaman na nag-uugnay sa mga naka-angkla na mahahalagang elemento.

--man_help | --manpage | --lalaki
I-print ang lahat ng dokumentasyon at lumabas.

--notoc_match
--notoc_match pisi

Kung may ilang mga indibidwal na tag na hindi mo gustong isama sa talahanayan ng
mga nilalaman, kahit na tumutugma ang mga ito sa "mga makabuluhang elemento", kung gayon kung ang pattern na ito
tumutugma sa mga nilalaman sa loob ng tag (hindi ang katawan), pagkatapos ay hindi isasama ang tag na iyon,
alinman sa pagbuo ng mga anchor o sa pagbuo ng ToC. (default: class="notoc")

--ol | --nool
Gumamit ng nakaayos na listahan para sa mga entry sa Table-of-Contents (hanggang sa isang partikular na lalim). Kung --ol ay
false (ie --nool ay nakatakda) pagkatapos huwag gumamit ng nakaayos na listahan para sa mga entry ng ToC.

(default:false)

(Tingnan ang --ol_num_levels para matukoy kung gaano kalalim ang listahan ng ordered-list)

--ol_num_levels
Ang bilang ng mga antas sa lalim ng listahan ng OL ay mapupunta kung --ol ay totoo. Kung nakatakda sa zero,
gagamit ng nakaayos na listahan para sa lahat ng antas. (default:1)

--outfile
--outfile file

File kung saan isusulat ang output. Dito ang binagong HTML na output at ang Table-of-
Ang mga nilalaman ay napupunta sa. Kung ibibigay mo ang '-' bilang filename, mapupunta ang output sa STDOUT.
(default: STDOUT)

--patungan
I-overwrite ang input file gamit ang output. Kung ito ay may bisa, --outfile ay hindi papansinin.
Ginamit sa generate_anchors para sa paglikha ng mga anchor "sa lugar" at sa generate_toc if
ang --inline na opsyon ay may bisa. (default: off)

--tahimik
Pigilan ang mga mensaheng nagbibigay-kaalaman. (default: naka-off)

--teksto lamang
Gumamit lamang ng nilalamang teksto sa mahahalagang elemento.

--pamagat
--pamagat pisi

Pamagat para sa pahina ng ToC (kung hindi gumagamit ng --header o --inline o --toc_only) (default: "Table
ng mga Nilalaman")

--toc_after
--toc_after mga tag=suffix

--toc_after "H2="

Para sa pagtukoy ng layout ng mga makabuluhang elemento sa ToC. Ang mga tag ay ang HTML tag na
minarkahan ang simula ng elemento. Ang suffix ay ang kailangang idugtong sa
Ang entry sa Talaan ng mga Nilalaman ay nabuo para sa tag na iyon. Ito ay isang pinagsama-samang argumento ng hash.
(default: hindi natukoy)

--toc_before
--toc_before mga tag=unlapi

--toc_before "H2= "

Para sa pagtukoy sa layout ng mga makabuluhang elemento sa ToC. Ang mga tag ay ang HTML tag
na nagmamarka ng pagsisimula ng elemento. Ang unlapi ay kung ano ang kinakailangan upang maging prepended
sa talaan ng mga nilalaman entry na nabuo para sa tag na iyon. Ito ay isang pinagsama-samang hash
argumento. (default: hindi natukoy)

--toc_end
--toc_end mga tag=endtag

--toc_end "H1=/H1"

Para sa pagtukoy ng mga makabuluhang elemento. Ang mga tag ay ang HTML tag na nagmamarka ng simula ng
ang elemento. Ang endtag ang HTML tag na nagmamarka sa dulo ng elemento. Kailan
tumutugma sa input file, ang kaso ay hindi pinansin (ngunit siguraduhin na ang lahat ng iyong mga tag pagpipilian
ang pagtukoy sa parehong tag ay eksaktong pareho!). Ito ay isang pinagsama-samang argumento ng hash.
(default: H1=/H1 H2=/H2)

--toc_entry
--toc_entry mga tag=antas

--toc_entry "TITLE=1" --toc_entry "H1=2"

Para sa pagtukoy ng mga makabuluhang elemento. Ang mga tag ay ang HTML tag na nagmamarka ng simula ng
ang elemento. Ang antas ay kung anong antas ang itinuturing na tag. Ang halaga ng antas
dapat numeric, at hindi zero. Kung negatibo ang value, consective na mga entry
na kinakatawan ng makabuluhang_elemento ay paghihiwalayin ng halagang itinakda ni
--entrysep na opsyon. Ito ay isang pinagsama-samang argumento ng hash. (default: H1=1 H2=2)

--toc_label | --toclabel
--toc_label pisi

HTML text na may label sa ToC. Laging ginagamit. (default: " Talaan ng nilalaman ")

--toc_only | --notoc_only
Output lamang ang Talaan ng mga Nilalaman, iyon ay, ang Talaan ng mga Nilalaman kasama ang toc_label.
Kung mayroong isang --header o isang --footer, ang mga ito ay magiging output din.

Kung --toc_only ay mali (ibig sabihin --notoc_only ay nakatakda) kung gayon kung walang --header, at
--inline ay hindi totoo, pagkatapos ay isang angkop na HTML page header ay magiging output, at kung mayroon
walang --footer at --inline ay hindi totoo, pagkatapos ay isang HTML page footer ang lalabas.
(default:--notoc_only)

--toc_tag
--toc_tag pisi

Kung ang isang ToC ay isasama sa linya, ito ang pattern na ginagamit upang tumugma sa tag
kung saan dapat ilagay ang ToC. Ito ay maaaring isang start-tag, isang end-tag o isang komento, ngunit
ang < ay dapat iwanan; ibig sabihin, kung gusto mong ilagay ang ToC pagkatapos ng KATAWAN
tag, pagkatapos ay ibigay ang "KATAWAN". Kung gusto mong gumawa ng espesyal na tag ng komento kung saan dapat gawin ang ToC
pumunta, pagkatapos ay isama ang mga marka ng komento, halimbawa: "!--toc--" (default:BODY)

--toc_tag_replace
Kasabay ng --toc_tag, ito ay isang flag para sabihin kung dapat ang ibinigay na tag
pinalitan, o kung dapat ilagay ang ToC pagkatapos ng tag. Ito ay maaaring maging kapaki-pakinabang kung ang iyong
Ang toc_tag ay isang komento at hindi mo na ito kailangan pagkatapos mong mailagay ang ToC.
(default:false)

--use_id
Gamitin ang id="pangalan" para sa mga anchor sa halip napangalan"> anchors. Gayunpaman kung ang anchor
mayroon na para sa isang Makabuluhang Elemento, hindi ito gagawa ng ID para sa partikular na iyon
elemento.

--useorg
Gamitin ang mga dati nang backup na file bilang input source; ibig sabihin, mga file ng form
filename.bak (tingnan ang --bak).

FILE FORMATS

Options File
Ang mga opsyon ay maaaring ibigay sa mga file gayundin sa command-line sa pamamagitan ng paggamit ng --argfile
filename opsyon sa command-line. Gayundin, ang mga file ~/.hypertocrc at ./.hypertocrc ay
sinuri para sa mga pagpipilian.

Ang format ay ang mga sumusunod: Ang mga linyang nagsisimula sa # ay mga komento. Mga linyang nakapaloob sa PoD
ang mga marker ay mga komento din. Binabalewala ang mga blangkong linya. Ang mga pagpipilian mismo ay dapat na
ibinigay ang paraan na sila ay nasa command line, iyon ay, ang pangalan ng opsyon (kabilang ang
--) na sinusundan ng halaga nito (kung mayroon man).

Halimbawa:

# itakda ang ToC na maging tatlong antas
--toc_entry H1=1
--toc_entry H2=2
--toc_entry H3=3

--toc_end H1=/H1
--toc_end H2=/H2
--toc_end H3=/H3

Maaaring ma-nest ang mga opsyong file, sa pamamagitan ng pagbibigay ng --argfile filename argumento sa loob ng opsyon
file, pupunta ito at makukuha rin ang tinukoy na file.

Tingnan ang Getopt::ArgvFile para sa higit pang impormasyon.

MGA DETALYE

Makabuluhan Mga Sangkap
Narito ang ilang halimbawa ng pagtukoy sa mahahalagang elemento para sa iyong Talaan ng mga Nilalaman.

halimbawa of default

Ang sumusunod ay sumasalamin sa default na setting kung walang tahasang tinukoy:

--toc_entry "H1=1" --toc_end "H1=/H1" --toc_entry "H2=2" --toc_end "H2=/H2"

O, kung tinukoy ito sa isa sa mga posibleng "Mga File ng Opsyon":

# default na setting
--toc_entry H1=1
--toc_end H1=/H1
--toc_entry H2=2
--toc_end H2=/H2

halimbawa of bago pagkatapos

Ang mga sumusunod na opsyon ay gumagamit ng bago/pagkatapos na mga opsyon:

# Isang file ng mga pagpipilian na nagdaragdag ng ilang pag-format
# gumawa ng antas 1 na mga entry sa ToC
--toc_entry H1=1
--toc_end H1=/H1
--toc_before H1=
--toc_after H1=

# gumawa ng antas 2 na mga entry sa ToC
--toc_entry H2=2
--toc_end H2=/H2
--toc_before H2=
--toc_after H2=

# Gawin ang antas 3 na mga entry ayon sa dati
--toc_entry H3=3
--toc_end H3=/H3

halimbawa of pasadya dulo

Sinusubukan ng mga sumusunod na opsyon na i-index ang mga termino para sa kahulugan:

# Isang file ng mga pagpipilian na maaaring gumana para sa mga dokumento ng uri ng Glossary
--toc_entry H1=1
--toc_end H1=/H1
--toc_entry H2=2
--toc_end H2=/H2

# Ipinapalagay na ang dokumento ay may DD para sa bawat DT, kung hindi, ToC
# ay makakakuha ng mga entry na may maraming teksto.
--toc_entry DT=3
--toc_end DT=DD
--toc_before DT=
--toc_after DT=

Formatting ang ToC
Ang --toc_entry atbp na mga opsyon ay nagbibigay sa iyo ng kontrol sa kung ano ang hitsura ng mga entry sa ToC, ngunit naroon
ay iba pang mga opsyon upang maapektuhan ang huling hitsura ng ToC file na ginawa.

Gamit ang --header na opsyon, ang mga nilalaman ng ibinigay na file ay ilalagay bago ang
nakabuo ng ToC. Nagbibigay-daan ito sa iyo na magkaroon ng panimulang teksto, o anumang iba pang teksto, bago ang
ToC.

tandaan:
Kung gagamitin mo ang --header na opsyon, tiyaking ang file na tinukoy ay naglalaman ng pambungad na HTML
tag, ang HEAD element (naglalaman ng TITLE element), at ang opening BODY tag.
Gayunpaman, ang mga tag/element na ito ay hindi dapat nasa header file kung ang --inline na mga opsyon
Ginagamit. Tingnan ang "Inlining the ToC" para sa impormasyon sa kung ano ang dapat na nilalaman ng header file
para sa inlining ng ToC.

Gamit ang --toc_label na opsyon, ang mga nilalaman ng ibinigay na string ay ilalagay bago ang
nakabuo ng ToC (ngunit pagkatapos ng anumang teksto na kinuha mula sa isang --header file).

Gamit ang --footer na opsyon, ang mga nilalaman ng file ay idaragdag pagkatapos na mabuo
ToC.

tandaan:
Kung gagamitin mo ang -footer, tiyaking kasama nito ang mga pansarang BODY at HTML tags (maliban kung,
siyempre, ginagamit mo ang --inline na opsyon).

Kung ang --header na opsyon ay hindi tinukoy, ang naaangkop na panimulang HTML markup ay
idinagdag, maliban kung ang --toc_only na opsyon ay tinukoy. Kung ang --footer na opsyon ay hindi
tinukoy, ang naaangkop na pagsasara ng HTML markup ay idaragdag, maliban kung ang --toc_only na opsyon
ay tinukoy.

Kung hindi mo nais/kailangan na makitungo sa header, at footer, mga file, pagkatapos ikaw ay alloed sa
tukuyin ang pamagat, --title na opsyon, ng ToC file; at ito ay nagpapahintulot sa iyo na tukuyin ang a
heading, o label, upang ilagay bago ang listahan ng mga entry ng ToC, ang --toc_label na opsyon. Parehong pagpipilian
may mga default na halaga, tingnan ang "OPTIONS" para sa higit pang impormasyon sa bawat opsyon.

Kung ayaw mong maibigay ang mga tag ng HTML na pahina, at gusto mo lang ang ToC mismo, kung gayon
tukuyin ang --toc_only na opsyon. Kung walang mga --header o --footer na mga file, gagawin ito
i-output lang ang mga nilalaman ng --toc_label at ang ToC mismo.

Inlining ang ToC
Ang kakayahang direktang isama ang ToC sa isang HTML na dokumento ay sinusuportahan sa pamamagitan ng
--inline na opsyon.

Ang inlining ay gagawin sa unang file sa listahan ng mga file na naproseso, at gagawin lamang
tapos na kung ang file na iyon ay naglalaman ng pambungad na tag na tumutugma sa --toc_tag na halaga.

Kung ang --overwrite ay totoo, ang unang file sa listahan ay mapapatungan, kasama ang
nabuong ToC na inilagay sa naaangkop na lugar. Kung hindi, isang binagong bersyon ng una
Ang file ay output sa alinman sa STDOUT o sa output file na tinukoy ng --outfile na opsyon.

Ang mga opsyon --toc_tag at --toc_tag_replace ay ginagamit upang matukoy kung saan at paano ang ToC
ipinasok sa output.

halimbawa 1

# ito ang default
--toc_tag BODY --notoc_tag_replace

Ilalagay nito ang nabuong ToC pagkatapos ng BODY tag ng unang file. Kung ang --header
ang opsyon ay tinukoy, pagkatapos ay ang mga nilalaman ng tinukoy na file ay ipinasok pagkatapos ng BODY
tag. Kung walang laman ang --toc_label na opsyon, ang text na tinukoy ng --toc_label
ang opsyon ay ipinasok. Pagkatapos ay ipinasok ang ToC, at sa wakas, kung ang --footer na opsyon ay
tinukoy, ipinapasok nito ang footer. Pagkatapos ang natitirang bahagi ng input file ay sumusunod sa dati
bago.

halimbawa 2

--toc_tag '!--toc--' --toc_tag_replace

Ilalagay nito ang nabuong ToC pagkatapos ng unang komento ng form , at iyon
ang komento ay papalitan ng ToC (sa order
--header
--toc_label
ToC
--footer) na sinusundan ng natitirang bahagi ng input file.

tandaan:
Ang header file ay hindi dapat maglaman ng panimulang HTML tag at HEAD element mula noong
Ang HTML file na pinoproseso ay dapat na naglalaman ng mga tag/elemento na ito.

HALIMBAWA

Lumikha an inline ToC para isa file
hypertoc --inline --make_anchors --overwrite --make_toc index.html

Gagawa ito ng mga anchor sa "index.html", gagawa ng ToC na may heading na "Table of
Contents" at ilagay ito pagkatapos ng BODY tag ng "index.html". Ang file na index.html.org ay
naglalaman ng orihinal na index.html file, nang walang ToC o mga anchor.

Lumikha a ToC file mula maramihang file
Una, lumikha ng mga anchor.

hypertoc --make_anchors --overwrite index.html fred.html george.html

Pagkatapos ay lumikha ng ToC

hypertoc --make_toc --outfile table.html index.html fred.html george.html

Lumikha an inline ToC pagkatapos ang una heading of ang una file
hypertoc --make_anchors --inline --overwrite --make_toc --toc_tag /H1 \
--notoc_tag_replace --toc_label "" index.html fred.html george.html

Ito ay lilikha ng mga anchor sa "index.html", "fred.html" at "george.html" na mga file, gagawa
isang ToC na walang header at ilagay ito pagkatapos ng unang H1 header sa "index.html" at i-back up
ang orihinal na mga file sa "index.html.org", "fred.html.org" at "george.html.org"

Lumikha an inline ToC sa pasadya mga elemento
hypertoc --quiet --make_anchors --bak "" --overwrite \
--make_toc --inline --toc_label "" --toc_tag '!--toc--' \
--toc_tag_replace \
--toc_entry H2=1 --toc_entry H3=2 \
--toc_end H2=/H2 --toc_end H3=/H3 myfile.html

Gagawa ito ng inline na ToC na magpapatungan sa orihinal na file, at papalitan ang a
komento, at kung saan ang H2 header bilang level 1 at H3 header bilang level 2. Ito ay maaaring
kapaki-pakinabang kung saan ang .html file ay nabuo sa pamamagitan ng ilang iba pang proseso, at maaari kang lumikha
ang ToC bilang huling hakbang.

Lumikha a ToC sa pasadya mga elemento
hypertoc --quiet --make_anchors --bak "" --overwrite \
--toc_entry TITLE=1 --toc_end TITLE=/TITLE
--toc_entry H2=2 --toc_entry H3=3 \
--toc_end H2=/H2 --toc_end H3=/H3 \
--make_toc --outfile index.html \
mary.html fred.html george.html

Lumilikha ito ng mga anchor sa H2 at H3 na elemento, at lumilikha ng ToC file na tinatawag na index.html,
pag-index sa TITLE, at ang H2 at H3 na mga elemento.

Lumikha a ToC sa pasadya mga elemento at pagpipilian file
Ibinigay ang isang file ng mga pagpipilian na tinatawag na 'custom.opt' tulad ng sumusunod:

# Pamagat, H2 at H3
--toc_entry TITLE=1
--toc_end TITLE=/TITLE
--toc_entry H2=2
--toc_end H2=/H2
--toc_entry H3=3
--toc_end H3=/H3

kung gayon ang nakaraang halimbawa ay maaaring magkaroon ng mas maikling mga linya ng command tulad ng sumusunod:

hypertoc --quiet --make_anchors --bak "" --overwrite \
--argfile custom.opt --make_toc --outfile index.html mary.html fred.html george.html

NOTA

· Ang hypertoc ay sapat na matalino upang makita ang mga anchor sa loob ng mahahalagang elemento. Kung ang anchor
tumutukoy sa NAME attribute, ginagamit ng hypertoc ang value. Kung hindi, nagdaragdag ito ng sarili nitong NAME
katangian sa anchor. Kung totoo ang --use_id, sinusuri at ginagamit din nito
mga ID.

· Ang elemento ng TITLE ay partikular na tinatrato kung tinukoy bilang isang makabuluhang elemento. Ito ay
ilegal na magpasok ng mga anchor (A) sa mga elemento ng TITLE. Samakatuwid, ang hypertoc ay talagang
link sa mismong filename sa halip na sa TITLE na elemento ng dokumento.

· Hindi babalewalain ng hypertoc ang isang makabuluhang elemento kung hindi ito naglalaman ng anumang hindi whitespace
mga karakter. Isang mensahe ng babala ang mabubuo kung may ganoong kundisyon.

· Kung mayroon kang isang pagkakasunod-sunod ng mga makabuluhang elemento na nagbabago sa isang bahagyang hindi maayos
fashion, tulad ng H1 -> H3 -> H2 o kahit H2 -> H1, kahit na ang hypertoc ay tumatalakay dito sa
lumikha ng isang listahan na kung saan ay pa rin magandang HTML, kung ikaw ay gumagamit ng isang ordered listahan na iyon
depth, pagkatapos ay makakakuha ka ng kakaibang pagnunumero, bilang isang karagdagang elemento ng listahan
ipinasok upang pugad ang mga elemento sa tamang antas.

Halimbawa (H2 -> H1 na may --ol_num_levels=1):

1.
* Aking H2 Header
2. Aking H1 Header

Halimbawa (H1 -> H3 -> H2 na may --ol_num_levels=0 at H3 din na makabuluhan):

1. Aking H1 Header
1.
1. Aking H3 Header
2. Aking H2 Header
2. Aking Pangalawang H1 Header

Sa mga kasong tulad nito, maaaring mas mainam na huwag gamitin ang --ol na opsyon.

· Kung ang isa ay hindi gumagamit ng --overwrite kapag bumubuo ng mga anchor, kung gayon ang utos ay kailangang
ginawa sa dalawang pass, upang maibigay ang tamang mga filename (ang mga may aktwal na
mga anchor sa kanila) sa bahagi ng henerasyon ng ToC. Kung hindi, magkakaroon ng mga anchor ang ToC
na tumuturo sa mga file na wala nito.

· Kapag gumagamit ng --inline, kailangang mag-ingat kung ma-overwrite -- kung itatakda ng isa ang ToC sa
isasama pagkatapos ng isang ibinigay na tag (tulad ng default na BODY) kung gayon kung ang isa ay nagpapatakbo ng command
paulit-ulit na maaaring makakuha ng maraming ToC sa parehong file, isa-isa.

MGA CAVEATS

· Ang Bersyon 3.10 (at mas mataas) ay bumubuo ng mas maraming verbose (SEO-friendly) na mga anchor kaysa dati
mga bersyon. Kaya ang mga anchor na nabuo gamit ang mga naunang bersyon ay hindi tutugma sa bersyon 3.10
mga angkla

· Ang Bersyon 3.00 (at mas mataas) ng hypertoc ay kumikilos nang medyo naiiba kaysa sa Bersyon 2.x ng
hypertoc. Ito ay idinisenyo na ngayon upang gawin ang lahat sa isang pass, at hindi na tiyak
mga opsyon: ang --infile na opsyon ay hindi na ginagamit (lahat ng mga filename ay inilalagay sa dulo ng
ang utos); ang --toc_file na opsyon ay wala na; gamitin ang --outfile na opsyon
sa halip; ang --tocmap na opsyon ay hindi na sinusuportahan.

Bumubuo na ito ngayon ng mga lower-case na tag sa halip na mga upper-case.

· Ang hypertoc ay hindi masyadong mahusay (memorya at bilis), at maaaring mabagal para sa malaki
mga dokumento.

· Ngayon na ang henerasyon ng mga anchor at ng ToC ay tapos na sa isang pass, mas maraming memorya
ay ginagamit kaysa sa dati. Ito ay mas kapansin-pansin kapag nagpoproseso ng maramihang
mga file, dahil ang lahat ng mga file ay binabasa sa memorya bago iproseso ang mga ito.

· Mabubuo ang di-wastong markup kung may mahalagang elemento sa loob ng isang
anchor. Halimbawa:

Ang utos ng FOO

ay mako-convert sa (kung ang h1 ay isang makabuluhang elemento),

Ang utos ng FOO

na labag sa batas dahil ang mga anchor ay hindi mapupugad.

Mas mainam na istilo ang paglalagay ng mga pahayag ng anchor sa loob ng elementong i-angkla. Para sa
halimbawa, mas gusto ang sumusunod:

Ang utos ng FOO

matutukoy ng hypertoc ang NAME na "foo" at gagamitin ito.

Mas mabuti pa ay gumamit ng mga ID:

Ang utos ng FOO

· Ang mga katangian ng NAME na walang mga panipi ay hindi kinikilala.

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