Start presentation

Slide 1: Einleitung

Slide 2: Warum ein neues Wiki?

bis Dezember 2013 Uralt-Installation Twiki auf LxWww01
  • eingeschränkte Funktionalität
    (diverse Begehrlichkeiten zur Aktualisierung)
  • Webserver gehackt
    (Einfallstor nicht weiter untersucht)

Slide 3: Warum nimmst'n nicht ... Teil 1

Bisher wurde Twiki verwendet:
  • steht unter GPL
  • überwiegend in Perl programmiert
  • braucht keine Datenbank
  • verwendet Versionsverwaltung (RCS)
  • granulare Zugriffskontrolle
  • erweiterbar durch zahlreiche Plugins
  • verwendet u.a. von Nokia, IBM, [ZENSUR]

Slide 4: Warum nimmst'n nicht ... Teil 2

Warum jetzt Foswiki?
  • Ableger von Twiki, weil Twiki-Entwickler Peter Thoeny „böse“ wurde
  • quasi identische Eigenschaften wie Twiki
    (wenn auch z.T. etwas weniger aktuell)
  • Debian-Pakete verfügbar smile

Slide 5: Warum nimmst'n nicht ... Teil 3

Und warum nicht Mediawiki?
  • steht unter GPL
  • überwiegend in PHP programmiert
  • verwendet MySQL (alternativ PostgreSQL, [ZENSUR], SQlite)
  • verwendet Versionsverwaltung
  • rudimentäre Zugriffskontrolle dead!
  • prinzipiell erweiterbar
  • verwendet u.a. von Wikipedia


genauere Informationen und Vergleiche auf http://www.wikimatrix.org/

Slide 6: interne Struktur

vorher:
  • diverse Wikis als virtuelle Apache-Instanzen auf einer Hardware (lxwww01)
  • Zugriffe nur unverschlüsselt (http)
    (Ausnahme wiki.gsi.de auch mittels https)
  • Betriebssystem verwaltet mit cfengine, Wiki-Konfiguration handgedengelt
  • weitere Dienste auf lxwww01 (www-aix (Sudoku-Solver), Forum, Subversion)

jetzt:
  • jedes Wiki als eigene VM (derzeit lxwww22…lxwww33)
  • Zugriffe nur verschlüsselt (https)
  • System und Wiki-Basiskonfiguration verwaltet mit CHEF

Slide 7: wesentliche Änderungen

info steht alles im Wiki (WikiTipsDe)


Abmelde-Funktion
  • mit Hilfe des Links »Ausloggen« in der oberen Ecke der Seitenleiste

WYSIWYG-Editor
  • per Voreinstellung WYSIWYG-Editor (TinyMCE)
    (nicht mit einigen Versionen des Internet Exploders)
  • Umschalten auf klassischen Textmodus per Schaltfläche oder Menüpunkt Editieren Wikitext

Übersicht der Wiki-Webs
  • ohne Anmeldung nur öffentliche Webs sichtbar
  • nach Anmeldung auch Webs mit Zugriffsbeschränkung sichtbar

Slide 8: bekannte Probleme

persönliche Seite
  • Umstellung der Benutzerseiten → persönliche Anpassungen gingen verloren
  • jetzt mit UserForm als Vorlage

HolidayList-Plugin

Slide 9: benutzerseitige Anpassungen Teil 1

WYSIWYG-Editor abschalten
<!--
   * Set NOWYSIWYG = 1
-->

Erscheinungsbild anpassen

Änderungsinformationen einholen
  • Eintrag in WebNotify des entsprechenden Webs

Slide 10: Benutzerverwaltung

noch immer eigene Benutzerverwaltung (keine Kopplung an Weblogin, LDAP, …)

Slide 11: Gruppenverwaltung

Gruppen werden auf Zuruf von AdminGroup angelegt
  • Mitgliederverwaltung normalerweise durch alle Gruppenmitglieder
  • Übersicht aller Gruppen: WikiGroups
  • Topic muß nicht mehr direkt editiert werden (* Set GROUP = Hund, Katze, Maus)
    • Benutzer hinzufügen und entfernen per Aktion
    • Empfehlung: alten Bestand mit »Gruppen-Topic auf neuesten Stand bringen...« übernehmen, dann alte Einträge wegwerfen

