====== Notizen zur Arbeit mit diesem Wiki ======

Diese Seite ist mein persönlicher Spickzettel zum Thema ''Wiki''. Er soll nicht die Wiki-Dokumentation ersetzen, sondern eigene Erkenntnisse und Erfahrungen übersichtlich zusammen fassen. \\
 --- //[[rl@agentur-lindner.de|Ralph Lindner]] 2018-03-09 13:32//

  * Die Möglichkeiten des Wikis ausprobieren kann jeder angemeldete Nutzer des Wikis auf der Seite [[:wiki:spielwiese | Spielwiese]].

===== Abkürzungen und Acronyme =====
Es können Tooltips zu Abkürzungen (Acronyme) angezeigt werden. Hierzu muss sich ein Eintrag der Abkürzung in der Datei ''<dokuwiki>/conf/acronyms.conf'' (bzw. ''<dokuwiki>/conf/acronyms.local.conf'' für eigene Ergänzungen) befinden. Nach Änderungen Apache-Reload nicht vergessen!

=> [[doku>abbreviations]]

===== Bootstrap-Erweiterung =====

<WRAP center round alert 60%>
Dieses Wiki verwendet ein Bootstrap 5 -Template und eine Erweiterung zur einfachen Integration von Bootstrap-Elemente in das Wiki.
<del>...keine Bootstrap-Erweiterung und kein Bootstrap-Theme mehr, da dieses mit der derzeit aktuellen Dokuwiki-Version nicht mehr funktioniert.</del>
 --- //[[support@hadiag.com|Ralph Lindner]] 2024/04/01 11:05//
</WRAP>



==== Modal ====
Das Modal ist ein Dialogbox-Popupfenster das über der aktuellen Seite angezeigt wird (mittels Lightbox).
Siehe http://www.lotar.altervista.org/wiki/wiki/plugin/bootswrapper/modal

<btn type="primary" size="sm" modal="modal-demo">Modal mit Text und Bild</btn>
 
<modal id="modal-demo" title="Das ist der Tifel der Modal-Dialogbox">
=== Das ist der Text im Modal-Popup ===
{{ :business:projekte:lia-consulting:darkpurple-and-atlanticblue.jpg?nolink |Duis mollis, est non commodo luctus, nisi erat porttitor ligula. [...]}}
</modal>

==== Accordion ====
<accordion>
<panel title="Ein Collapsed-Panel">Wenn das erste Panel auch ausgeblendet sein soll, muss man ''collapsed="true"'' setzen.</panel>
<panel title="Tabelle in einem Accordion">
^ # ^ First Name ^ Last Name ^ Username ^
^ 1 | Mark       | Otto	     | @mdo     |
^ 2 | Jacob      | Thornton  | @fat     |
^ 3 | Larry      | the Bird  | @twitter |
</panel>
<panel type="default" title="Default Panel"> Dieses Panel ist vom type="default"</panel>
<panel title="Collapsible Group Item #1">
Anim pariatur cliche reprehenderit, enim eiusmod high life accusamus terry richardson ad squid. 3 wolf moon officia aute, non cupidatat skateboard dolor brunch. Food truck quinoa nesciunt laborum eiusmod. Brunch 3 wolf moon tempor, sunt aliqua put a bird on it squid single-origin coffee nulla assumenda shoreditch et. Nihil anim keffiyeh helvetica, craft beer labore wes anderson cred nesciunt sapiente ea proident. Ad vegan excepteur butcher vice lomo. Leggings occaecat craft beer farm-to-table, raw denim aesthetic synth nesciunt you probably haven't heard of them accusamus labore sustainable VHS.
</panel>
</accordion>

==== Buttons ====
Durch das Bootswrapper-Plugin können einfach Buttons erzeugt werden.
<code><btn type="info" icon="glyphicon glyphicon-edit">[[:wiki:welcome]]</btn></code>
erzeugt <btn type="info" icon="glyphicon glyphicon-edit">[[:wiki:welcome]]</btn>
=== Weitere Button-Beispiele: ===
  * <btn type="success" size="xs" icon="glyphicon glyphicon-edit">[[:start?do=edit| Seite bearbeiten]]</btn>
  * <btn type="info" size="sm" icon="glyphicon glyphicon-phone">[[tel>+499112879779 | Agentur Lindner anrufen]]</btn>
