Skip to main content

Sphinx email obfuscation extension

Project description

[Latest PyPI version] [Supported Python versions] [pre-commit: enabled] [Code style: black] [Code style: prettier]

This package provides sphinxcontrib.email, an email obfuscator for Sphinx-based documentation.

Installation

  1. pip install sphinxcontrib-email

Configuration

  1. Add 'sphinxcontrib.email' to the extensions list in conf.py.

    extensions = [ 'sphinxcontrib.email' ]

Usage

Auto Mode

In conf.py, set

email_automode = True

to automatically obfuscate all mailto links.

Manual Mode

To obfuscate an email address use the email role:

:email:`Name Surname <user@myplace.org>`

Renders as “Name Surname” with the appropriate mailto link.

:email:`user@myplace.org`

Renders as “user@myplace.org” with the appropriate mailto link

Disclaimer

The obfuscation code was adapted from http://pypi.python.org/pypi/bud.nospam where it was released by Kevin Teague <kevin at bud ca> under a BSD license.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

sphinxcontrib-email-0.3.1.tar.gz (7.2 kB view details)

Uploaded Source

Built Distribution

sphinxcontrib_email-0.3.1-py3-none-any.whl (6.7 kB view details)

Uploaded Python 3

File details

Details for the file sphinxcontrib-email-0.3.1.tar.gz.

File metadata

  • Download URL: sphinxcontrib-email-0.3.1.tar.gz
  • Upload date:
  • Size: 7.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/50.3.0 requests-toolbelt/0.9.1 tqdm/4.48.2 CPython/3.8.5

File hashes

Hashes for sphinxcontrib-email-0.3.1.tar.gz
Algorithm Hash digest
SHA256 5dae9ae6aec433d5ebffa22fd380180af55b8c6eda7e38da82b4e243472500df
MD5 89a79b319a66b9c2d9ae51f0975b64cd
BLAKE2b-256 307a5bbaa2c0162cb180e5a9e7f67dff4d7345ce80a646e0c8be14d090804797

See more details on using hashes here.

File details

Details for the file sphinxcontrib_email-0.3.1-py3-none-any.whl.

File metadata

  • Download URL: sphinxcontrib_email-0.3.1-py3-none-any.whl
  • Upload date:
  • Size: 6.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/50.3.0 requests-toolbelt/0.9.1 tqdm/4.48.2 CPython/3.8.5

File hashes

Hashes for sphinxcontrib_email-0.3.1-py3-none-any.whl
Algorithm Hash digest
SHA256 3534c0dc91078276c3d6c2050dca3201ac9542f719e49486bf636cd48cadc229
MD5 c37ab3d228b3be28b9d6833edc746dc2
BLAKE2b-256 295116ba45cc2de1c63f10f7457f35bdb6dff8122522299dcdaefc0cf7ab4bd5

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page