Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/amaurycarrade/zds-to-grav
Converts Zeste de Savoir articles to Grav
https://github.com/amaurycarrade/zds-to-grav
converter grav-cli grav-cms zestedesavoir
Last synced: 28 days ago
JSON representation
Converts Zeste de Savoir articles to Grav
- Host: GitHub
- URL: https://github.com/amaurycarrade/zds-to-grav
- Owner: AmauryCarrade
- License: other
- Created: 2018-09-09T11:26:54.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2023-09-13T12:47:39.000Z (over 1 year ago)
- Last Synced: 2024-09-18T04:14:32.670Z (3 months ago)
- Topics: converter, grav-cli, grav-cms, zestedesavoir
- Language: Python
- Size: 63.5 KB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# zds-to-grav
Converts an article or an opinion from [Zeste de Savoir](https://zestedesavoir.com) to [Grav](https://getgrav.org).
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.
```bash
(sudo) pip install zds_to_grav
```
## Usage
```bash
zds-to-grav --help
```
Typical use: from the directory you want to put the exported grav article directory into:
```bash
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`):
```bash
pipenv install
```
Unit tested using `doctest`. From the project directory, within a virtualenv:
```bash
python zds_to_grav.py --test
```
No output means everything is good.