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

CHƯƠNG TRÌNH:

TÊN

hxcite-mkbib - mở rộng tài liệu tham khảo và tạo thư mục

SYNOPSIS

hxcite-mkbib [ -b cơ sở ] [ -p Belt Hold ] [ -s phân cách ] thư tịch [ hồ sơ ]

MÔ TẢ

hxcite-mkbib bản sao lệnh hồ sơ đến đầu ra tiêu chuẩn, tìm kiếm các chuỗi có dạng
"[[nhãn]] "và làm mẫu cho thư mục. Nhãn có thể không bao gồm khoảng trắng
và cặp dấu ngoặc vuông kép phải bao quanh nhãn mà không có bất kỳ khoảng cách nào trong
giữa. Nếu như hxcite-mkbib tìm nhãn trong thư tịch, chuỗi được thay thế bằng
Belt Hold. Mẫu có thể bao gồm một số biến nhất định. Nếu nhãn không được tìm thấy trong thư tịch,
nó không thay đổi.

Mẫu mặc định thay thế chuỗi bằng một siêu kết nối, nhưng nếu -p tùy chọn được sử dụng,
sự thay thế có thể là bất kỳ mẫu nào. Đầu vào thậm chí không cần phải là HTML.

hồ sơ bao gồm ba phần:

lời mở đầu Phần mở đầu là phần tính đến lần xuất hiện đầu tiên của %{. Phần mở đầu là
được sao chép vào đầu ra một lần (với các nhãn trong ngoặc vuông ("[[nhãn]] ") được mở rộng).
tính cách % được đối xử đặc biệt. Để tạo một% duy nhất trong đầu ra, phải có
là hai trong phần mở đầu (%%). Tất cả các lần xuất hiện khác của% theo sau bởi một lần khác
chữ cái không được sao chép, nhưng được thu thập thành một chuỗi được gọi là "thứ tự sắp xếp".
và được sử dụng để sắp xếp các mục nhập, như được giải thích bên dưới.

mẫu Mẫu bắt đầu bằng % {L: và kết thúc bằng một kết hợp %}. Văn bản ở giữa
được sao chép thường xuyên vì có các mục nhập thư mục trong thư tịch tương ứng đó
đến các nhãn được đánh dấu ngoặc trong hồ sơ. Các biến trong mẫu được thay thế bằng
trường tương ứng trong mục nhập thư mục: tất cả các lần xuất hiện của %x sẽ được
được thay thế bởi lĩnh vực %x của mục nhập. Các phần của văn bản có thể được bao gồm trong %{x:
và %}. Điều này có nghĩa là văn bản ở giữa chỉ được xuất ra nếu
mục nhập hiện tại có một trường x. Văn bản được bao gồm trong % {!x: và %} sẽ chỉ có
đầu ra nếu mục nhập không không có một cánh đồng x. Cả hai loại phần điều kiện
cũng có thể được lồng vào nhau.

có hậu Văn bản sau %} được sao chép không thay đổi vào đầu ra, sau tất cả thư mục
các mục đã được xử lý.

Theo mặc định, các mục nhập thư mục được sao chép vào đầu ra theo thứ tự của các nhãn trong
hồ sơ, ngoại trừ các nhãn xuất hiện nhiều lần chỉ được sử dụng một lần. Nếu phần mở đầu
chứa sự xuất hiện của %x (Ở đâu x không phải là "%" cũng không phải "{") thì những điều này cùng xác định
thứ tự sắp xếp. Ví dụ: nếu phần mở đầu chứa% A% D thì các mục sẽ được sắp xếp trước
trên trường A (tác giả) và sau đó là trường D (ngày tháng).

Dưới đây là một ví dụ về tệp tạo thư mục ở định dạng HTML:


Thư mục
... văn bản với [[tài liệu tham khảo]] tại đây ...