siehe [[http://www.lotar.altervista.org/wiki/wiki/plugin/bootswrapper/button]]

===== Caching deaktivieren =====
Um zu verhindern, dass eine Seite gecached wird, ~~NOCACHE~~ <nowiki>~~NOCACHE~~</nowiki> eintragen.

===== Interwiki =====
Um auf einfache Art Links zu Seiten anderer Webseiten einzufügen nutzt man die Interwiki-Funktion. Hierzu gibt es eine Definition in der Datei ''interwiki.conf'' im ''<dokuwiki>/conf''-Verzeichnis. Weitere Seiten können in der Datei ''interwiki.local.conf'' eingetragen werden.

<code> lusc https://lusc.de/dokuwiki/start?do=search&id={URL}</code> bewirkt dann [[lusc>RalphGL]]

Weitere Beispiele:

  * Manpage mit <nowiki>[[man>ls]]</nowiki> [[man>ls]] 
  * Debian Manpage mit <nowiki>[[debianman>man]]</nowiki> [[debianman>man]] 
  * Link zu einer Telefonnummer mit <nowiki>[[tel>+499112879779]]</nowiki> [[tel>+499112879779]]
  * Link zur deutschen Wikipedia mit <nowiki>[[wpde>wiki]]</nowiki> [[wpde>wiki]]

===== Keyboard-Tasten =====

Damit auf einfache Art und Weise Tastatur-"Tasten" im Wiki bezeichnet werden können, habe ich das Stylesheet ''userstyle.css'' im ''<dokuwiki>/conf''-Verzeichnis um folgenden Stylesheet ergänzt:

<sxh css> span.keyb {

  padding: 0.5rem;
  margin-right: 0.6rem;
  background: #EEEEEE;
  border: 1px solid black;
  box-shadow: 2px 2px 4px grey;

} </sxh>

Um nun eine Taste im Wiki darzustellen, wird das html-Tag benötigt, z. B. zeigt

<code ->
<html>
<p>Zur Darstellung der <span class="keyb">Einfg</span>-Taste und es folgt im Beispiel noch mehr Text mit noch mehr Tasten <span class="keyb">Pos 1</span><span class="keyb">X</span></p>
</html>
</code>

folgendes an:

<html><span class="keyb">Einfg</span></html>

<html>Zur Darstellung der <span class="keyb">Einfg</span>-Taste <br>
<span class="keyb">Pos 1</span> <br>
<span class="keyb">X</span> <br>
<span class="keyb">Einfg</span> <span class="keyb">Pos 1</span>  <span class="keyb">Bild ↑</span><br>
<span class="keyb">Entf</span>  <span class="keyb">Ende</span> <span class="keyb">Bild ↓</span><span " class="keyb" >⇑     </span>  <br>
</html>


===== Seitenliste =====
<pagelist&[flags]>
  * [[..:blog:|Blog Plugin]]
  * [[..:it:|jgfhjghjPlugin]]
  * [[..:editor:|Editor Plugin]]
  * [[..:tag:|Tag Plugin]]
  * [[..:wrap|Wrap Plugin|This is shown in the description cell]]
</pagelist>


===== Rich Text Editor =====

<WRAP center round alert 60%>
Das ''prosemirror plugin'' von  Andreas Gohr ist ein WYSIWYG editor für DokuWiki, funktioniert aber leider nicht fehlerfrei mit der aktuellen Dokuwiki-Version (<code>-Blöcke werden zerstört) und wurde deshalb deaktiviert.  --- //[[support@hadiag.com|Ralph Lindner]] 2020/07/09 12:27//
</WRAP>


====== Syntax-Highlighting-plugin für Code ======

<WRAP center round alert 60%>
Das Syntax-Highlighting-plugin scheint inkompatibel mit der aktuellen Dokuwiki-Version zu sein und wurde deshalb deaktiviert.
 --- //[[support@hadiag.com|Ralph Lindner]] 2020/07/09 12:21//
</WRAP>

<sxh htmlScript; highlight: [10-13]; title: New title attribute in action>
    /**
     * Render xhtml output or metadata
     *
     * @param string         $mode      Renderer mode (supported modes: xhtml)
     * @param Doku_Renderer  $renderer  The renderer
     * @param array          $data      The data from the handler() function
     * @return bool If rendering was successful.
     */
    public function render($mode, Doku_Renderer &$renderer, $data) {
        if($mode != 'xhtml') return false;

        if (count($data) != 3) {
            return true;
        }

        list($syntax, $attr, $content) = $data;
        if ($syntax == 'sxh') {
            $title = $this->procTitle($attr);
            $highlight = $this->procHighlight($attr);
            $renderer->doc .= '<pre class="brush: ' . strtolower($attr . $highlight) . '"' . $title . '>' . $renderer->_xmlEntities($content) . '</pre>';
        } else {
            $renderer->file($content);
        }

        return true;
    }

</sxh>
===== Syntax Highlightning =====
  * https://github.com/crazy-max/dokuwiki-plugin-syntaxhighlighter4

===== Sidebar mit Unterseitenmenü =====
  * https://www.dokuwiki.org/faq:sidebar
  * Für dieses Wiki ist die Sidebar grundsätzlich aktiviert
  * Wenn die Sidebar für einen Workspace deaktiviert werden soll muss einfach für diese Seite ''<URL>/doku.php?id=sidebar'' editiert und die Inhalte gelöscht werden.


===== Tagcloud =====

=> [[wiki:tag-cloud]]

===== Text in Spalten mit Plugin =====

<spaltenbreite 100% 50% 25% ->
Die erste Zahl hinter spaltenbreite gibt die Gesamtbreite des Spaltenbereichs auf der Seite an. 
Danach folgen die Angaben über den Anteil der Spalte am zur Verfügung stehenden Raum. In diesem Fall sind das 50%  von einem 100% breiten Spaltenbereich. aldfsld jflsflshflkjfl shdljf slfgnlxdf lksngs lgksnlg nslfg sflsj lksfg lsjdlfg shfdlg shflghfsdlg hsdflgslfdgn slf nslfg slfdgn sfldg ldsfg sljfd lsfgd aldfsld jflsflshflkjfl shdljf slfgnlxdf lksngs lgksnlg nslfg sflsj lksfg lsjdlfg shfdlg shflghfsdlg hsdflgslfdgn slf nslfg slfdgn sfldg ldsfg sljfd lsfgd h.
<spaltenumbruch>
Darauf folgt eine Spalte mit einem viertel der gesamten Fläche, also 25% der Gesamtbreite. aldfsld jflsflshflkjfl shdljf slfgnlxdf lksngs lgksnlg nslfg sflsj lksfg lsjdlfg shfdlg shflghfsdlg hsdflgslfdgn slf nslfg slfdgn sfldg ldsfg sljfd lsfgd h.
<spaltenumbruch>Dies ist letzte Spalte, da hierfür kein Wert eingegeben wurde, muss sie den Platz ausfüllen, der ihr noch bleibt - eben nochmal 25%. aldfsld jflsflshflkjfl shdljf slfgnlxdf lksngs lgksnlg nslfg sflsj lksfg lsjdlfg shfdlg shflghfsdlg hsdflgslfdgn slf nslfg slfdgn sfldg ldsfg sljfd lsfgd h.
</spaltenbreite>

===== Buttons für Dokuwiki =====
Diese Buttons sind überholt und werden zukünftig nicht mehr verwendet. Stattdessen werden Buttons wie oben beschrieben per Bootstrap generiert.
  * <del>so geht´s: https://www.dokuwiki.org/Smileys in ''./wiki/conf/smileys.local.conf'' anlegen und Buttons nach ''./wiki/lib/images/smileys/local'' kopieren.</del>
  * <del>[[https://dabuttonfactory.com/#t=Achtung!&f=Open+Sans-Bold&ts=14&tc=fff&hp=18&vp=7&c=5&bgt=gradient&bgc=f00&ebgc=900&it=png | Achtung-Button ]] :ACHTUNG:</del>
  * <del>[[https://dabuttonfactory.com/#t=WICHTIG&f=Open+Sans-Bold&ts=14&tc=fff&hp=18&vp=7&c=5&bgt=gradient&bgc=6fa8dc&ebgc=00f&it=png | Wichtig-Button ]]  :WICHTIG:</del>
  * <del>[[https://dabuttonfactory.com/#t=FIXME&f=Open+Sans-Bold&ts=14&tc=444&hp=18&vp=7&c=5&bgt=gradient&bgc=ff0&ebgc=f1c232&it=png | FIXME-Button ]] :FIXME:</del>
  * <del>[[https://dabuttonfactory.com/#t=velt.biz&f=Open+Sans-Bold&ts=14&tc=900&hp=18&vp=7&c=5&bgt=gradient&bgc=f3f3f3&ebgc=cbcbcb&it=png | Sven fragen... ]] :SVEN:</del>

===== Kurztasten (Hotkeys) =====
Kurztasten kombiniert man unter Windows mit ''Alt'' (bzw. ''Umschalt+Alt''), also z. B. ''Alt+1'' um eine Überschrift erster Ebene zuzuweisen.

Positioniert man den Mauszeiger über den Formatierungs-Knöpfen des DokuWiki Editorfensters, werden die jeweiligen Kurztasten angezeigt.
  * [[https://www.dokuwiki.org/accesskeys | Dokuwiki-Dokumentation zu Kurztasten]]

===== Seitenliste (manuell erstellte Tabelle mit Link zu Seiten) =====
<pagelist&nodate&nocomments&tags&header&nosort>
  * [[:start:| Startseite : | Nicht-Öffentliche Startseite]]
  * [[:wiki:dokuwiki:||Dokumentation der Dokuwiki-Software]]
  * [[:wiki:syntax:]]
  * [[..:tag:|Tag Plugin| In diesem Wiki verwendete Schlagworte]]
  * [[..:business:design#buttons_fuer_dokuwiki || Buttons für DokuWiki anlegen]]
</pagelist>


==== Zugriffsprobleme aufs Wiki ====
Anmelden nicht möglich? Passwort vergessen?
  * https://www.dokuwiki.org/faq:forgotten_password

==== Datentabellen ====

<datatables paging-type="simple" scroll-y="200px">
^ Column A ^ Column B ^ Column C ^
| Row A1   | Row B1   | Row C1   |
| Row A2   | Row B2   | Row C2   |
| Row A2   | Row B2   | Row C3   |
</datatables>

{{tag>dokuwiki wiki syntax tag buttons documentation}}

====== Dokumentation unseres Wiki ======

  * [[wiki:dokuwiki|Offizielle DokuWiki-Dokumentation]]
  * [[wiki:syntax|Wiki-Syntax]]
  * [[wiki:welcome|Welcome-Seite]]