Docs broken with latest DocPad

[onomated]

Originally reported to DocPad here: docpad/docpad#1094
Please see @balupton's comment on how to fix: docpad/docpad#1094 (comment)

TLDR: babel plugin needs to be upgraded to coffeescript version 2

[balupton]

Ref docpad/docpad-plugin-babel#9

[jlukic]

I'll check this out. Probably simplest solve for now is to use an older version of Docpad locally.

[s-pace]

You should use
npm uninstall -g docpad
and reinstall v6.79.4
npm install -g docpad@6.79.4since the latest version of docpad is buggy cc docpad/docpad-plugin-dateurls#13

[RedhatPH8]

Have we seen any movement on this? Or can we workaround it so we can start making use of efficiency enhancements made to docpad?

[balupton]

The aforementioned issue with that plugin is still not resolved as it still needs https://github.com/bevry/boundation run on it to upgrade it to the latest conventions.

Which is small effort on my part, however many of the community plugins still need this done. How many docpad issues are you facing?

That said, as per the notice on https://docpad.bevry.me DocPad is officially marked as deprecated as there were thousands of hours of unpaid time put into it and unless someone wishes to pay for its maintenance then it just bleeds me dry, for the benefit of others only, a slavery of servitude, and away from other work. That said, there is about a hundred hours of work left to sort out all the remaining issues with DocPad, however after several years of unfulfilled appeals for funding, the ecosystem made its choice.

For Semantic UI, I'd suggest just going all in on React, with Gatsby or Next as the generator. Or if you care about generic use, then Stencil by Ionic is precisely for design systems like Semantic UI.

FWIW you should be using DocPad locally via npm scripts or npx. Never have dev deps installed globally as there is no version compatibility control globally.

[balupton]

DocPad Plugin compatibility tracking is over at docpad/docpad#1101

Regarding Semantic UI's Documentation

• docpad
• docpad-plugin-babel
  • Incompatible with DocPad v6.80 and above docpad/docpad-plugin-babel#9
• docpad-plugin-copy - for bevry to update, it needs the maintainer to transfer to the docpad org and add bevryme as an npm owner, the docpad-plugin-raw could be used instead in the meantime
  • Incompatible with Current Docpad almero-digital-marketing/docpad-plugin-copy#4
• docpad-plugin-partials
• docpad-plugin-ghpages

[balupton]

The updated babel plugin has now been released.

docpad/docpad-plugin-babel#9 (comment)

[balupton]

As such, if Semantic UI moves from docpad-plugin-copy to docpad-plugin-raw then they will be able to upgrade to the latest DocPad, as all the other plugins you use have been upgraded except for docpad-plugin-copy which the DocPad community is unable to maintain as they do not have maintainership access.

[balupton]

I'd also like to plug my sponsorship page, as all these upgrades have been done gratis to make sure compatibility is available for everyone, as such for those who can, I'd appreciate any returns on the investment ❤️