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

CHƯƠNG TRÌNH:

TÊN

cao su - một hệ thống xây dựng cho các tài liệu LaTeX

SYNOPSIS

cao su [lựa chọn] nguồn ...
Ống cao su [lựa chọn]

MÔ TẢ

Cao su là một lớp bao bọc cho LaTeX và các chương trình đồng hành. Mục đích của nó là, được đưa ra một LaTeX
nguồn để xử lý, để biên dịch nó đủ thời gian để giải quyết tất cả các tham chiếu, có thể đang chạy
các chương trình vệ tinh như BibTeX, makeindex, Metapost, v.v. để tạo ra dữ liệu thích hợp
các tập tin.

Lệnh cao su xây dựng hoàn chỉnh các tài liệu quy định. Các tệp nguồn có thể là
nguồn LaTeX (trong trường hợp đó, hậu tố .tex có thể bị bỏ qua) hoặc các tài liệu trong
định dạng Cao su biết cách dịch sang LaTeX. Nếu một lần biên dịch không thành công, toàn bộ
quá trình dừng, bao gồm việc biên dịch các tài liệu tiếp theo trên dòng lệnh, và
cao su trả về một mã thoát khác XNUMX.

Lệnh Ống cao su làm tương tự cho một tài liệu nhưng nó đọc nguồn LaTeX từ
đầu vào tiêu chuẩn và kết xuất tài liệu đã biên dịch trên đầu ra tiêu chuẩn.

Một số thông tin không thể được trích xuất từ ​​các nguồn LaTeX. Đây là trường hợp, cho
ví dụ, với các đường dẫn tìm kiếm (có thể được chỉ định trong các biến môi trường như
TEXINPUTS) hoặc kiểu được sử dụng với Makeindex. Để giải quyết vấn đề này, người ta có thể thêm
thông tin cho Cao su trong phần bình luận của các nguồn LaTeX, xem phần HƯỚNG DẪN.

LỰA CHỌN

Các tùy chọn được sử dụng để chọn hành động được thực hiện hoặc để định cấu hình
quy trình xây dựng. Chúng hầu hết giống nhau ở cao su và Ống cao su. Các tùy chọn được phân tích cú pháp
sử dụng các quy ước GNU Getopt.

-NS, --bzip2
Nén tài liệu cuối cùng (trong bzip2 định dạng). Điều này tương đương với việc nói -o
bzip2 sau tất cả các tùy chọn khác.

--dọn dẹp
Loại bỏ tất cả các tệp do biên dịch tạo ra, thay vì tạo tài liệu.
Tùy chọn này hiện diện trong cao su chỉ một. Nó áp dụng cho việc biên dịch như nó sẽ
được thực hiện với các tùy chọn khác của dòng lệnh, tức là nói "cao su --clean
foo "sẽ không xóa foo.ps, trong khi nói" cao su --ps --clean foo "sẽ không xóa.

-NS, --chỉ huy
Thực thi lệnh (hoặc chỉ thị) được chỉ định trước phân tích cú pháp các tệp đầu vào. Nhìn thấy
phần HƯỚNG DẪN để biết thêm chi tiết.

-e, --pilogue
Thực thi lệnh (hoặc chỉ thị) được chỉ định sau khi phân tích cú pháp các tệp đầu vào. Nhìn thấy
phần HƯỚNG DẪN để biết thêm chi tiết.

-NS, --lực lượng
Bắt buộc ít nhất một lần biên dịch nguồn. Điều này có thể hữu ích, chẳng hạn, nếu
một số phụ thuộc bất thường đã được sửa đổi (ví dụ: một gói trong thư mục hệ thống). Cái này
tùy chọn không liên quan trong Ống cao su.

-z, --gzip
Nén tài liệu cuối cùng (trong gzip định dạng). Điều này tương đương với việc nói -o gz
sau tất cả các tùy chọn khác.

-NS, --Cứu giúp
Hiển thị danh sách tất cả các tùy chọn có sẵn và thoát ra một cách độc đáo.

