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

CHƯƠNG TRÌNH:

TÊN

collect_stx_titles - thu thập các khai báo tiêu đề từ các tài liệu Stx

SYNOPSIS

collect_stx_titles [-f hậu tố từ ] [ -NS hậu tố ] [ m4 lựa chọn ] hồ sơ [ hồ sơ ...]

MÔ TẢ

collect_stx_titles tìm ra các khai báo siêu dữ liệu Stx từ danh sách các tập tin, và vứt bỏ
tiêu đề và thông tin ID tài liệu dưới dạng định nghĩa m4 thành đầu ra tiêu chuẩn. Cái này
thông tin sau đó có thể được w_crosslink sử dụng để liên kết các tài liệu bằng siêu dữ liệu của chúng.

Tại sao điều này lại hữu ích? Hãy tưởng tượng rằng bạn có một trang web lớn với nhiều liên kết chéo.
Tên của tài liệu sẽ xuất hiện ở nhiều nơi: trong menu liên kết (nếu bạn có), và trong
phần nội dung của các trang khác nhau nơi nó được liên kết chéo. collect_stx_titles cho phép bạn đặt
tất cả thông tin ở một nơi và nơi nó thuộc về, tức là chính tệp. Bạn sẽ
rất vui nếu bạn đã làm như vậy, khi đến lúc thay đổi tiêu đề tài liệu hoặc di chuyển tài liệu
xung quanh; đặc biệt là như vậy nếu trang web của bạn có phép thuật đa ngôn ngữ.

LỰA CHỌN

collect_stx_titles sử dụng m4 trong nội bộ và sẽ chấp nhận bất kỳ tùy chọn nào mà m4 chấp nhận. Ngoài ra
đối với những người đó, nó có các tùy chọn sau:

-f hậu tố từ
Trong dữ liệu tên tệp, hãy thay thế bằng hậu tố hậu tố từ. Thực ra,
từ_hậu tố có thể là một biểu thức chính quy; ngu ngốc nhưng đúng, trong GNU m4, nó là một
Regexp "truyền thống", trong khi trong BSD m4, nó là regexp "mở rộng". Mặc định thành
không có hậu tố (không có gì để mang đi).

-t hậu tố
Trong dữ liệu tên tệp, hãy thay thế hậu tố được lấy đi bởi hậu tố từ với đến-
hậu tố. Nếu hậu tố từ là nil (mặc định), nối thêm hậu tố cho tất cả các tên tệp.

-p tiếp đầu ngữ
Bỏ tiền tố được cho bởi (biểu thức chính quy) tiếp đầu ngữ từ tên tệp. Các
tương đương với -t cho điều này không tồn tại, vì bạn có thể chỉ định một thư mục
tiền tố thành w_crosslink bởi w_base.

--phiên bản, -V
Chỉ cần hiển thị thông tin phiên bản và thoát.

--Cứu giúp, -?
Chỉ cần hiển thị một thông báo trợ giúp ngắn và thoát.

VÍ DỤ

Tôi đoán hầu hết thời gian bạn sẽ muốn tự động hóa việc sử dụng collect_stx_titles, để
ví dụ với Makefile như thế này:

SOURCES = $ (ký tự đại diện * .stx)
TARGETS = $ (NGUỒN: .stx = .html)

tất cả: $ (MỤC TIÊU)

title.m4: $ (SOURCES)
collect_stx_titles -f stx -t html $ ^> $ @

% .html:% .stx title.m4
stx2any -T html title.m4 $ <> $ @

Nếu bạn không muốn hoàn toàn đúng như vậy, hãy bỏ phần phụ thuộc .html vào title.m4 hoặc
tiêu đề.m4 phụ thuộc vào SOURCES. Sử dụng các tệp tạm thời là không cần thiết: điều này cũng nên
công việc:

$ collect_stx_titles * .stx | stx2any - mydoc.stx

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