DokuWiki

It's better when it's simple

User Tools

Site Tools


plugin:pdftools

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
plugin:pdftools [2020-02-10 15:26] – Update information Gero Gotheplugin:pdftools [2023-10-31 00:17] (current) Klap-in
Line 2: Line 2:
  
 ---- plugin ---- ---- plugin ----
-description: Add few simple features for dw2pdf (German language only) +description: Additional features for dw2pdf 
-author     : Gero Gothe  +author     : Gero Gothe 
-email      : practical@medizin-lernen.de +email      : gero.gothe@medizindoku.de
 type       : syntax type       : syntax
-lastupdate : 2020-02-10 +lastupdate : 2021-11-11 
-compatible : 2018-04-22++compatible : Greebo, Hogfather
 depends    : dw2pdf, wrap depends    : dw2pdf, wrap
 conflicts  conflicts 
Line 22: Line 22:
 Install the plugin using the [[plugin:plugin|Plugin Manager]] and the download URL above, which points to latest version of the plugin. Refer to [[:Plugins]] on how to install plugins manually. Install the plugin using the [[plugin:plugin|Plugin Manager]] and the download URL above, which points to latest version of the plugin. Refer to [[:Plugins]] on how to install plugins manually.
  
-===== Examples/Usage ===== 
  
-Presently, this plugin is only offered in **German language.** This will be improved in coming versions.+===== Features =====
  
-Momentan hat dieses Plugin zwei Funktionen, welches die Tätigkeit von einfachen Anwendern erleichtern soll:+  * Optional and configurable slider button to chose a template for pdf-generation 
 +  * Configurable pdf-generate button which can be placed in a page 
 +  * A set of templates for different purposes which can be installed directly from the admin section 
 +  * Upload your own templates in the admin section and option to remove templates 
 +  * Additional wrap-containers and some additional syntax for formatting 
 +  * Additional replacements which can be used in the templates
  
