نسخهٔ انگلیسی این صفحه تازه‌تر است.
بسته‌هایی که در Scissor LaTeX کار نمی‌کنند
سند باز هم حروفچینی میشود. بستهای که Scissor LaTeX هرگز نشناخته یادداشتی در زبانهٔ «مشکلات» می‌دهد؛ بستههای شناخته‌شده‌ای که پیاده‌سازی نشده‌اند، مانند fancyhdr، titlesec یا tcolorbox، بی‌صدا پذیرفته می‌شوند و اثری ندارند؛ و دستورهای ناشناخته با پیامی نادیده گرفته می‌شوند، در حالی که متنشان معمولاً نگه داشته میشود.
بسته‌ها چطور پردازش می‌شوند
Scissor LaTeX کد بسته‌ها را اجرا نمی‌کند. سند شما را با موتور خودش تبدیل می‌کند که دستورهای بستههای این صفحه‌ها را پیاده‌سازی کرده است. بنابراین هر سطر \usepackage در یکی از سه گروه می‌افتد:
| گروه | نمونه‌ها | چه رخ می‌دهد |
|---|---|---|
| پیاده‌سازی‌شده، کامل یا بخشی | amsmath، graphicx، booktabs، pgfplots، hyperref | دستورها همان‌طور که در صفحهٔ هر بسته توصیف شده کار می‌کنند. |
| شناخته‌شده، اما بی‌اثر | fancyhdr، titlesec، setspace، microtype، tcolorbox | بی‌صدا پذیرفته می‌شوند. تنظیماتشان چیزی را تغییر نمی‌دهد و دستورهایشان یا نادیده گرفته می‌شوند یا ناشناخته به حساب می‌آیند. |
| ناشناخته | chemfig، یک .sty از یک ناشر، نامی با غلط املایی | یادداشتی در زبانهٔ «مشکلات»: «Package ... is not available here, so its formatting is not applied.» |
یک دستور ناشناخته، از هر بستهای، نادیده گرفته میشود و در زبانهٔ «مشکلات» فهرست میشود. آرگومان‌های درون آکولادش معمولاً در متن می‌مانند، پس واژه‌ها را می‌بینید اما قالب‌بندی را نه. برای چند دستور این آن چیزی نیست که می‌خواهید: آرگومانها فهرست گزینه‌ها یا نام‌اند و به شکل متن سرگردان ظاهر می‌شوند. جدولهای زیر این موردها را نام میبرند.
اگر یک بسته یا کلاس به شکل فایل .sty یا .cls در پروژهٔ شما باشد، Scissor LaTeX بخشی از آن را میخواند: تعریفهای \newcommand، بسته‌هایی که بارگذاری می‌کند، رنگها، حاشیه‌های صفحه و فاصلهگذاری بندها. کدهای دیگر فایل اجرا نمیشوند و زبانهٔ «مشکلات» همین را می‌گوید.
بستههای رایجی که هنوز کار نمی‌کنند
صفحه‌آرایی و سرعنوان‌ها
| بسته | در Scissor LaTeX | به جای آن |
|---|---|---|
| fancyhdr | پذیرفته میشود، بی‌اثر: سرصفحه و پاصفحهٔ جاری ندارد. | چیزی برای تغییر نیست؛ تنظیمات در یک نصب TeX اعمال می‌شوند. |
| titlesec | پذیرفته میشود، بی‌اثر: سرعنوان‌ها سبک کلاس را نگه می‌دارند. | |
| sectsty | بستهٔ ناشناخته، با یادداشت؛ \sectionfont و مانند آن نادیده گرفته می‌شوند. | |
| setspace | \onehalfspacing و \doublespacing نادیده گرفته می‌شوند. \begin{spacing}{1.5} پیش از متن «1.5» چاپ می‌کند. | محیط spacing را حذف کنید. |
| lineno | \linenumbers نادیده گرفته میشود. |
جعبه‌ها، یادداشت‌ها و برجسته‌سازی
| بسته | در Scissor LaTeX | به جای آن |
|---|---|---|
| tcolorbox، mdframed، framed | پذیرفته می‌شوند؛ متن بدون جعبه نگه داشته میشود و عنوان جعبه‌ها از دست می‌رود. | یک محیط quote، یا یک tabular با \hline و | برای قاب. |
| todonotes | \todo{...} ناشناخته است: متن یادداشت در سطر ظاهر میشود. \missingfigure هم. | توضیح با %. |
| marginnote | \marginpar و \marginnote ناشناخته‌اند: یادداشت در سطر ظاهر میشود. | یک پانوشت. |
| soul | \st کار می‌کند (خط‌خوردگی). \hl متن را بدون برجسته‌سازی نگه می‌دارد؛ \ul و \so ناشناخته‌اند. | \underline برای زیرخط. |
| ulem | \uline و \sout کار می‌کنند؛ \uwave متن ساده نشان می‌دهد. |
علوم و نمودارها
| بسته | در Scissor LaTeX | به جای آن |
|---|---|---|
| mhchem | \ce{H2O} در متن «H2O» را بدون زیرنویس نشان می‌دهد. در فرمول، فرمول را قرمز می‌کند. | H$_2$O یا $\mathrm{CO_2}$ بنویسید. |
| chemfig | بستهٔ ناشناخته؛ \chemfig نادیده گرفته میشود. | تصویری از ساختار. |
| tikz-cd، circuitikz، forest | تصویر با پیامی کنار گذاشته میشود. | گره‌ها و پیکان‌های TikZ، یا یک تصویر. |
| pgfplotstable | \pgfplotstabletypeset نادیده گرفته میشود؛ نام فایل چاپ میشود. | یک tabular. رسم نمودار از جدول‌ها کار می‌کند، pgfplots را ببینید. |
| siunitx | siunitx را ببینید. | 44\,\mathrm{km} |
جدول‌ها، فهرست‌ها و ابزارهای متن
| بسته | در Scissor LaTeX | به جای آن |
|---|---|---|
| tabularray | tblr خوانده نمیشود: گزینه‌ها و علامت‌های & به شکل متن چاپ می‌شوند. | tabular؛ array و tabularx را ببینید. |
| nicematrix | pNiceMatrix و ماتریس‌های دیگر فرمول را قرمز می‌کنند. | pmatrix از amsmath. |
| makecell | \makecell به عنوان ناشناخته گزارش میشود، اما \\ درون آن همچنان سطر را درون خانه می‌شکند. | همان‌طور که هست کار می‌کند؛ \thead سبک نمی‌گیرد. |
| tasks | \task ناشناخته است؛ تعداد ستون‌ها چاپ میشود. | enumerate. |
| glossaries، acronym | \gls، \ac و \printglossaries ناشناخته‌اند؛ کلید چاپ میشود. | اصطلاح را کامل بنویسید. |
| xspace | پذیرفته میشود، اما دستوری که به \xspace ختم شود فاصلهٔ پس از خودش را می‌بلعد. | پیش از فاصله \name{} یا \name\ بنویسید. |
| ifthen | \ifthenelse ناشناخته است؛ شرط و هر دو شاخه چاپ می‌شوند. | |
| beamer (کلاس) | اسلایدی در کار نیست؛ قاب‌ها به متن تبدیل می‌شوند. | کلاس‌های سند را ببینید. |
نمونه‌ها
بستهای که اصلاً شناخته نشده یادداشتی می‌دهد و بقیهٔ سند حروفچینی میشود:
بستهٔ ناشناخته یادداشتی می‌دهد
Water is a bent molecule. The drawing below is skipped:
\chemfig{H-O-H}زبانهٔ مشکلات: Skipped 1 unknown command: \chemfig
یک بستهٔ جعبه پذیرفته میشود، اما جعبه‌اش رسم نمیشود:
tcolorbox: متن بدون جعبه
\begin{tcolorbox}[title=Remember]
Erika Mustermann checks all 44 samples before noon.
\end{tcolorbox}فرمول‌های شیمیایی mhchem زیرنویس‌هایشان را از دست می‌دهند. نوشتن آن‌ها با ریاضی همه‌جا کار می‌کند:
\ce از mhchem و نسخهٔ دستی
With mhchem: \ce{H2SO4}. By hand: H$_2$SO$_4$, or in a formula
$\mathrm{2\,H_2 + O_2 \rightarrow 2\,H_2O}$.زبانهٔ مشکلات: Skipped 1 unknown command: \ce
دستوری که با \xspace تعریف شده پیش از فاصله به {} نیاز دارد:
xspace: پیش از فاصله {} بنویسید
\newcommand{\tool}{Scissor LaTeX\xspace}
Without braces: \tool runs in the browser.
With braces: \tool{} runs in the browser.وقتی بستهای که لازم دارید نیست
- زبانهٔ «مشکلات» را بررسی کنید: بستههای ناشناخته و همهٔ دستورهای نادیده‌گرفته را فهرست می‌کند.
- بسته را در این صفحه‌ها جست‌وجو کنید؛ ستون «به جای آن» در بالا و صفحه‌های بسته‌ها نشان می‌دهند چه بنویسید.
- اگر سند را جای دیگری هم کامپایل خواهید کرد، سطر
\usepackageرا نگه دارید. Scissor LaTeX آن را می‌پذیرد و آن‌گاه یک نصب TeX بسته را اعمال می‌کند.
همچنین تفاوت‌ها با یک نصب TeX و رفع اشکال را ببینید. راهنمای بسته‌ها در CTAN است.
پرسش و پاسخ
اگر سندم بستهای را بارگذاری کند که Scissor LaTeX نمیشناسد، باز هم حروفچینی میشود؟
بله. بسته در زبانهٔ «مشکلات» گزارش میشود و قالببندیاش نیست، اما بقیهٔ سند حروفچینی میشود.
آیا میتوانم با افزودن یک فایل .sty بستهای را به کار بیندازم؟
تا حدی. Scissor LaTeX تعریفهای دستورها، بستههای بارگذاریشده، رنگها، حاشیهها و فاصلهگذاری بندها را از یک فایل .sty در پروژه میخواند. کدهای دیگر آن اجرا نمیشوند.
چرا متن سرگردانی مانند «1.5» یا «colspec=lr» در سندم میبینم؟
دستور یا محیطی که باید آن آرگومانها را بخواند پشتیبانی نمیشود، پس آرگومانها در متن قرار میگیرند. جدولهای بالا این موردها و آنچه به جایشان باید نوشت را نام میبرند.
هر مثال این صفحه هنگام ساخت سایت با Scissor LaTeX حروفچینی میشود. آخرین به‌روزرسانی: 2026-11-07.