Hakyll-convert provides a library and a program for importing blogs from a variety of engines (currently, Blogger and WordPress) to the Hakyll static site generator.
We aim to:
- avoid converting your content between formats (it usually comes in HTML and should stay as such without passing through filters)
- allow for the possibility of Cool URIs by keeping
relative page names the same as on your old blog (this only works
if you use your own domain for your hosted site). If you don't agree with us
on that point, use
--output-format
flag to specify your own output filename format.
-
You should make a dump (backup) of all the posts in your existing blog. For Blogger, see this post in the Help Center. For WordPress, see this support page.
-
Install
hakyll-convert
usingcabal-install
:$ cabal install hakyll-convert
-
Assuming you have your backup in a file named backup.atom, run one of the following:
-
if it's a Blogger backup:
$ hakyll-convert --format=blogger backup.atom posts
-
if it's a WordPress backup:
$ hakyll-convert --format=wordpress backup.atom posts
-
-
You now have a directory named "posts" with HTML or Markdown files containing your posts.
For more control over the conversion, see --output-format
and
--extract-comments
options. For now, --help
is the best documentation we
have (second only to the code. Sorry once again).