Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/rolfff/mkdocs-encriptmail-plugin

A MkDocs plugin that converts markdown encoded email-links into spambot save <a href> elements.
https://github.com/rolfff/mkdocs-encriptmail-plugin

email markdown mkdocs

Last synced: 2 days ago
JSON representation

A MkDocs plugin that converts markdown encoded email-links into spambot save <a href> elements.

Awesome Lists containing this project

README

        

# MkDocs encriptMail Plugin

This [MkDocs](https://www.mkdocs.org) plugin converts markdown encoded email addresses like

```
[Email-Link](mailto:[email protected])
```

into

```html

Email-Link

```

or

```
[[email protected]](mailto:[email protected])
```

into

```html

test(Q)test(P)test

```

This allows to hide email address from spam bots and allows user to link email addresses.

## Requirements

This package requires Python >=3.5 and MkDocs version 1.0 or higher.

## Installation

Install the package with pip:

```cmd
pip install mkdocs-encriptmail-plugin
```

Enable the plugin in your `mkdocs.yml`:

```yaml
plugins:
- search
- encriptmail:
placeholderAt: (Q)
placeholderDot: (P)
```

**Note:** If you have no `plugins` entry in your config file yet, you'll likely also want to add the `search` plugin. MkDocs enables it by default if there is no `plugins` entry set, but now you have to enable it explicitly.

More information about plugins in the [MkDocs documentation](https://www.mkdocs.org/user-guide/plugins/)