Metadata-Version: 2.1
Name: plone.pdfexport
Version: 1.0b1
Summary: PDF export of Plone content based on the weasyprint library.
Home-page: https://github.com/collective/plone.pdfexport
Author: Maik Derstappen
Author-email: md@derico.de
License: GPL version 2
Project-URL: PyPI, https://pypi.python.org/pypi/plone.pdfexport
Project-URL: Source, https://github.com/collective/plone.pdfexport
Project-URL: Tracker, https://github.com/collective/plone.pdfexport/issues
Description: .. This README is meant for consumption by humans and pypi. Pypi can render rst files so please do not use Sphinx features.
           If you want to learn more about writing documentation, please check out: http://docs.plone.org/about/documentation_styleguide.html
           This text does not appear on pypi or github. It is a comment.
        
        .. image:: https://github.com/plone/plone.pdfexport/actions/workflows/plone-package.yml/badge.svg
            :target: https://github.com/plone/plone.pdfexport/actions/workflows/plone-package.yml
        
        .. image:: https://coveralls.io/repos/github/plone/plone.pdfexport/badge.svg?branch=main
            :target: https://coveralls.io/github/plone/plone.pdfexport?branch=main
            :alt: Coveralls
        
        .. image:: https://img.shields.io/pypi/v/plone.pdfexport.svg
            :target: https://pypi.python.org/pypi/plone.pdfexport/
            :alt: Latest Version
        
        .. image:: https://img.shields.io/pypi/status/plone.pdfexport.svg
            :target: https://pypi.python.org/pypi/plone.pdfexport
            :alt: Egg Status
        
        .. image:: https://img.shields.io/pypi/pyversions/plone.pdfexport.svg?style=plastic   :alt: Supported - Python Versions
        
        .. image:: https://img.shields.io/pypi/l/plone.pdfexport.svg
            :target: https://pypi.python.org/pypi/plone.pdfexport/
            :alt: License
        
        
        ===============
        plone.pdfexport
        ===============
        
        Provides PDF export functionality for Plone content.
        
        Features
        --------
        
        - Exports Documents, Event, News items and other custom content.
        - Can be customized via CSS in the PDF Export control panel.
        - Long tables which will be rendered on more than one page, will have the thead repeated on every page.
        - One can use Plone body tag CSS classes to define CSS rules for specific Plone content.
        
        This add-on is based on the great `WeasyPrint library <https://weasyprint.org>`_.
        
        Translations
        ------------
        
        This product has been translated into
        
        - english
        - german
        
        
        Installation
        ------------
        
        Install plone.pdfexport by adding it to your buildout::
        
            [buildout]
        
            ...
        
            eggs =
                plone.pdfexport
        
        
        and then running ``bin/buildout``
        
        Usage
        -----
        
        After installing the add-on you can call the "aspdf" view on any Plone content.
        
        ``http://localhost:8080/Plone/news/aspdf``
        
        for testing, you can add the GET parameter "html=1" to see the HTML version before it get rendered into a PDF.
        
        ``http://localhost:8080/Plone/news/aspdf?html=1``
        
        
        To archive landscape mode, one can adjust the CSS in the control panel:
        
        .. code-block:: CSS
        
            @page {
                margin: 2.75cm 1.4cm 1.4cm 1.4cm;
                size: landscape;
                @top-center {
                    font-size:12px;
                    color:#666666;
                    content: "Beautiful Plone content, deserves a beautiful PDF export!";
                }
                @bottom-left {
                    font-size:12px;
                    color:#666666;
                    content: "provided by derico.de";
                }
                @bottom-right {
                    font-size:12px;
                    color:#666666;
                    content: "Page " counter(page);
                }
        
            }
        
        
        Authors
        -------
        
        This add-on was build by `Derico <https://derico.de>`_ [MrTango].
        
        
        Contribute
        ----------
        
        - Issue Tracker: https://github.com/plone/plone.pdfexport/issues
        - Source Code: https://github.com/plone/plone.pdfexport
        
        
        Support
        -------
        
        If you are having issues, please let us know.
        
        
        License
        -------
        
        The project is licensed under the GPLv2.
        
        
        Contributors
        ============
        
        - Maik Derstappen, md@derico.de
        
        
        Changelog
        =========
        
        
        1.0b1 (2021-07-15)
        ------------------
        
        - Resolve images internally in a custom WeasyPrint url_fetcher, this removes the need to resolves url's for WeasyPrint, which was problematic with permissions or https cert issues
          [MrTango]
        
        
        1.0a4 (2021-07-14)
        ------------------
        
        - Don't use  optimize_images=True in weasyprint for now, it only works in Py3 versions
          [MrTango]
        
        1.0a3 (2021-07-14)
        ------------------
        
        - Add print_image_scale to control panel and use custom image scale for PDF export
          [MrTango]
        
        
        1.0a2 (2021-07-14)
        ------------------
        
        - Fix missing lead image viewlet in PDF export
          [MrTango]
        
        - Merge content css classes with body tag classes instead of overriding them
          [MrTango]
        
        
        1.0a1 (2021-07-13)
        ------------------
        
        - Initial release.
          [MrTango]
        
Keywords: Python Plone CMS
Platform: UNKNOWN
Classifier: Environment :: Web Environment
Classifier: Framework :: Plone
Classifier: Framework :: Plone :: Addon
Classifier: Framework :: Plone :: 5.2
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3.7
Classifier: Operating System :: OS Independent
Classifier: License :: OSI Approved :: GNU General Public License v2 (GPLv2)
Requires-Python: ==2.7, >=3.6
Provides-Extra: test
