EsPresto.org

Mittwoch, 29. Februar 2012

Schritt 1

Eine Seite im Wiki anlegen, die so aussieht, wie das zukünftige Template aussehen soll. Den genauen Namen merken bzw. kopieren.

Schritt 2

In "Wiki administrieren" Menüpunkt "Content Templates" auswählen. Dabei darf bei "Page Name" nicht der selbe Name gewählt werden, wie bereits in Schritt 1 gewählt wurde. Am Besten die Seite "Seitenname" nennen und das dazugehörige Template "Seitenname_Template".

Wenn man jetzt auf "Create" geht, ist im Feld "Template to use" der Name einzugeben, den man sich bei Schritt 1 gemerkt hat "Bereich.Seitenname". Dabei auf Groß- und Kleinschreibung achten. Bereich und Seite sind mit "." zu trennen. Wenn XWiki als Space angegeben wurde, steht das Template im kompletten Wiki zur Verfügung. Ansonsten kann man genau den Bereich angeben, in dem es zur Verfügung stehen soll. Wichtig ist hier auch, dass man unter "" einen Namen eingibt. Das ist die Bezeichnung unter der man später das Template aufrufen kann.

Schritt 3

Im Menüpunkt "Add -> Page" gelangt man nun in ein Zwischenmenü, das fragt, ob man eine normale Seite erstellen möchte oder ein Template auswählen möchte.

Dienstag, 08. November 2011

Word-Dokumente ins Wiki importieren (XWiki)

Da man ein Wiki nie leer starten sollte, stellt sich die Frage, mit welchen Inhalten man beginnt. Sich intensiv damit auseinanderzusetzen was geeigenete Inhalte sein könnten, ist eine der zentralen Erfolgskriterien beim Start eines Wikis.
Auch ist es oft mühsam alle Inhalte händisch und neu anzulegen. Ein Weg unkompliziert bereits vorhandene Inhalte in ein Wiki zu bekommen, ist der Import von Word-Dokumenten.

Wie funktioniert das?
Um ein Dokument zu importieren, geht man oben links unter "ERSTELLEN" auf "Seite aus Office-Dokument".

Im nächsten Zwischenschritt, geben Sie Ihre Dokumentenquelle an, den Seitennamen und legen fest in welchem Bereich die neu generierte Seite entstehen soll.

Enthält Ihr Dokument Formatierungen, vergessen Sie nicht den Haken bei "Stile filtern" zu setzen. Sonst werden die bestehenden Formatierungen nicht übernommen. Die erzeugte Wiki-Seite sieht dann nicht gut aus.

Wenn Sie jetzt "IMPORTIEREN" wählen, wird die Seite erstellt.

Das Ergebnis können Sie sich gleich anschauen. Probleme kann es geben, wenn Ihr Dokument Sonderzeichen enthält. Sie sollten diese vorher löschen und erst dann eine Seite erzeugen. Sonderzeichen können von XWiki im Allgemeinen nicht verarbeitet werden.

DOC- und ODT-Endungen konvertiert XWiki problemlos. Leider funktioniert der Import bei anderen Formaten (noch?) nicht. Voraussetzung für den Import ist, dass ein OpenOffice-Server aufgesetzt ist. Je nach XWiki-Version ist der Ort, an dem die "Seite aus Office-Dokument erstellen" Funktion an einer anderen Stelle. Der oben beschriebene Fall illustiert XWiki Version 3.1.

Dienstag, 01. November 2011

Ein Wiki in mehreren Sprachen

Wenn Menschen an verschiedenen Orten gemeinsam an einem Projekt arbeiten, eignet sich meist ein Wiki besonders gut für die Zusammenarbeit. Dies ist insbesondere auch dann der Fall wenn diese Orte in verschiedenen Ländern liegen, denn die meisten Wiki-Softwarelösungen bieten das Feature Mehrsprachigkeit an.

Auch XWiki bietet bereits seit einigen Jahren die Möglichkeit Wiki-Seiten parallel in mehreren Sprachen anzulegen.

Mit Version 3.1. ist das Ganze noch ausgereifter und es werden laut Website des Anbieters 25 Sprachen unterstützt.

Wie stellt man Mehrsprachigkeit im Wiki ein?

Die Voreinstellung "Mehrsprachigkeit" kann nur vom Administrator vorgenommen werden. Dieser geht zunächst auf "Wiki administrieren".

Danach wählt man das Menü "Lokalisierung".

Hier Wiki auf "Mehrsprachig"-> "Ja" umstellen.