% {L:
% {A: A%}% {! A:% {E: E%}% {! E:% {Q: Q%}% {! Q: -%}%}%}
% {B: "% T"
trong:% {E:% E (eds)
%} % B. % {V:% V.%}
%}% {J: "% T"
trong:% {E:% E (eds)
%} % J. % {V:% V.%}% {N:% N.%}% {P: pp.% P.%}
%}% {! B:% {! J: % T.
%}%}% {I:% I.
%}% {D:% D.
%}% {C:% C.
%}% {R:% R.
%}%{NS.
%}% {O:% O
%}% {U: % U
%}
%}



Mẫu này bắt đầu với bốn dòng mở đầu, bao gồm chuỗi sắp xếp% A% D trên dòng
3. Bản thân chuỗi sắp xếp sẽ không được xuất ra, nhưng phần còn lại của chú thích sẽ có.

Từ dòng % {L: đến dòng %} là khuôn mẫu. Ví dụ: dòng bắt đầu bằng <dt
id = ... chứa một văn bản có điều kiện phức tạp in các tác giả (% A) nếu có,
nếu không thì các biên tập viên (% E) nếu có, nếu không thì tổ chức là tác giả
(% Q), nếu có và một dấu gạch ngang nếu không. Lưu ý cách các phần được lồng vào nhau, Hầu hết văn bản là
trong %{!MỘT:...%}, nghĩa là phần đó sẽ chỉ phát huy tác dụng nếu không có tác giả
trường (% A).

Hai dòng cuối cùng là dòng cuối cùng và sẽ đơn giản là sẽ được sao chép không thay đổi.

Một mục nhập thư mục trông giống như thế này trong thư tịch:

% L Java
% A Gosling, James
% A Niềm vui, Bill
% A Steele, Guy
% T Đặc tả ngôn ngữ Java
% D 1998
% I Addison-Wesley
%U http://java.sun.com/docs/books/jls/index.html

sẽ được in bởi mẫu trên như:

Gosling, James; Niềm vui, Bill; Steele, Guy
Đặc tả ngôn ngữ Java.
Addison-Wesley.
1998.
<a href="/http://java.sun.com/docs/books/jls/index.html">http://java.sun.com/docs/books/jls/index.html

LỰA CHỌN

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

-p Belt Hold
Chỉ định kiểu mà chuỗi [[nhãn]] được thay thế. Mô hình
có thể bao gồm các biến %b (sẽ được thay thế bằng giá trị của -b
tùy chọn) và %L (sẽ được thay thế bằng nhãn). Mẫu mặc định là

[% L]

-b cơ sở Đặt giá trị cho %b biến trong mô hình. Thông thường, điều này được đặt thành
URL tương đối hoặc tuyệt đối. Theo mặc định, giá trị này là một chuỗi trống.

-s phân cách
Nếu có nhiều tác giả hoặc biên tập viên trong một mục nhập, tên của họ sẽ được liệt kê
có dấu phân cách ở giữa. Theo mặc định, dấu phân tách là ";" (nghĩa là dấu chấm phẩy
và một khoảng trắng). Với tùy chọn này, dấu phân cách có thể được thay đổi.

TOÁN HẠNG

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

thư tịch Tên của cơ sở dữ liệu thư mục phải được cung cấp. Nó phải là một tệp trong
xem(1) định dạng và mọi mục nhập phải có ít nhất một %L lĩnh vực được so sánh
vào các nhãn được đặt trong ngoặc vuông. (Các mục nhập không có trường như vậy sẽ bị bỏ qua.)

hồ sơ Tên của tệp đầu vào là tùy chọn. Nếu vắng mặt, hxmkbib(1) sẽ đọc
mẫu từ stdin.

CHẨN ĐOÁN

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. Thông thường điều này là do không thể mở tệp hoặc vì
các cặp% {và%} không được lồng nhau đúng cách. Rất hiếm khi nó cũng có thể là một
lỗi bộ nhớ. Một số thông báo lỗi có thể xảy ra:

mất tích ':' in Belt Hold
hxmkbib tìm thấy% {nhưng ký tự thứ hai hoặc thứ ba sau nó không phải là dấu hai chấm.

Không '% {' in mẫu hồ sơ
Tệp mẫu không sử dụng được vì nó không chứa mẫu.

không cân bằng % {..%} in Belt Hold
Có nhiều hơn %}.

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