• Artikel
• Versionen
• Anhängen
• Druckansicht
• Backlinks

Hochladen von Dateien

Autoren (Fortgeschritten) (deutsche Übersetzung der Seite PmWiki.Uploads, Stand 2008-03-13)

PmWiki kann so konfiguriert werden, dass Autoren Dateien und Bilder auf den Server der PmWiki-Installation hochladen können. Auf solche hochgeladenen Dateien (auch "Anhänge") kann von allen Wikiseiten einfach verwiesen werden.

Attach:-Syntax

Um einen Anhang zu einer Seite hinzuzufügen (hochzuladen) oder um auf einen vorhandenen Anhang zu verweisen, nutzt man die Formatierungsanweisung "Attach:" gefolgt von dem Namen der entsprechenden Datei -- also z.B. "Attach:Datei.pdf". Bei der Seitenansicht wird dies von PmWiki folgendermaßen umgewandelt:

• Wenn eine solche Datei bereits hochgeladen wurde, wird ein Verweis auf die Datei angezeigt.
• Wenn eine solche Datei noch nicht hochgeladen wurde, wird ein Verweis auf ein "Hochlade-Formular" angezeigt, über das der Autor die hochzuladende Datei auswählen kann.
• Wenn es sich bei der Datei um eine Bilddatei handelt (wenn sie eine Dateiendung wie .gif, .jpeg oder .png hat), dann wird dieses Bild auf der Seite dargestellt.

Das Verhalten der automatisch erzeugten Verweise kann modifziert werden:

• Bilddateien können auch als Verweise anstatt als Bilder erscheinen, indem man das Verweis-Format mit doppelten eckigen Klammern verwendet, z.B. [[Attach:meinfoto.jpg]]).
• Wenn ein Verweis auf einen Anhang ohne "Attach:" erscheinen soll, kann man [[(Attach:)Datei.pdf]] verwenden.

Anhänge anderer Seiten oder von Seiten anderer Gruppen

Wie ein Verweis auf Anhänge anderer Seiten geschrieben werden muss, ist unterschiedlich je nachdem, ob die PmWiki-Konfiguration seitenweise, gruppenweise oder systemweite Speicherung vorsieht.

Wenn PmWiki so konfiguriert ist, dass die hochgeladenen Dateien gruppenweise in gemeinsamen Verzeichnissen gespeichert werden, sieht ein Verweis auf den Anhang einer anderen Seite so aus:

Wenn PmWiki so konfiguriert ist, dass alle hochgeladenen Dateien in einem gemeinsamen Verzeichnis gespeichert werden, sieht ein Verweis auf den Anhang einer anderen Seite so aus:

Wenn PmWiki so konfiguriert ist, dass für jede Seite ein eigenständiges Hochlade-Verzeichnis angelegt wird, sieht ein Verweis auf den Anhang einer anderen Seite so aus:

Dateinamen mit Leerzeichen

Zuallererst: Am besten ist es, keine Leerzeichen oder Sonderzeichen in Dateinamen zu verwenden! Statt eines Leerzeichens sollte ein Unterstrich (_) verwendet werden.
Um auf ein Datei mit Leerzeichen im Dateinamen zu verweisen, sollte die Verweis-Form mit doppelten eckigen Klammern genutzt werden:

Um eine Bild-Datei mit Leerzeichen im Dateinamen direkt auf der Seite einzubinden, kann einer der beiden folgenden Tricks genutzt werden:

Liste der hochgeladenen Dateien für eine Seite

Um hochgeladene Dateien aufzulisten, kann die folgende Anweisung genutzt werden: (:attachlist:)

Damit werden alle Anhänge der aktuellen Gruppe, der aktuellen Seite oder der gesamten Installation angezeigt -- je nachdem, ob Anhänge gruppenweise, seitenweise oder alle zusammen gespeichert werden. Für jeden Anhang wird ein Verweis zum Ansehen oder Herunterladen desselben angezeigt. Eine solche Liste der Anhänge wird auch als Teil des Hochlade-Forumlars angezeigt.

Formular für das Hochladen / Ersetzen von Anhängen

Man kann das Formular für das Hochladen auch direkt aufrufen, indem man "?action=upload" an die Internetadresse einer Seite anhängt, für die der Administrator des Wikis das Hochladen erlaubt hat.

Eine hochgeladene Datei kann einfach durch eine neue Version ersetzt werden, indem man die neue Datei unter dem selben Namen wie die alte hochlädt.

• Man sollte sicherstellen, dass der Browser-Cache nach dem Ersetzen der hochgeladenen Datei geleert wird. Anderenfalls könnte es den Anschein haben, als wäre weiterhin die alte Version der Datei auf dem Server.

Typen und Größenbeschränkungen

Aus Sicherheitsgründen ist bei PmWiki das Hochladen bei der Erstinstallation abgeschaltet; Einmal eingeschaltet ist das Hochladen auf bestimmte Typen und Dateigrößen beschränkt (siehe Administration hochgeladener Dateien). Die Standardeinstellungen bei PmWiki sind Dateigrößen von 50 Kilobytes und Dateiendungen wie ".gif", ".jpg", ".doc", ".txt", und ".pdf". Zusätzlich kann der Administrator das System so konfigurieren, dass ein Passwort für das Hochladen erforderlich ist (siehe Passwörter und Administration der Passwörter.

Standardmäßig ist das Hochladen von Datein mit folgender Endung möglich:

'gif','jpg','jpeg','png','bmp','ico','wbmp', # Bilder@] 'mp3','au','wav', # Musik 'mpg','mpeg','wmf','mov','qt','avi', # Video 'zip','gz','tgz','tar','rpm','hqx', # Komprimierte Dateien 'odt','ods','odp', # OpenOffice.org 'doc','ppt','xls','exe','mdb', # MSOffice 'pdf','psd','ps','ai','eps', # Adobe 'htm','html','fla','swf', # Internetzeugs 'txt','rtf','exe','tex','dvi','' # Verschiedenes@]

Löschen

Derzeit können hochgeladene Dateien nur vom Administrator des Wikis gelöscht werden. Jeder Benutzer mit Rechten für das Hochladen kann allerdings bereits bestehende Dateien mit anderen Dateien gleichen Namens ersetzen.

Der Administrator kann hochgeladene Dateien löschen, indem er sie direkt auf dem Server löscht (über FTP oder SSH oder was auch immer der Provider zur Verfügung stellt). Möglicherweise funktioniert auch das (nur auf Engisch verfügbare) Kochbuch-Rezept Cookbook:WebAdmin, das innerhalb des Wikis einen Zugang zu den hochgeladenen Dateien ermöglicht.

<< Übersicht über Formatierungsanweisungen | Dokumentationsindex | Einfache Tabellen >>