Wordpress to Publii

I am currently migrating my personal website from Wordpress to Publii.  Here are a few observations on Publii, from my experiences to date.  I also wrote some more general thoughts about moving to static HTML.  

  • Using software that is both mature and completely free of user manipulation gimmicks really feels like magic.  Publii is very enjoyable to use.   
  • I prefer the WYSIWYG editor, especially because I use a lot of nested lists.  Blocks interface is like WP blocks editor, but it's not quite as refined and I've never loved blocks editing anyway.  
  • You can choose a different editor for each post, but once you choose the editor you can't change it for that post.  (Easiest solution is to copy the content elsewhere, delete the post, and create a new post with the desired editor.) I started a few posts with the Blocks editor early on, and I find myself recreating them in the WYSIWYG editor for various reasons.
  • The default theme ("Simple") is enough to get me up and running.  Tweaking the theme settings and setting featured images for the posts is all I'm doing for now.
  • The rendered site is really fast.   
  • Images in my imported content were giving me trouble (appearing in WYSIWYG editor and preview, but not appearing on the live site).  Publii comes with a plugin called "regenerate thumbnails" which is the answer.  Just run it.

Process

At a high level, this is the process I am using to move this website from Wordpress to Publii.  

  • Wordpress export
    • Posts and page content using default WP Tools / Export
    • Download media library using plugin Export Media Library(?)
    • Also download a zip of the wp-content/uploads folder directly, for good measure
    • Export tablepress tables to CSV using that plugin’s built-in export
  • Create a new Publii site
    • Import Wordpress content using the built-in Publii WP importer 
    • Select all posts and set everything to draft
    • Figure out a theme
    • Set up navigation menu
    • Create tags
    • Add Matomo analytics plugin and configure
  • Preview overall theme, layout, nav (locally)
  • Set up new.coreysnipes.com on hosting so I can preview the site as deployed, including FTP account
  • Configure Publii server connection so it can sync (publish) everything
  • Work through remaining posts
    • Edit each and fix links
    • Edit each and re-upload images
  • Revise and refine content
    • Run the "regenerate thumbnails" plugin
    • Work through posts
    • Fix broken links and images
    • Set posts' featured images as needed
    • Set tags
  • When refinement is complete (enough) archive the Wordpress files and replace with the new Publii static site content
    • Back up WP files and data as needed
    • Update Publii server connection to connect to the live coreysnipes.com site
    • Sync from Publii
    • Check live site for any problems, broken links, etc
  • Continue to refine and publish content on the new site

This article was updated on October 29, 2024

✍️ Comments or questions? Get in touch: corey {at} coreysnipes.com, or on Mastodon.