--nơi
Đi tới thư mục của tệp nguồn trước khi biên dịch, để biên dịch
kết quả ở cùng nơi với nguồn của chúng.

--vào trong
Đi tới thư mục được chỉ định trước khi biên dịch, để tất cả các tệp được tạo
ở đó và không có trong thư mục hiện tại.

--tên công việc
Chỉ định một tên công việc khác với tên tệp cơ sở. Điều này làm thay đổi tên của
các tệp đầu ra và chỉ áp dụng cho mục tiêu đầu tiên.

-k, --giữ cho
Tùy chọn này được sử dụng trong Ống cao su chỉ một. Với tùy chọn này, các tệp tạm thời
sẽ không bị xóa sau khi biên dịch tài liệu và kết xuất kết quả trên
đầu ra tiêu chuẩn. Tài liệu tạm thời được đặt tên là rubtmpX.tex, trong đó X là một số
sao cho không có tệp nào có tên đó tồn tại ban đầu.

-l, --phong cảnh
Chỉ định rằng tài liệu cuối cùng nên sử dụng hướng ngang. Điều này có liên quan
chỉ khi sử dụng dvip or dvipdfm.

-N, --maxerr
Đặt số lỗi hiển thị tối đa. Theo mặc định, có tới 10 lỗi là
báo cáo, nói rằng -n -1 hiển thị tất cả các lỗi.

-NS, - mô-đun [:]
Sử dụng mô-đun đã chỉ định ngoài các gói của tài liệu. Lập luận có thể
được chuyển đến gói bằng cách thêm chúng sau dấu hai chấm, chúng tương ứng với gói
tùy chọn trong LaTeX. Mô-đun đã được tải trước phân tích cú pháp các nguồn của tài liệu.

--chỉ một
Biên dịch tài liệu một phần, chỉ bao gồm các nguồn được chỉ định. Những công việc này
bằng cách chèn lệnh gọi đến \ include trên dòng lệnh. Đối số là dấu phẩy-
danh sách tên tệp được phân tách.

-ồ, --Bưu kiện [:]
Sử dụng mô-đun được chỉ định làm bộ xử lý hậu kỳ. Điều này tương tự như -m lựa chọn
ngoại trừ việc mô-đun được tải sau khi phân tích cú pháp tài liệu.

-NS, --pdf
Tạo đầu ra PDF. Khi tùy chọn này đến sau --ps (ví dụ trong biểu mẫu
-pd) nó là một từ đồng nghĩa với -o ps2pdf, nếu không nó hoạt động như -m pdftex, để sử dụng
pdfLaTeX thay vì LaTeX.

-P, --ps
Xử lý DVI được tạo ra bởi quá trình thông qua dvip(1) để tạo ra một PostScript
tài liệu. Tùy chọn này là từ đồng nghĩa với -o dvip, nó không thể đến sau --pdf.

-NS, --Yên lặng
Giảm mức độ chi tiết. Đây là mặt trái của -v.

-NS, --đọc
Đọc chỉ thị bổ sung từ tệp được chỉ định (xem thêm chỉ thị "đọc").

-NS, --src-đặc biệt
Cho phép tạo nguồn đặc biệt nếu trình biên dịch hỗ trợ nó. Đây là
tương đương với việc thiết lập biến src-đặc biệt đến Vâng.

-S, --ngắn
Hiển thị thông báo lỗi của LaTeX ở dạng nhỏ gọn (một lỗi trên mỗi dòng).

-TÔI, --path
Thêm thư mục được chỉ định vào đường dẫn tìm kiếm của TeX.

--synctex
Bật hỗ trợ SyncTeX trong quá trình chạy LaTeX.

- không an toàn
Cho phép tài liệu gọi các chương trình bên ngoài tùy ý. Điều này có khả năng
nguy hiểm, chỉ sử dụng tùy chọn này cho các tài liệu đến từ một nguồn đáng tin cậy.

-v, --dài dòng
Tăng mức độ chi tiết. Các cấp độ từ 0 đến 4 tồn tại, cấp độ mặc định là 1
cho cao su và 0 cho Ống cao su. Hãy coi chừng, nói rằng -vvv khiến Cao su lên tiếng rất nhiều.

