README


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61

Introduction
============
This is a set of scripts that can be used to do a semi-automatic
migration from WordPress to haunt, a static website generator.

The code is a bit fragile and parses untrusted data so a human is
required to review if there are any suspicious data at several steps
in the migration process.

Dependencies
============
To generate this website you will need guix and curl. The rest of the
dependencies are taken care of by Guix. Once you installed Guix you
need to run 'guix pull' to have the latest revision.

Usage
=====

First run 'make links.txt' manually to produce the links.txt file.
Then you need to manually inspect it to see if it contains dangerous
or problematic characters / text.

Then you need to run run 'make markdown' to download all the blog
posts in wordpress/articles and convert them to markdown (and store
them in markdown/).

At this stage the website is then ready to used with haunt. You can
then build it with 'make build' or 'make serve'.


Reimporting articles in WordPress
=================================

If for some reasons you then need to import back some of the markdown
articles in WordPress, you use the 'make generate-wordpress-articles'
command, it will print out the article title and the HTML code that
you will need to copy-paste into WordPress.

By default, when creating an article in WordPress, you are presented
with a visual editor that is intended for people to create articles
without needing to write any HTML code.

Since here we need to paste HTML code here you will need to switch to
the "code editor" to be able to do that. The [WordPress official
documentation](https://wordpress.com/support/editors/) has more
details on where to find that "code editor".

License
=======
This project is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or (at
your option) any later version.

This project is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program.  If not, see <https://www.gnu.org/licenses/>.