[[Vorlage(Getestet, jammy, bionic, focal)]] {{{#!vorlage Wissen [:Paketquellen freischalten/PPA: Verwenden eines PPAs] [:Pakete installieren: Installation von Paketen] }}} [[Inhaltsverzeichnis(1)]] [[Bild(inyokaedit_64x64.png, 48, align=left)]] [github:inyokaproject/inyokaedit:InyokaEdit] {en} ist ein speziell auf [http://ubuntuusers.de/inyoka/ Inyoka] ausgerichteter [:Editor:]. In erster Linie ist er dafür gedacht, Artikel für auf Inyoka aufbauende Portale auf dem eigenen Rechner zu erstellen. Es wird keine Internetverbindung zum Schreiben benötigt, da InyokaEdit über eine integrierte Vorschaufunktion verfügt. InyokaEdit wurde mit [:Qt:] erstellt und integriert sich somit in jede [:Desktop:Desktopumgebung] und ist plattformübergreifend verfügbar. Neben einem PPA für Ubuntu gibt es zusätzlich ein [:AppImage:], ein [:Flatpak:] und eine Version für Windows. Die drei Letztgenannten gibt es auf der [github:inyokaproject/inyokaedit/releases:Projektseite] {dl} {en}. Für Arch Linux wird InyokaEdit über das [https://aur.archlinux.org/packages/?K=inyokaedit AUR] {en} angeboten. {{{#!vorlage Infobox "InyokaEdit", "[github:inyokaproject/inyokaedit:Projektseite] {en}", "inyokaedit_raw.png", "[:PPA:]" +++ Sprache {de} {en} {nl} +++ Autor [user:Shakesbier:] +++ Erste Veröffentlichung 2012 +++ Lizenz [wikipedia:GNU_General_Public_License#GPL_Version_3:GNU GPL v3] +++ Oberfläche [:Qt:] +++ Programmiersprache [wikipedia:C++:] }}} Weitere Funktionen: * Herunterladen des Rohtextes eines Inyoka-Artikels inklusive Bilder * Hochladen eines Artikels in die [:Baustelle:Wiki-Baustelle] * Integrierte offline Vorschaufunktion * Paralleles Bearbeiten mehrerer Artikel (Registerkarten) * Codevervollständigung für Vorlagen * Alle Inyoka-[:Wiki/Textbausteine:Textbausteine] und [:Wiki/InterWiki:InterWiki-Links] über das Menü auswählbar * Artikel zusammen mit Bildern in einer Datei speichern. * Rudimentäre Syntaxprüfung (offene Klammern, bekannte Vorlagen) * Erweiterungen: * Syntax-Hervorhebung der Inyoka-Elemente * Rechtschreibprüfung (basierend auf [:Hunspell:]) * [:Wiki/Textbausteine#Wissensblock:Wissensblock]-Auswahldialog * Tabellengenerator/-konverter * Tastenkombinationen für eigene Textelemente = Installation = InyokaEdit ist kein Bestandteil der offiziellen Paketquellen. Zur Installation muss das "Pesonal Packages Archiv" (PPA) [1] des Entwicklers freigeschaltet werden. == PPA == [[Vorlage(PPA, elthoro, inyokaedit)]] Nach dem Aktualisieren der Paketquellen können InyokaEdit und optional die Erweiterungen über die folgenden Pakete installiert [2] werden: {{{#!vorlage Paketinstallation inyokaedit, ppa inyokaedit-data-ubuntuusersde, ppa, uu.de spezifische Dateien, die zur Erstellung der Vorschau benötigt werden inyokaedit-plugins, ppa, optional und enthält Rechtschreibprüfung, Syntax-Hervorhebung, Wissensbox-Auswahldialog, Tabellengenerator und Tastenkombinationen }}} Sofern in der Vorschau die Syntax-Hervorhebung im [:Wiki/Syntax#Code-einfuegen:Codeblock] angezeigt werden soll, wird zusätzlich das nachfolgende Paket benötigt. Hinweis: Dies betrifft nicht die Syntax-Hervorhebung im Editor. Für diese wird kein extra Paket benötigt. {{{#!vorlage Paketinstallation python-pygments, bis einschließlich Ubuntu 18.10 python3-pygments, ab Ubuntu 19.04 }}} == AppImage == Alternativ zum PPA kann InyokaEdit auch von der [github:inyokaproject/inyokaedit/releases:Projektseite] {dl} {en} als [:AppImage:] bezogen werden. Achtung: Unter Ubuntu 22.04 Jammy Jellyfish funktioniert das Hoch-/Runterladen eines Artikels in der AppImage-Variante von InyokaEdit derzeit nicht! Wenn man diese Funktion unter Ubuntu 22.04 nutzen möchte, muss die Version aus dem PPA verwendet werden. [[Vorlage(Fremd, Software)]] = Bedienung = Nach der Installation kann InyokaEdit über ''"Zubehör → InyokaEdit"'' (Ubuntu), bzw. ''"Dienstprogramme → InyokaEdit"'' (Kubuntu) gestartet werden. Über das Menü ''"Datei → Neu von Template"'' können Artikelvorlagen geladen werden. Zusätzlich können eigene Vorlagen erstellt werden. Nachdem diese im Verzeichnis '''~/.local/share/inyokaedit/community/ubuntuusers_de/templates/articles/''' mit der Dateiendung '''.tpl''' abgelegt wurden, erscheinen diese ebenfalls im Vorlagenmenü. Die Symbolleiste des Editors entspricht exakt der Symbolleiste, welche bei der Online-Bearbeitung eines Artikels innerhalb von Inyoka angezeigt wird. Des Weiteren stehen über das Menü alle in Inyoka verfügbaren [:Wiki/Textbausteine:Textbausteine] und [:Wiki/InterWiki:InterWiki-Links] zur Verfügung. Durch [[Vorlage(Tasten, lmt)]] auf [[Bild(download.png, 25)]] kann der Rohtext eines beliebigen Wikiartikels heruntergeladen werden. Hierzu muss man den Namen des gewünschten Artikels in das erscheinende Eingabefenster eingeben. Zum Herunterladen alter Artikelrevisionen muss die Zeichenkette `@rev=1234` (`1234` durch die jeweilige Revisionsnummer des Artikels ersetzen) angehängt werden. Über den Knopf [[Bild(upload.png, 25)]] kann der aktuell geöffnete Artikel in die [:Baustelle:] hochgeladen werden. Sollen die verwendeten Bilder zusammen mit dem Artikel in einer Datei gespeichert werden, so muss beim Speichern die Dateierweiterung '''.inyzip''' ausgewählt werden. Über ''"Hilfe → Syntax-Übersicht"'' öffnet sich ein Fenster mit einer Übersicht über alle zur Verfügung stehenden Syntaxelemente inklusive einer kurzen Beschreibung. == Vorschau == Durch [[Vorlage(Tasten, lmt)]] auf das Symbol [[Bild(preview.png, 25)]] oder beim Wechsel eines Reiters wird die Vorschau des Artikels generiert und angezeigt. Befindet man sich in der Vorschau, kann man durch [[Vorlage(Tasten, rmt)]] ein Popup-Menü öffnen, über das man die Seite neu laden oder vor und zurück navigieren kann, falls man auf einen Link geklickt hat. Über die ''"Einstellungen"'' kann der Editor vertikal oder horizontal geteilte werden. Damit wird die Vorschau direkt neben oder unter dem Rohtext des Artikels angezeigt. Zusätzlich kann festgelegt werden, beim Druck auf welche Taste (z.B. immer sobald [[Vorlage(Tasten, Enter)]] gedrückt wird) die Vorschau automatisch aktualisiert werden soll. Alternativ kann eine Zeitspanne angegeben werden, nach der die Vorschau automatisch neu erstellt wird. Außerdem kann die Vorschau auch in einem [:Internetanwendungen#Webbrowser: Browser] aufgerufen werden. Die Datei dafür liegt unter '''~/.local/share/inyokaedit/tmpinyoka.html'''. Die Vorschau muss dann allerdings im Browser manuell neu geladen werden. Sollen eigene Bilder in der Vorschau genutzt werden, müssen diese im Verzeichnis des Artikels abgelegt werden. [[Vorlage(Bildunterschrift, inyokaedit-tabelle.jpeg, 200, "Tabelle erstellen", right)]] == Erweiterungen == Sofern das Paket '''inyokaedit-plugins''' installiert ist, stehen Syntax-Hervorhebung, Rechtschreibprüfung, Wissensblock-Auswahl, Tabellengenerator/-konverter und Tastenkombinationen als Erweiterungen zur Verfügung. Über ''"Bearbeiten → Einstellungen → Erweiterungen"'' können diese separat de-/aktiviert werden, sowie weitere Konfigurationen vorgenommen werden. Für die Syntax-Hervorhebung können eigene Farbstile definiert werden. Sowohl die Wissensblock-Auswahl, als auch die Tastenkombinationen für eigene Textelemente können beliebig erweitert oder gekürzt werden. Über den Tabellengenerator/-konverter können Tabellen in frei wählbarer Größe inklusive Farbformatierungen erstellt werden. Des Weiteren können Tabellen von der Inyoka [:Wiki/Tabellen/Basisformatierung:Basisformatierung] in die "[:Wiki/Tabellen:neue]" Tabellenformatierung und umgekehrt umgewandelt werden. Der Aufruf einer Erweiterung geschieht über das Menü ''"Extras"'', bzw. zusätzlich bei manchen Erweiterungen über das entsprechende Symbol in der Werkzeugleiste. = Einstellungen = Über ''"Bearbeiten → Einstellungen"'' kann ein grafischer Einstellungsdialog aufgerufen werden. Sofern man das automatische Speichern des Dokuments nach einer gewissen Zeit aktiviert hat, wird eine Sicherungskopie unter '''~/.local/share/inyokaedit/AutoSave.bak~''' abgelegt, bzw. falls eine existierende '''.iny'''-Datei geöffnet wurde, wird eine '''.bak~'''-Datei im selben Ordner wie der geöffnete Artikel angelegt. == Getestet-Vorlage erweitern == Da nicht direkt mit jeder Ubuntu-Version eine aktualisierte Version von InyokaEdit zur Verfügung stehen kann, hat man die Möglichkeit, die Textbausteine [:Wiki/Textbausteine/#Getestet:Getestet] und [:Wiki/Textbausteine/#Ubuntu-Touch:UT] über eine Konfigurationsdatei selbst um neue Ubuntu-Versionen zu erweitern. Hierzu muss eine Textdatei '''TestedWith.conf''' bzw. '''TestedWithTouch.conf''' im Verzeichnis '''~/.local/share/inyokaedit/community/ubuntuusers_de/templates/''' erstellen. Pro Ubuntu-Version ist eine neue Zeile mit folgender Formatierung einzufügen. Beispiel für Ubuntu 20.04: {{{ focal = [:Focal_Fossa:Ubuntu 20.04] Focal Fossa }}} == Eigene Menü-/Werkzeugleisten == Seit InyokaEdit 0.19.0 können eigene Menüeinträge und Werkzeugleisten zum Editor hinzugefügt werden. Hierzu muss eine XML-Datei in '''~/.local/share/inyokaedit/community/ubuntuusers_de/xml/''' erstellt werden. Für einen neuen Menüeintrag muss die Datei '''menu_1_de.xml''', für eine Werkzeugleiste '''toolbar_1_de.xml''' und für eine Dropdown-Menü '''dropdown_1_de.xml''' benannt werden. Bei mehr als einer Datei muss "_1" jeweils inkrementiert werden. Sofern nicht Deutsch als Sprache der Benutzeroberfläche verwendet wird, muss "_de" durch das entsprechende Sprachkürzel ersetzt werden. Als Vorlage können die bei der Installation mitgelieferten XML-Dateien in '''/usr/share/inyokaedit/community/ubuntuusers_de/xml''' verwendet werden. = Fehler melden = Gefundene Fehler sollten, sofern ein [github::GitHub]-Nutzerkonto vorhanden ist, über den zum Projekt gehörenden [github:inyokaproject/inyokaedit/issues:Bugtracker] {en} gemeldet werden. Dies ist über den Menüpunkt ''"Hilfe → Fehler melden"'' auch direkt aus dem Editor möglich. Ist kein GitHub-Nutzerkonto vorhanden, können Fehler über den [topic:inyokaedit-ein-editor-fuer-inyoka-artikel:Thread zu InyokaEdit] im Forum gemeldet werden. = Links = * [github:inyokaproject/inyokaedit:InyokaEdit] – Projektseite * [topic:inyokaedit-ein-editor-fuer-inyoka-artikel:Thread zu InyokaEdit] – Diskussion zum Editor, zur Mitarbeit und Verbesserungsvorschläge * [:xdg-utils#Neuen-MIME-Typ-erstellen:Einen eigenen MIME-Typ für InyokaEdit erstellen] * [ikhaya:2012/02/25/projektvorstellung-inyokaedit-ein-editor-fuer-inyoka:Projektvorstellung: InyokaEdit – ein Editor für Inyoka] - Ikhaya, 02/2012 * [:Wiki/Hilfsmittel:] {Übersicht} #tag: Wiki, Editor, Qt, Inyoka