Skip to content
Small utility for converting Wordpress blog into Hugo ones.
Java Dockerfile FreeMarker
Branch: master
Clone or download

Latest commit

Fetching latest commit…
Cannot retrieve the latest commit at this time.

Files

Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
gradle/wrapper Initial implementation Dec 13, 2019
src
.gitignore
Dockerfile Initial implementation Dec 13, 2019
README.md Add usage documentation Feb 18, 2020
build.gradle Add usage documentation Feb 18, 2020
gradlew
gradlew.bat
settings.gradle

README.md

WordHugoPress

Small utility for converting Wordpress blog from database into Hugo site. See the Story behind.

Configuration

app:
  sources:
    source-1:
      wordpress-home: /optional/path/to/public_html1
      wordpress-remote-base-url: http://optional.website1.org/
      database:
        url: jdbc:mysql://localhost:3306/database1
        username: root
        password: mysql
      tags:
        - 'regular'
      categories:
        - 'Basic posts'
    source-2:
      wordpress-home: /optional/path/to/public_html2
      wordpress-remote-base-url: http://optional.website2.org/
      target-resource-suffix: "-s"
      database:
        url: jdbc:mysql://localhost:3306/database2
        username: root
        password: mysql
      tags:
        - 'extra'
      categories:
        - 'Limited edition posts'
  target:
    hugo-site-content-items-dir: output/blog/content/posts

Sources

Here multiple sources could be declared. Local or remote or both locations could be specified, tool automatically tries to find a resource. So if you do not have a local copy, but there a workable website, just put it.

Also setting wordpress-remote-base-url helps for detecting inner-site or external links. Because inner-site links should be transformed into the new "folders" structure.

Tags, categories and other taxomonies

Special tags or categories could be assigned for specific sources. And, of course, original tokens will also be migrated.

Typical content page layout

Check file resources/templates/empty-post.ftl (Freemarker template) to get an idea about configuring the target post composition.

All fields from original Wordpress posts are propagated into post object. With some additions:

  • postDirectoryName - path to the target hugo directory for the specific post;
  • thumbnailFilename - path to the thumbnail file;
  • taxonomy - taxonomy data as map -> (e.g. post_tag -> ['hey', 'happy']).

Output hugo structure

Just create an empty hugo site.

hugo new site blog

And put its path to the tool configuration.

For example.

target:
  hugo-site-content-items-dir: output/blog/content/posts

Build and run

./gradlew clean build run
You can’t perform that action at this time.