Adding dw2pdf version 2023-11-25 (48253f1).

Signed-off-by: Daniel Baumann <daniel@debian.org>
2024-12-01 20:29:19 +01:00 · 2024-12-01 20:29:19 +01:00 · 8e32b01eb0
commit 8e32b01eb0
parent d4820b660a
999 changed files with 144285 additions and 0 deletions
--- a/plugins/55/dw2pdf/tpl/default/README.txt
+++ b/plugins/55/dw2pdf/tpl/default/README.txt
@ -0,0 +1,69 @@
+====== dw2pdf Templates ======
+
+Templates define the design of the created PDF files and are a good way
+to easily customize them to your Corporate Identity.
+
+To create a new template, just create a new folder within the plugin's
+''tpl'' folder and put your header, footers and style definitions in it.
+
+===== Headers and Footers =====
+
+The following files can be created and will be used to set headers and
+footers on odd or even pages. Special headers/footers can be used on the
+first page of a document. If a file is does not exist the next more generic
+one will be tried. Eg. if You don't differ between even and odd pages,
+just the header.html is used.
+
+  * ''header.html'' -- Header for all pages
+  * ''header_odd.html'' -- Header for odd pages
+  * ''header_even.html'' -- Header for even pages
+  * ''header_first.html'' -- Header for the first page
+
+  * ''footer.html'' -- Footer for all pages
+  * ''footer_odd.html'' -- Footer for odd pages
+  * ''footer_even.html'' -- Footer for even pages
+  * ''footer_first.html'' -- Footer for the first page
+
+  * ''citation.html'' -- Citationbox to be printed after each article
+  * ''cover.html'' -- Added once before first page
+  * ''back.html'' -- Added once after last page
+
+You can use all HTML that is understood by mpdf
+(See http://mpdf1.com/manual/index.php?tid=256)
+
+If you reference image files, be sure to prefix them with the @TPLBASE@
+parameter (See [[#Replacements]] below).
+
+===== Replacements =====
+
+The following replacement patterns can be used within the header and
+footer files.
+
+  * ''@PAGE@'' -- current page number in the PDF
+  * ''@PAGES@'' -- number of all pages in the PDF
+  * ''@TITLE@'' -- The article's title
+  * ''@WIKI@'' -- The wiki's title
+  * ''@WIKIURL@'' -- URL to the wiki
+  * ''@DATE@'' -- time when the PDF was created (might be in the past if cached)
+  * ''@BASE@'' -- the wiki base directory
+  * ''@INC@'' -- the absolute wiki install directory on the filesystem
+  * ''@TPLBASE@'' -- the PDF template base directory (use to reference images)
+  * ''@TPLINC@'' -- the absolute path to the PDF template directory on the filesystem
+
+//Remark about Bookcreator//:
+The page depended replacements are only for ''citation.html'' updated for every page.
+In the headers and footers the ID of the bookmanager page of the Bookcreator is applied.
+  * ''@ID@'' -- The article's pageID
+  * ''@PAGEURL@'' -- URL to the article
+  * ''@UPDATE@'' -- Time of the last update of the article
+  * ''@QRCODE@'' -- QR code image pointing to the original page url (requires an online generator, see config setting)
+
+===== Styles =====
+
+Custom stylings can be provided in the following file of your dw2pdf-template folder:
+
+  * style.css
+
+You can use all the CSS that is understood by mpdf
+(See http://mpdf1.com/manual/index.php?tid=34)
+
--- a/plugins/55/dw2pdf/tpl/default/citation.html
+++ b/plugins/55/dw2pdf/tpl/default/citation.html
@ -0,0 +1,21 @@
+<br />
+<br />
+<div style="font-size: 80%; border: solid 0.5mm #DDDDDD;background-color: #EEEEEE; padding: 2mm; border-radius: 2mm 2mm; width: 100%;">
+    <table width="100%">
+        <tr>
+            <td>
+                From:<br />
+                <a href="@WIKIURL@">@WIKIURL@</a>&nbsp;-&nbsp;<b>@WIKI@</b>
+                <br /><br />
+                Permanent link:<br />
+                <b><a href="@PAGEURL@">@PAGEURL@</a></b>
+                <br /><br />
+                Last update: <b>@UPDATE@</b>
+                <br />
+            </td>
+            <td align="right">
+                @QRCODE@
+            </td>
+        </tr>
+    </table>
+</div>
--- a/plugins/55/dw2pdf/tpl/default/footer_even.html
+++ b/plugins/55/dw2pdf/tpl/default/footer_even.html
@ -0,0 +1,7 @@
+<table width="100%" class="pdffooter">
+    <tr>
+        <td style="text-align: left">@WIKIURL@</td>
+        <td style="text-align: center"></td>
+        <td style="text-align: right">Printed on @DATE@</td>
+    </tr>
+</table>
--- a/plugins/55/dw2pdf/tpl/default/footer_odd.html
+++ b/plugins/55/dw2pdf/tpl/default/footer_odd.html
@ -0,0 +1,7 @@
+<table width="100%" class="pdffooter">
+    <tr>
+        <td style="text-align: left">@WIKI@ - @WIKIURL@</td>
+        <td style="text-align: center"></td>
+        <td style="text-align: right"></td>
+    </tr>
+</table>
--- a/plugins/55/dw2pdf/tpl/default/header_even.html
+++ b/plugins/55/dw2pdf/tpl/default/header_even.html
@ -0,0 +1,7 @@
+<table width="100%" class="pdfheader">
+    <tr>
+        <td style="text-align: left">Last update: @UPDATE@</td>
+        <td style="text-align: center">@ID@</td>
+        <td style="text-align: right">@PAGEURL@</td>
+    </tr>
+</table>
--- a/plugins/55/dw2pdf/tpl/default/header_odd.html
+++ b/plugins/55/dw2pdf/tpl/default/header_odd.html
@ -0,0 +1,7 @@
+<table width="100%" class="pdfheader">
+    <tr>
+        <td style="text-align: left">@DATE@</td>
+        <td style="text-align: center">@PAGE@/@PAGES@</td> <!-- remove / and use setting $mpdf->pagenumSuffix = '/'; to have only / if @PAGES@ is defined -->
+        <td style="text-align: right">@TITLE@</td>
+    </tr>
+</table>
--- a/plugins/55/dw2pdf/tpl/default/style.css
+++ b/plugins/55/dw2pdf/tpl/default/style.css
@ -0,0 +1,70 @@
+table.pdfheader {
+    font-size: 8pt;
+    border-collapse: collapse;
+    border-bottom: 1px solid #000000;
+    clear: both;
+}
+
+table.pdffooter {
+    font-size: 8pt;
+    border-collapse: collapse;
+    border-top: 1px solid #000000;
+    clear: both;
+}
+
+/* Table of Content -- see http://mpdf1.com/manual/index.php?tid=243 */
+div.mpdf_toc {
+}
+a.mpdf_toc_a {
+    color: black; /* links black as well */
+}
+/* Whole line level 0 */
+div.mpdf_toc_level_0 {
+    line-height: 1.5;
+    margin-left: 0;
+    padding-right: 1em; /* padding-right should match e.g <dottab outdent="2em" /> 0 is default */
+}
+/* Title level 0 - may be inside <a> */
+span.mpdf_toc_t_level_0 {
+}
+/* Page no. level 0 - may be inside <a> */
+span.mpdf_toc_p_level_0 {
+}
+/* Whole line level 1 */
+div.mpdf_toc_level_1 {
+    margin-left: 1em;
+    text-indent: -1em;
+    padding-right: 1em; /* padding-right should match <dottab outdent="2em" /> 2em is default */
+}
+/* Title level 1 */
+span.mpdf_toc_t_level_1 {
+}
+/* Page no. level 1 - may be inside <a> */
+span.mpdf_toc_p_level_1 {
+}
+/* level 2 */
+div.mpdf_toc_level_2 {
+    margin-left: 2em;
+    text-indent: -1em;
+    padding-right: 1em; /* padding-right should match <dottab outdent="2em" /> 2em is default */
+}
+span.mpdf_toc_t_level_2 {}
+span.mpdf_toc_p_level_2 {}
+
+/* level 3 */
+div.mpdf_toc_level_3 {
+    margin-left: 3em;
+    text-indent: -1em;
+    padding-right: 1em; /* padding-right should match <dottab outdent="2em" /> 2em is default */
+}
+span.mpdf_toc_t_level_3 {}
+span.mpdf_toc_p_level_3 {}
+
+/* level 4 */
+div.mpdf_toc_level_4 {
+    margin-left: 4em;
+    text-indent: -1em;
+    padding-right: 1em; /* padding-right should match <dottab outdent="2em" /> 2em is default */
+}
+span.mpdf_toc_t_level_4 {}
+span.mpdf_toc_p_level_4 {}