Wikiseiten anlegen und bearbeiten
Inhaltsverzeichnis
Wikiseite anlegen
Um eine Wikiseite anzulegen, markieren Sie in VLM in der Baumstruktur der Sammlung das Element "Web | Wikiseiten" und wählen Sie den Kontextmenü-Befehl "Neue Seite anlegen". Damit wird die Seite in die Baumstruktur eingefügt. Anschließend können Sie auf der Registerkarte "Eigenschaften" die folgenden Angaben anpassen:
-
Die Beschreibung wird als Name der Seite in der Baumstruktur sowie als Seitentitel im Browserfenster/-tab verwendet.
-
Der wiki-Identifier wird zum Aufrufen und Verlinken der Seite benutzt. Vorgegeben wird ein wiki-Identifier in der Form "page123", den Sie bei Bedarf ändern können. Dabei ist zu beachten, daß die wiki-Identifier stets eindeutig sein müssen, d.h. daß kein wiki-Identifier mehrmals innerhalb einer Sammlung verwendet werden kann.
Wenn Sie eine Wikiseite mit dem wiki-Identifier home versehen, dann wird diese Seite nach der Freigabe als Startseite der entsprechenden Sammlung angezeigt. Auf diese Weise können Sie die ggf. vorgegebene Home-Seite durch eine Seite ersetzen, deren Inhalt Sie selbst pflegen können. Dies gilt entsprechend auch für das Impressum und - sofern vorhanden - für die Seite "Kontakt". Verwenden Sie in diesem Fall die wiki-Identifier imprint sowie contact.
Sollten Sie einen wiki-Identifier nachträglich ändern, so müssen Sie auch alle Links, die auf die betreffende Seite verweisen, entsprechend anpassen. -
Mit der Checkbox "Freigegeben" können Sie - nachdem Sie den Seiteninhalt eingegeben haben - die Seite freigeben. Damit wird sie veröffentlicht und kann unter der Adresse "http://portaladresse.tld/wiki/wiki-Identifier" (z.B. http://demo.visuallibrary.net/wiki/wiki_howto/) abgerufen werden. Vor der Freigabe ist die Seite nur für Benutzer sichtbar, die sich in das entsprechende VL-Portal eingeloggt haben.
Um den Inhalt einer Wikiseite zu bearbeiten, markieren Sie die Seite in der Baumstruktur und wechseln Sie auf die Registerkarte "Wiki" im mittleren Teil des Programmfensters.
Die Registerkarte "Wiki" enthält einen Editor, in dem Sie die Texte eingeben und mittels der nachfolgend beschriebenen Syntax formatieren können; rechts daneben befindet sich eine Vorschau, die Ihnen zeigt, wie die jeweilige Seite im Webportal dargestellt wird. Die Vorschau können Sie über die Schaltfläche "Vorschau anzeigen" in der Multifunktionsleiste (dort auf der Registerkarte "Wiki" zu finden) ein-/ausblenden. Die Vorschau aktualisiert sich automatisch, wenn Sie die eingegebenen Änderungen speichern. Mit der Schaltfläche "Vorschau aktualisieren" können Sie die Vorschau aktualisieren, ohne die jüngsten Änderungen speichern zu müssen.
Wenn Sie innerhalb einer Seite Texte in mehreren Sprachen angeben, so wie im Abschnitt "Mehrsprachiger Seiteninhalt" beschrieben, können Sie mit den Tabs am unteren Rand der Vorschau (z.B. "de"/"en") zwischen den verschiedensprachigen Textversionen wechseln.
Die gleichen Bedienelemente stehen Ihnen zur Verfügung, wenn Sie eine Kollektion oder einen Klassifikationseintrag in der Baumstruktur unterhalb von "Alle Inhalte" auswählen und dann auf die Registerkarte "Wiki" wechseln. Damit können Sie Kollektionen bzw. Klassifikationen mit einführenden Texten versehen.
Mehrsprachiger Seiteninhalt
Innerhalb einer Seite können Sie Texte in mehreren Sprachen angeben, um den Portalnutzern die Möglichkeit der Sprachwahl zu bieten (eine entsprechende Konfiguration Ihres VL-Portals vorausgesetzt). Die verschiedensprachigen Textblöcke werden mit dem jeweiligen ISO-Sprachkürzel gekennzeichnet, wie aus folgendem Beispiel ersichtlich:
~de~
... (Text in deutscher Sprache)
~en~
... (Text in englischer Sprache)
~fr~
... (Text in französischer Sprache)
~it~
... (Text in italienischer Sprache)
~all~
... (Text, der in allen Sprachversionen der Seite ausgegeben wird)
Innerhalb der verschiedensprachigen Textblöcke können Textformatierungen (siehe den folgenden Abschnitt) verwendet werden. In der Vorschau auf der Registerkarte "Wiki" können Sie mit den Tabs am unteren Fensterrand zwischen den verschiedensprachigen Textvarianten umschalten.
Text eingeben und formatieren
Den Seitentext geben Sie auf der Registerkarte Text ein. Textauszeichnungen können Sie in XHTML oder in der Markdown-Syntax vornehmen. Dabei sind einige grundsätzliche Besonderheiten zu beachten:
-
HTML und Markdown können innerhalb einer Seite gemischt verwendet werden. Dabei können Markdown-Auszeichnungen innerhalb von HTML-Inline-Elementen (Span-Level-Elementen) verwendet werden, nicht jedoch innerhalb von HTML-Block-Elementen.
-
Anders als in HTML müssen in Markdown die Zeichen < > & generell nicht kodiert werden. Der Markdown-Parser kodiert diese Zeichen automatisch, wo es erforderlich ist.
-
Einige Zeichen (z.B. * _ \ ` ) haben in Markdown spezifische Funktion als Steuerzeichen. Wenn eines dieser Zeichen im Text verwendet wird (d.h. unverändert angezeigt werden soll), muß ihm ein "Backslash" ( \ ) vorangestellt werden. Ggf. kommt es auf die Position oder Umgebung eines Zeichens an, ob die Kennzeichnung mit einem \ nötig ist.
Beispiel: Damit im Text das Zeichen \ ausgegeben wird, müssen Sie\\
eingeben. -
Wenn in einem mit Markdown formatierten Text Code-Passagen in HTML oder Markdown-Syntax nicht interpretiert, sondern unverändert angezeigt werden sollen, müssen sie mit "Accent grave"-Zeichen ( ` ) umschlossen werden.
Beispiel: Damit im Text die Zeichenfolge<hr />
oder---
ausgegeben (und nicht eine horizontale Linie erzeugt) wird, müssen Sie `<hr />
` bzw. `---
` eingeben.
Textformatierungen mit Markdown (Auswahl)
Nachfolgend sehen Sie einige Beispiele dafür, wie Sie Texte mit Markdown formatieren können. Eine vollständige Beschreibung der Markdown-Syntax finden Sie in der offiziellen Dokumentation.
Überschriften
Eine Überschrift n-ter Ordnung können Sie durch n Rauten ( # ) am Anfang der betreffenden Zeile erzeugen, z.B.:
#Überschrift 1. Ordnung
- entspricht <h1>...</h1>
in HTML
##Überschrift 2. Ordnung
- entspricht <h2>...</h2>
in HTML
###Überschrift 3. Ordnung
- entspricht <h3>...</h3>
in HTML
Absätze und Zeilenumbrüche
Einen Absatz erzeugen Sie...
... durch eine Leerzeile.
Einen Zeilenumbruch erzeugen Sie...
... durch zwei Leerzeichen am Zeilenende.
Listen
Eine sortierte (numerierte) Liste können Sie erzeugen, indem Sie den Listeneinträgen am Zeilenanfang jeweils eine (beliebige) Zahl und einen Punkt voranstellen; vor und nach der Liste muß je eine Leerzeile stehen.
Beispiel:
1. eins
1. zwei
1. drei
ergibt
- eins
- zwei
- drei
Eine unsortierte (nicht numerierte) Liste können Sie erzeugen, indem Sie den Listeneinträgen am Zeilenanfang jeweils eines der Zeichen * oder + oder - voranstellen; vor und nach der Liste muß je eine Leerzeile stehen.
Beispiel:
* dies
* oder das
* oder jenes
ergibt
- dies
- oder das
- oder jenes
Hervorhebung von Text
Von * oder _ umschlossener Text entspricht Text, der mit dem HTML-Tag <em>
("emphasis" = "Betonung") ausgezeichnet ist.
Von ** oder __ umschlossener Text entspricht Text, der mit dem HTML-Tag <strong>
("strong emphasis" = "starke Betonung") ausgezeichnet ist.
Beispiel: *Text*
ergibt Text und **Text**
ergibt Text.
Wenn die Zeichen * und _ von Leerzeichen umschlossen sind, werden sie nicht als Textauszeichnung interpretiert, sondern unverändert angezeigt.
Horizontale Linien
Eine separate Zeile, die mindestens dreimal hintereinander eines der Zeichen * - _ enthält (mit oder ohne Leerzeichen dazwischen), entspricht dem <hr />
-Tag in HTML.
Beispiel:
---
ergibt:
Links
Interne VL-Links
Um einen Link auf einen VL-Metadatenknoten anzulegen, verwenden Sie folgende Syntax:
Link auf den Metadatenknoten eines Werks:
{title|label=gewünschter Name des Links|id=<VL-ID>}
Beispiel: {title|label=Brentanos Wirtschaftsleben|id=384503}
ergibt: Brentanos Wirtschaftsleben
Link auf den Metadatenknoten eines Werks, wenn dieses Werk einen urn besitzt:
{title|label=gewünschter Name des Links|urn=<urn:xxxxxx>}
Beispiel: {title|label=Juchhe nach Italia!|urn=urn:nbn:de:s2w-6445}
ergibt Juchhe nach Italia!
Link auf eine Einzelseite eines Werks:
{page|label=gewünschter Name des Links|id=<VL-ID der Seite>}
Beispiel: {page|label=Juchhe nach Italia!, Seite 18|id=138269}
ergibt: Juchhe nach Italia!, Seite 18
Für eine Suche nach allen Werken in denen eine Person Autor oder Beteiligter ist, verwenden Sie den Namen und die gnd-ID dieser Person:
{person|label=gewünschter Name des Links|name= Nachname, Vorname|gnd=<xxxxxxx>}
Beispiel: {person|label=Ludwig Bamberger|name=Bamberger, Ludwig|gnd=118656961}
ergibt: Ludwig Bamberger
Links auf Wikiseiten
Um einen Link zu einer Wikiseite innerhalb der gleichen Sammlung anzulegen, verwenden Sie:
[Link-Text](/wiki/wiki-Identifier)
Beispiel: [Ein Link.](wiki/wiki_howto)
ergibt: Ein Link.
Um einen Link zu einer Wikiseite in einer anderen Sammlung oder auf einem anderen Server anzulegen, verwenden Sie:
[Link-Text](http://subdomain.domain.de/pfad/)
Beispiel: [Ein Link.](http://demo.visuallibrary.net/)
ergibt: Ein Link.
Links auf externe Webseiten
Um einen "externen Link" (mit einem Icon markiert, öffnet sich in einem neuem Browserfenster/-tab) zu erzeugen, verwenden Sie:
[Link-Text](!http://subdomain.domain.de/pfad/)
Beispiel: [Ein Link.](!http://demo.visuallibrary.net/)
ergibt: Ein Link.
Externe URLs werden automatisch zu anklickbaren Links, wenn man sie in < und > einschließt.
Beispiele: <http://demo.visuallibrary.net/>
ergibt: http://demo.visuallibrary.net/
Links auf Ressourcen in VL
Um einen Link zu einer Ressource (z. B. einem hochgeladenen Logo oder Bild) zu erzeugen, die in der Baumstruktur via "Web | Resourcen"*
hochgeladen wurde, verwenden Sie den Resource-Identifier und bilden den Link wie folgt:
[Link-Text](domainresource/resource-Identifier)
Beachten Sie: Der Link darf nicht in div-Tags stehen.
*
Zur konkreten Beschreibung von "Web | Resourcen" siehe folgenden Abschnitt "Bilder"
Bilder
Um eine Bilddatei hochzuladen, die Sie in eine Wikiseite einbinden möchten, markieren Sie in der Baumstruktur das Element "Web | Resourcen" und wählen Sie den Kontextmenü-Befehl "Web-Resource hochladen". Damit wird die Datei in die VL-Datenbank geladen und als Resource in der Baumstruktur angezeigt. Anschließend können Sie auf der Registerkarte "Eigenschaften" die folgenden Angaben anpassen:
-
Die Beschreibung wird als Name der Bilddatei in der Baumstruktur verwendet. Vorgegeben wird der Name der hochgeladenen Datei.
-
Der Resource-Identifier wird zum Verlinken der Resource benutzt. Vorgegeben wird ein Resource-Identifier in der Form "resource123", den Sie bei Bedarf ändern können. Dabei ist zu beachten, daß die Resource-Identifier stets eindeutig sein müssen, d.h. daß kein Resource-Identifier mehrmals innerhalb einer Sammlung verwendet werden kann.
Sollten Sie einen Resource-Identifier nachträglich ändern, so müssen Sie auch alle Links, die auf die betreffende Resource verweisen, entsprechend anpassen.
Um ein Bild, das als Web-Resource hochgeladen wurde, in eine Wikiseite einzubinden, verwenden Sie:
![Alt-Text](resource-Identifier)
Beispiel: ![Ein Bild](demo_image)
Um ein Bild einzubinden, das nicht als Web-Resource in der entsprechenden Sammlung vorliegt, verwenden Sie:
![Alt-Text](http://subdomain.domain.de/pfad/datei.name)
Beispiel: ![Ein Bild](http://demo.visuallibrary.net/domainimage/home/LivreOuvert.jpg)
Um ein Bild zu positionieren oder zu formatieren, verwenden Sie HTML/CSS-Syntax:
<img src="resource-Identifier" alt="Alt-Text" style="[CSS-Definitionen]"/>
oder
<img src="http://sub.domain.de/pfad/datei.name" alt="Alt-Text" style="[CSS-Definitionen]"/>
Beispiele:
<img src="demo_image" alt="Ein Bild" style="float:right;margin:20px"/>
oder
<img src="http://demo.visuallibrary.net/domainimage/home/LivreOuvert.jpg" alt="Ein Bild" style="float:right;margin:20px"/>
Eine ausführliche Beschreibung der HTML- und CSS-Syntax finden Sie bei SELFHTML.
Dateien zum Herunterladen einbinden
Um eine Datei (z.B. ein PDF-Dokument oder ein ZIP-Paket) hochzuladen, die zum Herunterladen angeboten werden soll, markieren Sie in der Baumstruktur das Element "Web | Resourcen" und wählen Sie den Kontextmenü-Befehl "Web-Resource hochladen". Damit wird die Datei in die VL-Datenbank geladen und als Resource in der Baumstruktur angezeigt. Anschließend können Sie auf der Registerkarte "Eigenschaften" die folgenden Angaben anpassen:
- Die Beschreibung wird als Name des Elements in der Baumstruktur verwendet. Vorgegeben wird der Name der hochgeladenen Datei.
- Der Resource-Identifier wird zum Verlinken der Datei benutzt. Vorgegeben wird ein Resource-Identifier in der Form "resource123", den Sie bei Bedarf ändern können. Dabei ist zu beachten, daß die Resource-Identifier stets eindeutig sein müssen, d.h. daß kein Resource-Identifier mehrmals innerhalb einer Sammlung verwendet werden kann.
Sollten Sie einen Resource-Identifier nachträglich ändern, so müssen Sie auch alle Links, die auf die betreffende Resource verweisen, entsprechend anpassen.
Um in eine Wikiseite einen Link zum Herunterladen der Datei einzubinden, verwenden Sie:
[Link-Text](/domainresource/resource-identifier)
Mit einem Mausklick auf den Link können Besucher der Wikiseite den Download der betreffenden Datei auslösen.