ALERT! Vorsicht bei voreiliger Aufnahme nicht existenter Benutzer! (siehe TestGroup)

Slide 12: Rechteverwaltung

falls gewünscht, lassen sich Zugriffsrechte einschränken

  • global für Wiki-Web in WebPreferences
  • individuell auf jeder Wiki-Seite

verfügbare Parameter:
   * Set ALLOWTOPICCHANGE = Main.StefanHaller,Main.ChristianWolbert
   * Set ALLOWTOPICVIEW = 

mögliche Stolpersteine:
  • mehrere Definitionen auf einer Seite wink
  • in zugriffsbeschränkten Webs lassen sich Rechte einzelner Seiten nicht erweitern, sondern nur weiter einschränken

Slide 13: Seitenverwaltung

neue Seiten anlegen:
  • auf bestehender Seite WikiWort eintragen, dann anklicken
  • in URL neuen Seitennamen hinschreiben
  • im »Sandkasten« per Schaltfläche »Neues Topic anlegen«

bestehende Seiten manipulieren:
  • Inhalt verändern mit Schaltfläche »Editieren« oder Links am Seitenende
  • Verschieben/Löschen/Umbenennen mit »Mehr Topic-Aktionen« am Seitenende


guggstu TwentyMinuteTutorial sowie ManagingTopics

Slide 14: Formatierung: Schrift

  • fette Schrift mit *Sternchen*
  • kursive Schrift mit _Unterstrichen_
  • unproportionale Schrift mit =Gleichheitszeichen=
  • bunte Schrift mit %FARBE%Text%ENDCOLOR%
  • unformatierten Text einschließen in
    <verbatim> ... </verbatim>
  • alle HTML-Zeichen erlaubt (siehe z.B. SelfHTML), etwa: → ® ϖ


guggstu WikiSyntax sowie TextFormattingRules

Slide 15: Usertipp: Hervorhebung von Textpassagen

  • Mittels <blockquote> ... </blockquote> oder <verbatim> ... </verbatim>
  • Innerhalb von <verbatim> keine Macroausführung und größerer Rahmenabstand!
  • Blockquote:
    TIP hier kommt ein quotierter Block
  • Verbatim:
     %T% hier kommt ein %RED%quotierter%ENDCOLOR% Block 

  • Hintergrundfarbe ist standardmäßig grau. Über die Klassendefinition (foswikiHelp) kann auch Hellbau gewählt werden. <blockquote class="foswikiHelp">
    TIP hier kommt ein quotierter Block mit farbigen Hintergrund
  • Andere Farben mit Stylesheetüberschreibung: <blockquote style="background-color: #FFE4E1;">
    TIP hier kommt ein quotierter Block mit farbigen Hintergrund

