پرۆژە و فایلەکان

پرۆژە کۆمەڵێک فایلە کە لەسەر ئامێرەکەت هەڵدەگیرێن، و یەکێکیان فایلی سەرەکییە کە ڕیز دەکرێت. دەتوانیت بە کردنەوەی .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.