Im Feld darunter werden die Abkürzungen für die jeweiligen Landessprachen angegeben. Diese sind den XWiki-Seiten zur Mehrsprachigkeit zu entnehmen. Damit ist die Möglichkeit geschaffen, erstellte Seiten parallel in mehreren Sprachen anzulegen.

Wie erstellt man mehrsprachige Seiten im Wiki?

Um eine Seite in mehreren Sprachen zu erstellen, muss man kein Administrator sein. Jeder "normaler" User kann das ebenfalls. Man erstellt eine Seite und geht nach Fertigstellung in den Bearbeitungsmodus.

Hier gibt es im rechten Bereich die Möglichkeit weitere Sprachversionen zu aktivieren.

Speichert man, so existiert die erstellte Seite somit in unterschiedlichen Sprachversionen. In der Ansicht kann oben rechts im Wiki unter der Suche durch einfaches Klicken in die andere Sprache gewechselt werden.

Theoretisch ändert sich mit dem Wechsel in die andere Sprache auch die Sprache der Menüführung. Praktisch liefert XWiki die Menüsprache nur in Englisch, Deutsch und Französisch. Stellt man beispielsweise auf "Italienisch", wird die Menüführung Englisch.

XWiki ist eine Open Source Software. Sie können ihre eigene Übersetzung selbst einpflegen. Liegt ihnen eine Übersetzung für die einzelnen Punkte vor, können sie diese auf der XWiki Übersetzungseite hinterlassen. So besteht die Möglichkeit, dass die Entwickler von XWiki die Sprachversion zukünftig in der übersetzen Variante anbieten.

Sollten Sie mit dem Gedanken spielen ihr Wiki in mehreren Sprachversionen anzulegen, dann raten wir dazu, diese Entscheidung möglichst zum Start ihres Wikis zu treffen, denn man kann bereits erstellte Seiten nicht rückwirkend in parallelen Sprachversionen erstellen und muss sie dann neu (per copy & paste - was je nach Anzahl und Verlinkungen dennoch recht aufwändig werden kann) anlegen.

Mittwoch, 05. Oktober 2011

Seitenvorlagen mit XWiki benutzen

Es gehört für mich bereits seit langem zum Berufsalltag mit einem Wiki zu arbeiten. Wie praktisch das ist, merke ich v.a. wenn ich Jahre später Antworten suche und sie in dem Wiki tatsächlich finde. Nachdem ich mich daran gewöhnt habe, frage ich mich oft, wie man überhaupt ordentlich arbeiten kann OHNE ein Wiki zu benutzen. Ebenfalls sehr hilfreich ist es im Wiki Templates (oder Seitenvorlagen) benutzen zu können, denn es gibt Seiten (Layouts), die man immer wieder braucht (z.B. Gesprächsprotokolle, Projektdokumentationen, Adresslisten, ...) In XWiki ab Version 3.1 geht das völlig problemlos. Hat man sich erstmal eine Seitenvorlage erstellt, kann man diese ganz einfach über die Funktion "Erstellen - Seite" ansteuern.

Man gelangt in ein Zwischenmenü, welches fragt, ob man eine leere Seite oder eine der vorhandenen Seitenvorlagen nutzen möchte, klickt auf "Erstellen" und schon ist die Seite angelegt.

Donnerstag, 03. März 2011

Gastbereiche im XWiki einrichten

Das XWiki erlaubt viele detaillierte Einstellungen in den Zugriffsrechten; gelegentlich ergeben sich aber Spezialanforderungen, wie etwa die Anforderung einer "Gäste"-gruppe, die nur einen speziellen Bereich sehen darf, und nicht die "normale" Startseite.

Leider hat die direkte Umsetzung einen kleinen Haken: Wenn sich die Gäste einloggen, werden sie erst einmal mit einer rüden Meldung begrüsst:
"Fehler: Sie sind zur Anzeige dieses Dokuments oder zur Ausführung dieser Aktion nicht berechtigt."
weil sie ja kein Recht haben, die normale Startseite zu sehen.

Dies lässt sich aber auch mit Bordmitteln beheben.

[Mehr ...]

Freitag, 04. Februar 2011

Zwischenüberschriften im XWiki verlinken.

Im XWiki gibt es die Möglichkeit, zu Zwischenüberschriften im Inhalt zu verlinken. Das ist oft bei langen Seiten hilfreich. Neben dem "Table of Contents" Makro, welches nur zum Verweis auf Überschriften derselben Seite geeignet ist, gibt es noch die Möglichkeit, Anker direkt an die Links anzuhängen. Dies ermöglicht beliebige Querverweise, aber dazu muss man erst einmal die Anker kennen. Hier gibt es ein kleines Panel, das diese Arbeit ein wenig erleichtert. [Mehr ...]

