This is a pre-production deployment of Warehouse, however changes made here WILL affect the production instance of PyPI.
Latest Version Dependencies status unknown Test status unknown Test coverage unknown
Project Description

svglue is a small library that takes a template in form of a specially prepared SVG document and fills in text and images to create an output SVG file. Style information like opacity, size, and ordering is kept.

It’s mainly intended to be used to set up a nice workflow creating templates for PDF generation:

  1. Create your template in Inkscape, a placeholder text-element where you want to fill in text later, or a rectangle for filling in images.
  2. Add a custom attribute template-id to every <tspan> or <rect> element that you want to replace. Each template-id must be a unique identifier.
  3. Using svglue, you can programmatically replace every text or rect using its template-id with either a raster image, another SVG graphic or replacement text.
  4. Finally, use something like rsvg, CairoSVG or another SVG-renderer to create a PDF document.

Example code:

Step 3:

#!/usr/bin/env python

import svglue

# load the template from a file
tpl = svglue.load(file='sample-tpl.svg')

# replace some text
tpl.set_text('sample-text', u'This was replaced.')

# replace the pink box with 'hello.png'. if you do not specify the mimetype,
# the image will get linked instead of embedded
tpl.set_image('pink-box', file='hello.png', mimetype='image/png')

# svgs are merged into the svg document (i.e. always embedded)
tpl.set_svg('yellow-box', file='Ghostscript_Tiger.svg')

# to render the template, cast it to a string. this also allows passing it
# as a parameter to set_svg() of another template
src = str(tpl)

# write out the result as an SVG image and render it to pdf using cairosvg
open('output.svg', 'w').write(src)
from cairosvg.surface import PDFSurface
PDFSurface.convert(src, write_to=open('output.pdf', 'w'))

It’s important to note that versions <= 0.5 of cairosvg have a bug that renders the tiger scaled incorrectly. For now, you can use a different renderer for better results until that bug is fixed.

API reference

svglue.load(src=None, file=None)

Loads a template, returning a Template-object. The src/file load pattern is used through the library - src is a string containing the source of the SVG file, or file can either be a file-like object (with a read() method) or a filename for the source file. Only one of src/file may be specified.

Template.set_text(tid, text)

Replaces the text inside the element <tspan id="tid"> (whose id is the actual tid) with the specified text.

Template.set_image(tid, src=None, file=None, mimetype=None)

Replaces a rectangle whose id is tid (<rect id="tid">) with an <image> tag to link/embed the specified image. If mimetype is None, the image is linked (so file should be the path/URI of thte image).

If mimetype is given (should be either image/png or image/jpeg), the supplied image is stored inline in the resulting SVG document.

Template.set_svg(tid, src=None, file=None)

Conceptually similiar to Template.set_image(), this replaces a rectangle with an SVG-image. However, no linking is supported, the SVG is copied into the resulting SVG-documents <defs>-section and a <use>-Element replaces the rectangle.

Since Template.__str__() (see below) is used to render templates, this allows nesting templates by simply passing them as the second argument to set_svg().


Renders the template. Returns the template with all supplied info filled in.

Release History

Release History


This version

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

Download Files

Download Files

TODO: Brief introduction on what you do with files - including link to relevant help section.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
svglue-0.2dev.tar.gz (4.1 kB) Copy SHA256 Checksum SHA256 Source Apr 29, 2013

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS HPE HPE Development Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting