commit e1a785043a28251d8173e4542c77d767476afbac
Author: Juergen Spitzmueller <[email protected]>
Date: Tue Jul 21 19:14:12 2026 +0200
Update minted documentation
As of TeXLive 2024, pygments comes bundled in a trusted version which
no longer requires --shell-escape.
MikTeX still requires the risky settings.
---
lib/doc/EmbeddedObjects.lyx | 110 +++++++++++++++++++++++++++++++++++++++--
lib/doc/de/EmbeddedObjects.lyx | 90 +++++++++++++++------------------
2 files changed, 145 insertions(+), 55 deletions(-)
diff --git a/lib/doc/EmbeddedObjects.lyx b/lib/doc/EmbeddedObjects.lyx
index d984b03c80..fe0d8c8b9b 100644
--- a/lib/doc/EmbeddedObjects.lyx
+++ b/lib/doc/EmbeddedObjects.lyx
@@ -252,6 +252,7 @@ varwidth
\docbook_table_output 0
\docbook_mathml_prefix 1
\docbook_mathml_version 0
+\author -712698321 "Jürgen Spitzmüller"
\end_header
\begin_body
@@ -42506,11 +42507,49 @@ minted
provide a powerful and flexible way to insert program source code into your
document.
One can only use one of these packages in a document.
+
+\change_inserted -712698321 1784652862
+ The package
+\change_unchanged
\series bold
listings
\series default
is used by default.
+
+\change_inserted -712698321 1784653642
+ In order to use the more powerful package
+\series bold
+minted
+\series default
+,
+ you need to select it as the syntax highlighting package in the document
settings under
+\family sans
+Listings
+\family default
+.
+ Note that
+\series bold
+minted
+\series default
+ additionally requires the
+\noun on
+Python
+\noun default
+ library
+\family sans
+pygments
+\family default
+ which is used for highlighting.
+ As of 2024,
+
+\family sans
+pygments
+\family default
+ is included in \SpecialChar TeX
+Live.
+\change_unchanged
+
\end_layout
\begin_layout Standard
@@ -42541,6 +42580,8 @@ Note:
\end_layout
\begin_layout Plain Layout
+
+\change_deleted -712698321 1784652827
In order to use
\series bold
minted
@@ -42578,13 +42619,56 @@ pygments
\end_inset
- and the option
+
+\change_inserted -712698321 1784653377
+Note that with \SpecialChar TeX
+Live older than 2024 and with Mik\SpecialChar TeX
+,
+
+\series bold
+minted
+\series default
+ only runs if you enable the insecure
+\change_deleted -712698321 1784653169
+and the option
+\change_unchanged
+
\family typewriter
-shell-escape
\family default
- for the \SpecialChar LaTeX
+
+\change_inserted -712698321 1784653178
+option
+\change_unchanged
+for the \SpecialChar LaTeX
processor.
- If you want for example view or export your document as the format
+
+\change_inserted -712698321 1784653225
+Since this makes your system vulnerable,
+ we do not recommend using it.
+
+\change_unchanged
+If you
+\change_inserted -712698321 1784653289
+still want,
+ and are sure about what you are doing,
+ you need to change the converter settings.
+
+\change_deleted -712698321 1784653293
+want f
+\change_inserted -712698321 1784653293
+F
+\change_unchanged
+or example
+\change_inserted -712698321 1784653304
+,
+ for
+\change_unchanged
+
+\change_deleted -712698321 1784653307
+view or export your document as
+\change_unchanged
+the format
\family sans
PDF
\begin_inset space ~
@@ -42593,9 +42677,20 @@ PDF
(pdflatex)
\family default
,
- go to the \SpecialChar LyX
- preferences and there to the section
+ go to
+\change_deleted -712698321 1784653322
+the \SpecialChar LyX
+ preferences and there to the section
+\change_inserted -712698321 1784653338
+
\family sans
+Tools\SpecialChar menuseparator
+Preferences\SpecialChar ldots
+\SpecialChar menuseparator
+
+\change_deleted -712698321 1784653339
+
+\change_unchanged
File
\begin_inset space ~
\end_inset
@@ -42675,6 +42770,11 @@ PDF
(XeTeX)
\family default
.
+
+\change_inserted -712698321 1784653434
+ But note again that this is a security risk!
+\change_unchanged
+
\end_layout
\end_inset
diff --git a/lib/doc/de/EmbeddedObjects.lyx b/lib/doc/de/EmbeddedObjects.lyx
index 5d7eab55a9..1f9d78078c 100644
--- a/lib/doc/de/EmbeddedObjects.lyx
+++ b/lib/doc/de/EmbeddedObjects.lyx
@@ -43002,11 +43002,33 @@ minted
können Programm-Code auf vielfältige und flexible Weise in Ihr Dokument
einfügen.
Man kann nur eines der Pakete in einem Dokument verwenden.
-
+ Das Paket
\series bold
listings
\series default
ist voreingestellt.
+ Um das mächtigere
+\series bold
+minted
+\series default
+ zu benutzen,
+ muss man es als Paket zur Code-Hervorhebung in den Dokumenteinstellungen in
der Rubrik
+\family sans
+Programmlistings
+\family default
+ festlegen.
+ Beachten Sie aber,
+ dass
+\series bold
+minted
+\series default
+ für die Code-Hervorhebung zusätzlich die Python-Bibliothek
+\family sans
+pygments
+\family default
+ benötigt,
+ die aber ab der Version 2024 in \SpecialChar TeX
+Live enthalten ist.
\end_layout
\begin_layout Standard
@@ -43038,59 +43060,26 @@ Achtung:
\end_layout
\begin_layout Plain Layout
-Um
+Beachten Sie:
+ In \SpecialChar TeX
+Live-Distributionen vor 2024 und bei Mik\SpecialChar TeX
+ läuft
\series bold
minted
\series default
- zu benutzen,
- muss man es als Paket zur Code-Hervorhebung in den Dokumenteinstellungen in
der Rubrik
-\family sans
-Programmlistings
-\family default
- festlegen.
-
-\series bold
-minted
-\series default
- benötigt zusätzlich das Modul
-\family sans
-pygments
-\family default
- des Programms
-\noun on
-Python
-\noun default
-
-\begin_inset Foot
-status collapsed
-
-\begin_layout Plain Layout
-Unte
-\family sans
-r \SpecialChar LyX
- f
-\family default
-ür Windows ist
-\family sans
-pygments
-\family default
- bereits installiert.
-\end_layout
-
-\end_inset
-
- und die Option
+ nur,
+ wenn die unsichere Option
\family typewriter
-shell-escape
\family default
für den \SpecialChar LaTeX
--Prozessor.
- Wenn Sie z.
-\begin_inset space \thinspace{}
-\end_inset
-
-B.
- Ihr Dokument als Format
+-Prozessor aktiviert ist.
+ Da dies ihr System angreifbarer macht,
+ raten wir nachdrücklich davon ab.
+ Wenn Sie es trotzdem verwenden wollen (und wirklich wissen,
+ was Sie tun!),
+ müssen Sie die Konvertereinstellungen ändern.
+ Für das Format
\family sans
PDF
\begin_inset space ~
@@ -43098,8 +43087,7 @@ PDF
(pdflatex)
\family default
- ansehen oder exportieren wollen,
- gehen Sie in die \SpecialChar LyX
+ etwa gehen Sie in die \SpecialChar LyX
-Einstellungen und dort zum Abschnitt
\family sans
Datei-Handhanbung\SpecialChar menuseparator
@@ -43123,7 +43111,7 @@ LaTeX
Konverter
\family default
.
- Dort sehen sie voreingestellt den Inhalt
+ Dort sehen sie den Inhalt
\begin_inset Newline newline
\end_inset
@@ -43177,6 +43165,8 @@ PDF
(XeTeX)
\family default
gemacht werden.
+ Nochmals aber:
+ Das ist ein Sicherheitsrisiko!
\end_layout
\end_inset
--
lyx-cvs mailing list
[email protected]
https://lists.lyx.org/mailman/listinfo/lyx-cvs
