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

CHƯƠNG TRÌNH:

TÊN

hxindex - chèn chỉ mục vào tài liệu HTML

SYNOPSIS

hxindex [ -t ] [ -x ] [ -n ] [ -f ] [ -r ] [ -c các lớp học ] [ -b cơ sở ] [ -i chỉ mụcdb ] [ -s
mẫu ] [ -u cụm từ ] [-] [ tệp hoặc URL ]

MÔ TẢ

Sản phẩm hxindex tìm kiếm các thuật ngữ được lập chỉ mục trong tài liệu, thu thập chúng, biến chúng thành
mục tiêu neo và tạo chỉ mục được sắp xếp dưới dạng danh sách HTML, được chèn tại vị trí
của một trình giữ chỗ trong tài liệu. Tài liệu kết quả được ghi vào đầu ra tiêu chuẩn.

Chỉ mục được chèn vào vị trí nhận xét của biểu mẫu



hoặc giữa hai nhận xét của biểu mẫu


...


Trong trường hợp sau, tất cả nội dung hiện có giữa hai nhận xét sẽ bị xóa trước.

Các thuật ngữ chỉ mục là một trong hai phần tử của loại hoặc các phần tử có thuộc tính lớp là
"mục lục". (Đối với khả năng tương thích ngược, cũng thuộc tính lớp "index-inst" và "index-def"
được công nhận.) các phần tử (và lớp "index-def") được coi là quan trọng hơn
các yếu tố với lớp "mục lục" và sẽ xuất hiện bằng chữ in đậm trong chỉ mục đã tạo.

Tùy chọn -c thêm các lớp bổ sung, đó là bí danh cho "mục lục".

Theo mặc định, nội dung của phần tử được lấy làm thuật ngữ chỉ mục. Đây là hai
ví dụ về các lần xuất hiện của thuật ngữ chỉ mục "giày":

Giày là một bộ quần áo ...
hoàn thành bởi một chiếc giày da ...

Nếu thuật ngữ được lập chỉ mục không bằng với nội dung của phần tử, tiêu đề thuộc tính
có thể được sử dụng để đưa ra thuật ngữ chính xác:

... Giày là trang phục ...
... với hai đôi giày da ...

Sản phẩm tiêu đề thuộc tính cũng phải được sử dụng khi thuật ngữ chỉ mục là một thuật ngữ con của một thuật ngữ khác.
Các cụm từ phụ xuất hiện thụt vào trong chỉ mục, dưới cụm từ chính của chúng. Để xác định một điều khoản phụ, hãy sử dụng
tiêu đề thuộc tính có hai dấu chấm than ("!!") giữa cụm từ và cụm từ phụ, như
điều này:

...
...
...

Như ví dụ cuối cùng ở trên cho thấy, có thể có nhiều cấp độ phụ.

Sản phẩm tiêu đề thuộc tính cũng cho phép nhiều cụm từ chỉ mục được liên kết với một
tần suất xảy ra. Các cụm từ được phân tách bằng một thanh dọc ("|"). So sánh
các ví dụ sau với những ví dụ trên:

...
...

Hai yếu tố này đều chèn hai thuật ngữ vào chỉ mục. Lưu ý rằng ví dụ thứ hai
ở trên kết hợp các điều khoản phụ và nhiều điều khoản.

Có thể chạy chỉ mục trên tệp đã có chỉ mục. Mục tiêu cũ neo
và chỉ mục cũ sẽ bị xóa trước khi được tạo lại.

LỰA CHỌN

Các tùy chọn sau được hỗ trợ:

-t Theo mặc định, hxindex thêm thuộc tính ID vào phần tử có chứa
sự xuất hiện của một thuật ngữ và Ngoài ra chèn một phần tử bên trong nó với một tên
thuộc tính bằng ID. Điều này là để cho phép các trình duyệt cũ bỏ qua ID
, chẳng hạn như Netscape 4, để tìm mục tiêu. Các -t tùy chọn
ngăn chặn thành phần.

-x Tùy chọn này bật các quy ước cú pháp XML: các phần tử trống sẽ kết thúc bằng />
thay vì > như trong HTML. -x ngụ ý -NS.

-i chỉ mụcdb
hxindex có thể đọc một chỉ mục ban đầu từ một tệp và ghi bộ sưu tập đã hợp nhất của
lập chỉ mục các điều khoản trở lại tệp đó. Điều này cho phép một chỉ mục mở rộng một số tài liệu.
Sản phẩm -i tùy chọn được sử dụng để cung cấp tên của tệp có chứa chỉ mục.

-b cơ sở Tùy chọn này hữu ích khi kết hợp với -i để cung cấp cho tham chiếu URL cơ sở của
tài liệu. Theo mặc định, hxindex sẽ lưu trữ các liên kết đến các lần xuất hiện trong chỉ mụcdb
nộp hồ sơ theo mẫu #mỏ neo, nhưng khi -b được đưa ra, các liên kết sẽ giống như
base # anchor thay thế.

Khi sử dụng kết hợp với -n, thuộc tính tiêu đề của các liên kết sẽ chứa
tiêu đề của tài liệu có chứa thuật ngữ. Tiêu đề được chèn trước
các mẫu (xem tùy chọn -s) và được ngăn cách với nó bằng dấu phẩy và dấu cách.
Ví dụ: nếu hxindex được gọi bằng