--phiên bản
In số phiên bản và thoát ra một cách độc đáo.

-À, --cảnh báo
Báo cáo thông tin của loại đã cho nếu không có lỗi trong quá trình biên dịch. Các
các loại có sẵn là: hộp (hộp quá đầy và thiếu), giới thiệu (không xác định hoặc
nhân các tham chiếu đã xác định), linh tinh (các cảnh báo khác) và tất cả các để báo cáo tất cả các cảnh báo.

MODULES

Hoạt động của cao su bị ảnh hưởng bởi các mô-đun. Các mô-đun chăm sóc các tính năng cụ thể của
gói và chương trình bên ngoài.

Gói
Đối với mọi gói mà tài liệu sử dụng, Cao su sẽ tìm kiếm một mô-đun có cùng tên để
thực hiện các tác vụ mà gói này của tôi yêu cầu ngoài việc biên dịch bởi LaTeX.
Các mô-đun có thể được thêm vào những mô-đun được cung cấp theo mặc định để bao gồm các tính năng mới (đây là
điểm của hệ thống mô-đun). Các mô-đun tiêu chuẩn như sau:

tiệm cận
Xử lý các tệp .asy được tạo bởi gói LaTeX, sau đó kích hoạt
biên dịch lại.

máy chiếu Mô-đun này xử lý các tệp bổ sung của Beamer theo cách giống như các mục lục khác.

yếm, biblatex
Đảm nhận việc xử lý thư mục của tài liệu bằng BibTeX khi cần thiết. Cái này
mô-đun được tự động tải nếu tài liệu chứa macro \ bibliography
(xem thêm trong HƯỚNG DẪN cho các tùy chọn).

kết hợp
Gói kết hợp được sử dụng để tập hợp một số tài liệu LaTeX thành một tài liệu duy nhất,
và mô-đun này xử lý các phụ thuộc trong trường hợp này.

epsfig Mô-đun này xử lý bao gồm đồ họa cho các tài liệu sử dụng kiểu cũ
\ psfig macro. Nó thực sự là một giao diện cho mô-đun đồ họa, hãy xem cái này
để biết thêm chi tiết.

chú giải
Chạy makeglossaries và biên dịch lại khi tệp .glo thay đổi.

đồ họa, đồ họax
Các mô-đun này xác định đồ họa có trong tài liệu và coi chúng là
phụ thuộc để biên dịch. Họ cũng sử dụng các quy tắc tiêu chuẩn để xây dựng các tệp này
với các chương trình bên ngoài. Xem tài liệu thông tin để biết chi tiết.

siêu tham chiếu
Xử lý các tệp bổ sung mà gói này tạo ra trong một số trường hợp.

mục lục, trang điểm, danh pháp
Xử lý các chỉ mục và danh pháp của tài liệu với lập chỉ mục(1) khi cần thiết (xem
phần HƯỚNG DẪN cho các tùy chọn).

ltxtable
Thêm phần phụ thuộc cho các tệp được chèn qua gói LaTeX ltxtable.

nhỏ, minitoc-hyper
Khi dọn dẹp, hãy xóa các tệp bổ sung được tạo ra để tạo một phần bảng của
nội dung.

thêm động từ, từng tiếng một
Thêm các tệp có \ verbatiminput và các macro tương tự vào danh sách
sự phụ thuộc.

nhiều yếm
Xử lý các thư mục bổ sung mà gói này tạo ra và xóa các thư mục bổ sung
các tập tin về việc dọn dẹp.

xr Thêm các tệp .aux bổ sung được sử dụng cho các tham chiếu bên ngoài vào danh sách các phần phụ thuộc,
vì vậy việc biên dịch lại là tự động khi tài liệu tham chiếu được thay đổi.

Sơ chế
Các mô-đun sau được cung cấp để sử dụng các chương trình tạo nguồn LaTeX từ
định dạng tệp khác nhau:

