Docs broken with latest DocPad - Githubissues

Semantic-Org / Semantic-UI-Docs

Official Documentation for Semantic UI

http://www.semantic-ui.com

303 stars 1.43k forks source link

Docs broken with latest DocPad #404

Open onomated opened 6 years ago

onomated commented 6 years ago

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

balupton commented 6 years ago

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

jlukic commented 5 years ago

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

s-pace commented 5 years ago

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 commented 4 years ago

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 commented 4 years ago

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 commented 4 years ago

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

Regarding Semantic UI's Documentation

[x] docpad
[x] docpad-plugin-babel
- https://github.com/docpad/docpad-plugin-babel/issues/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
- https://github.com/almero-digital-marketing/docpad-plugin-copy/issues/4
[x] docpad-plugin-partials
[x] docpad-plugin-ghpages

balupton commented 4 years ago

The updated babel plugin has now been released.

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

balupton commented 4 years ago

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 commented 4 years ago

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 ❤️