org2jeklly is changing... excerpt: Some change breaks my current workflow, and the workaround

publish failure in org2jeklly 0.25

Some time ago, I started using org2jeklly to publish my blogs. All went well until someday I did a package upgrade for all my emacs packages…

My publishing start to fail, there's no markdown file produced after I run `M-x org2jeklly-publish`…

There's `org-export-process exited abnorml` message in Message buffer.

org-export-process exited abnormally issue

Several hours of debug show that the "org-export-process" related issue was caused by there's no correct org asynchronous export setting.

To fix it, add the following snippet to .emacs:

(custom-set-variables
 '(org-export-async-init-file "~/.emacs.d/org-async-init.el"))

And create a "~/.emacs.d/org-async-init.el" with following contents:

(require 'package)
(setq package-enable-at-startup nil)
(package-initialize)

(require 'org) 
(require 'ox)
(setq org-export-async-debug t)

no markdown generated in post directory

It turns out to be the issue of my own configuration file. I accidentally removed my org2jeklly package. Which cause all org2jeklly related configurations to be removed from .emacs.

While this is an intentional behavior of package system. I also find my "removed" org2jeklly package was actually not removed, it remains in the local elpa package tree.

After some cleanup and reinstallation, reconfiguration work, the markdown file is able to be generated as usual.

Then there comes a new issue: no meta data generated for jeklly in the post header!!!

no meta data header

The issue was caused some recently introduced breaking change in org2jeklly.

The new org2jeklly is not compatible with `org-md-publish-to-md` anymore.

To workaround, I have to replace the `org-md-publish-to-md` function with `org-html-publish-to-html`.