Benutzer-Werkzeuge

Zuletzt angesehen:

Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

Link zu dieser Vergleichsansicht

Beide Seiten der vorigen RevisionVorhergehende Überarbeitung
Nächste Überarbeitung		Vorhergehende Überarbeitung
dokuwiki_manual [2023/09/14 16:15] – [4.1.15 nodisp Plugin] cbuehlerdokuwiki_manual [2023/09/15 12:04] (aktuell) – [4.1.12 Wrap Plugin] cbuehler
Zeile 736: Zeile 736:
 {{wiki:dokuwiki-128.png?15&direct}} {{wiki:dokuwiki-128.png?15&direct}}
   {{wiki:dokuwiki-128.png?15&direct}}   {{wiki:dokuwiki-128.png?15&direct}}
 +  
 +=== 4.1.3.7 Videos im DokuWiki speichern ===
 +
 +== Syntax ==
 +
 +<code>
 +{{ :video_example_mp4_1280_10mg.mp4 |Video Beispiel}}
 +</code>
  
 +{{ :video_example_mp4_1280_10mg.mp4 |Video Beispiel}}
 ==== 4.1.4 Listen ==== ==== 4.1.4 Listen ====
  
Zeile 1001: Zeile 1010:
 === 4.1.11.1 Syntax === === 4.1.11.1 Syntax ===
  
-The width has to be specified at the start of a line before the table. The first value is used as width of the table, the rest is for columns. If you want to omit some value use a dash instead. The widths can be specified in any CSS units:+Die Breite muss am Anfang einer Zeile vor der Tabelle angegeben werden. Der erste Wert wird als Breite der Tabelle verwendet, der Rest ist für die Spalten. Wenn Sie einen Wert auslassen möchten, verwenden Sie stattdessen einen Bindestrich. Die Breiten können in beliebigen CSS-Einheiten angegeben werden:
  
 <code> <code>
Zeile 1009: Zeile 1018:
 </code> </code>
  
-The relative units (percentage) for the table width refer to the width of the page, and when used for columns they refer for the table wight. For example, the width specification ''|< 50% 50% 50% >|'' makes the table half width of the page and two equal columns quarter of the page width each.+Die relativen Einheiten (in Prozent) für die Tabellenbreite beziehen sich auf die Breite der Seite, und wenn sie für Spalten verwendet werden, beziehen sie sich auf die Tabellenbreite. Zum Beispiel macht die Breitenangabe ''|< 50% 50% 50% >|'' die Tabelle halb so breit wie die Seite und zwei gleiche Spalten jeweils ein Viertel der Seitenbreite.
  
-If there are more columns in the table than there are values in the width specification, the width will be applied to the columns from left to right:+Wenn die Tabelle mehr Spalten enthält, als Werte in der Breitenangabe vorhanden sind, wird die Breite auf die Spalten von links nach rechts angewendet:
  
 <code> <code>
 |< 50em 20% >| |< 50em 20% >|
 ^ 20%              ^ 80%                          ^ ^ 20%              ^ 80%                          ^
-| Specified width  | The rest of the table width  |+| Festgelegte Breite  | Die restliche Breite der Tabelle  |
 </code> </code>
  
 ==== 4.1.12 Wrap Plugin ==== ==== 4.1.12 Wrap Plugin ====
  
-Universal plugin which combines the functionality of many other plugins. Wrap wiki text inside containers (divs or spans) and give them a class (choose from a variety of preset classes), a width and/or a language with its associated text direction.+Universelles Plugin, das die Funktionalität vieler anderer Plugins kombiniert. Packen Sie Wiki-Text in Container (divs oder spans) und geben Sie ihnen eine Klasse (wählen Sie aus einer Vielzahl von voreingestellten Klassen), eine Breite und/oder eine Sprache mit der dazugehörigen Textrichtung.
  
 === 4.1.12.1 One plugin to rule them all === === 4.1.12.1 One plugin to rule them all ===
  
-This plugin gives you the ability to wrap wiki text inside containers (divs or spans) and give them +Dieses Plugin gibt Ihnen die Möglichkeit, Wiki-Text in Containern (divs oder spans) zu packen und ihnen 
-  - a certain class (with loads of useful preset classes) +  - eine bestimmte Klasse (mit vielen nützlichen voreingestellten Klassen) 
-  - a width +  - eine Breite 
-  - a language with its associated text direction+  - eine Sprache mit der dazugehörigen Textrichtung
  
