المشاريع والملفات

المشروع مجموعة من الملفات محفوظة على جهازك، أحدها الملف الرئيسي الذي يُنضَّد. يمكنك استيراد مشروع كامل دفعة واحدة بفتح ملف .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 أو مجلد من Google 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 ميغابايت. وعندما يكون المجلد أكبر من ذلك، تُحفظ الملفات المصدرية أولًا، ويُستبعد الباقي ويُحصى.

ملفات يحتاجها المستند ولا يحتويها المشروع

بعد أن تفتح ملفات أو تضيفها، يتحقق المحرر مما يشير إليه مستندك: الصور في \includegraphics، وملفات .bib، والملفات في \input و\include، وملفات بيانات الرسوم البيانية. وإذا كان شيء ما مفقودًا، تسرده لوحة «الملفات» مع أزرار لرفعه أو إضافته من Drive. والملف الذي تضيفه باسمه المجرد يوضع حيث يتوقعه المستند، فيستقر plot.png في figures/ إذا كان المستند يطلب figures/plot.png.

وإلى أن يحدث ذلك، تُرسم الصورة المفقودة مربعًا متقطع الحدود يحمل اسمها، ويذكر تبويب «المشكلات» الصور المفقودة.

صورة موجودة في المشروع وأخرى مفقودة

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.