Donnerstag, 16. Dezember 2010

XWiki: kompletten Bereich als HTML exportieren.

XWiki hat ein nettes Feature, das es erlaubt, einzelne Seiten als HTML zu exportieren. Was weniger bekannt ist, obwohl dokumentiert, ist die Möglichkeit, mehrere Seiten zugleich zu exportieren.

Das liegt eventuell daran, dass dieses Feature nur dadurch erreichbar ist, dass man on der URL herumeditiert, eine gewisse Ahnung von HQL hat, und dabei die entsprechenden Werte im Kopf URL-encoded.

Ich vermute, dass es kein User-bashing ist, wenn ich mal behaupte, dass dies für die meisten Nutzer an der einen oder anderen Stelle oberhalb der Frustrationstoleranzschwelle liegt. Wenn die volle Flexibilität nicht gefragt ist, kann aber mit XWiki schnell etwas benutzerfreundliches gebastelt werden; und zwar folgendermassen ...

[Mehr ...]

Mittwoch, 26. August 2009

Angelegte Bereiche im Wiki umbenennen

In der Regel wird die Grundstruktur eines Wikis von einem Administrator angelegt. In unserem Wiki gibt es die Möglichkeit neben einzelnen Seiten sogenannte Bereiche anzulegen, die als Art Grundgerüst verwendet werden können. Einzelnen Bereichen lassen sich dann Unterseiten zuordnen.
Da es immer mal wieder vorkommt, dass man Bereiche umbenennen möchte, hier eine kurze Erläuterung.

1. Bereich umbenennen

In den Bereich navigieren und dann unter Aktionen -> Umbenennen auswählen. Gewünschten, neuen Bereichsnamen eingeben und speichern.

2. Seiten des Bereichs umhängen

Der "alte", falsch benannte Bereich wird jetzt durch ein blaues Fragezeichen in der Hauptnavigation gekennzeichnet und verschwindet nicht aus dem Panel.

Dies bedeutet, dass an dem ursprünglichen Bereich Unterseiten hängen, die ebenfalls umgehangen werden müssen. Am besten findet man alle betroffenen Unterseiten indem man die alte Bereichsbezeichnung als Suchbegriff in der Suche eingibt.

Man navigiert dann nacheinander auf die betroffenen Seiten und geht ebenfalls auf Aktionen -> Umbennenen.

Im Drop-Down-Menü wählt man nun den neuen Bereich aus und trägt in das Feld "Neue Seite" den alten Seitennamen ein.
Diesen Vorgang wiederholt man so lange, bis alle Seiten umbenannt sind.
Der alte Bereich verschwindet automatisch aus der Hauptnavigation wenn alle Unterseiten umgehangen sind.
Dieser Weg ist evtl. ein bisschen mühsam - stellt jedoch sicher, dass Seiten nicht verloren gehen und mit einer Umbenennung eines Bereichs vollständig mit übertragen werden.

Dienstag, 25. August 2009

XWiki Panels anpassen und übersetzen

Als Panels (Menüleisten) bezeichnet man die Funktionsflächen im Wiki, wie z.B. die Suche oder die Hauptnavigation in den Marginalspalten.

[Mehr ...]

Mittwoch, 05. August 2009

Mehrsprachigkeit im Wiki

Je nach Einsatzgebiet kann es hilfreich sein, ein Wiki mehrsprachig anzulegen. XWiki bietet hier eine sehr einfache Umsetzung.

1. Mehrsprachigkeit aktivieren

Als Administrator loggen Sie sich ins Wiki ein und klicken oben rechts auf „Verwalten“ → „Einstellungen Wiki“ → „General“. Dort gelangen Sie in eine Ansicht, die Mehrsprachigkeit abfragt.

Standardeinstellung ist nein. Diese bitte auf "ja" umstellen. Dann unter "Sprachen" die gewünschte Sprache eingeben (z.B. fr) und die neuen Einstellungen speichern.

[Mehr ...]

Freitag, 17. April 2009

Einrichten von Nutzungsrechten für Gruppen und Einzelpersonen bei XWiki

XWiki erlaubt es unterschiedliche Nutzer in Gruppen zusammenzufassen. Diesen Gruppen können dann für ganze Bereiche oder einzelne Seiten Zugriffsrechte zugeordnet werden. Im Nachfolgenden werden einige nützliche Vorgehensweisen im Zusammenhang von Vergabe der Nutzungsrechte beschrieben:

