hypertocp - Trực tuyến trên đám mây

CHƯƠNG TRÌNH:

TÊN

hypertoc - tạo mục lục cho các tài liệu HTML

PHIÊN BẢN

phiên bản 3.20

SYNOPSIS

hypertoc --help | --manpage | --man_help | --Đàn ông

hypertoc [--bak chuỗi ] [--debug] [--entrysep chuỗi ] [--footer hồ sơ ] [--header
hồ sơ ] [--ignore_only_one] [--ignore_sole_first] [--inline] [--make_anchors] [
--make_toc] [--notoc_match chuỗi ] [--ol | --nool] [--ol_num_levels] [--outfile
hồ sơ ] [--overwrite] [--quiet] [--textonly] [--title chuỗi ] {--toc_ after
tag = hậu tố } {--toc_before tag = tiền tố } {--toc_end tag = endtag } {--toc_entry tag = cấp độ
} [--toc_label chuỗi ] [--toc_only | --notoc_only] [--toc_tag chuỗi ] [
--toc_tag_replace] [--use_id] [--useorg] tệp ...

MÔ TẢ

hypertoc cho phép bạn chỉ định "các phần tử quan trọng" sẽ được liên kết với
"Mục lục" (ToC) cho một bộ tài liệu HTML nhất định.

Về cơ bản, ToC được tạo là một danh sách nhiều cấp có chứa các liên kết đến
các yếu tố quan trọng. hypertoc chèn các liên kết vào ToC tới các phần tử quan trọng tại một
mức do người dùng chỉ định.

Ví dụ:

Nếu H1 được chỉ định là cấp 1, thì chúng sẽ xuất hiện trong danh sách cấp đầu tiên của ToC. Nếu như
H2 được chỉ định là cấp 2, hơn là chúng xuất hiện trong danh sách cấp hai trong ToC.

Có hai khía cạnh đối với việc tạo ToC: (1) đặt các neo phù hợp vào HTML
tài liệu (--make_anchors) và (2) tạo ToC từ tài liệu HTML có
neo trong chúng để ToC liên kết đến (--make_toc). Người ta có thể chọn làm một hoặc cả hai
những cái này.

hypertoc cũng hỗ trợ khả năng kết hợp ToC vào chính tài liệu HTML
thông qua tùy chọn --inline.

Để hypertoc hỗ trợ liên kết với các phần tử quan trọng, hypertoc sẽ chèn các neo
vào các yếu tố quan trọng. Người ta có thể sử dụng hypertoc làm bộ lọc, ngoại trừ kết quả
một tệp khác hoặc một người có thể ghi đè lên tệp gốc, với tệp gốc được sao lưu bằng
hậu tố (mặc định: "org") được thêm vào tên tệp.

Người ta cũng có thể xác định các tùy chọn trong tệp cấu hình cũng như trên dòng lệnh.

LỰA CHỌN

Các tùy chọn có thể bắt đầu bằng "-" hoặc "-"; các tùy chọn boolean có thể bị phủ định bằng cách đặt trước chúng bằng
"không"; các tùy chọn có giá trị băm hoặc mảng có thể được thêm vào bằng cách cung cấp lại tùy chọn cho
mỗi giá trị.

Xem Getopt :: Long để biết thêm thông tin.

--argfile tên tập tin
Tên của một tệp để đọc các tùy chọn khác. Điều này có thể được sử dụng nhiều hơn một lần. Vì
thí dụ:

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

Xem "Tệp tùy chọn" để biết thêm thông tin.

--bak
--bak chuỗi

Nếu tệp đầu vào / tệp đang / đang bị ghi đè (- ghi đè đang bật), hãy sao chép
tệp gốc thành "tên tập tin.chuỗi". Nếu giá trị trống, không có tệp sao lưu
bằng văn bản. (mặc định: org)

