{
"info": {
"author": "Journalism Robotics Stockholm",
"author_email": "contact@newsworthy.se",
"bugtrack_url": null,
"classifiers": [],
"description": "\nInstalling\n----------\n\n.. code-block:: bash\n\n pip install newsworthy_slides\n\n\nUsing\n-----\n\nThis library has one main function: `slides_from_xml()` which lets you generate and slides from a custom HTML structure (described below).\n\nBasic usage:\n\n.. code-block:: python\n\n from newsworthy_slides import slides_from_xml\n\n slides_xml = \"\"\"\n \n \n Hello world!\n \n \n \"\"\"\n\n # Generate to new, empty presentation\n pres = slides_from_xml(slides_xml)\n\n # Generate to existing presentation\n pres = slides_from_xml(slides_xml, \"path/to/my_base_slides.pptx\")\n\n # pres is an instance of pptx.Presentation and can be saved easily:\n pres.save('my_presentation.pptx')\n\n\n\nThe XML structure\n-----------------\n\n\nSlides\n~~~~~~\n\nA slide must always have a `layout` attribute referring to the name of a slide layout.\n\n.. code-block:: XML\n\n \n \n\nA slide _may_ have `position` attribute which defines where in the presentation the slide is to be added.\n\nA slide consists of a number of placeholders.\n\n.. code-block:: XML\n\n \n \n Hello world!\n \n \n\nEach placeholder must have a `type` attribute, which can be either `text`, `image`, `table`. The `type` attribute defines how the content of the tag is to be interpreted.\n\nThe placeholders may also have a `name` attribute. This attribute should refer to a placeholder name in the slide layout.\n\n.. code-block:: XML\n\n \n Hello\n World!\n \n\nIf no placeholder name is defined the placeholders will be positioned in order.\n\n.. code-block:: XML\n\n \n First placeholder\n Second placeholder\n \n\n\nThe different placeholders types are defined below.\n\nText placeholders\n~~~~~~~~~~~~~~~~~\n\nText placeholders may contain plain text or basic html. `
` and `
` tags are interpreted as paragraphs.\n\n.. code-block:: XML\n\n \n Hello world!\n \n\n \n
Hello Earth!
\n
Hello Mars!
\n \n\n \n
Hello Earth!
\n
Hello Mars!
\n \n\n``, ``/`` and `` tags may be used for inline formating and linking.\n\n.. code-block:: XML\n\n \n Hello world. Considering a Mars?\n \n\n\nImage placeholders\n~~~~~~~~~~~~~~~~~~\n\nAn image placeholder recognizes `` tags and picks up the path (or url) to the image from the `src` attribute.\n\n.. code-block:: XML\n\n \n \n \n\nNote that the placeholder explicitly has to be a picture placeholder. This has to be set manually in Powerpoint. At the moment of writing Google Slides does not support picture placeholders (neither does Libre Office). A base presentation from Google Slides will not, in other words, be able to handle this image placeholders.\n\nTable placeholders\n~~~~~~~~~~~~~~~~~~\n\nA table placeholder should contain an html table. All `
` tags are parsed as rows. `
` and `
` tags are parsed as cells. The cells may contain same basic text formatting as paragraphs (`` for bold, `` for italic etc).\n\nCells with `class=\"value\"` are interpreted as numbers and right-aligned.\n\n`` and `` may be present, but does not bring any meaning. `
![](\"path/to/image.png\")
\n