convert.py
Conversion tool for PerlPress static website generator to Nikola static website generator.
Introduction
This tool supports the conversion of website articles from PerlPress to Nikola for my personal website http://www.jan-grosser.de.
The website articles from PerlPress are stored in a SQlite database. With the conversion tool, selected articles can be extracted to input files for Nikola. The format of the Nikola input files are selected to be HTML, because also in the database the articles are stored in HTML. The articles to be converted are referenced by the unique article ID of PerlPress. These IDs are provided via the command line
The tool can also be provided with a source directory, containing auxilliary files for the articles like images or download files. The conversion tool scans the articles for those files, copies the files to a specific output folder and adapt the links/references in the outputted articles as needed for Nikola.
Command
./convert.py [-s src-dir] [-o out-dir] database-file art-id-0 \
[art-id-1 art-id-2 ...]
-s src-dir Source directory holding "auxilliary" files (images,
download files, ...) for the articles
Default is ./source
-o out-dir Output directory for articles files and aux files. If not
present, it will created with following sub diretories:
./output/posts
./output/images
database-file SQLite database file.
See: https://github.com/rzbrk/jan-grosser.de/blob/master/db/jan-grosser.sqlite
art-id-* Article IDs from those articles to be converted, separated
by spaces. If this IDs are stored in a text file (e.g.
art_ids.txt), they can be provided to the conversion tool
via command line by $(cat art_ids.txt).
Examples
./convert.py -s ./source -o ./output jan-grosser.sqlite 1 2 3 4
./convert.py -s ./source -o ./output jan-grosser.sqlite $(cat art_ids.txt)
Dependencies
The following dependencies apply:
- Python 3
- argparse
- os
- shutil
- sys
- sqlite3
- re
- bs4