Slide 16: Formatierung: Überschriften, Absätze, Verknüpfungen

  • sechs Überschriftsebenen;
    festlegen mit ---+ (1. Ebene) bis ---++++++ (6. Ebene)
    alternativ numeriert mit ---# (1. Ebene) bis ---###### (6. Ebene)
  • Absätze mit Leerzeile trennen;
    Zeilenumbruch mit %BR% erzwingen
  • Links automatisch durch WikiWord oder manuell mit eckigen Klammern:
    [[http://www.domain.tld][Beschreibung des Links]]
    

info bei Wiki-Links in andere Webs Ebenen mit Punkt trennen, z.B. System.WebHome

info Kapitel in Wiki-Seiten können direkt angesprungen werden, z.B. System.WikiSyntax#Internal_and_external_links

Slide 17: Formatierung: Aufzählungen

unsortierte Aufzählungen mit mehreren Ebenen:
  • drei Leerzeichen, Sternchen, Leerzeichen, Text
  • weitere Ebenen mit je drei weiteren führenden Leerzeichen:
    • sechs Leerzeichen
      • neun Leerzeichen
  • und wieder drei Leerzeichen

sortierte Aufzählungen mit mehreren Ebenen:
  1. drei Leerzeichen, Ziffer, Leerzeichen, Text
  2. weitere Ebenen mit je drei weiteren führenden Leerzeichen
    1. Unterpunkt
    2. noch ein Unterpunkt
  3. Ziffer ist egal (wird automatisch gesetzt)

  1. Leerzeilen in Aufzählungen durchbrechen Numerierung ALERT!


guggstu WikiSyntax#Bullet_and_numbered_lists und TextFormattingRules

Slide 18: Formatierung: Tabellen

  • Spalten mit | trennen
  • mehrere Spalten mit mehreren || zusammenfassen
  • mehrere Zeilen mit ˆ zusammenfassen
  • Text in Überschrift mit Sternchen versehen
  • Sortierung durch Klick auf Überschrift

bli bla blubb
Hund Katze Maus
Apfel Birne
Kirsche Pflaume
Lavendel Oleander Jasmin

info Anzahl der Leerzeichen zwischen Trennlinien und Text beeinflußt Textausrichtung

Slide 19: Usertipp: Dynamische Tabellen mit Edittable-Plugin

  • Datumsfelder, Checklisten, Automatischer Wikinamen, DropDown-Listen
    %TABLE% %EDITTABLE{ header="|*Datum*|*Name*|*Wochentag*|*Wunsch*|" format="|date,15,,$percntY-$percntm-$percntd | text,30,Main.%WIKINAME% | checkbox, 10, Mo, Di, Mi, Do, Fr | select, 1, Apfel, Banane, Orange |"}%

  • Beispiel
Datum Name Wochentag Wunsch
2014-04-10 ChristianWolbert Mo , Di Apfel

Slide 20: Ein Bild ...

… sagt mehr als tausend Worte.

mögliche Bildquellen für Symbole

weitere Bildquellen

Slide 21: Macros (Wiki-Variablen)

  • jede Menge Macros (Wiki-Variablen) zur einfachen Gestaltung von Wiki-Seiten
  • stets in Prozentzeichen eingeschlossen, z.B. %TOPIC%
  • eigene Definitionen mittels * Set MACRONAME = irgendwas möglich

ein paar ausgewählte Beispiele:

Makro Bedeutung
%AQUA% legt Textfarbe fest
%BR% erzeugt Zeilenumbruch
%CODE% Sprache für Syntax-Highlighting im BeautifierPlugin
%DATE% wird durch aktuelles Datum ersetzt, also 2017-10-16
%ENDCOLOR% schließt Textfarbe ab
%GROUPS% erzeugt Liste aller Wiki-Gruppen
%HOLIDAYLIST% erzeugt Abwesenheitsliste
%ICON{"name"}% bindet die Symbolgrafik "name" ein
%INCLUDE{"link"}% bindet die angegebene Seite (URL oder WikiWord) ein
%N% zeigt das Symbol "NEW" an, also NEW
%PUBURL% steht für die URL von Anhängen, hier https://wiki.gsi.de/foswiki/pub
%SEARCH{"text"}% durchsucht Topics nach Zeichenkette "text"
%TOC% generiert Seiteninhaltsverzeichnis aus Überschriften
%WIKINAME% Name des Wikibenutzers, also WikiGuest (Ersatz für %USERNAME%)
%WIKIUSERNAME% Name des Wikibenutzers mit %USERSWEB%-Präfix, also WikiGuest


guggstu System.Macros

Slide 22: Erweiterung durch Plugins

zahlreiche Erweiterungen für Foswiki
  • Installation und Aktivierung duch Administrator
  • Verwendung durch alle Benutzer
  • Übersicht der installierten Erweiterungen unter InstalledPlugins

ein paar ausgewählte Beispiele:

Plugin Funktion
ActionTrackerPlugin Aktionsverfolgung mit automatischer Benachrichtigung
BlackListPlugin verdächtige Clients aussperren
CalendarPlugin Monatskalender bereitstellen
GenPDFAddOnPlugin Wiki-Topics als PDF exportieren
InterwikiPlugin Links zu anderen Webseiten, z.B. OTRS, trac, …

Slide 23: Plugin-Beispiel: Kommentare einfügen

CommentPlugin erlaubt Einfügen von Kommentaren ohne direktes Editieren der Seite


01 Apr 2014 - 11:11 StefanHaller: Uffbasse!

April, April!

Slide 24: Plugin-Beispiel: Skripte darstellen

BeautifierPlugin erlaubt Syntax-Highlighting für verschiedene Programmiersprachen

#!/bin/bash
# Author: Dr. N.E. Anderthaler
# Purpose: show other remote-logins

MYTERM=$(tty)
who -u | grep -vw  "${MYTERM##/dev/}" |nawk '$7 ~ /\([^:]/ {print $1 " <-> " $NF}'

Slide 25: Plugin-Beispiel: Tabellenkalulation

SpreadSheetPlugin für einfache Tabellenkalkulationen mit CALC

Kostenstelle Betrag Typ
1940 800 Invest
1940 800 Invest
1941 3000 Sach
1910,5 300 Invest
Total 4900 Invest: 3
Sach: 1

  • Letzte Zeile
     | Total |  %CALC{"$SUM($ABOVE())"}% |  %CALC{"$COUNTITEMS( R2:C3..R$ROW(-1):C3 )"}% | 
  • Werte in Variablen speichern mit CALC:
     %CALC{"$SET(total, $SUM( $ABOVE() )"}% | %CALC{"$GET(total)"}%

Slide 26: Plugin-Beispiel: Abwesenheitsliste

 
Name
arrow_leftarrow_right
OctNov
We
11
Th
12
Fr
13
Sa
14
Su
15
Mo
16
Tu
17
We
18
Th
19
Fr
20
Sa
21
Su
22
Mo
23
Tu
24
We
25
Th
26
Fr
27
Sa
28
Su
29
Mo
30
Tu
31
We
1
Th
2
Fr
3
Sa
4
Su
5
Mo
6
Tu
7
We
8
Th
9
AnnaSusanna                              
ChristianWolbert                              
StefanHaller                              
Legende: cool! - Urlaub thumbs up - Gleittag indifferent - Dienstreise dead! - krank frown - Palaver vamp.png - untot

Urlaub

Gleittag

Palaver

krank

Geistig abwesend

Slide 27: benutzerseitige Anpassungen Teil 2

Erstellung einer persönlichen Seitenleiste (WikiGuestLeftBar):
  • Gruppenmitgliedschaft und eigene Seiten per %SEARCH% suchen
  • Suchergebnisse und statische Einträge mit TreeBrowserPlugin darstellen
<div style="background-color: lightyellow;" >
%TREEBROWSER{"home" title=" *wiki.gsi.de*" shared="klick"}%
   * meine Gruppen
%SEARCH{"*GROUP.*%USERNAME%" regex="on" web="%MAINWEB%" nonoise="on" topic="*Group" format="      * %MAINWEB%.$topic"}%
   * meine Seiten
%SEARCH{"name=\"%WIKIUSERNAME%" web="Personalpages"  nosearch="on" noheader="on" nototal="on" format="      * $web.$topic"}%
   * wichtige Seiten
      * [[WebSearch][Wiki-Suche]]
      * [[Linux.WebHome][Linux-Web]]
      * [[LXadmin.WebHome][LXadmin-Web]]
      * [[IT.AbwesenheitsListe][IT-Abwesenheitsliste]]
      * [[System.DocumentGraphics][Wiki-Grafiken]]
      * [[http://kino-langen.de/index.php?show=week][Kinoprogramm Langen]]
<a class="foswikiSmallish" href="javascript: klick.openAll();">[alles auf]</a> &nbsp; <a  class="foswikiSmallish" href="javascript: klick.closeAll();">[alles zu]</a>&nbsp;
<a class="foswikiSmallish" href="%SCRIPTURLPATH{"edit"}%/%WEB%/%TOPIC%?t=%GMTIME{"$epoch"}%">[edit]</a>
</div>

Slide 28: Ausblick

Was bleibt noch zu tun?
  • Benutzerverwaltung/Authentifizierung umstellen
  • verbliebene Problemchen reparieren
  • kosmetische Korrekturen (GSI-Skin?)

Slide 29: Ich habe fertig.

QUESTION? Fragen?

info Anmerkungen?

REFACTOR Korrekturen?

food Kantine?

-- StefanHaller, ChristianWolbert - März…April 2014
Topic attachments
I Attachment Action Size Date Who Comment
vamp.pngpng vamp.png manage 1.2 K 2015-03-05 - 10:09 StefanHaller Vampir-Gesicht
Topic revision: r3 - 2015-03-05, StefanHaller
 
This site is powered by FoswikiCopyright &© by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Ideas, requests, problems regarding GSI Wiki? Send feedback