-It potentially replaces a lot of other plugins and is IMHO the better alternative for many.+Es ersetzt potentiell eine Menge anderer Plugins und ist IMHO für viele die bessere Alternative.
  
-It fully replaces: [[class]], [[clearfloat]], [[div_span_shorthand]], [[divalign2]], [[divalign]], [[emphasis]], [[hide]], [[important_paragraf]], [[importanttext]], [[lang]], [[ltr]], [[noprint]], [[pagebreak]], [[side_note]], [[tip]], [[wpre]]+Es ersetzt vollständig: [[class]], [[clearfloat]], [[div_span_shorthand]], [[divalign2]], [[divalign]], [[emphasis]], [[hide]], [[important_paragraf]], [[importanttext]], [[lang]], [[ltr]], [[noprint]], [[pagebreak]], [[side_note]], [[tip]], [[wpre]]
  
-It partly replaces: [[box]], [[button]], [[color]], [[columns]], [[fontcolor]], [[fontfamily]], [[fontsize2]], [[fontsize]], [[highlight]], [[layout]], [[note]], [[styler]], [[tab]], [[tablewidth]], [[typography]]+Es ersetzt teilweise: [[box]], [[button]], [[color]], [[columns]], [[fontcolor]], [[fontfamily]], [[fontsize2]], [[fontsize]], [[highlight]], [[layout]], [[note]], [[styler]], [[tab]], [[tablewidth]], [[typography]]
  
 === 4.1.12.2 Syntax === === 4.1.12.2 Syntax ===
Zeile 1449: Zeile 1458:
 ==== 4.1.15 nodisp Plugin ==== ==== 4.1.15 nodisp Plugin ====
  
