Attachments: Difference between revisions

(Created page with "{{BSVersion|bsvFrom=4.2|bsvTo=|bsvFeature=}} ==What are file attachments?== File attachments are links on wiki pages that link directly to an uploaded file (Word document, PD...")
 
No edit summary
(4 intermediate revisions by the same user not shown)
Line 3: Line 3:
==What are file attachments?==
==What are file attachments?==
File attachments are links on wiki pages that link directly to an uploaded file (Word document, PDF, image file,...). From BlueSpice 4.2, file attachments are directly integrated into a wiki page.
File attachments are links on wiki pages that link directly to an uploaded file (Word document, PDF, image file,...). From BlueSpice 4.2, file attachments are directly integrated into a wiki page.
{{Messagebox|boxtype=important|icon=|Note text=Attachments on pages before BlueSpice 4.2 will be moved to the page content during the update to 4.2. This triggers a new revision (version) of each affected page.
Pages that have been in approved state will have a new draft version.|bgcolor=}}


==Create attachments==
==Create attachments==
To create file attachments:
To create file attachments:
#[[File:Manual:VE-insert-magicword.png|alt=Insert magic word|thumb|Insert magic word]]'''Click''' ''Insert >''  ''> Magic word'' in the VisualEditor toolbar'':''
#'''Click''' ''Insert'' ''> Magic word'' in the VisualEditor toolbar:<br />[[File:Manual:VE-insert-magicword.png|alt=Insert magic word|thumb|Insert magic word|center|330x330px]]
#'''Wählen''' Sie "attachments"  aus der Liste aus und klicken Sie ''Fertig''. <br />
#'''Choose''' "attachments"  and click ''Done''. <br />[[File:magicword-attachments.png|alt=Magic word "attachments"|center|thumb|450x450px|Magic word "attachments"]]
[[File:magicword-attachments.png|alt=Magic word "attachments"|center|thumb|450x450px|Magic word "attachments"]]
#''' Save''' the page. You will now see the new attachments area.<br />[[File:attachment-area.png|alt=New attachments area|center|thumb|750x750px|New attachments area]]
#''' Speichern''' Sie die Seite. Sie sind nun im Ansichtsmodus der Seite und sehen den neuen Anhangsbereich. <br />[[File:attachment-area.png|alt=New attachments area|center|thumb|750x750px|New attachments area]]
#'''Upload''' a new file to the wiki (button 1). Alternatively, choose an already existing file (button 2).
#'''Laden''' Sie im Ansichtsmodus eine '''neue''' Datei ins Wiki (Schaltfläche 1). Alternativ: '''Wählen''' Sie eine bereits existierende Datei (Schaltfläche 2).
{{Filename}}
 
==Elements of the attachment area==
Mit Einstellungen im Attachments-Tag kann die Darstellung des Anhangsbereichs angepasst werden. Um die Parameter einzustellen, gehen Sie in den Bearbeitungsmodus der Seite und klicken Sie auf den Anhangsbereich. Der Tag-Inspektor öffnet sich. Dieser gliedert sich in zwei Bereiche:
 
#Präfix, Kategorien, Beschreibung: Standard-Werte für Dateien, die neu über den Anhangsbereich in das Wiki hochgeladen werden. Die Standardwerte werden auch verwendet, wnn der Umschalter "Hochlade-Optionen überspringen" aktiviert ist. In diesem Fall werden die Dateien direkt ohne weitere Hochlade-Dialoge ins Wiki übernommen. Die Standard-Hochladeoptionen werden hierbei berüccksichtigt.
#Umschalter, die verschiedene Spalten im Anhangsbereich ein- oder ausblenden. [[Datei:Entwurf:Anhangs-Inspektor.png|alternativtext=Anhangs-Inspektor|zentriert|mini|460x460px|Anhangs-Inspektor]]
 


== Elements of the attachments area==
The appearance of the attachments area can be adjusted with settings in the attachments tag. To set the parameters, go to the edit mode of the page and click on the attachments area. The tag inspector opens. It consists of two areas:


#Prefix, Categories, Description: Default values for files that are newly uploaded to the wiki via the attachments section. The default values are also used when the toggle  switch "Skip upload options" is activated. In this case, the files are transferred directly to the wiki without any further upload dialogs. The standard upload options are applied.
#Toggle switches  that show or hide different columns in the attachments area.<br />  [[File:attachments-inspector.png|alt=attachments inspector|center|thumb|337x337px|attachments inspector]]