mạng xã hội Mục đích của mô-đun này là chạy dệt(1) nếu cần trước khi quá trình biên dịch thành
sản xuất nguồn LaTeX. Mô-đun này được tự động tải nếu tệp
được chỉ định trên dòng lệnh có .w làm hậu tố của nó.

lhs2TeX
Mô-đun này sử dụng lhs2TeX bộ tiền xử lý để tạo nguồn LaTeX từ một
Chương trình Literate Haskell. Nó tự động được kích hoạt nếu tên của tệp đầu vào
kết thúc bằng .lhs.

Hậu xử lý
Các mô-đun sau được cung cấp để hỗ trợ các loại xử lý hậu kỳ khác nhau. Ghi chú
rằng thứ tự quan trọng khi sử dụng các mô-đun này: nếu bạn muốn sử dụng một chuỗi xử lý
Lượt thích
foo.tex -> foo.dvi -> foo.ps -> foo.pdf -> foo.pdf.gz
bạn phải tải các mô-đun dvip, ps2pdf và gz theo thứ tự đó, chẳng hạn như sử dụng
dòng lệnh
cao su -p -o ps2pdf -z foo.tex

bzip2 Tạo phiên bản của tệp cuối cùng được nén bằng bzip2(1).

dvipdfm
Chạy dvipdfm(1) ở cuối quá trình biên dịch để tạo tài liệu PDF.

dvip Chạy dvip(1) vào cuối quá trình biên dịch để tạo ra một tài liệu PostScript. Cái này
mô-đun cũng được tải bằng tùy chọn dòng lệnh --ps.

mở rộng Tạo nguồn LaTeX mở rộng bằng cách thay thế macro \ input bằng các tệp được bao gồm,
macro thư mục của thư mục được tạo bởi cái yếm(1), và các lớp học địa phương
và các gói theo nguồn của chúng. Nếu tệp chính là foo.tex sau đó mở rộng tệp
sẽ được đặt tên foo-cuối cùng.tex. Xem tài liệu thông tin để biết chi tiết.

gz Tạo phiên bản của tệp cuối cùng được nén bằng gzip(1).

ps2pdf Giả sử rằng quá trình biên dịch tạo ra một tài liệu PostScript (ví dụ: sử dụng
mô-đun dvip), chuyển đổi tài liệu này sang PDF bằng cách sử dụng ps2pdf(1).

Trình biên dịch sự lựa chọn
Các mô-đun sau được sử dụng để thay đổi trình biên dịch LaTeX:

aleph Sử dụng trình biên dịch Aleph thay vì TeX, tức là biên dịch tài liệu bằng cách sử dụng què quặt(1)
thay vì mủ cao su.

omega Sử dụng trình biên dịch Omega thay vì TeX, tức là biên dịch tài liệu bằng lambda(1)
thay vì mủ cao su. Nếu mô-đun dvip cũng được sử dụng, nó sẽ sử dụng odvip(1) tới
dịch tệp DVI. Lưu ý rằng mô-đun này được kích hoạt tự động khi
tài liệu sử dụng gói omega.

pdftex Hướng dẫn Cao su sử dụng pdflatex(1) thay vì mủ cao su(1) để biên dịch tài liệu. Qua
mặc định, điều này tạo ra tệp PDF thay vì DVI, nhưng khi tải mô-đun
với tùy chọn dvi (ví dụ bằng cách nói -m pdftex: dvi) tài liệu được biên dịch
vào DVI bằng cách sử dụng pdflatex. Mô-đun này cũng được tải bằng tùy chọn dòng lệnh
--pdf.

