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

minted لە Scissor LaTeX

پاکێجی minted لە Scissor LaTeX بەشێکی کار دەکات، \begin{minted}{python} و \mintinline بەبێ Python یان -shell-escape کار دەکەن، بە ڕەنگی ڕستەسازی لە شێوازێکی جێگیرەوە؛ هەڵبژاردەکانی وەک linenos، \setminted، \usemintedstyle، ناونیشانی listing، \mint و \inputminted پشتگیری ناکرێن.

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

minted کۆدی سەرچاوە بە کتێبخانەی Pygments ڕەنگ دەکات. \begin{minted}{python} ... \end{minted} دەنووسیت، یان لەناو ڕستەیەکدا \mintinline{python}{code}. هەڵبژاردەکانی وەک linenos و frame=lines ڕێکخستنەکە دەگۆڕن، \setminted بۆ هەموو بەڵگەنامەکە دیارییان دەکات، و \usemintedstyle شێوازێکی ڕەنگ هەڵدەبژێرێت. لە دامەزراندنێکی TeX دا، minted پێویستی بە Python لەگەڵ Pygments هەیە، و بەڵگەنامەکە دەبێت بە -shell-escape کۆمپایل بکرێت.

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

تایبەتمەندیلە Scissor LaTeXتێبینی
\begin{minted}{lang} ... \end{minted}کار دەکاتڕەنگکراو، بەبێ Python یان shell escape.
\mintinline{lang}{code}کار دەکاتیەکپانی، بێ ڕەنگ.
هەڵبژاردەکان: [linenos, frame=lines, bgcolor=...]لادەبرێنبەبێ پەیام پشتگوێ دەخرێن.
\setminted{...}، \usemintedstyle{...}لادەبرێنبەبێ پەیام پشتگوێ دەخرێن؛ ڕەنگەکان جێگیرن.
ژینگەی listing لەگەڵ \captionبەشێکیکۆدەکە پیشان دەدرێت و ناونیشانەکە وەک دەقی سادە چاپ دەکرێت، بەبێ "Listing 1"؛ \refـێک بۆی "??" پیشان دەدات.
\mint{lang}|code|پشتگیری ناکرێتبە پەیامێک تێدەپەڕێندرێت؛ زمان و کۆدەکە وەک دەقی سادە چاپ دەکرێن.
\inputminted{lang}{file}پشتگیری ناکرێتبە پەیامێک تێدەپەڕێندرێت.
\newminted، \newmintinlineپشتگیری ناکرێتبە پەیامێک تێدەپەڕێندرێن، و ئارگیومێنتەکان چاپ دەکرێن.

ناوی زمانەکان هەمان ئەوانەی listingsـن: Python، C، C++، Java، JavaScript، Rust، Go، R، MATLAB، SQL، Bash، HTML، TeX و زۆری تر، بە پیتی گەورە یان بچووک.

نموونەکان

بلۆکێکی minted لەگەڵ زمانێک:

minted لەگەڵ JavaScript

LaTeXپێشەکی: \usepackage{minted}لە دەستکاریکەردا بیکەرەوە
\begin{minted}{javascript}
// greet a list of people
const people = ["Erika", "Hans", "John"];
for (const name of people) {
  console.log(`Hello, ${name}!`);
}
\end{minted}
Scissor LaTeX ڕیزی کردووە: minted لەگەڵ JavaScript

هەڵبژاردەکان وەردەگیرێن و پشتگوێ دەخرێن، بۆیە ئەم بلۆکە لێرە ژمارەی دێڕ یان چوارچێوەی نییە:

linenos و frame پشتگوێ دەخرێن

LaTeXپێشەکی: \usepackage{minted}لە دەستکاریکەردا بیکەرەوە
\begin{minted}[linenos, frame=lines]{rust}
fn main() {
    let total: u32 = (1..=8).sum();
    println!("{}", total + 8); // 44
}
\end{minted}
Scissor LaTeX ڕیزی کردووە: linenos و frame پشتگوێ دەخرێن

بۆ ناونیشانێکی ژمارەدار، لە جیاتی ژینگەی listingـی minted، figure بەکاربهێنە. لێرەدا ناونیشانەکە "Listing 1" دەخوێندرێتەوە، و \ref ژمارەکە دەدات:

بلۆکێکی minted بە ناونیشانەوە لەناو figure

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

گونجاوی

  • لە دامەزراندنێکی TeX ەوە بۆ ئێرە: هەموو بلۆکێکی minted بە ڕەنگەوە پیشان دەدرێت. هەڵبژاردە و شێوازەکان جێبەجێ ناکرێن؛ \mint بە \mintinline بگۆڕە و کۆدی فایلەکانی \inputminted بلکێنە ناو بەڵگەنامەکە.
  • لێرەوە بۆ دامەزراندنێکی TeX: بلۆکەکانی minted لەوێ کۆمپایل دەبن کاتێک Python، Pygments و -shell-escape بەردەستن. figureـێک لە دەوری بلۆکێکی minted لەوێ ناونیشانی "Figure 1" وەردەگرێت.

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

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

ئایا minted بەبێ shell escape کار دەکات؟

لێرە، بەڵێ. Scissor LaTeX خۆی بلۆکەکانی minted ڕەنگ دەکات، بۆیە نە Python پێویستە نە -shell-escape. لە دامەزراندنێکی TeX دا هەردووکیان هێشتا پێویستن.

minted بەکاربهێنم یان listings؟

لێرە هەردووکیان وەک یەک کار دەکەن: زمانەکە دەخوێندرێتەوە و هەڵبژاردەکانی تر پشتگوێ دەخرێن. ئەگەر بەڵگەنامەکە دەبێت لە شوێنی تریش بەبێ shell escape کۆمپایل بێت، listings هەڵبژاردەی سەلامەتترە.

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