39 lines
1.2 KiB
Markdown
39 lines
1.2 KiB
Markdown
jekyll2s9y importer
|
|
===================
|
|
|
|
This is a tool to import my Jekyll-based [GitHub Pages](https://pages.github.com) blog/wiki
|
|
into [Serendipity](https://s9y.org).
|
|
|
|
|
|
Preparations
|
|
------------
|
|
|
|
Setup Serendipity with an SQLite database. Download the database file to where you also plan to run jekyll2s9y.
|
|
|
|
|
|
Usage
|
|
-----
|
|
|
|
Copy `config.yaml.example` to `config.yaml` and modify according to your needs. Note that
|
|
`jekyll_dir` has to point to your Jekyll base directory.
|
|
|
|
If not done already, update the Python environment:
|
|
|
|
pipenv install
|
|
|
|
Then run the script:
|
|
|
|
pipenv run ./jekyll2s9y.py
|
|
|
|
Now copy the new database file (`s9y_database_output` in the config.yaml) back to your server and overwrite
|
|
the old version. Also copy the `uploads` directory containing the media files. Then, in the Serendipity admin
|
|
area, edit your configuration and change the permalink for "Entry URL structure" in any way (e.g. add a letter
|
|
to the end) to have the permalinks regenerated. Afterwards, you can undo the change again.
|
|
|
|
|
|
Issues
|
|
------
|
|
|
|
If there are two entries where the permalink generation (i.e. stripping all emojis, etc.) results in the same
|
|
permalink, only the older one can be accessed.
|