--gỡ lỗi
Bật đầu ra gỡ lỗi chi tiết. Được sử dụng để gỡ lỗi mô-đun này; nói cách khác,
đừng bận tâm. (mặc định: tắt)

--entrysep
--entrysep chuỗi

Chuỗi phân tách cho không mục nhập (mặc định: ",")

--chân trang
--chân trang hồ sơ

Tệp chứa văn bản chân trang cho mục lục.

--tiêu đề
--tiêu đề hồ sơ

Tệp chứa văn bản tiêu đề cho mục lục.

--Cứu giúp
In một thông báo trợ giúp ngắn và thoát.

--ignore_only_one
Nếu chỉ có một mục trong ToC, đừng tạo ToC.

--ignore_sole_first
Nếu mục đầu tiên trong ToC là cấp cao nhất, VÀ nó là mục duy nhất trong số đó
cấp, bỏ qua nó. Điều này rất hữu ích trong các trang web chỉ có một tiêu đề H1 nhưng
người ta không biết trước liệu sẽ có một cái duy nhất.

--nội tuyến
Đặt ToC trong tài liệu tại một điểm nhất định. Xem "Nội tuyến ToC" để biết thêm thông tin.

--make_anchors | --gen_anchors
Tạo neo cho mục lục để liên kết đến.

--make_toc | --gen_toc
Tạo Mục lục liên kết đến các phần tử quan trọng được cố định.

--man_help | --manpage | --Đàn ông
In tất cả tài liệu và thoát.

--notoc_match
--notoc_match chuỗi

Nếu có một số thẻ riêng lẻ mà bạn không muốn đưa vào bảng
nội dung, ngay cả khi chúng khớp với "các yếu tố quan trọng", thì nếu mẫu này
khớp với nội dung bên trong thẻ (không phải phần nội dung), thì thẻ đó sẽ không được đưa vào,
trong việc tạo neo cũng như trong việc tạo ToC. (mặc định: class = "notoc")

--ol | --nool
Sử dụng danh sách có thứ tự cho các mục Mục lục (theo độ sâu nhất định). Nếu --ol là
false (tức là --nool được đặt) thì không sử dụng danh sách có thứ tự cho các mục nhập ToC.

(mặc định: false)

(Xem --ol_num_levels để xác định mức độ sâu của danh sách theo thứ tự)

--ol_num_levels
Số cấp độ sâu trong danh sách CV sẽ tăng lên nếu --ol là true. Nếu được đặt thành XNUMX,
sẽ sử dụng một danh sách có thứ tự cho tất cả các cấp. (mặc định: 1)

--outfile
--outfile hồ sơ

Tệp để ghi đầu ra vào. Đây là nơi đầu ra HTML được sửa đổi và Bảng-of-
Nội dung chuyển đến. Nếu bạn cung cấp '-' làm tên tệp, thì đầu ra sẽ chuyển đến STDOUT.
(mặc định: STDOUT)

- ghi đè
Ghi đè tệp đầu vào với đầu ra. Nếu điều này có hiệu lực, --outfile sẽ bị bỏ qua.
Được dùng trong create_anchors để tạo các neo "tại chỗ" và ở create_toc if
tùy chọn --inline đang có hiệu lực. (mặc định: tắt)

--Yên lặng
Ngăn chặn các thông báo cung cấp thông tin. (mặc định: tắt)

--chỉ văn bản
Chỉ sử dụng nội dung văn bản trong các phần tử quan trọng.

--chức vụ
--chức vụ chuỗi