1. Benutzer anlegen

Benutzer können nur von Administratoren angelegt werden. Ins Wiki einloggen und dann oben rechts auf „Verwalten“ → „Einstellungen verwalten“ → „Users“ → „Benutzer hinzufügen“.

[Mehr ...]

Freitag, 20. März 2009

XWiki: Panel der Hauptnavigation bearbeiten

Panel auswählen

Die Hauptnavigation kann im XWiki über ein spezielles Panel individuell angepasst werden. Mit einem Admin-Account geht man unter Verwalten > Einstellungen Wiki > zum Panel Wizard und dort weiter unten zu "Go to Panels Homepage" und wählt das Panel namens Hauptnavigation aus, indem man auf "Bearbeiten" geht.

[Mehr ...]

Montag, 02. Februar 2009

Das XWiki Forum Plugin

Für das XWiki können Anwendungen installiert werden. Die Anwendungen sind überwiegend Wiki Seiten, die mit Hilfe des Imports in einem XWiki installiert werden können.

Ausprobiert hab ich das Forum . Das Installieren, zum Beispiel in einem gehostetem XWiki, besteht aus mehreren Schritten. Nach dem Download wird das Forum über den Admin-Bereich des XWikis importiert. Danach gibt es zwei neue Spaces, einen für das Forum ('BulletinBoard') und einen weiteren für Macros und Forumlare ('BBCode').

Das Forum ist mehrsprachig. Die Seite mit den Übersetzungen muss registriert werden. Dies geschieht in dem Admin-Bereich des Wikis unter 'Programming'. Im letztem Formularfeld, die deutsche Übersetzung des Feldes ist 'Dokumentenpaket für die Internationalisierung', muss die Seite BBCode.Translations eingetragen werden.

Nun gibt es leider noch einen Fehler in dem Forum. Die Forumsbeiträge werden nicht angezeigt bzw. nicht gespeichert.

Mir ist aufgefallen, dass die Seiten für die Posts zwar das entsprechende Objekt BBCode.PostClass besitzen, das Objekt selber aber nicht die Eigenschaften haben, welcher durch die Klasse BBCode.PostClass definiert werden. So fehlen bei einem Post das Feld, welches den eigentlichen Inhalt des Forumsbeitrages beinhaltet.

Nun, Abhilfe schafft da ein einfaches 'touchen' der Klasse in dem man die Seite BBCode.PostClass mit dem Klasseneditor öffnet und ein weiteres Feld hinzufügt. Danach sollte das Forum funktionieren.

Weiter Fragen oder Anregungen, gerne hier im Forum

Bildelement im XWiki-Layout einbauen

Frauen mögen's ja gerne hübsch. Ich habe deswegen - zugegeben mit ein bisschen Nachhilfe - ein eigenes Panel für unser EsPresto XWiki gebastelt, das ermöglicht einfach Bilder in das Menü einzubauen.

Wie wird's gemacht?
Als Administrator des Wikis geht man oben rechts auf "Einstellungen Wiki" und landet auf einer Übersicht, aus der man sich den "Panel Wizard" auswählt.
Dort wählt man ganz unten rechts "Go to Panels home Page". Bei "Create new panel:" gibt man den gewünschten Namen des Panels in die Eingabezeile ein, z.B. Bildcontainer und klickt "Erstellen".
In das Contentfenster gibt man ein.
#panelheader('Gewünschte Überschrift des Panels - kann auch leer bleiben')
{image:Bildquelle.jpg|document=Panels.Bildcontainer}
#panelfooter()
Als Panel type bitte "view" und als category "other" wählen.
Unten rechts auf "Speichern & Ansehen" gehen.

Dann im unteren Auswahlmenü "Anhänge" wählen und das Bild, das angezeigt werden soll hochladen. Reload und wenn alles geklappt hat, müßte ein neues Panel mit Bild zu sehen sein.
Um dieses Bildpanel in das Layout einzubauen wieder oben rechts auf "Einstellungen Wiki" und dann wieder "Panel Wizard" auswählen. Hier in die Leiste "other" gehen. Dort ist das selbst erstellte Panel zu sehen. Per drag & drop mit der Maus auf die gewünschte Stelle im Layout ziehen und dann - ganz wichtig - unten auf der Seite "Save the new layout" klicken.
Maximale Breite des Bildes in unserem Standardlayout ist übrigens 193 Pixel groß.

Die Farbwelt im CSS ist übrigens ebenfalls im EsPresto XWiki händisch anpassbar. Das Design und Logo des Screenshots basieren auf einem Entwurf von Eva Lo.