49 lines
1.9 KiB
Markdown
49 lines
1.9 KiB
Markdown
Markdown Inline Extension For Pelican
|
|
=====================================
|
|
This plugin lets you customize inline HTML
|
|
within Markdown by extending Python's Markdown module.
|
|
|
|
Installation
|
|
------------
|
|
To enable, ensure that the `md_inline_extension` plugin is accessible.
|
|
Then add the following to settings.py:
|
|
|
|
PLUGINS = ["md_inline_extension"]
|
|
|
|
Usage
|
|
-----
|
|
By default, any Markdown text inside `[]...[]` will get wrapped in
|
|
`span` tags with a class of `pelican-inline`. For example:
|
|
|
|
`[]Lorem ipsum dolor sit amet, consectetur adipiscing elit[]` will
|
|
become `<span class="pelican-inline">Lorem ipsum dolor sit amet, consectetur adipiscing elit</span>`
|
|
|
|
You can create your own inline patterns and associate them with
|
|
arbitrary classes and styles by using the `MD_INLINE` dictionary in settings.
|
|
The dictionary takes a pattern as key and expects either a string or a tuple
|
|
as a value. If a string is provided, then that will be the CSS class. If
|
|
a tuple is provided, then the first value will be the style, and the second
|
|
value (if present) will be the class. For example:
|
|
|
|
```
|
|
MD_INLINE = {
|
|
'+=+': ('color:red;', 'my-test-class'),
|
|
'|-|': ('color:blue;',),
|
|
'&^': 'my-other-text-class',
|
|
}
|
|
```
|
|
|
|
The above defines three new inline patterns:
|
|
|
|
1. **+=+**: Text within `+=+` will be wrapped in `span` tags like so
|
|
: `<span style="color:red;" class="my-test-class">...</span>`
|
|
2. **|-|**: Text within `|-|` will be wrapped in
|
|
`<span style="color:blue;">...</span>`. Note - no class is present.
|
|
3. **&^**: Text within `&^` will be wrapped in
|
|
`<span class="my-other-text-class">...</span>`. Note - no style present.
|
|
|
|
In order to work seamlessly with default inline patterns such as `*` and
|
|
`**`, it is important that your pattern not contain these characters. So
|
|
do not create patterns that are already part of a default Markdown
|
|
[span element](http://daringfireball.net/projects/markdown/syntax#span).
|