Tiêu đề cho trang ToC (nếu không sử dụng --header hoặc --inline hoặc --toc_only) (mặc định: "Bảng
trong số Nội dung ")

--toc_ after
--toc_ after tag=hậu tố

--toc_ after "H2 ="

Để xác định bố cục của các phần tử quan trọng trong ToC. Các tag là thẻ HTML mà
đánh dấu sự bắt đầu của phần tử. Các hậu tố là những gì được yêu cầu để được thêm vào
Mục lục Mục lục được tạo cho thẻ đó. Đây là một đối số băm tích lũy.
(mặc định: không xác định)

--toc_b Before
--toc_b Before tag=tiếp đầu ngữ

--toc_before "H2 = "

Để xác định cách bố trí của các phần tử quan trọng trong ToC. Các tag là thẻ HTML
đánh dấu sự bắt đầu của phần tử. Các tiếp đầu ngữ là những gì được yêu cầu phải được thêm vào trước
vào mục Mục lục được tạo cho thẻ đó. Đây là một hàm băm tích lũy
tranh luận. (mặc định: không xác định)

--toc_end
--toc_end tag=thẻ cuối

--toc_end "H1 = / H1"

Để xác định các yếu tố quan trọng. Các tag là thẻ HTML đánh dấu sự bắt đầu của
phần tử. Các thẻ cuối thẻ HTML đánh dấu phần cuối của phần tử. Khi nào
khớp trong tệp đầu vào, trường hợp được bỏ qua (nhưng hãy đảm bảo rằng tất cả tag lựa chọn
đề cập đến cùng một thẻ hoàn toàn giống nhau!). Đây là một đối số băm tích lũy.
(mặc định: H1 = / H1 H2 = / H2)

--toc_entry
--toc_entry tag=cấp

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

Để xác định các yếu tố quan trọng. Các tag là thẻ HTML đánh dấu sự bắt đầu của
phần tử. Các cấp là cấp độ mà thẻ được coi là. Giá trị của cấp
phải là số và khác XNUMX. Nếu giá trị âm, các mục nhập phụ thuộc
được đại diện bởi phân_lục_có_lượng sẽ được phân tách bằng giá trị được đặt bởi
- tùy chọnentrysep. Đây là một đối số băm tích lũy. (mặc định: H1 = 1 H2 = 2)

--toc_label | --toclabel
--toc_label chuỗi

Văn bản HTML gắn nhãn ToC. Luôn luôn được sử dụng. (vỡ nợ: " Mục lục ")

--toc_only | --notoc_only
Chỉ xuất ra Mục lục, tức là Mục lục cộng với toc_label.
Nếu có --header hoặc --footer, chúng cũng sẽ được xuất ra.

Nếu --toc_only là false (tức là --notoc_only được đặt) thì nếu không có --header và
--inline không đúng, thì một tiêu đề trang HTML phù hợp sẽ được xuất ra và nếu có
không --footer và --inline là không đúng, khi đó một chân trang của trang HTML sẽ được xuất ra.
(mặc định: - notoc_only)

--toc_tag
--toc_tag chuỗi

Nếu ToC được đưa vào nội tuyến, thì đây là mẫu được sử dụng để khớp với thẻ
nơi ToC nên được đặt. Đây có thể là thẻ bắt đầu, thẻ kết thúc hoặc nhận xét, nhưng
dấu <nên được bỏ đi; nghĩa là, nếu bạn muốn ToC được đặt sau BODY
, sau đó đưa ra "BODY". Nếu bạn muốn có một thẻ nhận xét đặc biệt để làm nơi ToC nên
đi, sau đó bao gồm các dấu nhận xét, ví dụ: "! - toc--" (mặc định: BODY)

--toc_tag_replace
Cùng với --toc_tag, đây là một lá cờ để cho biết liệu thẻ đã cho có phải là
được thay thế, hoặc nếu ToC nên được đặt sau thẻ. Điều này có thể hữu ích nếu
toc_tag là một nhận xét và bạn không cần nó sau khi đã có Điều khoản sử dụng.
(mặc định: false)

--use_id
Sử dụng id = "tên"cho neo hơn làtên"> neo. Tuy nhiên nếu một mỏ neo
đã tồn tại cho một Phần tử quan trọng, điều này sẽ không tạo ID cho phần tử cụ thể đó
thành phần.

--useorg
Sử dụng các tệp sao lưu có sẵn làm nguồn đầu vào; nghĩa là, các tệp của biểu mẫu
tên tập tin.bánh (xem --bak).

FILE M FORU ĐƠN

Các lựa chọn Các tập tin
Các tùy chọn có thể được cung cấp trong tệp cũng như trên dòng lệnh bằng cách sử dụng --argfile
tên tập tin trong dòng lệnh. Ngoài ra, các tệp ~ / .hypertocrc và ./.hypertocrc là
đã kiểm tra các tùy chọn.

Định dạng như sau: Các dòng bắt đầu bằng # là nhận xét. Các dòng kèm theo trong PoD
đánh dấu cũng là bình luận. Các dòng trống bị bỏ qua. Bản thân các tùy chọn phải là
theo cách chúng sẽ ở trên dòng lệnh, tức là tên tùy chọn (kể cả các
-) theo sau là giá trị của nó (nếu có).

Ví dụ:

# đặt ToC thành ba cấp
--toc_entry H1 = 1
--toc_entry H2 = 2
--toc_entry H3 = 3

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

Các tệp tùy chọn có thể được lồng vào nhau, bằng cách đưa ra một --argfile tên tập tin đối số bên trong tùy chọn
tệp, nó cũng sẽ đi và lấy tệp được giới thiệu đó.

Xem Getopt :: ArgvFile để biết thêm thông tin.

CHI TIẾT

Đáng kể Các yếu tố
Dưới đây là một số ví dụ về việc xác định các yếu tố quan trọng cho Mục lục của bạn.

Ví dụ of Mặc định

Phần sau phản ánh cài đặt mặc định nếu không có gì được chỉ định rõ ràng:

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

Hoặc, nếu nó được xác định trong một trong các "Tệp tùy chọn" có thể có:

# thiết lập mặc định
--toc_entry H1 = 1
--toc_end H1 = / H1
--toc_entry H2 = 2
--toc_end H2 = / H2

Ví dụ of trước / sau

Các tùy chọn sau sử dụng các tùy chọn trước / sau:

# Một tệp tùy chọn bổ sung một số định dạng
# tạo mục nhập ToC cấp 1
--toc_entry H1 = 1
--toc_end H1 = / H1
--toc_before H1 =
--toc_ after H1 =

# thực hiện các mục nhập ToC cấp 2
--toc_entry H2 = 2
--toc_end H2 = / H2
--toc_before H2 =
--toc_ after H2 =

# Thực hiện các mục cấp 3 như nguyên trạng
--toc_entry H3 = 3
--toc_end H3 = / H3

Ví dụ of khách hàng cuối

Các tùy chọn sau cố gắng lập chỉ mục các thuật ngữ định nghĩa:

# Một tệp tùy chọn có thể hoạt động cho các tài liệu loại Bảng chú giải thuật ngữ
--toc_entry H1 = 1
--toc_end H1 = / H1
--toc_entry H2 = 2
--toc_end H2 = / H2

# Giả sử tài liệu có DD cho mỗi DT, nếu không thì ToC
# sẽ nhận được các mục nhập có nhiều văn bản.
--toc_entry DT = 3
--toc_end DT = DD
--toc_before DT =
--toc_ after DT =

Định dạng các ToC
Các tùy chọn --toc_entry, v.v. cung cấp cho bạn quyền kiểm soát về cách các mục nhập ToC có thể trông như thế nào, nhưng ở đó
là các tùy chọn khác để ảnh hưởng đến giao diện cuối cùng của tệp ToC được tạo.

Với tùy chọn --header, nội dung của tệp đã cho sẽ được thêm vào trước
ToC đã tạo. Điều này cho phép bạn có văn bản giới thiệu hoặc bất kỳ văn bản nào khác, trước
ToC.

Lưu ý:
Nếu bạn sử dụng tùy chọn --header, hãy đảm bảo rằng tệp được chỉ định chứa HTML mở
, phần tử HEAD (chứa phần tử TITLE) và thẻ mở BODY.
Tuy nhiên, các thẻ / phần tử này không được nằm trong tệp tiêu đề nếu tùy chọn --inline
Được sử dụng. Xem "Nội tuyến ToC" để biết thông tin về những gì tệp tiêu đề nên chứa
để nội tuyến ToC.

Với tùy chọn --toc_label, nội dung của chuỗi đã cho sẽ được thêm vào trước
ToC được tạo (nhưng sau bất kỳ văn bản nào được lấy từ tệp --header).

Với tùy chọn --footer, nội dung của tệp sẽ được thêm vào sau khi
ToC.

Lưu ý:
Nếu bạn sử dụng -footer, hãy đảm bảo rằng nó bao gồm các thẻ đóng BODY và ​​HTML (trừ khi,
tất nhiên, bạn đang sử dụng tùy chọn --inline).

Nếu tùy chọn --header không được chỉ định, đánh dấu HTML bắt đầu thích hợp sẽ là
được thêm vào, trừ khi tùy chọn --toc_only được chỉ định. Nếu tùy chọn --footer không phải là
được chỉ định, đánh dấu HTML đóng thích hợp sẽ được thêm vào, trừ khi tùy chọn --toc_only
được quy định.

Nếu bạn không muốn / cần phải xử lý đầu trang và chân trang, tệp, thì bạn được phân bổ cho
chỉ định tiêu đề, tùy chọn --title, của tệp ToC; và nó cho phép bạn chỉ định một
tiêu đề hoặc nhãn, để đặt trước danh sách mục nhập ToC, tùy chọn --toc_label. Cả hai lựa chọn
có giá trị mặc định, hãy xem "TÙY CHỌN" để biết thêm thông tin về từng tùy chọn.

Nếu bạn không muốn cung cấp thẻ trang HTML và chỉ muốn chính ToC, thì
chỉ định tùy chọn --toc_only. Nếu không có tệp --header hoặc --footer, thì điều này sẽ
chỉ cần xuất nội dung của --toc_label và chính ToC.

Nội tuyến các ToC
Khả năng kết hợp ToC trực tiếp vào tài liệu HTML được hỗ trợ thông qua
- tùy chọn nội tuyến.

Nội tuyến sẽ được thực hiện trên tệp đầu tiên trong danh sách các tệp được xử lý và sẽ chỉ
được thực hiện nếu tệp đó chứa thẻ mở khớp với giá trị --toc_tag.

Nếu --overwrite là true, thì tệp đầu tiên trong danh sách sẽ bị ghi đè, với
ToC đã tạo được chèn tại vị trí thích hợp. Nếu không, một phiên bản sửa đổi của phiên bản đầu tiên
tệp được xuất ra STDOUT hoặc tệp đầu ra được xác định bởi tùy chọn --outfile.

Các tùy chọn --toc_tag và --toc_tag_replace được sử dụng để xác định ToC ở đâu và như thế nào
được chèn vào đầu ra.

Ví dụ 1

# đây là mặc định
--toc_tag CƠ THỂ --notoc_tag_replace

Điều này sẽ đặt ToC được tạo sau thẻ BODY của tệp đầu tiên. Nếu --header
tùy chọn được chỉ định, sau đó nội dung của tệp được chỉ định sẽ được chèn vào sau BODY
nhãn. Nếu tùy chọn --toc_label không trống, thì văn bản được chỉ định bởi --toc_label
tùy chọn được chèn. Sau đó, ToC được chèn và cuối cùng, nếu tùy chọn --footer
được chỉ định, nó sẽ chèn chân trang. Sau đó, phần còn lại của tệp đầu vào sẽ như sau
trước đây.

Ví dụ 2

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

Điều này sẽ đặt ToC được tạo sau nhận xét đầu tiên của biểu mẫu , và điều đó
nhận xét sẽ được thay thế bằng ToC (theo thứ tự
--tiêu đề
--toc_label
ToC
--footer) theo sau là phần còn lại của tệp đầu vào.

Lưu ý:
Tệp tiêu đề không được chứa thẻ HTML bắt đầu và phần tử HEAD vì
Tệp HTML đang được xử lý phải chứa các thẻ / phần tử này.

VÍ DỤ

Tạo an nội tuyến ToC cho một hồ sơ
hypertoc --inline --make_anchors --overwrite --make_toc index.html

Thao tác này sẽ tạo neo trong "index.html", tạo ToC với tiêu đề "Bảng của
Nội dung "và đặt nó sau thẻ BODY của" index.html ". Tệp index.html.org sẽ
chứa tệp index.html ban đầu, không có ToC hoặc ký tự neo.

Tạo a ToC hồ sơ từ nhiều các tập tin
Đầu tiên, tạo các neo.

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

Sau đó, tạo ToC

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

Tạo an nội tuyến ToC sau khi các Thành phố điện khí hóa phía tây dãy núi Rocky đầu tiên phần mở đầu of các Thành phố điện khí hóa phía tây dãy núi Rocky đầu tiên hồ sơ
hypertoc --make_anchors --inline --overwrite --make_toc --toc_tag / H1 \
--notoc_tag_replace --toc_label "" index.html fred.html george.html

Thao tác này sẽ tạo neo trong các tệp "index.html", "fred.html" và "george.html", hãy tạo
ToC không có tiêu đề và đặt nó sau tiêu đề H1 đầu tiên trong "index.html" và sao lưu
các tệp gốc tới "index.html.org", "fred.html.org" và "george.html.org"

Tạo an nội tuyến ToC với khách hàng các yếu tố
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

Điều này sẽ tạo ToC nội tuyến ghi đè lên tệp gốc và thay thế một
nhận xét và nhận tiêu đề H2 làm tiêu đề cấp 1 và tiêu đề H3 là cấp 2. Điều này có thể
hữu ích khi tệp .html được tạo bởi một số quy trình khác và sau đó bạn có thể tạo
ToC là bước cuối cùng.

Tạo a ToC với khách hàng các yếu tố
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

Điều này tạo ra các neo tại các phần tử H2 và H3 và tạo một tệp ToC có tên là index.html,
lập chỉ mục trên TITLE và các phần tử H2 và H3.

Tạo a ToC với khách hàng các yếu tố và lựa chọn hồ sơ
Đưa ra một tệp tùy chọn được gọi là 'custom.opt' như sau:

# Tiêu đề, H2 và 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

thì ví dụ trước có thể có các dòng lệnh ngắn hơn như sau:

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

GHI CHÚ

· Hypertoc đủ thông minh để phát hiện các neo bên trong các phần tử quan trọng. Nếu mỏ neo
xác định thuộc tính NAME, hypertoc sử dụng giá trị. Ngoài ra, nó sẽ thêm NAME của chính nó
thuộc tính cho anchor. Nếu --use_id là true, thì nó cũng sẽ kiểm tra và sử dụng
ID.

· Phần tử TITLE được xử lý đặc biệt nếu được chỉ định là phần tử quan trọng. Nó là
bất hợp pháp để chèn neo (A) vào các phần tử TITLE. Do đó, hypertoc sẽ thực sự
liên kết đến chính tên tệp thay vì phần tử TITLE của tài liệu.

· Hypertoc sẽ bỏ qua một phần tử quan trọng nếu nó không chứa bất kỳ khoảng trắng nào
nhân vật. Một thông báo cảnh báo được tạo ra nếu điều kiện như vậy tồn tại.

· Nếu bạn có một chuỗi các yếu tố quan trọng thay đổi một chút
thời trang, chẳng hạn như H1 -> H3 -> H2 hoặc thậm chí H2 -> H1, mặc dù hypertoc giải quyết vấn đề này để
tạo một danh sách vẫn là HTML tốt, nếu bạn đang sử dụng một danh sách có thứ tự
độ sâu, sau đó bạn sẽ nhận được đánh số kỳ lạ, vì một phần tử danh sách bổ sung sẽ được
được chèn để lồng các phần tử ở mức chính xác.

Ví dụ (H2 -> H1 với --ol_num_levels = 1):

1.
* Tiêu đề H2 của tôi
2. Tiêu đề H1 của tôi

Ví dụ: (H1 -> H3 -> H2 với --ol_num_levels = 0 và H3 cũng có ý nghĩa):

1. Tiêu đề H1 của tôi
1.
1. Tiêu đề H3 của tôi
2. Tiêu đề H2 của tôi
2. Tiêu đề H1 thứ hai của tôi

Trong những trường hợp như vậy, tốt hơn là không nên sử dụng tùy chọn --ol.

· Nếu một người không sử dụng - ghi đè khi tạo neo, thì lệnh cần phải
được thực hiện trong hai lần, để cung cấp các tên tệp chính xác (những tên có thực
neo trong chúng) vào phần tạo ToC. Nếu không ToC sẽ có neo
trỏ đến các tệp không có chúng.

· Khi sử dụng --inline, cần phải cẩn thận nếu ghi đè - nếu một người đặt ToC thành
được đưa vào sau một thẻ nhất định (chẳng hạn như BODY mặc định) sau đó nếu một thẻ chạy lệnh
lặp đi lặp lại một người có thể nhận được nhiều ToC trong cùng một tệp, cái này đến cái khác.

THẬN TRỌNG

· Phiên bản 3.10 (trở lên) tạo nhiều neo dài hơn (thân thiện với SEO) hơn trước
các phiên bản. Do đó, các neo được tạo với các phiên bản trước đó sẽ không khớp với phiên bản 3.10
mỏ neo.

· Phiên bản 3.00 (trở lên) của hypertoc hoạt động hơi khác so với Phiên bản 2.x của
hypertoc. Nó hiện được thiết kế để thực hiện mọi thứ trong một lần và đã giảm một số
tùy chọn: tùy chọn --tệp không còn được sử dụng nữa (tất cả các tên tệp được đặt ở cuối
lệnh); tùy chọn --toc_file không còn tồn tại; sử dụng tùy chọn --outfile
thay thế; tùy chọn --tocmap không còn được hỗ trợ.

Bây giờ nó tạo ra các thẻ viết thường thay vì viết hoa.

· Hypertoc không hiệu quả lắm (bộ nhớ và tốc độ), và có thể chậm
các tài liệu.

· Giờ đây, thế hệ neo và ToC được thực hiện trong một lần, thậm chí nhiều bộ nhớ hơn
được sử dụng nhiều hơn so với trường hợp trước đây. Điều này đáng chú ý hơn khi xử lý nhiều
vì tất cả các tệp được đọc vào bộ nhớ trước khi xử lý chúng.

· Đánh dấu không hợp lệ sẽ được tạo nếu một phần tử quan trọng được chứa bên trong
mỏ neo. Ví dụ:

Lệnh FOO

sẽ được chuyển đổi thành (nếu h1 là một phần tử quan trọng),

Lệnh FOO

điều này là bất hợp pháp vì các neo không thể được lồng vào nhau.

Tốt hơn là bạn nên đặt các câu lệnh neo trong phần tử được neo. Vì
ví dụ, những điều sau được ưu tiên:

Lệnh FOO

hypertoc sẽ phát hiện TÊN "foo" và sử dụng nó.

Tốt hơn nữa là sử dụng các ID:

Lệnh FOO

· Các thuộc tính NAME không có dấu ngoặc kép không được nhận dạng.

Sử dụng hypertocp trực tuyến bằng các dịch vụ onworks.net