Skip to main content

A tool to convert a Movable Type site to a Publ site

Project description

mt2publ

A tool to (partially) convert a Movable Type website for use with Publ.

Basic usage

Currently only SQLite databases are supported (although adding direct support for MySQL and Postgres isn't too hard). If you have a MySQL database dump you can convert it to SQLite via mysql2sqlite, and for Postgres you can follow these instructions.

pip install mt2publ
mt2publ -b BLOG_ID -c /path/to/site/content database.db

If you don't specify -b then it will dump all entries and category metadata from the MT database, which is probably not what you want if you have multiple blogs configured on the dashboard. You can find the specific blog ID by looking at its URL from the dashboard.

Current status

It has been tested successfully to extract entries and categories from a single Movable Type 4.21 website.

Features

What's supported

  • Markdown, Rich Text, and HTML entries (both with and without "convert linebreaks" set), with both intro and extended text
  • Publication status:
    • "Draft" and "Scheduled" supported directly
    • "Review" becomes "HIDDEN"
    • "Spam" becomes "GONE"
    • "Published" tries to do the right thing with Publ's scheduling model
  • Category metadata
  • Blog metadata (stored on the root category)
  • Multiple categories with some limitations:
    • It tries to infer the actual category based on the entry's primary category and what other subcategories an entry is in
    • All category placements are set in metadata headers, allowing manual cleanup (and fancy template logic if you so choose)
  • Sets path aliases of "entry" and "page" assets based on the original template mappings
  • Preserves the original entry ID as Import-ID
  • Entry-Type for entry vs. page
  • Atom-Tag for the original, inferior atom <id> elements

What won't be supported

  • Asset relocation
  • Converting HTML/richtext entries to Markdown (use Pandoc if you're feeling brave)
  • Native multiple categories (unless those become supported by Publ)
  • Things which are absolutely too complicated to get right, such as:
    • Full automated template conversion

What's feasible

  • Limited template conversion as a starting point
  • Limited category path alias support
  • Native support for MySQL, Oracle, and Postgres databases
  • Tags
  • Output backends for other blogging systems (Jekyll, Pelican, etc.)
  • Comment export (probably using the WordPress comment dump format, since many hosted comment systems support that, notably Disqus)

Data compatibility notes

Entry dates

The Date and Last-Modified are based on local time, since Movable Type only provides a single global timezone offset (not even a locale!) for the entire blog.

Feed <id>s

Atom-Tag potentially leaks data and shouldn't be used, unless you are really worried about Atom feed subscribers seeing duplicate entries. If you still want to use this feature, the appropriate XML fragment would be:

{% if entry['Atom-Tag'] %}
<id>{{entry['Atom-Tag']}}</id>
{% else %}
<id>urn:uuid:{{entry.uuid}}</id>
{% endif %}

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mt2publ-0.1.1.tar.gz (8.7 kB view details)

Uploaded Source

Built Distribution

mt2publ-0.1.1-py3-none-any.whl (10.9 kB view details)

Uploaded Python 3

File details

Details for the file mt2publ-0.1.1.tar.gz.

File metadata

  • Download URL: mt2publ-0.1.1.tar.gz
  • Upload date:
  • Size: 8.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.13.0 pkginfo/1.5.0.1 requests/2.21.0 setuptools/40.8.0 requests-toolbelt/0.9.1 tqdm/4.31.1 CPython/3.7.0

File hashes

Hashes for mt2publ-0.1.1.tar.gz
Algorithm Hash digest
SHA256 742369d7adda3d7ca66cf3ffc9bb23f2227bb82b9ded9e3f66cbf543997fe766
MD5 79bbce38704d8bc850fa55e956a1a157
BLAKE2b-256 273ee7e48985604a0360cc2d7e6d196e153eee9935061b77c1d9bf83691504a8

See more details on using hashes here.

Provenance

File details

Details for the file mt2publ-0.1.1-py3-none-any.whl.

File metadata

  • Download URL: mt2publ-0.1.1-py3-none-any.whl
  • Upload date:
  • Size: 10.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.13.0 pkginfo/1.5.0.1 requests/2.21.0 setuptools/40.8.0 requests-toolbelt/0.9.1 tqdm/4.31.1 CPython/3.7.0

File hashes

Hashes for mt2publ-0.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 517bc3caa69ac77960feed1492a60346705c394bcf54fa8347478ccc5e17bb66
MD5 0cb652e994718d2f9073006d11575672
BLAKE2b-256 1248aa0125d7a92b99044cc6b80722114e32509ca3ad01633e827d5f5e47d5f6

See more details on using hashes here.

Provenance

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page