A Sphinx extension that enables watermarks for HTML output.
Project description
sphinx-watermark is an extension for Sphinx that enables watermarks for HTML output.
Full documentation: https://jokneemo.github.io/sphinx-watermark
Why a Fork?
Forked from kallimachos/sphinxmark
This fork was created primarily to remove the dependency on bottle, and to support updates to Sphinx v7, Docutils, and Pillow.
Some themes perform differently in newer version of Docutils. The main issues faced are html elements are changed between div, section, article, etc.
Sphinxmark only supported div elements and the configuration changes I made to support it were too expansive for a simple pull request. See below for all of the enhancements added.
What’s Different?
Removed bottle dependency
HTML element selection
Static png name to support spaces in text
Collection of fonts
See the fonts directory.
Customizable border
Installation
Install sphinx-watermark using pip:
$ pip3 install sphinx-watermark
Usage
Add sphinx-watermark to the list of extensions in conf.py:
extensions = ['sphinx_watermark']
Enable and configure sphinx-watermark in conf.py. You only have to include the values you want to change from default.
Below is the bare-minimum config for an Internal Draft watermark:
watermark = { 'enabled': False, 'text': 'Internal\nDraft' }
Below are the defaults for all options: (Notice that watermarks are disabled by default.)
watermark = { 'enabled': False, 'selector': { 'type': 'div', 'class': 'body' }, 'position': { 'margin': None, 'repeat': True, 'fixed': False }, 'image': None, 'text': { 'content': None, 'align': 'center', 'font': 'RubikDistressed', 'color': (255, 0, 0), 'opacity': 40, 'size': 100, 'rotation': 0, 'width': 816, 'spacing': 400, 'border': { 'outline': (255, 0, 0), 'fill': None, 'width': 10, 'padding': 30, 'radius': 20, } } }
Build your docs as normal. The defined watermark should appear behind the text.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for sphinx_watermark-2.0.0-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 5ad45f4d0383b6c4e4e5a94238fc628504666b5a95eb7095d686b65043dd0225 |
|
MD5 | 29e466a1ff6f66b37a3c6783f2a9f442 |
|
BLAKE2b-256 | 99605176fd1d4ed9ccbfe4cc741e93c396499d265a25e6d549c44e718c5d21cf |