Bản tiếng Anh của trang này mới hơn.
Các gói không hoạt động trong Scissor LaTeX
Tài liệu vẫn được dàn trang. Một gói mà Scissor LaTeX chưa từng biết đến tạo ra một ghi chú trong thẻ Sự cố; những gói phổ biến mà nó không triển khai, như fancyhdr, titlesec hay tcolorbox, được chấp nhận mà không báo và không có tác dụng; còn các lệnh không xác định bị bỏ qua kèm thông báo, trong khi văn bản của chúng thường được giữ lại.
Cách các gói được xử lý
Scissor LaTeX không chạy mã của gói. Nó chuyển đổi tài liệu của bạn bằng bộ máy riêng, bộ máy này triển khai các lệnh của những gói có trong các trang này. Vì vậy, một dòng \usepackage thuộc về một trong ba nhóm:
| Nhóm | Ví dụ | Điều gì xảy ra |
|---|---|---|
| Được triển khai, toàn bộ hoặc một phần | amsmath, graphicx, booktabs, pgfplots, hyperref | Các lệnh hoạt động như mô tả trên trang của từng gói. |
| Được biết đến, nhưng không có tác dụng | fancyhdr, titlesec, setspace, microtype, tcolorbox | Được chấp nhận mà không báo. Các thiết lập của chúng không thay đổi gì, và các lệnh của chúng hoặc bị bỏ qua hoặc bị coi là không xác định. |
| Không xác định | chemfig, một tệp .sty của nhà xuất bản, một tên viết sai | Một ghi chú trong thẻ Sự cố: "Package ... is not available here, so its formatting is not applied." |
Một lệnh không xác định, từ bất kỳ gói nào, sẽ bị bỏ qua và được liệt kê trong thẻ Sự cố. Các đối số trong ngoặc nhọn của nó thường ở lại trong văn bản, nên bạn thấy chữ nhưng không thấy định dạng. Với một vài lệnh, điều đó không như bạn muốn: các đối số là danh sách tùy chọn hoặc tên, và chúng hiện ra thành văn bản thừa. Các bảng dưới đây nêu tên những trường hợp đó.
Nếu một gói hoặc lớp tài liệu có sẵn dưới dạng tệp .sty hoặc .cls trong dự án của bạn, Scissor LaTeX đọc một phần của nó: các định nghĩa \newcommand, các gói mà nó nạp, màu, lề trang và khoảng cách đoạn văn. Mọi mã khác trong tệp không được chạy, và thẻ Sự cố sẽ cho biết điều đó.
Các gói phổ biến chưa hoạt động
Bố cục trang và tiêu đề
| Gói | Trong Scissor LaTeX | Thay thế |
|---|---|---|
| fancyhdr | Được chấp nhận, không có tác dụng: không có tiêu đề đầu trang hay chân trang. | Không cần thay đổi gì; các thiết lập sẽ được áp dụng trong một bản cài đặt TeX. |
| titlesec | Được chấp nhận, không có tác dụng: tiêu đề giữ kiểu của lớp tài liệu. | |
| sectsty | Gói không xác định, kèm ghi chú; \sectionfont và các lệnh tương tự bị bỏ qua. | |
| setspace | \onehalfspacing và \doublespacing bị bỏ qua. \begin{spacing}{1.5} in ra "1.5" trước văn bản. | Bỏ môi trường spacing đi. |
| lineno | \linenumbers bị bỏ qua. |
Hộp, ghi chú và tô sáng
| Gói | Trong Scissor LaTeX | Thay thế |
|---|---|---|
| tcolorbox, mdframed, framed | Được chấp nhận; văn bản được giữ nhưng không có hộp, và tiêu đề hộp bị mất. | Một môi trường quote, hoặc một tabular với \hline và | làm khung. |
| todonotes | \todo{...} không được nhận biết: văn bản ghi chú hiện trong dòng. \missingfigure cũng vậy. | Chú thích với %. |
| marginnote | \marginpar và \marginnote không được nhận biết: ghi chú hiện trong dòng. | Một chú thích cuối trang. |
| soul | \st hoạt động (gạch ngang). \hl giữ văn bản nhưng không tô sáng; \ul và \so không được nhận biết. | \underline để gạch chân. |
| ulem | \uline và \sout hoạt động; \uwave hiện văn bản thường. |
Khoa học và sơ đồ
| Gói | Trong Scissor LaTeX | Thay thế |
|---|---|---|
| mhchem | \ce{H2O} trong văn bản hiện "H2O" mà không có chỉ số dưới. Trong công thức, nó làm công thức chuyển sang màu đỏ. | Viết H$_2$O hoặc $\mathrm{CO_2}$. |
| chemfig | Gói không xác định; \chemfig bị bỏ qua. | Một ảnh của cấu trúc. |
| tikz-cd, circuitikz, forest | Hình bị bỏ qua, kèm thông báo. | Node và mũi tên của TikZ, hoặc một ảnh. |
| pgfplotstable | \pgfplotstabletypeset bị bỏ qua; tên tệp được in ra. | Một tabular. Vẽ đồ thị từ bảng thì hoạt động, xem pgfplots. |
| siunitx | Xem siunitx. | 44\,\mathrm{km} |
Bảng, danh sách và công cụ văn bản
| Gói | Trong Scissor LaTeX | Thay thế |
|---|---|---|
| tabularray | tblr không được đọc: các tùy chọn và dấu & được in ra thành văn bản. | tabular, xem array và tabularx. |
| nicematrix | pNiceMatrix và các ma trận khác làm công thức chuyển sang màu đỏ. | pmatrix từ amsmath. |
| makecell | \makecell được báo là không xác định, nhưng \\ bên trong nó vẫn ngắt dòng trong ô. | Dùng được như vậy; \thead không được định kiểu. |
| tasks | \task không được nhận biết; số cột được in ra. | enumerate. |
| glossaries, acronym | \gls, \ac và \printglossaries không được nhận biết; khóa được in ra. | Viết đầy đủ thuật ngữ. |
| xspace | Được chấp nhận, nhưng một lệnh kết thúc bằng \xspace nuốt mất khoảng trắng sau nó. | Viết \name{} hoặc \name\ trước khoảng trắng. |
| ifthen | \ifthenelse không được nhận biết; điều kiện và cả hai nhánh đều được in ra. | |
| beamer (lớp) | Không có trang chiếu; các frame trở thành văn bản. | Xem Lớp tài liệu. |
Ví dụ
Một gói hoàn toàn không được biết đến tạo ra một ghi chú, và phần còn lại của tài liệu vẫn được dàn trang:
Một gói không xác định tạo ra ghi chú
Water is a bent molecule. The drawing below is skipped:
\chemfig{H-O-H}Thẻ Sự cố: Skipped 1 unknown command: \chemfig
Một gói hộp được chấp nhận, nhưng hộp của nó không được vẽ:
tcolorbox: văn bản không có hộp
\begin{tcolorbox}[title=Remember]
Erika Mustermann checks all 44 samples before noon.
\end{tcolorbox}Công thức hóa học từ mhchem mất chỉ số dưới. Viết chúng bằng toán thì hoạt động ở mọi nơi:
\ce của mhchem và cách viết bằng tay
With mhchem: \ce{H2SO4}. By hand: H$_2$SO$_4$, or in a formula
$\mathrm{2\,H_2 + O_2 \rightarrow 2\,H_2O}$.Thẻ Sự cố: Skipped 1 unknown command: \ce
Một lệnh được định nghĩa với \xspace cần {} trước khoảng trắng:
xspace: viết {} trước khoảng trắng
\newcommand{\tool}{Scissor LaTeX\xspace}
Without braces: \tool runs in the browser.
With braces: \tool{} runs in the browser.Khi thiếu một gói bạn cần
- Hãy xem thẻ Sự cố: nó liệt kê các gói không xác định và mọi lệnh bị bỏ qua.
- Hãy tìm gói đó trong các trang này; cột Thay thế ở trên và các trang về gói cho biết nên viết gì.
- Hãy giữ dòng
\usepackagenếu bạn cũng sẽ biên dịch tài liệu ở nơi khác. Scissor LaTeX chấp nhận nó, và khi đó một bản cài đặt TeX sẽ áp dụng gói.
Xem thêm Khác biệt so với một bản cài đặt TeX và Khắc phục sự cố. Tài liệu hướng dẫn của các gói có trên CTAN.
Hỏi và đáp
Tài liệu của tôi có được dàn trang không nếu nó nạp một gói mà Scissor LaTeX không biết?
Có. Gói đó được báo trong thẻ Sự cố và định dạng của nó bị thiếu, nhưng phần còn lại của tài liệu vẫn được dàn trang.
Tôi có thể thêm một tệp .sty để một gói hoạt động không?
Một phần. Scissor LaTeX đọc các định nghĩa lệnh, các gói được nạp, màu, lề và khoảng cách đoạn văn từ một tệp .sty trong dự án. Mã khác trong đó không được chạy.
Vì sao tôi thấy văn bản thừa như "1.5" hay "colspec=lr" trong tài liệu?
Lệnh hoặc môi trường lẽ ra phải đọc các đối số đó không được hỗ trợ, nên các đối số rơi vào văn bản. Các bảng ở trên nêu tên những trường hợp này và cách viết thay thế.
Mọi ví dụ trên trang này đều được Scissor LaTeX dàn trang khi xây dựng trang web. Cập nhật lần cuối 2026-11-07.