[[Vorlage(Getestet, focal)]]

{{{#!vorlage Wissen
[:Pakete_installieren: Installation von Programmen]
[:Terminal: Ein Terminal öffnen] optional
[:sudo: Root-Rechte erlangen] optional
[:Programme_starten:]
}}}
[[Inhaltsverzeichnis(1)]]

[[Bild(./retext_logo.png, 48, align=left)]]
[github:retext-project/retext:ReText] {en} ist ein Editor für die vereinfachten Auszeichnungssprachen [wikipedia:Markdown:] bzw. dessen Dialekt [https://python-markdown.github.io/ Python-Markdown] {en}, [wikipedia:ReStructuredText:reStructuredText] (reST) und [wikipedia:Textile:]. Es verwendet zwei Fenster: eines für den Quelltext und ein zweites ausblendbares rechts daneben als spezielle Live-Vorschau. Alternativ kann zwischen Quelltext- und einem normalen Vorschau-Fenster gewechselt werden. Damit ist das Programm ein sehr nützliches Werkzeug zum Erlernen der genannten Auszeichnungssprachen.

Das [:Python:]-Programm verwendet die Bibliothek [:Qt:] für die grafische Oberfläche (GUI).

= Installation =
[[Bild(Wiki/Icons/synaptic.png, 48, align=right)]]

ReText ist Bestandteil der offiziellen Paketquellen. Folgendes Paket muss installiert werden [1]:

{{{#!vorlage Paketinstallation
retext, universe
}}}

== Manuell ==
[[Vorlage(Fremd, Software)]]

Um die jeweils aktuellste Version zu nutzen, kann alternativ eine manuelle Installation via [:pip:] erfolgen. Voraussetzung ist neben Python in der Version 3.6 oder höher das folgende Paket:

{{{#!vorlage Paketinstallation
python3-pyqt5, universe
}}}
Dann installiert man das Programm durch folgenden Befehl [2]:

{{{#!vorlage Befehl
pip3 install ReText
}}}
Soll das Programm systemweit installiert werden, muss `pip` mit Root-Rechten [3] ausgeführt werden. Soll eine manuelle Installation später wieder entfernt werden, nutzt man den Befehl (ggfs. ebenfalls mit Root-Rechten):

{{{#!vorlage Befehl
pip3 uninstall ReText
}}}

= Verwendung =
{{{#!vorlage Tabelle
<tablestyle=float:right; clear:right" :>[[Bild(./retext.png, x180)]]
<:>[[Bild(./retext_md.png, x180)]]
+++
<:>Live-Vorschau reStructuredText
<:>Live-Vorschau Markdown
}}}
Bei Ubuntu-Varianten mit einem Anwendungsmenü befindet sich ein Programmstarter unter ''„Büro -> ReText“'' [4]. Alternativ kann man den Befehl `retext` bzw. `~/.local/bin/retext` (nur bei manueller Installation) verwenden.

Neben der Grundfunktionen eines Editors stehen folgende weitere zur Verfügung (Auswahl):

 * Tabellen
 * Bilder einbinden
 * Mathematische Formeln
 * Externe Links
 * Rechtschreibprüfung
 * Druckvorschau

== Export ==
Von Haus aus unterstützt ReText den Export nach:

 * HTML
 * [:PDF:]
 * LibreOffice Writer (.odt)

Je nach Auszeichnungssprache können Werkzeuge wie [:Pandoc:] oder die [:docutils:] zur Umwandlung in andere Formate eingesetzt werden. Wie man diese Werkzeuge in ReText einbindet, ist der Anleitung [https://github.com/retext-project/retext/wiki/Export-Extensions Export Extensions] {en} zu entnehmen.

Möchte man beispielsweise eine Umwandlung von Markdown nach [wikipedia:Rich_Text_Format:RTF] mittels Pandoc vornehmen, erstellt man die Datei '''~/.local/share/retext/export-extensions/md2rtf.desktop''':

{{{
[Desktop Entry]
Name=Export Markdown to RTF
Name[de]=Markdown in RTF umwandeln
Exec=/usr/bin/pandoc -f markdown -t rtf -o %of %if
X-ReText-FileFilter=RTF Files (*.rtf)
X-ReText-DefaultExtension=.rtf
}}}
Der neue Konverter ist anschließend im Menü unter ''„Datei -> Exportieren“'' zu finden.

== Einstellungen ==
Die Programmeinstellungen sind über ''„Bearbeiten -> Einstellungen“'' erreichbar. Dazu zählt beispielsweise ein automatisches Speichern oder die Verwendung bestimmter Markdown-Funktionen. Gespeichert wird die Konfiguration in der Datei '''~/.config/ReText project/ReText.conf''' (Leerzeichen im Pfad und Groß-/Kleinschreibung beachten!).

= Problembehebung =
== Alternativen ==
Obwohl ReText einfach aus den offiziellen Paketquellen installierbar ist, ist er nicht der einzige Editor für Markdown. Mögliche Alternativen sind:

 * [:Typora:]
 * [:Apostrophe:]
 * [http://pad.haroopress.com/ Harropad] {en}
 * [https://remarkableapp.github.io/ ReMarkable] {en}
 * [github:atareao/utext:uText] {en} ([launchpad:~atareao/+archive/ubuntu/utext:PPA])

Siehe auch [https://itsfoss.com/best-markdown-editors-linux/ 11 Best Markdown Editors for Linux] {en} - Blogbeitrag, 10/2020

= Links =
 * [github:retext-project/retext:Projektseite] {en}
  * [https://github.com/retext-project/retext/wiki Dokumentation] {en}
 * [http://www.linux-community.de/Internal/Artikel/Print-Artikel/LinuxUser/2014/03/Retext-hilft-beim-Editieren-von-Markdown-Dokumenten Ohne Umwege – Retext hilft beim Editieren von Markdown-Dokumenten] {de} - LinuxUser, 03/2014
 * [https://linuxundich.de/gnu-linux/markdown-editor-retext-mit-live-vorschau/ Markdown-Editor ReText mit Live-Vorschau] {de} - Blogbeitrag, 10/2012
 * [github:rst2pdf/rst2pdf:rst2pdf] und [http://rst2pdf.ralsina.me/stories/ rst2pdf] {en} - aus reStructuredText eine PDF-Datei erzeugen
 * [:Editoren:] {Übersicht} Programmübersicht

#tag: Markdown, Editor, Büro, Python, Qt