پروژه‌ها و فایل‌ها

پروژه مجموعه‌ای از فایل‌هاست که روی دستگاه شما نگه داشته می‌شود و یکی از آن‌ها فایل اصلی است که حروف‌چینی می‌شود. می‌توانید با باز کردن یک فایل .zip یا یک پوشه، کل پروژه را یک‌جا وارد کنید؛ مثلاً پروژه‌ای که از یک ویرایشگر LaTeX دیگر دانلود کرده‌اید.

پروژه چیست

پروژه همهٔ فایل‌هایی را که سند شما لازم دارد در خود نگه می‌دارد: کدهای منبع .tex، یک فایل .bib با مرجع‌هایتان، تصویرها و فایل‌های داده برای نمودارها. فایل‌ها می‌توانند در پوشه‌ها باشند، مثلاً chapters/intro.tex یا figures/plot.png.

پروژه‌ها لحظه‌ای پس از هر تغییر در فضای ذخیره‌سازی مرورگر روی همین دستگاه ذخیره می‌شوند. پنل پروژه‌ها آن‌ها را از جدیدترین فهرست می‌کند و امکان تغییر نام، جابه‌جایی بین آن‌ها یا حذفشان را می‌دهد. حذف یک پروژه در اینجا هرگز نسخه‌ای را که در Google Drive ذخیره کرده‌اید حذف نمی‌کند.

فایل اصلی

یکی از فایل‌های .tex فایل اصلی است: همان که \documentclass و \begin{document} را دارد. این فایل حروف‌چینی می‌شود و فایل‌های دیگر را با \input و \include به درون خود می‌آورد. پنل «فایل‌ها» آن را با اصلی نشان‌گذاری می‌کند.

برای حروف‌چینی فایلی دیگر، منوی آن را در پنل «فایل‌ها» باز کنید و حروف‌چینی این فایل را برگزینید، یا آن را زیر فایل اصلی انتخاب کنید.

یک فایل اصلی با کتاب‌نامه

LaTeXکپیباز کردن در ویرایشگر (در زبانه‌ای تازه باز می‌شود)

\documentclass{article}
\begin{document}
\section{Background}
Long tables are discussed by \cite{mustermann2021}.
\bibliographystyle{plain}
\bibliography{refs}
\end{document}

نمونهٔ بالا به فایل دومی به نام refs.bib در همان پروژه نیاز دارد. آن را در ویرایشگر باز کنید تا هر دو فایل را ببینید. دربارهٔ مرجع‌ها در کتاب‌نامه و ارجاع‌ها بیشتر بخوانید.

چند فایل .tex

یک سند بلند را به یک فایل برای هر فصل تقسیم کنید و آن‌ها را به فایل اصلی بیاورید. \input{chapters/intro} فایل را درست در جای دستور قرار می‌دهد؛ \include{chapters/intro} همین کار را می‌کند اما پیش از آن صفحهٔ تازه‌ای شروع می‌کند. پسوند .tex را می‌توان ننوشت.

\documentclass{report}
\begin{document}
\include{chapters/intro}
\include{chapters/method}
\input{appendix}
\end{document}

خطاهای یک فایل واردشده در زبانهٔ «مشکلات» به فایل و خط درست اشاره می‌کنند. برای جزئیات، از جمله آنچه با \includeonly و بستهٔ subfiles رخ می‌دهد، پروژه‌های چندفایلی را ببینید.

افزودن فایل

برای افزودن فایل به پروژهٔ باز چند راه هست:

• فایل‌ها را هر جای ویرایشگر رها کنید.
• در پنل «فایل‌ها»، از بارگذاری برای فایل‌ها یا از پوشه برای یک پوشهٔ کامل از همین دستگاه استفاده کنید.
• با فایل جدید یک فایل خالی بسازید. برای گذاشتن آن در یک پوشه، مسیری مانند chapters/intro.tex تایپ کنید.
• با Drive یا پوشهٔ Drive فایل‌هایی را از Google Drive خود اضافه کنید. ذخیره در Google Drive را ببینید.

اگر پروژه از قبل فایلی با همان نام داشته باشد، ویرایشگر می‌پرسد که آن را جایگزین کند یا فایل شما را نگه دارد.

