بڕۆ بۆ ناوەڕۆک
Scissor LaTeX

listings لە Scissor LaTeX

پاکێجی listings لە Scissor LaTeX بەشێکی کار دەکات، lstlisting کۆدەکە ڕێک وەک نووسراوە دەپارێزێت و کاتێک language= لەسەر ژینگەکە دەدەیت ڕەنگی دەکات، و \lstinline کار دەکات؛ \lstset، ژمارەی دێڕ، چوارچێوە، ناونیشان و labelـەکان پشتگوێ دەخرێن، و \lstinputlisting تێدەپەڕێندرێت.

پاکێجەکە چی دەکات

listings کۆدی سەرچاوە ڕیز دەکات. ژینگەی lstlisting دێڕشکان و بۆشاییەکان دەپارێزێت، و لەگەڵ language=Python (یان C، Java، SQL ...) وشە کلیلییەکان، لێدوانەکان و ڕستەکان بە شێوازی جیاواز دادەنێت. هەڵبژاردەکان ژمارەی دێڕ، چوارچێوە، ناونیشان و ڕەنگ زیاد دەکەن، یان بۆ هەر لیستێک یان بۆ هەموو بەڵگەنامەکە بە \lstset. \lstinline شێوەی ناو دێڕەکەیە، و \lstinputlisting کۆد لە فایلێکەوە دەخوێنێتەوە.

چی لێرە کار دەکات

تایبەتمەندیلە Scissor LaTeXتێبینی
\begin{lstlisting} ... \end{lstlisting}کار دەکاتیەکپانی، ڕێک وەک نووسراوە.
[language=Python] لەسەر ژینگەکەکار دەکاتڕەنگی ڕستەسازی لە شێوازێکی جێگیرەوە.
[language={[Sharp]C}] و شێوەزارەکانی ترکار دەکاتشێوەزارەکەی ناو کەوانەکە لەگەڵ ناوەکەدا دەخوێندرێتەوە.
\lstinline|code|، \lstinline{code}کار دەکاتیەکپانی، بێ ڕەنگ.
numbers=left، frame=single، basicstyle، keywordstyle، backgroundcolorلادەبرێنبەبێ پەیام پشتگوێ دەخرێن.
caption=، label=لادەبرێنهیچ ناونیشانێک چاپ ناکرێت، و \refـێک بۆ labelـەکە "??" پیشان دەدات.
\lstset{...}، \lstdefinestyle، style=لادەبرێنپشتگوێ دەخرێن، لەوانە language=ـێک کە لەوێ دیاری کرابێت.
\lstinputlisting{file}پشتگیری ناکرێتبە پەیامێک تێدەپەڕێندرێت.
\lstlistoflistings، \lstnewenvironmentپشتگیری ناکرێتبە پەیامێک تێدەپەڕێندرێن.

ناوی زمانەکان هەستیار نین بە پیتی گەورە و بچووک. ڕەنگ بۆ زمانە باوەکانی وەک Python، C، C++، C#، Java، JavaScript، Rust، Go، R، MATLAB، SQL، Bash، HTML و TeX بەردەستە. ناوێک کە نەناسرێتەوە، وەک Fortran، بەبێ پەیام کۆدی یەکپانیی سادە دەدات.

نموونەکان

زمانەکە لەسەر هەر لیستێک بدە:

lstlisting لەگەڵ language=Python

LaTeXپێشەکی: \usepackage{listings}لە دەستکاریکەردا بیکەرەوە
\begin{lstlisting}[language=Python]
def mean(values):
    # average of a list of numbers
    return sum(values) / len(values)

print(mean([40, 44, 48]))
\end{lstlisting}
Scissor LaTeX ڕیزی کردووە: lstlisting لەگەڵ language=Python

زمانێک کە بە \lstset دیاری کرابێت بەکارناهێنرێت، بۆیە ئەم لیستە ڕەنگی نییە. هەڵبژاردەکانی ڕێکخستنی وەک numbers و frame ـیش پشتگوێ دەخرێن:

\lstset پشتگوێ دەخرێت

LaTeXلە دەستکاریکەردا بیکەرەوە
\documentclass{article}
\usepackage{listings}
\lstset{language=SQL, numbers=left, frame=single}
\begin{document}
\begin{lstlisting}
SELECT name FROM staff WHERE id = 44;
\end{lstlisting}
\begin{lstlisting}[language=SQL]
SELECT name FROM staff WHERE id = 44;
\end{lstlisting}
\end{document}

کۆدی ناو دێڕ بە \lstinline هەر سنووردانەرێک وەردەگرێت، وەک \verb:

\lstinline لە ڕستەیەکدا

LaTeXپێشەکی: \usepackage{listings}لە دەستکاریکەردا بیکەرەوە
The loop \lstinline|for i in range(44):| runs 44 times, and
\lstinline{total += i} adds up the numbers.
Scissor LaTeX ڕیزی کردووە: \lstinline لە ڕستەیەکدا

لیستێکی ناونیشاندار لەناو figure

LaTeXپێشەکی: \usepackage{listings}لە دەستکاریکەردا بیکەرەوە
\begin{figure}[h]
\begin{lstlisting}[language=Python]
print(sum(range(44)))
\end{lstlisting}
\caption{Adding the numbers below 44}
\label{lst:sum}
\end{figure}
The code in Listing~\ref{lst:sum} prints 946.
Scissor LaTeX ڕیزی کردووە: لیستێکی ناونیشاندار لەناو figure

گونجاوی

  • لە دامەزراندنێکی TeX ەوە بۆ ئێرە: کۆدی هەموو lstlistingـێک پیشان دەدرێت. بۆ وەرگرتنی ڕەنگ، language= لە \lstset ەوە بگوازەوە بۆ سەر هەر لیستێک، و کۆدی فایلەکانی \lstinputlisting بلکێنە ناو بەڵگەنامەکە.
  • لێرەوە بۆ دامەزراندنێکی TeX: بەڵگەنامەکان لەوێ بێ گۆڕانکاری کۆمپایل دەبن، و ئەو کات هەڵبژاردەکانت جێبەجێ دەبن.

ڕێنماییە تەواوەکە لە CTAN دایە: ctan.org/pkg/listings. هەروەها سەیری پیشاندانی کۆد لە LaTeX و minted بکە.

پرسیار و وەڵام

بۆچی لیستەکانم ڕەنگیان نییە؟

لەوانەیە زمانەکە بە \lstset دیاری کرابێت، کە لێرە پشتگوێ دەخرێت. دوای \begin{lstlisting}، [language=Python] (یان زمانەکەی خۆت) بنووسە.

دەتوانم ژمارەی دێڕەکان پیشان بدەم؟

هێشتا نا. numbers=left وەردەگیرێت و پشتگوێ دەخرێت.

هەموو نموونەیەکی ئەم پەڕەیە لە کاتی دروستکردنی ماڵپەڕەکەدا لەلایەن Scissor LaTeX ڕیز دەکرێت. دوایین نوێکردنەوە: 2026-11-07.