Struktur des Hilfe-Servers

1. Implementation auf dem Server

Das Wiki ist rein dateisystembasiert und liegt derzeit an der Uni Osnabrück auf einem virtUOS-Server. Alle Dateisystempfade, die hier verwendet werden, beziehen sich relativ auf das Wurzelverzeichnis der Installation.

Ein Einzelwiki besteht aus folgenden Komponenten

/cookbook/
Erweiterungen/Plugins, nur einmal installiert
/local/
Konfiguration, nur einmal vorhanden
/pub/
Skins, CSS-Dateien, etc., nur einmal vorhanden
/uploads/
Hochgeladene Dateien, nur zweimal vorhanden (s.u.)
/wiki.d/
Inhalte des Wikis (i.d.R. für jedes Wiki vorhanden)
wikiconf.ini
Konfiguration pro Wiki, wird vom Admin-Interface geschrieben und von local/config.php gelesen
pmwiki.php
Haupt-Wikidatei
index.php
Verweis auf pmwiki.php

2. Nutzer-Authentifizierung

Derzeit wird leider noch die Wiki-interne Authentifizierung verwendet, die Admin-Nutzer über den Link "Benutzerverwaltung" erreichen. Es gibt keine Wiki-spezifischen Nutzerrechte, alle Rechte werden global vergeben.

3. Verzeichnisstruktur

Eine vollständige Liste aller eingerichteten Wikis bekommt ein Nutzer mit Adminrechten, wenn er im Wurzelwiki auf "Admin" klickt.


docs.studip.de - Startseite, AuthUser
|
|--- /meta - Hilfe zur Hilfe
|
|--- /admin - Hilfe für Systemadministratoren und Betreiber
|
|--- /develop - Hilfe für Entwickler
|
|--- /template-new - Vorlage für neue Wikis
|
|-- /help
      |
      |-- 2.0 - Hilfe für 2.0 enthält die deutschen Inhalte
      |    |
      |    |=== /de - keine eigenen Inhalte
      |    |      |
      |    |      |=== /ugoe - standortspez. Sicht Göttingen
      |    |      |=== /uhb - standortspez. Sicht Bremen
      |    |      |=== /uos - standortspez. Sicht Osnabrück
      |    |
      |    |=== /en - englische Hilfeseiten
      |    |      |
      |    |      |=== /ugoe - standortspez. Sicht Göttingen
      |    |      |=== /uhb - standortspez. Sicht Bremen
      |    |      |=== /uos - standortspez. Sicht Osnabrück
      |
      |-- 2.1
      |    |
      |    |=== /de - keine eigenen Inhalte
      |    |      |
      |    |      |=== /ugoe - standortspez. Sicht Göttingen
      |    |      |=== /uhb - standortspez. Sicht Bremen
      |    |      |=== /uos - standortspez. Sicht Osnabrück
      |    |
      |    |=== /en - englische Hilfeseiten
      |    |      |
      |    |      |=== /ugoe - standortspez. Sicht Göttingen
      |    |      |=== /uhb - standortspez. Sicht Bremen
      |    |      |=== /uos - standortspez. Sicht Osnabrück
      |
      |-- 2.2
      |    |
      |    |=== /de - keine eigenen Inhalte
      |    |      |
      |    |      |=== /ugoe - standortspez. Sicht Göttingen
      |    |      |=== /uhb - standortspez. Sicht Bremen
      |    |      |=== /uos - standortspez. Sicht Osnabrück
      |    |
      |    |=== /en - englische Hilfeseiten
      |    |      |
      |    |      |=== /ugoe - standortspez. Sicht Göttingen
      |    |      |=== /uhb - standortspez. Sicht Bremen
      |    |      |=== /uos - standortspez. Sicht Osnabrück


Legende:

=== - erbt Inhalte des Mutterwikis

-- - erbt keine Inhalte des Mutterwikis

4. Upload-Verzeichnisse

Es hat nicht jedes Wiki ein eigenes Upload-Verzeichnis. Grund: Vererbungsmechanismus funktioniert nicht mit Uploads. Deshalb gibt es ein (in Wahrheit: mehrere) Upload-Verzeichnis für alles.

Damit es nicht zu Problemen kommt, können einmal hochgeladene Dateien nicht mehr überschrieben werden.

Insgesamt gibt es zwei Upload-Verzeichnisse:

  • Ein zentrales deutsches Upload-Verzeichnis, das von allen deutschen Hilfe-Seiten verwendet wird. (/docs.studip.de/uploads, realisiert im Dateisystem durch symbolische Links)
  • Ein zentrales englisches Upload-Verzeichnis, das von allen englisches Hilfe-Seiten verwendet wird. (/docs.studip.de/uploads-en, realisiert im Dateisystem durch symbolische Links)

5. Workflow: Neue Version anlegen

Für jede neue Stud.IP-Version muss ein neuer Zweig der Anwender-Hilfe unter /help erzeugt werden. Das kann derzeit nur per Shell-Zugriff auf den Server passieren.

Schritte:

  1. Alten Baum kopieren cd /help; cp -a 2.1 2.2
  2. .htaccess-Dateien anpassen: cd 2.2; find . -name .htaccess -exec sed -i 's/2\.1/2.2/g' {} \;
  3. wikiconf.ini-Dateien anpassen: cd 2.2; find . -name wikiconf.ini -exec sed -i 's/2\.1/2.2/g' {} \;

Letzte Änderung am 07.04.2011 14:15 Uhr von tthelen.

 
 

Hilfe zur Hilfe

Hier finden Sie Dokumentation für Hilfeautoren zum Stud.IP-Dokumentationswiki.

(c) Stud.IP e.V. und die Autoren der Stud.IP-Dokumentation.
Dieser Text ist unter der Lizenz "Creative commons Attribution/Share Alike" verfügbar.