ویرایشگر فایل‌های .tex، .bib، .sty، .cls، .bst، .txt، .md، .csv و فایل‌های متنی مشابه، تصویرها (PNG، JPG، SVG، PDF و چند قالب دیگر) و فایل‌های .zip را می‌پذیرد که از حالت فشرده خارج می‌شوند.

وارد کردن پروژه از .zip یا پوشه

بیشتر ویرایشگرهای LaTeX و همهٔ نصب‌های TeX پروژه را به شکل یک پوشه نگه می‌دارند. برای آوردن یکی از آن‌ها به Scissor LaTeX:

1. پروژه را از ویرایشگر دیگر به شکل .zip دانلود کنید، یا پوشهٔ آن را روی رایانهٔ خود پیدا کنید.
2. در Scissor LaTeX، پروژهٔ جدید و سپس باز کردن فایل‌های .tex یا .zip یا باز کردن پوشه را انتخاب کنید.
3. ویرایشگر آن را باز می‌کند، ساختار پوشه‌هایش را حفظ می‌کند و فایل اصلی را برمی‌گزیند.

وقتی بیش از یک سند کامل وجود دارد، ویرایشگر اول main.tex، سپس فایلی هم‌نام با پوشه و سپس فایلی با کوتاه‌ترین مسیر را ترجیح می‌دهد. یک یادداشت به شما می‌گوید کدام فایل را انتخاب کرده و می‌توانید آن را زیر فایل اصلی تغییر دهید.

یک پوشه می‌تواند تا 2,000 فایل و 100 MB داشته باشد. وقتی پوشه بزرگ‌تر باشد، اول کدهای منبع نگه داشته می‌شوند و بقیه کنار گذاشته و شمرده می‌شوند.

فایل‌هایی که سند لازم دارد اما پروژه ندارد

پس از باز کردن یا افزودن فایل‌ها، ویرایشگر بررسی می‌کند سند شما به چه چیزهایی اشاره دارد: تصویرهای \includegraphics، فایل‌های .bib، فایل‌های \input و \include، و فایل‌های دادهٔ نمودارها. اگر چیزی گم شده باشد، پنل «فایل‌ها» آن را با دکمه‌هایی برای بارگذاری یا افزودن از Drive فهرست می‌کند. فایلی که فقط با نامش اضافه کنید به جایی می‌رود که سند انتظارش را دارد؛ پس اگر سند figures/plot.png را بخواهد، plot.png در figures/ قرار می‌گیرد.

تا آن موقع، تصویر گم‌شده به شکل یک کادر خط‌چین با نامش کشیده می‌شود و زبانهٔ «مشکلات» می‌گوید کدام تصویرها گم شده‌اند.

یک تصویر در پروژه، یکی گم‌شده

LaTeXمقدمهٔ سند: \usepackage{graphicx}کپیباز کردن در ویرایشگر (در زبانه‌ای تازه باز می‌شود)

\includegraphics[width=0.45\linewidth]{figures-plot.png}

\includegraphics[width=0.45\linewidth]{figures/missing.png}

زبانهٔ مشکلات: Images not in the project: figures/missing.png

فایل‌های .sty و .cls خودتان

پروژه می‌تواند فایل‌های .sty و .cls خودش را داشته باشد: این فایل‌ها نگه داشته می‌شوند، در Drive ذخیره می‌شوند و همراه پروژه خروجی گرفته می‌شوند. اما پیش‌نمایش هنوز آن‌ها را نمی‌خواند. یک \usepackage{mymacros} که به فایل خودتان اشاره دارد در زبانهٔ «مشکلات» به عنوان بسته‌ای که در دسترس نیست گزارش می‌شود و دستورهای تعریف‌شده در آن نادیده گرفته می‌شوند.

تا وقتی این وضع تغییر کند، خط‌های \newcommand و \newenvironment لازم را از فایل .sty خود به مقدمهٔ سند در فایل اصلی کپی کنید. آنجا کار می‌کنند و سند همچنان در یک نصب TeX کامپایل می‌شود.

\documentclass{article}
% from mymacros.sty
\newcommand{\project}{River Survey}
\newcommand{\unit}[1]{\,\mathrm{#1}}
\begin{document}
The \project{} measured a flow of $44\unit{m^3/s}$.
\end{document}

تفاوت‌ها با یک نصب TeX

هر مثال این صفحه هنگام ساخت سایت با Scissor LaTeX حروف‌چینی می‌شود. آخرین به‌روزرسانی: 2026-11-07.