zds-to-grav

Converts Zeste de Savoir articles to Grav


Keywords
converter, grav-cli, grav-cms, zestedesavoir
License
CECILL-B
Install
pip install zds-to-grav==1.0.2

Documentation

zds-to-grav

Converts an article or an opinion from Zeste de Savoir to Grav.

Accepts either an URL to a ZdS article/optinion, or an exported archive.

Note: the generated frontmatter includes some non-standard fields, as this was initially built for my own use and my theme uses them. Standard fields are covered. Authors are assumed to be a taxonomy.

Installation

Requires Python 3.6 or newer.

(sudo) pip install zds_to_grav

Usage

zds-to-grav --help

Typical use: from the directory you want to put the exported grav article directory into:

zds-to-grav https://zestedesavoir.com/articles/42/le-point-sur-les-exoplanetes/

See options in --help to specify explicit slug, article type, lang, or destination directory (numbered or not).

Development & tests

Installation for development (requires pipenv: sudo pip install pipenv):

pipenv install

Unit tested using doctest. From the project directory, within a virtualenv:

python zds_to_grav.py --test

No output means everything is good.