> For the complete documentation index, see [llms.txt](https://overleaf-pro.ayaka.space/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://overleaf-pro.ayaka.space/texlive/fi/pakettiin-liittyvat/minted.md).
# {Minted}
Tämä artikkeli näyttää, miten käytetään [`minted` pakettia](https://ctan.org/pkg/minted?lang=en) ohjelmointikielen lähdekoodin muotoiluun ja korostamiseen LaTeX-asiakirjassa, alkaen esimerkistä:
```latex
\documentclass{article}
\usepackage{minted}
\begin{document}
\begin{minted}{python}
import numpy as np
def incmatrix(genl1,genl2):
m = len(genl1)
n = len(genl2)
M = None #tulee ilmaantumismatriisiksi
VT = np.zeros((n*m,1), int) #väliaikainen muuttuja
#laske bittikohtainen xor-matriisi
M1 = bitxormatrix(genl1)
M2 = np.triu(bitxormatrix(genl2),1)
for i in range(m-1):
for j in range(i+1, m):
[r,c] = np.where(M2 == M1[i,j])
for k in range(len(r)):
VT[(i)*n + r[k]] = 1;
VT[(i)*n + c[k]] = 1;
VT[(j)*n + r[k]] = 1;
VT[(j)*n + c[k]] = 1;
if M is None:
M = np.copy(VT)
else:
M = np.concatenate((M, VT), 1)
VT = np.zeros((n*m,1), int)
return M
\end{minted}
\end{document}
```
Tämä esimerkki tuottaa seuraavan tulosteen:
Tässä on kaksi tärkeää komentoa. Esipuheessa paketti tuodaan kirjoittamalla
```latex
\usepackage{minted}
```
sitten tunnisteet `\begin{minted}{python}` ja `\end{minted}` rajaavat ympäristön, joka tulostaa tekstin sellaisenaan tasavälistä fonttia käyttäen ja lisää myös väriä kommentteihin, avainsanoihin ja funktioihin. Parametri `python` on ohjelmointikieli, jolla lähdekoodi on kirjoitettu. `minted` tukee yli 150 ohjelmointi- ja merkkauskieltä sekä asetustiedostoja, katso [viiteopasta](https://www.overleaf.com/learn/latex/Code_Highlighting_with_minted#Reference_guide) tuettujen kielten luetteloa varten.
**Huom**: Jotta `minted` toimisi sinun *paikallisen* LaTeX-jakelusi kanssa, on asennettava lisäohjelma nimeltä [Pygments](https://pygments.org/) . [Overleaf](https://www.overleaf.com/) voi säästää sinut asennuksen vaivalta ja erikoiskomentojen suorittamiselta asiakirjan kääntämiseksi — Overleafissa asiakirjat, jotka käyttävät `minted` toimivat "suoraan paketista".
### Peruskäyttö
Seuraavassa esimerkissä osoitetaan, että `minted` ympäristö voidaan määrittää muokkaamaan ladotun koodin ulkoasua. Tässä `minted` ympäristö käyttää useita pilkuilla erotettuja parametreja muodossa `avain=arvo`:
```latex
\documentclass{article}
\usepackage{minted}
\usepackage{xcolor} % päästäkseen käsiksi nimettyyn väriin LightGray
\definecolor{LightGray}{gray}{0.9}
\begin{document}
\begin{minted}
[
frame=lines,
framesep=2mm,
baselinestretch=1.2,
bgcolor=LightGray,
fontsize=\footnotesize,
linenos
]
{python}
import numpy as np
def incmatrix(genl1,genl2):
m = len(genl1)
n = len(genl2)
M = None #tulee ilmaantumismatriisiksi
VT = np.zeros((n*m,1), int) #väliaikainen muuttuja
#laske bittikohtainen xor-matriisi
M1 = bitxormatrix(genl1)
M2 = np.triu(bitxormatrix(genl2),1)
for i in range(m-1):
for j in range(i+1, m):
[r,c] = np.where(M2 == M1[i,j])
for k in range(len(r)):
VT[(i)*n + r[k]] = 1;
VT[(i)*n + c[k]] = 1;
VT[(j)*n + r[k]] = 1;
VT[(j)*n + c[k]] = 1;
if M is None:
M = np.copy(VT)
else:
M = np.concatenate((M, VT), 1)
VT = np.zeros((n*m,1), int)
return M
\end{minted}
\end{document}
```
Tämä esimerkki tuottaa seuraavan tulosteen:
Tässä esimerkissä käytetyt parametrit ovat:
* `frame=lines`: piirtää kaksi viivaa, yhden ylös ja yhden alas koodin ympärille kehykseksi. Muita mahdollisia arvoja ovat `leftline`, `topline`, `bottomline` ja `single`.
* `framesep=2mm`: kehyksen väliksi asetetaan 2 mm. Myös muita [pituusyksiköitä](https://www.overleaf.com/learn/latex/Lengths_in_LaTeX) voidaan käyttää.
* `baselinestretch=1.2`: koodin riviväliksi asetetaan 1,2.
* `bgcolor=LightGray`: taustaväriksi asetetaan `LightGray`. Sinun on tuotava `xcolor` paketti, jotta tämä toimii. Katso [Värien käyttäminen LaTeXissa](https://www.overleaf.com/learn/latex/Using_colours_in_LaTeX) oppia lisää värien käsittelystä.
* `fontsize=\footnotesize`: fonttikooksi asetetaan `footnotesize`. Mikä tahansa muu [fonttikoko](https://www.overleaf.com/learn/latex/Font_sizes_and_kinds%23Reference_guide) voidaan asettaa.
* `linenos`: ottaa rivinumerot käyttöön.
Muita hyödyllisiä vaihtoehtoja ovat:
* `mathescape`: ottaa matemaattisen tilan käyttöön koodikommenteissa.
* `rulecolor`: muuttaa kehyksen väriä.
* `showspaces`: ottaa käyttöön erikoismerkin, joka tekee välilyönnit näkyviksi.
### Koodin sisällyttäminen tiedostosta
Koodi on yleensä tallennettu lähdetiedostoon, joten komento, joka tuo koodin automaattisesti tiedostosta, on erittäin kätevä, kuten seuraavassa esimerkissä osoitetaan:
```latex
\documentclass{article}
\usepackage{minted}
\title{Importing files using minted}
\begin{document}
Seuraava koodi tuodaan suoraan tiedostosta:
\inputminted{octave}{BitXorMatrix.m}
\end{document}
```
Tämä esimerkki tuottaa seuraavan tulosteen:
Komento `\inputminted{octave}{BitXorMatrix.m}` tuo koodin tiedostosta `BitXorMatrix.m`, parametri `octave` kertoo LaTeXille koodin ohjelmointikielen. Tämä komento voi ottaa kaksi lisäparametria, jotta tiedostosta tuodaan vain osa; esimerkiksi koodin tuomiseksi riviltä 2 riville 12 komento on:
```latex
\inputminted[firstline=2, lastline=12]{octave}{BitXorMatrix.m}
```
### Yhden rivin koodi
Jos sinun täytyy syöttää vain yksi koodirivi, komento `\mint`, jonka syntaksi esitetään seuraavassa esimerkissä, hoitaa asian.
{% code overflow="wrap" %}
```latex
Yhden rivin koodin muotoilu toimii myös \texttt{minted}-paketilla. Esimerkiksi pieni HTML-fragmentti, kuten tämä:
\mint{html}|Something here
|
\noindent voidaan muotoilla oikein.
```
{% endcode %}
Tämä esimerkki tuottaa seuraavan tulosteen:
Suluissa oleva parametri asettaa ohjelmointikielen (`html` tässä tapauksessa merkkauskielen) ja varsinainen muotoiltava teksti on rajattu '|' -merkillä.
### Ongelmia itse isännöidyn Overleafin kanssa
Jos käytät sandbox-kääntämistä ja lisäksi Overleaf-palvelinta Overleafin käyttöönottoon, minted ei ehkä toimi hyvin. Lisätietoja varten voit katsoa: [issues/131](https://github.com/yu-i-i/overleaf-cep/issues/131). Jotta minted toimisi, sinun on otettava käyttöön ARM-käskykannan profiili ja joitakin järjestelmäkutsuja.
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://overleaf-pro.ayaka.space/texlive/fi/pakettiin-liittyvat/minted.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.