hxindex -i termdb -n -base myfile.html myfile.html

và termdb đã chứa một mục nhập cho "foo" trong phần "3.1" của
tài liệu có tên "file2.html" với tiêu đề "The foos", sau đó là chỉ mục được tạo
sẽ chứa một mục nhập như sau:

foo,
title = "The foos, section 3.1"> 3.1

-c lớp [, lớp [, ...]]
Các thuật ngữ chỉ mục thông thường được công nhận vì chúng có một lớp "mục lục". Sản phẩm -c
tùy chọn thêm các tên lớp bổ sung, được phân tách bằng dấu phẩy sẽ được xem xét
bí danh cho "mục lục". Ví dụ, -c ví dụ sẽ đảm bảo rằng
class = "instance"> hạn được công nhận là một thuật ngữ cho chỉ số.

-n Theo mặc định, chỉ mục bao gồm các liên kết với "#" làm văn bản liên kết. Lựa chọn -n
khiến văn bản liên kết bao gồm số phần của các phần trong đó
các điều khoản xảy ra, trở lại "không có số" (xem tùy chọn -u dưới đây) nếu không
số phần có thể được tìm thấy. Số phần được tìm thấy bằng cách tìm kiếm
thẻ bắt đầu trước gần nhất có lớp "secno" hoặc "no-num". Trong trường hợp
"secno", nội dung của phần tử đó được lấy làm số phần. bên trong
trường hợp "no-num" phần được giả định là không có số và hxindex sẽ in
"không có số" thay vào đó. Các lớp này cũng được sử dụng bởi hxnum(1), vì vậy nó là
hữu ích để chạy hxindex sau khi hxnum, ví dụ,

hxnum myfile.html | hxindex -n> mynewfile.html

-s mẫu
Tùy chọn khi nào -n được sử dụng, liên kết sẽ có thuộc tính tiêu đề và mẫu
xác định những gì nó chứa. Giá trị mặc định là "section% s", trong đó% s là
trình giữ chỗ cho số phần. Nói cách khác, chỉ mục sẽ chứa
các mục như thế này:

hạn, 7.8

Vài ví dụ:

hxindex -n -s 'chương% s'
hxindex -n -s 'part% s'
hxindex -n -s 'hoofdstuk% s' -u 'zonder nummer'

Tùy chọn này chỉ hữu ích khi kết hợp với -n

-u cụm từ Tùy chọn khi nào -n được sử dụng để hiển thị số phần, tham chiếu mà không
số phần có thể được tìm thấy được hiển thị như cụm từ thay thế. Giá trị mặc định là "??".

Tùy chọn này chỉ hữu ích khi kết hợp với -n

-f Hủy bỏ tiêu đề các thuộc tính đã được sử dụng cho chỉ mục cũng như các nhận xét
phân định chỉ mục được chèn. Điều này tránh việc các trình duyệt hiển thị những
thuộc tính. Lưu ý rằng hxindex không thể chạy lại trên đầu ra của chính nó nếu điều này
tùy chọn được sử dụng. (Ghi nhớ: "freeze "hoặc"final ".)

-r Đừng bỏ qua dấu chấm câu khi sắp xếp các từ chỉ mục. Ví dụ: nếu hai điều khoản
được viết là

foo, ... foo

hxindex thông thường sẽ bỏ qua dấu phẩy và coi chúng như một thuật ngữ giống nhau, nhưng với
-NS, họ được coi là khác nhau. Điều này ảnh hưởng đến dấu phẩy ở cuối (,), dấu chấm phẩy
(;), dấu hai chấm (:), dấu chấm than (!), dấu chấm hỏi (?) và dấu chấm (.).
Một điểm dừng cuối cùng không bao giờ bị bỏ qua nếu có hai hoặc nhiều hơn trong thuật ngữ, để
bảo vệ các chữ viết tắt ("BC") và dấu chấm lửng ("thêm ..."). Điều này không không ảnh hưởng đến
làm thế nào thuật ngữ chỉ mục được in (nó luôn được in như nó xuất hiện trong văn bản),
chỉ làm thế nào nó được so với các điều khoản tương tự. (Ghi nhớ: "raw ".)

TOÁN HẠNG

Toán hạng sau được hỗ trợ:

tệp hoặc URL
Tên của tệp HTML hoặc XML hoặc URL của một tệp. Nếu vắng mặt, hoặc nếu tệp
"-", đầu vào chuẩn được đọc thay thế.

EXIT TÌNH TRẠNG

Các giá trị thoát sau được trả về:

0 Hoàn thành thành công.

>0 Đã xảy ra lỗi khi phân tích cú pháp tệp HTML.

MÔI TRƯỜNG

Đầu vào được giả định là UTF-8, nhưng ngôn ngữ hiện tại được sử dụng để xác định
thứ tự sắp xếp của các điều khoản chỉ mục. I E, hxindex nhìn vào LANG, LC_ALL và / hoặc
LC_COLLATE biến môi trường. Nhìn thấy miền địa phương(1).

Để sử dụng proxy để truy xuất tệp từ xa, hãy đặt các biến môi trường http Proxy or
ftp_proxy. Ví dụ, http_proxy = "http://localhost: 8080 / "

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