The following parameters are available (all settings are optional):
The following parameters are available (all settings are optional):
{| class="wikitable"
{| class="wikitable" style=""
|+
|+
!
!
Line 39: Line 40:
''Product:''      (prefixes the filename with the namespace-prefix for the ''Product'' namespace)
''Product:''      (prefixes the filename with the namespace-prefix for the ''Product'' namespace)
|-
|-
|1
| 1
|Categories
|Categories
|Default categories for newly uploaded files.
|Default categories for newly uploaded files.
Line 48: Line 49:
|-
|-
|2
|2
|Skip upload options
| Skip upload options
|When uploading new files, they are uploaded directly to the wiki without showing a further settings dialogs. The standard upload options (prefix, categories, description) are applied.
|When uploading new files, they are uploaded directly to the wiki without showing a further settings dialogs. The standard upload options (prefix, categories, description) are applied.
|-
|-
Line 55: Line 56:
|The "Latest version" column is hidden. This column shows the last edit date.
|The "Latest version" column is hidden. This column shows the last edit date.
|-
|-
|2
| 2
|Hide editor
|Hide editor
|The "Editor" column is hidden. This column shows the last editor.
|The "Editor" column is hidden. This column shows the last editor.
Line 68: Line 69:
|}
|}


===Additional features===
==Additional features==


*Click the x-icon to remove an attachment from the attachments pane.
*Click the x-icon to remove an attachment from the attachments pane.
*Click the i-icon to open the file description page.
*Click the i-icon to open the file description page.
*Click on the filter symbol in the header bar to filter for terms in the file name.
*Click on the filter symbol in the header bar to filter for terms in the file name.
[[en:{{FULLPAGENAME}}]]
[[de:Dateianhänge]]
[[Category:Content]]

Revision as of 14:31, 30 September 2022

is available from BlueSpice 4.2.


What are file attachments?

File attachments are links on wiki pages that link directly to an uploaded file (Word document, PDF, image file,...). From BlueSpice 4.2, file attachments are directly integrated into a wiki page.

Important!Attachments on pages before BlueSpice 4.2 will be moved to the page content during the update to 4.2. This triggers a new revision (version) of each affected page. Pages that have been in approved state will have a new draft version.


Create attachments

To create file attachments:

  1. Click Insert > Magic word in the VisualEditor toolbar:
    Insert magic word
    Insert magic word
  2. Choose "attachments" and click Done.
    Magic word "attachments"
    Magic word "attachments"
  3. Save the page. You will now see the new attachments area.
    New attachments area
    New attachments area
  4. Upload a new file to the wiki (button 1). Alternatively, choose an already existing file (button 2).
Note:When uploading a new file, you should check the file/page name for unusual special characters (e.g., ", %, /,< ,>, [ ,], {, }). Change the name to include only standard characters, since the server file system could have problems with them or since some characters have special meanings in MediaWiki.

The special characters (, ), &, + can be used and are translated into their equivalent %-hex notation.


: will be converted to spaces, unless it is part of an existing namespace prefix.


Elements of the attachments area

The appearance of the attachments area can be adjusted with settings in the attachments tag. To set the parameters, go to the edit mode of the page and click on the attachments area. The tag inspector opens. It consists of two areas:

  1. Prefix, Categories, Description: Default values for files that are newly uploaded to the wiki via the attachments section. The default values are also used when the toggle switch "Skip upload options" is activated. In this case, the files are transferred directly to the wiki without any further upload dialogs. The standard upload options are applied.
  2. Toggle switches that show or hide different columns in the attachments area.
    attachments inspector
    attachments inspector

The following parameters are available (all settings are optional):

Parameter Description
Title Title that should be shown at the top of the attachments area.
1 Prefix A prefix that should automatically be added during the upload.

Example:

Product: (prefixes the filename with the namespace-prefix for the Product namespace)

1 Categories Default categories for newly uploaded files.
1 Description Default description for newly uploaded files.
2 Skip upload options When uploading new files, they are uploaded directly to the wiki without showing a further settings dialogs. The standard upload options (prefix, categories, description) are applied.
2 Hide version The "Latest version" column is hidden. This column shows the last edit date.
2 Hide editor The "Editor" column is hidden. This column shows the last editor.
2 Show size The "Size" column is displayed. This shows the file size in KB/MB.
2 Show categories The "Categories" column is displayed. If a file is categorized, the categories are listed here.

Additional features

  • Click the x-icon to remove an attachment from the attachments pane.
  • Click the i-icon to open the file description page.
  • Click on the filter symbol in the header bar to filter for terms in the file name.



To submit feedback about this documentation, visit our community forum.

Discussions