Requirements

Pelican FrontMark works with Pelican 3.7+ and Python 3.3+

Getting started

Install pelican-frontmark with pip:

pip install pelican-frontmark

And enable the plugin in you pelicanconf.py (or any configuration file you want to use):

PLUGINS = [
    '...',
    'frontmark',
    '...',
]

Files format

Frontmark will only recognize files using .md extension.

Here an article example:

---
title: My article title
date: 2017-01-04 13:10
modified: 2017-01-04 13:13
tags:
  - tag 1
  - tag 2
slug: my-article-slug
lang: en
category: A category
authors: Me
summary: Some summary
status: draft

custom:
  title: A custom metadata
  details: You can add any structured and typed YAML metadata

---

My article content

Advanced configuration

FRONTMARK_PYGMENTS = {
    'linenos': 'inline',
}

from frontmark.signals import frontmark_yaml_register


def upper_constructor(loader, noder):
    return loader.construct_scalar(node).upper()


def register_upper(reader):
    return '!upper', upper_constructor


def register():
    frontmark_yaml_register.connected(register_upper):

Testing

To test the plugin against all supported Python versions, run tox:

tox

To test only within your current Python version with pytest:

pip install -e .[test]  # Install with test dependencies
pytest  # Launch pytest test suite

or let setuptools do the job:

python setup.py test

1.2.1 (2019-12-09)

• Support CommonMark 0.9.1

1.2.0 (2018-09-08)

• Upgrade to CommonMark 0.8+

• Drop support for Python version prior to 3.5

1.1.0 (2017-01-22)

• Added FRONTMARK_PYGMENTS optionnal setting for Pygments rendering

• Fix links handling (ie. {filename}…)

1.0.1 (2017-01-08)

• Test and fix plugin registeration

• Make version and description available at module level

1.0.0 (2017-01-08)

• Initial release