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 Pm Wiki-Installation hochladen können. Auf solche hochgeladenen Dateien (auch "Anhänge") kann von allen Wikiseiten einfach verwiesen werden.
Hinweis2: Das Hochladen so konfiguriert werden, dass hochgeladene Dateien für jede Seite in einem eigenen Verzeichnis gespeichert werden oder dass die Dateien für jede Gruppe in einem Verzeichnis landen oder dass für sämtliche Dateien ein gemeinsames (system-weites) Verzeichnis verwendet wird. Die Standardeinstellung ist, die hochgeladenen Dateien gruppenweise zu speichern. Siehe Uploads Administration für Details.
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 Pm Wiki 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 Pm Wiki-Konfiguration seitenweise, gruppenweise oder systemweite Speicherung vorsieht.
Wenn Pm Wiki so konfiguriert ist, dass die hochgeladenen Dateien gruppenweise in gemeinsamen Verzeichnissen gespeichert werden, sieht ein Verweis auf den Anhang einer anderen Seite so aus:
Attach:Datei.pdf
für Seiten der selben Gruppe
Attach:Gruppe/Datei.pdf
für Seiten anderer Gruppen
Wenn Pm Wiki so konfiguriert ist, dass alle hochgeladenen Dateien in einem gemeinsamen Verzeichnis gespeichert werden, sieht ein Verweis auf den Anhang einer anderen Seite so aus:
Attach:Datei.pdf
Wenn Pm Wiki 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:
Attach:Gruppe.SeitenName/Datei.pdf
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:
[[Attach:Eine Datei mit Leerzeichen im Dateinamen.txt]]
Um eine Bild-Datei mit Leerzeichen im Dateinamen direkt auf der Seite einzubinden, kann einer der beiden folgenden Tricks genutzt werden:
[[#blank | Attach:Bild mit schlechtem Namen.jpeg]]
[[#1 | Attach:Bild mit schlechtem Namen.jpeg]]
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.
Hinweis für Administratoren: Wenn man den Eintrag $EnableUploadVersions
=1;
in local/config.php
oder bspw. in einer Gruppen-Konfigurationsdatei macht, werden alte Versionen einer Datei nicht überschriebe sondern nur umbenannt.
Typen und Größenbeschränkungen
Aus Sicherheitsgründen ist bei Pm Wiki 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 Pm Wiki 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', # Open Office?.org
'doc','ppt','xls','exe','mdb', # MS Office?
'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 >>
Wenn ich eine Datei hochlade, wie kann ich es schaffen, dass der Verweis "Datei.pdf" lautet und nicht "Attach:Datei.pdf Δ"?
Benutze Klammern -- wie in [[(Attach:)Datei.pdf]]
. Es gibt auch eine Konfigurations-Option, mit dem sich der "Attach:
-Teil" entfernen lässt -- siehe dazu Cookbook:AttachLinks (nur auf Englisch verfügbar).
Why can't I upload files of size more than 50kB to my newly installed Pm Wiki?
Out of the box Pm Wiki limits the size of files to be uploaded to 50kB. Add
$UploadMaxSize = 1000000; # limit upload file size to 1 megabyte
to your
config.php to increase limit to 1MB (for example). See
UploadsAdmin for how to further customize limits. Note that both PHP and webservers also place their own limits on the size of uploaded files.
Who does my upload exit unexpectedly with "Incomplete file received"?
You may be running out of space in a 'scratch' area, used either by Pm Wiki or by PHP. On *nix, check that you have sufficient free space in /tmp and /var/tmp.
How do I make it so that the upload link still allows one to make another upload (if someone wants to replace the old version of a file with a newer version, for example). Currently you only get the upload link when there is no file in the upload directory.
Use the Attach page action, and click on the delta symbol (Δ) shown against each of files listed. If you can't see the attach action either uploads are not enabled, you are not not authorised to upload, or the attach action has been commented out or is missing. See also available actions, and look at Test?action=upload.
How do I prevent files being uploaded with no extension?
How to avoid problems with non-ASCII characters in attachment names (i.e. "Zażółć geślą jaźń.doc")?
See $UploadNameChars = "-\w. !=+"#;
# allow exclamations, equals, plus, and hash