Semantic-UI-Docs icon indicating copy to clipboard operation
Semantic-UI-Docs copied to clipboard

Docs broken with latest DocPad

Open onomated opened this issue 7 years ago • 9 comments

Originally reported to DocPad here: https://github.com/docpad/docpad/issues/1094 Please see @balupton's comment on how to fix: https://github.com/docpad/docpad/issues/1094#issuecomment-423912929

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

onomated avatar Sep 24 '18 10:09 onomated

Ref https://github.com/williammalo/docpad-plugin-babel/issues/9

balupton avatar Sep 25 '18 00:09 balupton

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

jlukic avatar Dec 21 '18 16:12 jlukic

You should use npm uninstall -g docpad and reinstall v6.79.4 npm install -g [email protected] the latest version of docpad is buggy cc docpad/docpad-plugin-dateurls#13

s-pace avatar Apr 25 '19 12:04 s-pace

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

RedhatPH8 avatar Jan 10 '20 17:01 RedhatPH8

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 avatar Jan 10 '20 18:01 balupton

DocPad Plugin compatibility tracking is over at https://github.com/docpad/docpad/issues/1101

Regarding Semantic UI's Documentation

balupton avatar Aug 13 '20 03:08 balupton

The updated babel plugin has now been released.

https://github.com/docpad/docpad-plugin-babel/issues/9#issuecomment-718212710

balupton avatar Oct 28 '20 21:10 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 avatar Oct 28 '20 21:10 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 ❤️

balupton avatar Oct 28 '20 21:10 balupton