xoáy Hướng dẫn Cao su sử dụng trình biên dịch VTeX. Theo mặc định, điều này sử dụng vlatex như
trình biên dịch để tạo đầu ra PDF. Với tùy chọn ps (ví dụ: khi nói "cao su -m
vtex: ps foo.tex ") trình biên dịch được sử dụng là vlatex và kết quả là một tệp PostScript.

xelatex
Hướng dẫn Cao su sử dụng xelatex(1) thay vì mủ cao su.

HƯỚNG DẪN

Hoạt động tự động của Cao su dựa trên việc tìm kiếm các macro trong các nguồn LaTeX.
Khi điều này là không đủ, chỉ thị có thể được thêm vào phần nhận xét của các nguồn. MỘT
chỉ thị là một dòng như
% cao su: cmd args
Dòng phải bắt đầu bằng "%", sau đó là bất kỳ chuỗi dấu hiệu và dấu cách "%" nào, sau đó là văn bản
"cao su:" theo sau là dấu cách và tên lệnh, có thể theo sau là dấu cách và
lập luận.

Tổng quan chỉ thị
bí danh
Giả sử rằng macro LaTeX tên1 tương đương với tên2. Điều này có thể hữu ích khi
xác định các trình bao bọc xung quanh các macro được hỗ trợ.

giống cá lăng
Cho biết rằng tệp được chỉ định nên được xóa khi làm sạch bằng cách sử dụng --dọn dẹp.

phụ thuộc
Hãy coi tệp được chỉ định là tệp phụ thuộc để thời gian sửa đổi tệp đó sẽ là
đã kiểm tra.

làm cho []
Khai báo rằng tệp đã chỉ định phải được tạo. Các tùy chọn có thể chỉ định cách
nó nên được sản xuất, các tùy chọn có sẵn là từ để chỉ định nguồn
và với để chỉ định quy tắc chuyển đổi. Ví dụ: nói "make foo.pdf
from foo.eps "chỉ ra rằng foo.pdf nên được sản xuất từ foo.eps, với bất kỳ
quy tắc chuyển đổi có thể làm điều đó. Xem tài liệu thông tin để biết chi tiết trong hồ sơ
sự chuyển đổi.

mô-đun []
Tải mô-đun được chỉ định, có thể với các tùy chọn. Điều này tương đương với
tùy chọn dòng lệnh - mô-đun.

sự thay đổi
Thực thi lệnh shell được chỉ định sau khi biên dịch nếu nội dung của
tệp được chỉ định đã thay đổi. Tên tệp kết thúc ở khoảng trắng đầu tiên.

giấy
Chỉ định các tùy chọn liên quan đến khổ giấy. Hiện tại chúng được sử dụng để cho -t lựa chọn
đến dvip và -p tùy chọn để dvipdfm.

con đường
Thêm thư mục được chỉ định vào đường dẫn tìm kiếm cho TeX (và Cao su). Tên của
thư mục là tất cả mọi thứ theo sau dấu cách sau "đường dẫn".

sản xuất
Tuyên bố rằng quá trình chạy LaTeX sẽ tạo hoặc cập nhật (các) tệp được chỉ định.

đọc
Đọc tệp chỉ thị được chỉ định. Tệp phải chứa một chỉ thị cho mỗi
hàng. Các dòng trống và dòng bắt đầu bằng "%" bị bỏ qua.

quy tắc
Đọc các quy tắc chuyển đổi bổ sung từ tệp được chỉ định. Định dạng của tệp này là
giống như của quy tắc.ini, xem tài liệu thông tin để biết chi tiết.

định
Đặt giá trị của một biến dưới dạng một chuỗi. Để biết chi tiết về các biến hiện có và
ý nghĩa của chúng, hãy xem tài liệu thông tin.

lập danh sách
Đặt giá trị của một biến dưới dạng danh sách chuỗi (được phân tách bằng dấu cách). Để biết chi tiết về
các biến hiện có và ý nghĩa của chúng, hãy xem tài liệu thông tin.

shell_escape
Đánh dấu tài liệu là yêu cầu chương trình bên ngoài (shell-Escape hoặc write18). Cao su
không thực sự kích hoạt tính năng này trừ khi được gọi với tùy chọn --unsafe.

đồng bộ hóa
Bật hỗ trợ SyncTeX trong quá trình chạy LaTeX.

đồng hồ đeo tay
Xem tệp được chỉ định để biết các thay đổi. Nếu nội dung của tệp này đã thay đổi
sau một quá trình biên dịch, thì một quá trình biên dịch khác được kích hoạt. Điều này hữu ích trong
chẳng hạn như trường hợp của mục lục.

Mô-đun cụ thể chỉ thị
Nếu một lệnh có dạng foo.bar, nó được coi là một lệnh thanh cho mô-đun foo. Nếu
mô-đun này không được đăng ký khi chỉ thị được tìm thấy, sau đó lệnh sẽ không hoạt động
mặc kệ. Đối với các mô-đun tiêu chuẩn, các chỉ thị như sau:

biblatex.path
Thêm thư mục được chỉ định vào đường dẫn tìm kiếm cho cơ sở dữ liệu BibTeX (tệp .bib).

bibtex.crossrefs
Đặt số lượng tối thiểu chéo cần thiết để tự động đưa vào
mục nhập tham chiếu trong danh sách trích dẫn. Điều này đặt tùy chọn -min-crossrefs khi nào
gọi cái yếm(1).

bibtex.path
Thêm thư mục được chỉ định vào đường dẫn tìm kiếm cho cơ sở dữ liệu BibTeX (tệp .bib).

bibtex.stylepath
Thêm thư mục được chỉ định vào đường dẫn tìm kiếm kiểu BibTeX (tệp .bst).

bibtex.tool
Sử dụng một công cụ thư mục khác thay vì BibTeX.

dvipdfm.options
Chuyển các công tắc dòng lệnh được chỉ định đến dvipdfm.

dvips.options
Chuyển các công tắc dòng lệnh được chỉ định đến dvip.

chỉ mục.tool (mục lục)
Chỉ định công cụ nào sẽ được sử dụng để xử lý chỉ mục. Hiện được hỗ trợ
công cụ là lập chỉ mục(1) (lựa chọn mặc định) và xindy(1). Lý lẽ chỉ số is
tùy chọn, nó có thể được sử dụng để chỉ định danh sách các chỉ mục mà lệnh áp dụng.
Khi trình bày phải để trong ngoặc đơn; danh sách được phân tách bằng dấu phẩy.
Khi đối số không có, lệnh áp dụng cho tất cả các chỉ số.

chỉ mục.ngôn ngữ (mục lục)
Chọn ngôn ngữ được sử dụng để sắp xếp chỉ mục. Điều này chỉ áp dụng khi sử dụng
xindy(1) làm công cụ lập chỉ mục. Đối số tùy chọn có cùng ngữ nghĩa như
ở trên.

chỉ mục.mô-đun (mục lục) ...
Chỉ định mô-đun nào sẽ sử dụng khi xử lý một chỉ mục với xindy(1). Tùy chọn
đối số có cùng ngữ nghĩa như trên.

chỉ mục.order (mục lục)
Sửa đổi các tùy chọn sắp xếp cho các chỉ mục. Các đối số là các từ (được phân tách
bởi dấu cách) trong số Tiêu chuẩn, tiếng Đức và bức thư. Điều này chỉ áp dụng khi sử dụng
lập chỉ mục(1). Đối số tùy chọn có cùng ngữ nghĩa như trên.

chỉ mục.path (mục lục)
Thêm thư mục được chỉ định vào đường dẫn tìm kiếm kiểu chỉ mục (tệp .ist). Các
đối số tùy chọn có cùng ngữ nghĩa như trên.

chỉ mục.style (mục lục)
Chỉ định kiểu chỉ mục sẽ được sử dụng. Đối số tùy chọn có cùng ngữ nghĩa
như trên.

makeidx.ngôn ngữ, . mô-đun, .đặt hàng, .con đường, .Phong cách, .dụng cụ
Các chỉ thị này giống như đối với chỉ số mô-đun, ngoại trừ việc họ không
chấp nhận đối số tùy chọn.

multibib.crossrefs, .con đường, .stylepath, .dụng cụ
Các chỉ thị này giống như đối với cái yếm nhưng chúng áp dụng cho
thư mục được quản lý bởi nhiều yếm Bưu kiện. Họ có một tùy chọn đầu tiên
đối số, với quy ước tương tự như đối với các lệnh của chỉ số mô-đun, mà
có thể được sử dụng để chỉ định danh sách thư mục mà lệnh áp dụng.

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