[[Vorlage(Getestet, bionic)]]
{{{#!vorlage Wissen
[:Pakete installieren: Installation von Programmen]
[:Terminal: Ein Terminal öffnen]
}}}

[[Inhaltsverzeichnis()]]
[https://waf.io/semantik.html Semantik] {en} ist ein [:KDE:]-Programm, um auch komplexe Dokumente schnell mit Hilfe einer [:Mind_Map:] zu erstellen. Die Mind Map wird dabei als Übersicht in Semantik angelegt, Knoten mit Inhalt versehen und daraufhin das Dokument generiert.

Semantik ist Nachfolger des KDE-Programms Kdissert. Kdissert und Semantik unterscheiden sich in einigen Punkten in der Funktionalität. So bietet Semantik zum Beispiel Tabellen als auch Diagramme als Knotentyp, kann aber noch keine Inhalte der Knoten in LaTeX-Beamerdokumente einbinden.

{{{#!vorlage Hinweis
Semantik wurde in Ubuntu aus den Paketquellen entfernt (siehe [bug:1841825:]). Semantik wird weiterentwickelt, zur Installation der aktuellen Version kann ein Debianpaket [https://waf.io/semantik.html von der Projektseite] heruntergeladen und installiert werden. Zur Vereinfachung kann es deshalb ratsam sein, für neue Projekte ein anderes [:Mind_Map:]-Programm zu verwenden, wie z.B. des ebenfalls Qt-basierte [http://www.insilmaril.de/vym/ VYM] {en}.
}}}

= Installation =
Es kann bis Ubuntu 18.04 folgendes Paket installiert[1] werden:

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

= Benutzung = 
== Empfohlene Vorgehensweise ==
[[Vorlage(Bildunterschrift, semantik.png, 300, "Semantik", right)]]
Man beginnt mit der Gedankensammlung und fügt man eigene Ideen als unabhängige Knoten hinzu. Anschließend verbindet man die Knoten, löscht unnütze Knoten und balanciert den entstehenden Baum aus. Für die Dokumenterstellung empfiehlt es sich, nicht mehr als 3-4 Knoten pro Ast und nicht mehr als 5 Unterebenen zu erstellen. Zu den Knoten können nun noch Inhalt (Text, Bilder, Diagramme, Tabellen) hinzugefügt werden. Bevor man das Dokument generieren lässt, legt man noch die Reihenfolge der Knoten fest.

== Bedienung ==

Um einen Knoten zu erstellen, genügt ein einfacher Doppelklick auf die freie Fläche, ein Doppelklick auf einen Knoten erstellt einen Kindknoten. Nachdem ein Knoten ausgewählt ist, genügt ein Druck auf [[Vorlage(Tasten, enter)]], um diesen zu editieren. Kindknoten können auch mit [[Vorlage(Tasten, Strg + enter)]] und Geschwisterknoten mit [[Vorlage(Tasten, Shift + enter)]] erzeugt werden. Knoten können nach Belieben per [wikipedia:Drag_&_Drop:Drag&Drop] verschoben werden.

Ein Doppelklick auf eine Verbindung löscht diese.

Die Reihenfolge der Kindknoten legt man fest, indem man zuerst auf den Elternknoten klickt, dann auf den gelben Punkt am Elternknoten und daraufhin in der gewünschten Reihenfolge auf die erscheinenden Zahlen.

Die Karte ist zoom- und navigierbar. Mit gedrückter [[Vorlage(Tasten, lmt)]] kann die Karte verschoben werden.

Um die Übersicht zu erhöhen, können verschiedenen Knoten unterschiedliche Farben zugewiesen werden, oder diese mit Flags versehen werden. Außerdem kann man jederzeit die Karte über ''"Edit -> Reorganize the map"'' oder [[Vorlage(Tasten, Strg + r)]] neu organisieren lassen. Die ''"Linear view"'' im linken Unterfenster gibt einen hierarchischen Überblick.

Will man in seine Knoten neben den Namen noch weitere Inhalte eintragen, wählte man zuerst über einen Klick mit der [[Vorlage(Tasten, rmt)]] auf den Knoten dessen Typ aus (Text, Diagramm, Tabelle oder Bild). Diagrammelemente werden ebenfalls mit einem Doppelklick erstellt, Mit [[Vorlage(Tasten, Strg + lmt)]] können mehrere Knoten ausgewählt und verschoben werden. Bestehende Verbindungen können über die gelben Punkte verändert werden. Ein Doppelklick auf eine Verbindung entfernt diese wieder. Zeilen und Spalten in Tabellen werden über die rechte Maustaste erstellt und können dann mit Inhalt gefüllt werden.

== Erstellen von Dokumenten ==
Ist man mit seiner Mind Map zufrieden, kann man über ''"Tools -> Generate"'' oder [[Vorlage(Tasten, Strg + g)]] ein Dokument aus dieser erstellen lassen. Hat man eine ''"S5 presentation"'' oder ein ''"Web document"'' (HTML-Seite) erstellt, steht die Vorschau zur Verfügung. Mit Variablen lassen sich verschiedene Dokumenteigenschaften einstellen. Um die Variablen zu setzen, darf kein Knoten ausgewählt sein und müssen diese unter ''"View -> Variables"'' aktiviert sein. Welche Variablen zur Verfügung stehen, sieht man in den Template-Dateien in der Qt4-Version im Verzeichnis '''/usr/share/kde4/apps/semantik/templates/''' (bis 18.04) bzw. in der Qt5-Portierung unter '''/usr/share/semantik/templates''' (ab 20.04). Ein Beispiel für Variablen eines Dokumentes:

{{{
doc_author=Ubuntu User
doc_place=Ubuntuland
doc_title=Semantik
babel=deutsch
each_subsection_off=1
content_title=Beispiel
}}}

Bei der Erzeugung von [:LaTeX: PDFLaTeX]-Dokumenten wird eine tex-Datei erstellt, die erst noch kompiliert werden muss. Dazu erstellt das Programm ein Skript für [github:waf-project/waf:waf] {en} im Ordner, indem man auch das Dokument erstellt hat. Hier führt man nun folgende Befehle[2] aus, um eine PDF-Datei zu erstellen und zu betrachten:

{{{#!vorlage Befehl
./waf configure
./waf build
./waf view
}}}

= Links =
== Intern ==
 * [:Mind_Map:] {Übersicht} Programmübersicht
== Extern ==
 * [https://waf.io/semantik.html Projektseite] {en}
  * [https://gitlab.com/ita1024/semantik Quellcode] {en}

#tag: Bildung, Büro, KDE