-=== Configuration Settings for dw2pdf plugin ===+=== Examples/Usage === 
 + 
 +This plugin has two ways of concealing text from unauthorized users.   
 +  - In the first case, it conceals text from all viewers except users who are logged in and belong to either the admin or manager group.  The text is still on the page, but not displayed.  This means it can be viewed using the browser's view source facility. 
 +  - In the second case, an acl level is set and if the viewer does not have an acl level equal to or greater than the acl setting, the text is completely removed from the page.  It is not output from the server to the browser. The same is true if the site allows viewers to view the page source using Dokuwiki's view source action. 
 + 
 +=== Syntax === 
 + 
 +== The syntax for the first case == 
 + 
 +<code> 
 +<nodisp> your text here </nodisp> 
 + 
 +<nodisp> 
 +your text here 
 +etc 
 +</nodisp> 
 +</code> 
 + 
 +== The syntax for the second case == 
 + 
 +<code> 
 +<nodisp acl> your text here </nodisp> 
 + 
 +<nodisp acl> 
 +your text here 
 +etc 
 +</nodisp> 
 +</code> 
 + 
 +''acl'' is the numeric representation of the acl level which is required for the marked off text to be output to the browser.  In other words the viewer must be logged in and have ''acl'' rights for the page in order for the marked up text to be included in the page.  So, for example, with ''<nodisp 8>'' the viewer must have upload permission or greater for the namespace where the page appears; with ''<nodisp 2>'', the viewer must have edit permission or greater for the page, etc.  
 + 
 +It's possible to have several ''nodisp'' blocks on a page, each with a different ''acl'' level, so that the current user might have access to one section of text and not another. For example, the user might have write permission ((acl 2)) for a page but not create permission for its namespace.  ''<nodisp 2>'' would mark off a passage which this user could view, but ''<nodisp 4>'' would mark off one which this user does not have access to. A user with create permission for page's namespace ((acl 4)) would uhave access to both.   
 +The ACL levels are described in the [[:acl#background_info|acl documentation]].  
 + 
 +== Newline syntax == 
 +<code> 
 +{nodisp} your text here {/nodisp} 
 + 
 +{nodisp} 
 +your text here 
 +etc 
 +{/nodisp} 
 + 
 +{nodisp acl} your text here {/nodisp} 
 + 
 +{nodisp acl} 
 +your text here 
 +etc 
 +{/nodisp} 
 +</code> 
 +The ''<nodisp. . . >'' syntax sets off blocks of text. If you place two blocks, one after the other, there will be a paragraph break between the two.  The newline syntax treats the enclosed text as a single line unless an extra newline (CR/LF) or the DokuWiki newline markup is inserted. This conforms to the practice of the DokuWiki editor. If you place one newline entry above another, they will continue on the same line unless a newline is inserted. See https://github.com/turnermm/nodisp/issues/3 
 + 
 +If you are upgrading from an earlier version of nodisp, which does not support the newline syntax, you will have to remove the file syntax.php from the root directory of the plugin.  This is now replaced by a new file called basic.php in the syntax directory.  
 + 
 +== Group Syntax == 
 +It is also possible to limit access to the hidden material by group. The syntax is the same as for the other cases, except that ACL numbers are replaced by a group names.  
 + 
 +<code> 
 +<nodisp group> 
 +Restricted Data 
 +</nodisp> 
 + 
 +{nodisp group}Restricted Data{/nodisp}  
 +</code>  
 + 
 +**Notice:** The group name does not use the at-sign; it is ''group'', not ''@group''. 
 + 
 +==== 4.1.16 DW2PDF Plugin ==== 
 + 
 +=== 4.1.16.1 Configuration Settings for dw2pdf plugin ===
  
 The plugin provides a few configuration settings that can be configured in the [[plugin:config|Configuration Manager]]. Some can be overridden via url-parameters. The plugin provides a few configuration settings that can be configured in the [[plugin:config|Configuration Manager]]. Some can be overridden via url-parameters.
  
-=== Initiate export only via URL-parameters ===+=== 4.1.16.2 Initiate export only via URL-parameters ===
  
 Per way of export a list of URL-parameters: Per way of export a list of URL-parameters:
Zeile 1482: Zeile 1561:
     * ''book_skipforbiddenpages=1'' -- (optional) Default it will not export if not-accessible pages are selected      * ''book_skipforbiddenpages=1'' -- (optional) Default it will not export if not-accessible pages are selected 
  
-=== via Configuration Manager, but override-able via URL-parameters ===+=== 4.1.16.3 via Configuration Manager, but override-able via URL-parameters ===
  
-If aurl-parameter is provided, that value is used, otherwise the plugin config setting from the Configuration Manager is used.+If a url-parameter is provided, that value is used, otherwise the plugin config setting from the Configuration Manager is used.
  
 == Pagesize == == Pagesize ==
Zeile 1523: Zeile 1602:
 Choose which [[plugin:dw2pdf:pdftemplate|PDF template]] should be used by default. The template can be overridden with the ''tpl'' request variable e.g. add ''&tpl=yourtemplate'' to the export url. Choose which [[plugin:dw2pdf:pdftemplate|PDF template]] should be used by default. The template can be overridden with the ''tpl'' request variable e.g. add ''&tpl=yourtemplate'' to the export url.
  
- +=== 4.1.16.4 Only via URL-parameter ===
-=== Only via URL-parameter ===+
  
 == Watermark == == Watermark ==
Zeile 1530: Zeile 1608:
 Adding this parameter to the url adds a water mark to your document e.g. ''&watermark=DRAFT''. Adding this parameter to the url adds a water mark to your document e.g. ''&watermark=DRAFT''.
  
-=== Only via configuration manager ===+=== 4.1.16.5 Only via configuration manager ===
  
 == Output Control == == Output Control ==
Zeile 1544: Zeile 1622:
 The plugin automatically uses ''print.css'' and ''pdf.css'' files of installed 3rd party plugins to style plugin content. Often plugins do not provide such styles or you may actually prefer their screen styles. In that case list the names of these plugins here. The plugin automatically uses ''print.css'' and ''pdf.css'' files of installed 3rd party plugins to style plugin content. Often plugins do not provide such styles or you may actually prefer their screen styles. In that case list the names of these plugins here.
  
-== QR code==+== QR code ==
  
 Via a placeholder a QR code can be added in the pdf-templates, which is generated with the size given in the configuration. The plugin uses the [[https://github.com/mpdf/qrcode|QR-code library of mPDF]] ([[https://mpdf.github.io/what-else-can-i-do/barcodes.html|docs]]). Setting the size to zero will disable this feature. Via a placeholder a QR code can be added in the pdf-templates, which is generated with the size given in the configuration. The plugin uses the [[https://github.com/mpdf/qrcode|QR-code library of mPDF]] ([[https://mpdf.github.io/what-else-can-i-do/barcodes.html|docs]]). Setting the size to zero will disable this feature.
Zeile 1552: Zeile 1630:
 Lets you show or hide the export button in the pagetools. Lets you show or hide the export button in the pagetools.
  
-== Examples/Usage == +=== 4.1.16.6 PDF Templates ===
- +
-This plugin has two ways of concealing text from unauthorized users.   +
-  - In the first case, it conceals text from all viewers except users who are logged in and belong to either the admin or manager group.  The text is still on the page, but not displayed.  This means it can be viewed using the browser's view source facility. +
-  - In the second case, an acl level is set and if the viewer does not have an acl level equal to or greater than the acl setting, the text is completely removed from the page.  It is not output from the server to the browser. The same is true if the site allows viewers to view the page source using Dokuwiki's view source action. +
- +
-=== Syntax === +
- +
-== The syntax for the first case == +
- +
-<code> +
-<nodisp> your text here </nodisp> +
- +
-<nodisp> +
-your text here +
-etc +
-</nodisp> +
-</code> +
- +
-== The syntax for the second case == +
- +
-<code> +
-<nodisp acl> your text here </nodisp> +
- +
-<nodisp acl> +
-your text here +
-etc +
-</nodisp> +
-</code> +
- +
-''acl'' is the numeric representation of the acl level which is required for the marked off text to be output to the browser.  In other words the viewer must be logged in and have ''acl'' rights for the page in order for the marked up text to be included in the page.  So, for example, with ''<nodisp 8>'' the viewer must have upload permission or greater for the namespace where the page appears; with ''<nodisp 2>'', the viewer must have edit permission or greater for the page, etc.  +
- +
-It's possible to have several ''nodisp'' blocks on a page, each with a different ''acl'' level, so that the current user might have access to one section of text and not another. For example, the user might have write permission ((acl 2)) for a page but not create permission for its namespace.  ''<nodisp 2>'' would mark off a passage which this user could view, but ''<nodisp 4>'' would mark off one which this user does not have access to. A user with create permission for page's namespace ((acl 4)) would uhave access to both.   +
-The ACL levels are described in the [[:acl#background_info|acl documentation]].  +
- +
-== Newline syntax == +
-<code> +
-{nodisp} your text here {/nodisp} +
- +
-{nodisp} +
-your text here +
-etc +
-{/nodisp} +
- +
-{nodisp acl} your text here {/nodisp} +
- +
-{nodisp acl} +
-your text here +
-etc +
-{/nodisp} +
-</code> +
-The ''<nodisp. . . >'' syntax sets off blocks of text. If you place two blocks, one after the other, there will be a paragraph break between the two.  The newline syntax treats the enclosed text as a single line unless an extra newline (CR/LF) or the DokuWiki newline markup is inserted. This conforms to the practice of the DokuWiki editor. If you place one newline entry above another, they will continue on the same line unless a newline is inserted. See https://github.com/turnermm/nodisp/issues/3 +
- +
-If you are upgrading from an earlier version of nodisp, which does not support the newline syntax, you will have to remove the file syntax.php from the root directory of the plugin.  This is now replaced by a new file called basic.php in the syntax directory.  +
- +
-== Group Syntax == +
-It is also possible to limit access to the hidden material by group. The syntax is the same as for the other cases, except that ACL numbers are replaced by a group names.  +
- +
-<code> +
-<nodisp group> +
-Restricted Data +
-</nodisp> +
- +
-{nodisp group}Restricted Data{/nodisp}  +
-</code>  +
- +
-**Notice:** The group name does not use the at-sign; it is ''group'', not ''@group''. +
- +
-==== 4.1.16 DW2PDF Plugin ==== +
- +
-=== PDF Templates ===+
 PDF Templates define the design of the created PDF files and are a good way to easily customize them to your Corporate Identity.  PDF Templates define the design of the created PDF files and are a good way to easily customize them to your Corporate Identity. 
  
 The default PDF template which is shipped with the dw2pdf plugin is shown below. It has simple headers, footers and citation box. The default PDF template which is shipped with the dw2pdf plugin is shown below. It has simple headers, footers and citation box.
  
-{{ :plugin:dw2pdf:pdfexport_with_default_tpl.png?direct&200|The default shipped PDF template}}+{{ :pdfexport_with_default_tpl.png?direct&200|The default shipped PDF template}}
 To create a new template, just create a new folder within the plugin's ''lib/plugins/dw2pdf/tpl/'' folder and put your header, footers, cover page, and style definitions in it. See ''lib/plugins/dw2pdf/tpl/default'' for an example. Do //**not modify**// the template ''default'', this template will be overwritten on updates, so you will lose your changes.  To create a new template, just create a new folder within the plugin's ''lib/plugins/dw2pdf/tpl/'' folder and put your header, footers, cover page, and style definitions in it. See ''lib/plugins/dw2pdf/tpl/default'' for an example. Do //**not modify**// the template ''default'', this template will be overwritten on updates, so you will lose your changes. 
  

Seiten-Werkzeuge

Webseiten-Werkzeuge