Bedienung

Allgemein

Diese Website ist in erster Linie zur Information gedacht. Das heißt aber nicht, dass Du daran nichts ändern könntest. Sollten Inhalte inaktuell werden, willst Du neues hinzufügen oder News verfassen, so logge Dich mit Deinen Benutzerdaten ein. Es sei Dir dabei ans Herz gelegt, dass Deine Änderungen behutsam und aufrichtig geschehen müssen. Weil alle Texte einen Urheber haben, solltest Du Rücksicht auf Seine Arbeit nehmen und überlegt darin ›herumstreichen‹. Gut ist auch, wenn Du Deinem eigenen Text (D)einen Namen gibst.

Struktur

Wie in jeder Wiki findest Du auch in dieser Namensräume, was Du mit Ordnern gleichsetzen könntest. Die Seitenstruktur wird vielleicht etwas besser in der Übersicht deutlich. Namensräume trennst Du mit Doppelpunkten bzw. in der Adressleiste mit Schrägstrichen. Namensräume sind in erster Linie für Links innerhalb unserer Website wichtig.

Texte editieren

So ziemlich alle Seiten sind editierbar. Das ist gar nicht mal schwer. Die Auszeichnungsmöglichkeiten sind aus der Syntaxbeschreibung ersichtlich.

Seiten hinzufügen

Willst Du eine neue Seite einfügen, so lege zuerst einen Link dazu auf einer bestehenden Seite an:

  [[namensraum:unternamensraum:seite|Linktext]]

Dann speichere den Entwurf und klicke auf den rotgefärbten Link. Dann auf ›Seite anlegen‹ und Du kannst wie gewohnt editieren.

Bilder und Dateien hochladen

Ein Bild oder eine Datei hochzuladen ist ganz leicht. Einfach im Editiermodus das Bildsymbol (4tes von rechts) anklicken und dann das Bild in den aktuellen Namensraum hochladen. Bitte beachte, dass nicht jedes Dateiformat akzeptiert wird. Sollte es mal nicht klappen, schicke eine Beschwerde an den Administrator oder erstelle ein zip-Archiv.

Kommentarfunktion

Du kannst grundsätzlich auf jeder Seite kommentieren. Die Funktionalität lässt sich aber auch gezielt ein- und ausschalten.

  ~~DISCUSSION~~
  ~~DISCUSSION:off~~

Im eingeloggten Zustand wird gleich der richtige Name übernommen. Wenn Du aber lieber anonym kommentieren möchtest, kannst Du das natürlich auch gern tun.

Inhaltsverzeichnis

Das automatisch generierte Inhaltsverzeichnis lässt sich auch ausschalten:

  ~~NOTOC~~

Einfügen von inc/parser/xhtml.php

function internalmedia(..)

EXIF-Daten als Bildunterschrift

    /**
     * Renders internal and external media
     *
     * @author Andreas Gohr <andi@splitbrain.org>
     */
    function _media ($src, $title=NULL, $align=NULL, $width=NULL,
                      $height=NULL, $cache=NULL, $render = true) {
 
        $ret = '';
 
        list($ext,$mime,$dl) = mimetype($src);
        if(substr($mime,0,5) == 'image'){
            // first get the $title
            if (!is_null($title)) {
                $title  = $this->_xmlEntities($title);
            }elseif($ext == 'jpg' || $ext == 'jpeg'){
                //try to use the caption from IPTC/EXIF
                require_once(DOKU_INC.'inc/JpegMeta.php');
                $jpeg =& new JpegMeta(mediaFN($src));
                if($jpeg !== false) {
                  $cap = $jpeg->getTitle();
                  if($cap){
                      $title = $this->_xmlEntities($cap);
                  }
                  $desc = $jpeg->getField(array('Exif.TIFFImageDescription','Exif.TIFFUserComment','Exif.UserComment','Iptc.Caption'));
                  if($desc){
                    $desc = $this->_xmlEntities($desc);
                  }
                }
            }
            if (!$render) {
                // if the picture is not supposed to be rendered
                // return the title of the picture
                if (!$title) {
                    // just show the sourcename
                    $title = $this->_xmlEntities(basename(noNS($src)));
                }
                return $title;
            }
 
            //add image tag
            $ret .= '<table class="media'.$align.'">'.
                        '<caption align="bottom">'.$desc.'</caption><tr><td>';
            $align = '';
            $ret .= '<img src="'.ml($src,array('w'=>$width,'h'=>$height,'cache'=>$cache)).'"';
            $ret .= ' class="media'.$align.'"';
 
            // make left/right alignment for no-CSS view work (feeds)
            if($align == 'right') $ret .= ' align="right"';
            if($align == 'left')  $ret .= ' align="left"';
 
            if ($title) {
                $ret .= ' title="' . $title . '"';
                $ret .= ' alt="'   . $title .'"';
            }else{
                $ret .= ' alt=""';
            }
 
            if ( !is_null($width) )
                $ret .= ' width="'.$this->_xmlEntities($width).'"';
 
            if ( !is_null($height) )
                $ret .= ' height="'.$this->_xmlEntities($height).'"';
 
            $ret .= ' />';
            $ret .= '</td></tr></table>';
 
        }elseif($mime == 'application/x-shockwave-flash'){
            if (!$render) {
                // if the flash is not supposed to be rendered
                // return the title of the flash
                if (!$title) {
                    // just show the sourcename
                    $title = basename(noNS($src));
                }
                return $this->_xmlEntities($title);
            }
 
            $att = array();
            $att['class'] = "media$align";
            if($align == 'right') $att['align'] = 'right';
            if($align == 'left')  $att['align'] = 'left';
            $ret .= html_flashobject(ml($src,array('cache'=>$cache)),$width,$height,
                                     array('quality' => 'high'),
                                     null,
                                     $att,
                                     $this->_xmlEntities($title));
        }elseif($title){
            // well at least we have a title to display
            $ret .= $this->_xmlEntities($title);
        }else{
            // just show the sourcename
            $ret .= $this->_xmlEntities(basename(noNS($src)));
        }
        return $ret;
    }

Einfügen von inc/html.php

function html_edit(...)

Eine Marke eingefügt, um das Ende des Editierungsformulars anzuzeigen.

...
        </div>
      <?php }?>
    </div>
  </form>
  </div>
  <!-- edit_area_end --!>
<?php
}

Von Richard Weickelt