Giter Club home page Giter Club logo

exitwp-for-hugo_clone's Introduction

ExitWP for Hugo

This is a port of Thomas Frössman's ExitWP tool (for Jekyll).

You can find also a howto and background information here on my website: https://arjan.wooning.cz/conversion-tools-from-wordpress-to-hugo/#final-solution-exitwp-for-hugo

Exitwp is tool for making migration from one or more wordpress blogs to the hugo blog engine as easy as possible.

By default it will try to convert as much information as possible from wordpress but can also be told to filter the amount of data it converts.

The latest version of these docs should always be available at https://github.com/wooni005/exitwp-for-hugo

Getting started

  • Download or clone using git clone https://github.com/wooni005/exitwp-for-hugo.git
  • Export one or more wordpress blogs using the wordpress exporter under tools/export in wordpress admin.
  • Put all wordpress xml files in the wordpress-xml directory
  • Special note for Wordpress 3.1, you need to add a missing namespace in rss tag : xmlns:atom="http://www.w3.org/2005/Atom"
  • Run xmllint on your export file and fix errors if there are.
  • Run the converter by typing ./exitwp.py in the console from the directory of the unzipped archive
  • You should now have all the blogs converted into separate directories under the build directory

Runtime dependencies

  • Python: Python 2
  • html2text : converts HTML to markdown (python)
  • PyYAML : Reading configuration files and writing YAML headers (python)
  • Beautiful soup : Parsing and downloading of post images/attachments (python)

Installing dependencies in ubuntu/debian

sudo apt-get install python-yaml python-bs4 python-html2text

Installing Python dependencies using python package installer (pip)

From the checked out root for this project, type:

sudo pip install --upgrade -r pip_requirements.txt

Note that PyYAML will require other packages to compile correctly under ubuntu/debian, these are installed by typing:

sudo apt-get install libyaml-dev python-dev build-essential

Configuration/Customization

See the configuration file for all configurable options.

Some things like custom handling of non standard post types is not fully configurable through the config file. You might have to modify the source code to add custom parsing behaviour.

Known issues

  • Target file names are some times less than optimal.
  • Rewriting of image/attachment links if they are downloaded would be a good feature
  • There will probably be issues when migrating non utf-8 encoded wordpress dump files (if they exist).

Other Tools

exitwp-for-hugo_clone's People

Contributors

thomasf avatar wooni005 avatar yorkxin avatar huxuan avatar cedricporter avatar zenithar avatar amithgeorge avatar danifbento avatar mgalves avatar juliangruber avatar iromeister avatar astockwell avatar astockwell-ps avatar devkmsg avatar ashipkowski avatar agateau avatar bascht avatar etc avatar jberryman avatar dsteinkopf avatar gpoul avatar jamesward avatar goles avatar phlash avatar ronnie76er avatar daoluan avatar oz123 avatar

Watchers

James Cloos avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.