-==== <etikett> ====+ 
 +===== Print Button ===== 
 + 
 +Activate a print button (slider) which is shown at the bottom right of the screen. You can configure the templates which are the display and can be chosen in order to generate a PDF. 
 + 
 +---- 
 + 
 +{{https://raw.githubusercontent.com/practical-solutions/dokuwiki-pdftools/master/img/screenshot2.png}} 
 + 
 +---- 
 + 
 +{{https://raw.githubusercontent.com/practical-solutions/dokuwiki-pdftools/master/img/screenshot1.png}} 
 + 
 +---- 
 +===== Inline PDF button ===== 
 + 
 +Use the ''<pdf>''-Tag in a document to create an inline button. Pressing this button will generate a PDF with the defined template. Syntax: 
 + 
 +  <pdf template-name> 
 +  <pdf template-name quer> 
 + 
 +The option ''quer'' creates the PDF in landscape orientation (German word "quer" = horizontal) 
 + 
 +Standard parameters for the created PDF are 
 +  * toc = 0 (no table of content) 
 +  * tpl = ''template-name'' 
 +  * orientation=landscape (if the keyword ''quer'' is used) 
 + 
 + 
 +===== etikett-Tag =====
  
   <etikett>   <etikett>
  
-Fügt ein Bild einwelches die Größe eines durchschnittlichen Etiketts hatDies ist für Formulare gedacht, bei denen ein Adressaufkleber platziert werden soll+Inserts an image which is meant for printed documentswhere a sticker is to be pasted on.
  
 +{{https://raw.githubusercontent.com/practical-solutions/dokuwiki-pdftools/master/img/etikett.png}}
  
-==== <pdf> ==== 
  
-  <pdf VORLAGENBEZEICHNUNG>+===== Additional wrap containers =====
  
-Erzeugt einen Linkbei der eine Wiki-Seite mit der ausgewählten dw2pdf-Vorlage generiert wird.+If you have the wrap-plugin installedyou can use these addition classes:
  
 +  <WRAP maxtabelle>
 +  Table ist set to 100% width = same as tablewidth-option
 +  | Content | Another content |
 +  </WRAP>
 +  
 +  <WRAP formular>
 +  Table without borders
 +  | Example | Okay |
 +  </WRAP>
 +  
 +  <WRAP formular2>
 +  Table with border only on the bottom of the lines
 +  | Another example | Test |
 +  </WRAP>
  
-==== Zusätzliche WRAP-Klassen ====+  <WRAP platz> 
 +  Increases the padding of cells in a table 
 +  | Test | 
 +  | Test | 
 +  </WRAP>
  
-Ist das wrap-Plugin installiert, so können folgende zusätzliche WRAP-Klassen mit diesem Plugin verwendet werden+  <wrap bigtext>Text scaled to 115%</wrap> 
 +   
 +  <wrap smalltext>Text scaled to 90%</wrap>
  
-| ''<WRAP maxtabelle>'' | Tabelle nimmt 100% der Seitenbreite ein | +===== Create spaces in empty table cells =====
-| ''<WRAP formular>'' | Erzeugt eine Tabelle, bei der die Ränder nicht angezeigt werden. Wird gerne zum Erstellen von Formularen verwendet | +
-| <wrap smalltext> | Skaliert den Text auf 90% | +
-| <wrap bigtext> | Skaliert den Text auf 115% |+
  
 +Vertical space
  
-===== Change Log =====+  | <abstand1> | Test | 
 +  | <abstand2> | Test | 
 +  | <abstand3> | Test |
  
-  * **2020-02-10** +Horizontal space 
-    Additional wrap-classes + 
-  * **2020-02-09** +  | Test | <quer1> | <quer2> | <quer3>
-    * Initial release+ 
 +===== Set of templates ===== 
 + 
 +The pdftools-plugin contains a set of templates which can be installed in the admin section. These templates contain additional replacements: 
 +   
 +  @AUTHOR@ - Name of the author 
 +  @COMPANY@ - Name of the company which can be configured 
 +  @APPROVER@ - Name of the approve (requires Approve- und ApprovePlus-Plugin) 
 + 
 +===== Upload pdf-templates ===== 
 + 
 +Upload form for uploading your own pdf-templates. 
 + 
 +The template files must be placed in a directory, which must bei included in the zip-file. The files are extracted directly into the ''dw2pdf/tpl'' directory. This feature depends on the Linux ''unzip'' programme to work. 
 + 
 +===== Erase pdf-templates ===== 
 + 
 +Button to delete templates from dw2pdf. 
 + 
 +===== Ideas for coming versions ===== 
 + 
 +  online template editor 
 +  configurable GET-Parameters for the ''<pdf>''-Tag and the slider 
 + 
 +===== Compatibility ===== 
 + 
 +Tested with 
 +  PHP **7.3** 
 +  * Dokuwiki / **Hogfather** 
 +  * [[https://www.dokuwiki.org/plugin:approve|Approve-Plugin]] / **2021-02-17** 
 +  [[https://github.com/practical-solutions/dokuwiki-plugin-dw2pdf|dw2pdf / Modified Version]] / **2020-09-16** 
 +  * [[https://github.com/practical-solutions/dokuwiki-plugin-approveplus|ApprovePlus-Plugin]] / **2020-11-23** 
 + 
 +===== Development ===== 
 + 
 +{{rss>https://github.com/practical-solutions/dokuwiki-pdftools/commits/master.atom date}}
  
  
Line 63: Line 151:
  
 I will be thankful for any approvement suggestions or translations in form of pull-requests. I will be thankful for any approvement suggestions or translations in form of pull-requests.
- 
  
plugin/pdftools.1581344778.txt.gz · Last modified: 2020-02-10 15:26 by Gero Gothe

Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Share Alike 4.0 International
CC Attribution-Share Alike 4.0 International Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki