[RC Feedback] Feedback on the Docsify v5-rc1 Release Candidate

[paulhibbitts]

[!IMPORTANT] The RC version docs can be previewed at https://preview.docsifyjs.org/. It may contain breaking changes in further rc versions until the standard v5 release.

The Docsify Maintainer Team is excited to share the v5-rc1 release candidate and we’d love to hear your feedback! 🙏🏼 Testing and feedback are crucial to help us ensure a stable final release.

Docsify.js v5 boasts a modernized UI with improved accessibility and theming, simplified CSS customization and theme add-ons (incl. dark theme support). Other new features include a Google Analytics plugin, enhanced error handling, substantial code cleanup and numerous bug fixes. View more details on the RC1 release notes.

How You Can Help Please provide general feedback on your experience with v5-rc1 below. Even if everything works perfectly, that’s valuable feedback too! Simply letting us know will help us ensure that v5-rc1 has been thoroughly tested by the community.

If You Encounter Bugs If you run into any issues while testing, please open a new GitHub issue with the label v5-rc.

For those who wants a quick way to try out their own Markdown content with the v5 release candidate, here is an updated Docsify Template project (including automatic support of dark mode) which can be cloned, edited, and viewed: https://github.com/hibbitts-design/docsify-template-v5

[yan624]

I think the main content is too narrow, Why leave such a large blank space. I use Docsify to record my study notes (about programming, AI, work, and also things in life). I hope it can be wider to display enough content.

我觉得主要内容太窄了，为什么留这么大的空白空间。 docsify 被我用来记录学习笔记（编程、AI、工作方面，也有生活上的事），我希望能够宽一点，展示足够多的内容。

in docsify@^5.0.0-rc

in [email protected]

[sy-records]

You can use CSS to override the default values according to your needs. @yan624

:root {
    --content-max-width: 100%
}

[mateuswetah]

Hey guys, really loving 5.0.0-rc so far, most things are really improved.

One thing I couldn't get to work yet is the new Callout system... am I doing something wrong? For example in this page:

https://tainacan.github.io/tainacan-wiki/#/blocks-item

You can see that the callout above the title is rendered as a Blockquote instead of being converted to the new style. Here is the source code for that page:

https://github.com/tainacan/tainacan-wiki/edit/master/blocks-item.md

And in case you have any suspect, here is the index.html:

https://github.com/tainacan/tainacan-wiki/blob/master/index.html

Thanks in advance and congrats on the migration :)

[sy-records]

Maybe it's cache. It's normal for me to check here.

[mateuswetah]

LOOL it was my browser cache 😆

Thanks!

[paulhibbitts]

If you have not already done so @mateuswetah , you should also remove loading Docsify Themeable to avoid any potential conflicts with the new Docsify v5 core theme system. <script src="https://cdn.jsdelivr.net/npm/docsify-themeable@0"></script>

Thanks so much for testing and providing feedback!

[mateuswetah]

Thanks for the tip @paulhibbitts I'm in the middle of the migration so if you have any other tip it is welcome.

That cache behavior is a bit funky, sometimes it happens, sometimes not, but anyways things are much improved with these new Callouts, we can express better things.

[paulhibbitts]

No other tips off the top of my head @mateuswetah but please feel free to ask any questions here or DM me on the Docsify Discord (https://discord.gg/3NwKFyR). I've migrated several projects myself over as well.