Changes between Version 11 and Version 12 of TracWikiPrintPlugin


Ignore:
Timestamp:
Apr 3, 2009, 8:17:12 AM (15 years ago)
Author:
Álvaro Iradier
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • TracWikiPrintPlugin

    v11 v12  
    3535}}}
    3636
     37When enabled, a new administrative panel with name ''WikiPrint'' will be made available, and 3 new formats will be available in the ''Download in other formats'' section at the end of the wiki page:
     38
     39 * PDF Article
     40 * PDF Book
     41 * Printable HTML
     42
    3743Additional options can be set by creating a ''wikiprint'' section:
    3844
     
    5258[[Image(wiki:TracWikiPrintPlugin:admin_screenshot.jpg)]]
    5359
     60
     61=== Some notes ===
     62
     63==== xhtml2pdf special tags and styles ====
     64
    5465!WikiPrint works by converting one or some Wiki pages to HTML, adding some CSS styles and replacing special tags, and then passing the output to the xhtml2pdf library, so in order to understand how to customize the output using CSS, and to use some special html tags used by xhtml2pdf, you'll have to check the [attachment:"pisa-en.pdf" xhtml2pdf manual].
    5566
    5667Also, check the default ''css'' and ''extra_content'' files, as they provide usage examples. To see the contents of the default files, leave the corresponding field blank in the administration panel, and click the '''View''' button.
     68
     69==== Images ====
     70
     71WikiPrint exports the wiki format to HTML first, then converts the HTML to PDF using xhtml2pdf library. Links and image references in the wiki to html conversion are made as absolute URLS, and then absolute urls (like http://myserver/myproject/wiki/attachments/myimage.jpg) are replaced by the environment local path before converting to PDF (like c:/path/to/my/environment/wiki/attachments/myimage.jpg). This should be done automatically, with no additional settings, from the URL in the request.
     72
     73There are some limitations in the supported image formats, due to the way the Image macro works. See #4865
    5774
    5875=== Export formats ===