mkdocs-safe-text-plugin 1.0.0

Plugin for safe text editing with MKDocs.

Plugin for safe text editing with MKDocs.

Table of Contents

• How does this plugin work?

• Installation

• Plugin configuration

• License

How does this plugin work?

Markdown is a very flexible format, and raw HTML is allowed. But it is unnecessary in multiple-person text editing.

When raw HTML like <font> tag is used in MKDocs, it is rendered as it is.

If you use this plug-in with MKDocs, tags that are not allowed in the whitelist are escaped.

Installation

Install it via PyPI using pip command.

$ pip install mkdocs-safe-text-plugin

And add it to your mkdocs.yml file.

plugins:
  - mkdocs_safe_text

An example of use can be checked by example/basic-usage.

Plugin configuration

This plugin works with the HTML tag element for Markdown defined by bleach-whitelist enabled. This implementation approach is recommended in the Python-Markdown release notes.

And user can change this setting.

plugins:
  - mkdocs_safe_text:
      append_allowed_tags:
        - tag1
        - tag2
      remove_allowed_tags:
        - tag3
        - tag4
      allowed_attrs:
        tag5:
          - attribute1
          - attribute2

An example of use can be checked by example/customization-usage.

License

BSD 2-Clause License

CHANGELOG

1.0.0

• First stable release version

  • Support Python 3.3 or later

0.5.0

• Support reST format in PyPI Web UI

  • Add dependency on pypandoc

0.4.0

• Update status to Beta version

  • Add documentation about this plugin

  • Add a Makefile for tidy tasks

0.3.0

• Update status to Alpha version

0.2.0

• Implement plugin configuration

  • Add class files to mkdocssafetext

  • Add unittest files to tests

0.1.0

• First planning version

  • Make temporary directory structure

  • Add requirement specifiers