Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen der Seite angezeigt.

--- faecher:informatik:oberstufe:datenbanken:projekt:dokuwiki_plugin:plugin_grundlagen:start [07.06.2021 16:55] – [Aufgaben] sbel
+++ faecher:informatik:oberstufe:datenbanken:projekt:dokuwiki_plugin:plugin_grundlagen:start [10.06.2021 09:53] (aktuell) – [Styling der Ausgaben] sbel
@@ Zeile 23: / Zeile 23: @@
 {{ :faecher:informatik:oberstufe:datenbanken:projekt:dokuwiki_plugin:plugin_grundlagen:auswahl_383.png?600 |}}
+<WRAP center round tip 60%>
+Tipp: Füge auf der Wiki-Seite, auf der du das Plugin testest am Seitenstart den Dokuwiki Code
+  ~~NOCACHE~~
+ein, um das Caching der Seite abzuschalten - das erspart dir verwirrende Probleme, wenn du alte Versionen aus dem Cache angezeigt bekommst.
+</WRAP>
 ==== Erklärungen ====
@@ Zeile 37: / Zeile 44: @@
 {{ :faecher:informatik:oberstufe:datenbanken:projekt:dokuwiki_plugin:plugin_grundlagen:ablauf.png |}}
-===== Aufgaben =====
+----
 {{:aufgabe.png?nolink  |}}
 === (A1) ===
-Öffne die Datei ''syntax.php'' im Editor deiner Wahl. Der Quelltext ist mit Kommentaren versehen - vollziehe den im Diagramm oben dargestellten Ablauf beim finden des Musters und dessen Ersetzung im Quelltext nach.
+Öffne die Datei ''syntax.php'' deines Plugins (innerhalb des Verzeichnisses ''projekt'') im Editor deiner Wahl. Der Quelltext ist mit Kommentaren versehen - vollziehe den im Diagramm oben dargestellten Ablauf beim finden des Musters und dessen Ersetzung im Quelltext nach.
 Überprüfe deine Erkenntnisse, indem du das Plugin veränderst:
@@ Zeile 83: / Zeile 89: @@
 Übernehme diese beiden Zeilen in deine connectTo-Methode und steuere die Ausgabeart nun über den Befehl anstelle der Option.
+==== Styling der Ausgaben ====
+Um den im Plugin erzeugen und dann im Browser angezeigten HTML-Code noch mit eigenen Styles zu versehen, reicht es, im Plugin Verzeichnis eine Datei ''style.css'' anzulegen, in denen man CSS-Regeln festlegen kann. Styles in dieser Datei werden von DokuWiki beim Seitenaufruf automatisch mitgeliefert.
+----
+{{:aufgabe.png?nolink  |}}
+=== (A4) ===
+Erstelle eine Datei ''style.css'' im Plugin Verzeichnis mit folgendem Inhalt:
+<code css>
+.projekt-befehl {
+    color: red;
+}
+.projekt-option {
+    color: green;
+}
+</code>
+Passe dann die Ausgabe im Plugin so an, dass der Befehl zwischen
+  <span class="projekt-befehl">...</span>
+steht und die Option entsprechend und überprüfe das Ergebnis.
+<WRAP center round important 60%>
+Die CSS-Dateien werden von Dokuwiki lange im Cache gehalten. Wenn aktualisierte CSS-Regeln nicht im Browser ankommen, kann man das Löschen des Caches erzwingen, indem man auf dem Übungsserver den Zeitstempel der Datei ''../wiki/conf/dokuwiki.php'' aktualisiert: ''touch ~/public_html/wiki/conf/dokuwiki.php''.
+</WRAP>
+===== Sichern des bearbeiteten Plugins in einem eigenen Git-Repo =====
+Da die Plugin-Vorlage aus einer Quelle geklont wurde, auf die du keine Schreibrechte besitzt, sorgen wir jetzt noch dafür dass du eine weiteren Entwicklern in einem eigenen Repo weiterverfolgen kannst.
+Lege zunächst ein leeres Git-Repo auf Gitea an. Im Beispiel verwende ich ''https://gitea.schule.social/sbel/dokuwiki-plugin-frank.git''. Die Adresse zeigt Gitea nach dem Erstellen des Repos in der Kurzanleitung an:
+{{ :faecher:informatik:oberstufe:datenbanken:projekt:dokuwiki_plugin:plugin_grundlagen:auswahl_385.png?600 |}}
+Jetzt wechselt man in das Plugin-Verzeichnis auf dem Übungsserver und setzt dort eine neue Adresse für den "origin" des Repos:
+  git remote set-url origin https://gitea.schule.social/sbel/dokuwiki-plugin-frank.git
+Von nun an kann man das Repository auf den eigenen Origin pushen - du hast einen Fork erstellt.
+=== Den gesamten Ablauf zeigt der folgende ASCII-Cast: ===
+<html>
+<script id="asciicast-5AXcMQhGvS1VZv5LPZuVDlJUZ" src="https://asciinema.org/a/5AXcMQhGvS1VZv5LPZuVDlJUZ.js" async></script>
+</html>