[[Vorlage(Getestet, jammy focal)]]

{{{#!vorlage Wissen
[:Pakete installieren: Installation von Programmen]
[:Programme_starten: Starten von Programmen]
[:Terminal: Ein Terminal öffnen]
[:mit Root-Rechten arbeiten:]
}}}

[[Inhaltsverzeichnis(1)]]

[[Bild(./Logo.png, 50, align=left)]]
jdTextEdit ist ein in [:Python:] geschriebener Texteditor, der auf dem [:Qt:]-Toolkit basiert. Als Editorkomponente dient [http://www.scintilla.org/ Scintilla] {en}, welches u.a. auch in [:Geany:] und [:SciTE:] verwendet wird.

[[Bild(./Screenshot.png, 200, right)]]
Zu den Funktionen von jdTextEdit gehören u.a.: 

 * Syntaxhervorhebung ("Highlighting") – Unterstützung der meisten Programmier-, Skript- und Markup-Sprachen wie C++, Java, Perl, PHP, Python, HTML, XML, LaTeX, etc. 
 * Falteneditor – einzelne, zusammengehörige Codeteile können ausgeblendet werden. 
 * Codevervollständigung – benutzte Wörter werden eigenständig ergänzt. 
 * Seitenleiste – über die Seitenleiste können u.a. Dateien geöffnet werden. 
 * Makros – Häufig benutzte Aktionen können aufgezeichnet und abgespielt werden. 
 * Externe Befehle – es können externe befehle ausgeführt werden.

= Installation =
== Flatpak ==
Die empfohlene Installationsmethode ist per [:Flatpak:]:
{{{#!vorlage Befehl
flatpak install flathub com.gitlab.JakobDev.jdTextEdit
}}}
Nähere Hinweise dazu auch unter: [https://flathub.org/apps/details/com.gitlab.JakobDev.jdTextEdit] {en}

== pip ==
jdTextEdit kann mit [:pip:] installiert werden.

[[Vorlage(PipInstallation, jdTextEdit)]]

Dabei ist jedoch zu beachten, dass kein Eintrag im Menü angelegt wird.

== manuell ==
Wer jdTextEdit manuell installieren möchte, kann das wie folgt tun:

{{{#!vorlage Befehl
git clone https://gitlab.com/JakobDev/jdTextEdit.git
cd jdTextEdit
pip3 install -r requirements.txt
chmod u+x jdTextEdit.py
}}}

Anschließend kann jdTextEdit durch ausführen von jdTextEdit.py gestartet werden.

= Bedienung =
jdTextEdit steht im Menü unter ''"Entwicklung → jdTextEdit"'' zur Verfügung.

Das Programm lässt sich ähnlich wie jeder andere Texteditor benutzen. Dateien können entweder über das Menü oder über die Seitenleiste, welche mit ''"Ansicht -> Seitenleiste"'' eingeblendet werden kann, öffnen. Die Einstellungen lassen ''"Bearbeiten → Einstellungen"'' finden.

Plugins können mithilfe des Pluginmanagers, der unter ''"Bearbeiten -> Pluginmanager"'' zu finden ist, installiert werden. Dazu setzt man einfach ein Häkchen bei den Plugins, die installiert werden sollen und klickt auf ''OK''.

Um eigene Vorlagen dem Menü hinzuzufügen, muss man sie in den Ordner "templates" im Speicherordner, welchen man unter ''"? -> Speicherordner öffnen"'' öffnen kann, kopieren.

= Portabler Modus =
jdTextEdit lässt sich mithilfe des Arguments `-p` im portablen Modus starten. Dabei werden alle Dateien im gleichen Ordner gespeichert, in dem das Programm abgelegt ist. Dadurch kann das Programm z.B. auf einem USB-Stick mitgenommen und ohne Instalation benutzt werden. Voraussetzung dafür ist jedoch, dass sich entweder auf dem USB-Stick oder auf dem Zielsystem Python mit allen benötigten Paketen installiert ist.

= Einrichtung für mehre Nutzer =
jdTextEdit kann auch für die Benutzung von mehren Nutzern eingerichtet werden. Mit Programmordner ist im folgenden der Ordner gemeint, denn man mit ''"? -> Programmordner öffnen"'' öffnen kann. Mit Speicherordner ist im folgenden der Ordner gemeint, denn man mit ''"? -> Speicherordner öffnen"'' öffnen kann.

== Voreinstellungen festlegen ==
jdTextEdit speichert alle Daten wie z.B. Einstellungen, eigene Makros und Befehle usw. in seinem Speicherordner. Es kann ein vordefinierter Speicherordner festgelegt werden. Dazu muss der Speicherordner als '''default_data''' in den Programmordner kopiert werden. Wenn ein Nutzer, der noch keinen eigenen Speicherordner besitzt, jdTextEdit startet, wird der Inhalt von '''default_data''' in den eigenen neu erstellten Speicherordner kopiert. Auf Nutzer mit bereits vorhandenen Speicherordner, hat '''default_data''' keinen Einfluss.

== Einstellungen für mehrere Nutzer treffen ==
Es können Makros, Befehle, Plugins und Vorlagen für mehrere Nutzer bereitgestellt werden. Vorlagen müssen dazu in den Ordner '''templates''' und Plugins in den Ordner '''plugins''' im Programmordner kopiert werden. Für Makros legt man im Programmordner die Datei '''macros.json''' und für Befehle die Datei '''commands.json''' an. Beiden Dateien haben exakt den selben Aufbau wie die gleichnamigen Dateien im Speicherordner. Es ist also empfehlenswert, Makros und Befehle normal über das entsprechende Menü hinzuzufügen und danach die entsprechenden Dateien vom eigenen Speicherordner in den Programmordner zu kopieren.

= Links =
 * [:Editoren:] {Übersicht} Übersichtsartikel
 * [gitlab:JakobDev/jdTextEdit:Projekseite] {en}
 * [https://jdtextedit.readthedocs.io Dokumentation] {en}

# tag: Editor, Programmierung