Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- nerdkram:webdesign:rezepte-in-dokuwiki [2023/09/30 19:30] – [Seitenvorlagen nutzen] matthias.moorkamp
+++ nerdkram:webdesign:rezepte-in-dokuwiki [2023/10/03 09:58] (aktuell) – [Daten strukturieren] matthias.moorkamp
@@ Zeile 1: / Zeile 1: @@
 ====== Rezepte in Dokuwiki ======
 ===== Seitenvorlagen nutzen =====
-Da Rezepte in der Regel eine wiederkehrende Textstrukturierung aufweisen, empfiehlt sich die Verwendung einer darauf angepassten Seitenvorlage.
+Da Rezepte in der Regel eine wiederkehrende Textstrukturierung aufweisen, empfiehlt sich die Verwendung einer darauf angepassten [[https://www.dokuwiki.org/de:namespace_templates|Seitenvorlage]].
-Hierzu muss eine entsprechend der Dokuwiki-Artikelsyntax formatierte Textdatei im Verzeichnis ''./data/pages/$myNamespace'' des Namensraums ''$myNamespace'' angelegt werden, unterhalb dessen im folgenden die Rezept gespeichert werden.
+Voraussetzung ist, dass alle Rezepte inner- oder unterhalb eines gemeinsamen [[https://www.dokuwiki.org/de:namespaces|Namensraums]] ''$myNamespace'' angelegt werden.
-Für Seitenvorlagen, die ausschließlich nur innerhalb des Namensraums ''$myNamespace'' gelten sollen, in dessen Verzeichnis die Seitenvorlage gespeichert ist, muss dabei der Dateiname ''_template.txt'' (einfacher führender Unterstrich) verwendet werden; Seitenvorlagen, die vererbt und damit auch für alle hierarchisch unterhalb von ''$myNamespace'' liegenden Namensräume gelten sollen, sind unter dem Dateinamen ''__template.txt'' (doppelter führender Unterstrich) zu speichern.
+Unter dieser Bedingung kann eine entsprechend der [[https://www.dokuwiki.org/de:wiki:syntax|Dokuwiki-Artikelsyntax]] formatierte Textdatei im Verzeichnis ''./data/pages/$myNamespace'' des gemeinsamen Namensraums ''$myNamespace'' als Seitenvorlage angelegt werden.
+\\ Für Seitenvorlagen, die ausschließlich innerhalb des Namensraums ''$myNamespace'' gelten sollen, muss dabei ''_template.txt'' (einfacher führender Unterstrich) als Name der Textdatei verwendet werden; Seitenvorlagen, die vererbt werden und damit auch für alle hierarchisch unterhalb von ''$myNamespace'' liegenden Namensräume gelten sollen, sind unter dem Dateinamen ''__template.txt'' (doppelter führender Unterstrich) zu speichern.
 Beispiel einer einfachen Seitenvorlage für Rezepte:
@@ Zeile 20: / Zeile 21: @@
 </file>
-===== Glossar verwenden =====
+===== Glossar anlegen =====
 Da die Mengenangaben in Rezepten regelmäßig auf etablierten (SI-)Einheiten beruhen, bietet sich bei der Eingabe die Nutzung der zugehörigen Abkürzungen an.
@@ Zeile 74: / Zeile 75: @@
 Eine Verwaltung dieser Datei über die Administrations-Oberfläche von Dokuwiki ist über das Plugin [[https://www.dokuwiki.org/plugin:confmanager|confmanager]] möglich.
+===== Strukturierte Daten ausgeben =====
+Hinsichtlich einer automatisierten Auswertung (z.B. durch Suchmaschinen) kann es sinnvoll erscheinen, die Inhalte gemäß [[https://schema.org/Recipe|etablierter Schemata]] zu strukturieren. Da die verschiedenen Implementationsmöglichkeiten mit unterschiedlichem Pflege- bzw Einrichtungsaufwand verbunden sind, ist im Einzelfall zu abzuwägen, ob der Nutzen strukturierter Daten den erforderlichen Aufwand rechtfertigt.
+Eine einfache Implementierung kann durch Verwendung der Dokuwiki-Plugins [[https://www.dokuwiki.org/plugin:adhoctags|adhoctags]] und [[https://www.dokuwiki.org/plugin:adhoctables|adhoctables]] erzielt werden.
+\\ Nach deren Installation können entsprechende Tags und Attribute in den Seitenvorlagen hinterlegt werden.
+\\ Nachteil dieser Lösung ist der Bruch mit der bewusst einfach gehaltenen Dokuwiki-Syntax.
+Eine aus Anwendersicht weniger komplexe und damit fehlerunanfälligere Alternative besteht in der Nutzung des [[https://www.dokuwiki.org/plugin:struct|struct-Plugins]], mit dessen Hilfe sich Eingabemasken für die strukturierten Daten definieren lassen.
+\\ Nachteil dieser Lösung ist der relativ hohe Implementationsaufwand.