-
-
Notifications
You must be signed in to change notification settings - Fork 355
feat(tags): improve usability of tags #698
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Conversation
yuri1969
commented
Jun 1, 2025
- Tags can be shown also at Docs (based on 8c4fae2)
- Documented tag-related config flags
- Added example tags to the site
- Made rendered tags active
✅ Deploy Preview for hugo-hextra ready!
To edit notification comments on pull requests, go to your Netlify project configuration. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
thank you, that’s a great idea to make the tags reusable.
I’ll need to think about the placement for them, putting at the top together with breadcrumbs and title seems a bit crowded.
One option could be in the right sidebar, similar to how Docsy handles it: https://www.docsy.dev/docs/
Maybe a good first step would be making a shortcode for it?
|
@imfing I'm not sure if I got that. Should the toggle-able tag listing be reworked to a shortcode? If so what should be the parameters of the shortcode? |
Splitting the tags out is totally fine, but I’m not sure placing them at the top is the best approach - it makes the breadcrumbs area feel a bit crowded. That’s why I was thinking it might be better to reuse the sidebar space for displaying tags instead.
|
* Tags can be shown also at docs * Documented tag-related config flags * Added example tags to the site * Made rendered tags active
|
@imfing I've moved the tags listing to a new section of ToC and adjusted configuration accordingly. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
@yuri1969 great work, thanks!
for future: also need to add i18n translations for tags & update docs in other languages - can be addressed in a separate PR
Generated missing translations related to tags. Related to imfing#698
Generated missing translations related to tags. Related to imfing#698
* feat(tags): improve usability of tags * Tags can be shown also at docs * Documented tag-related config flags * Added example tags to the site * Made rendered tags active * Move tags listing to ToC * Hide tags section on no tags
* Sync tabs across groups * feat(tabs): add optional synchronization * Move tabs sync setting under page params * fix: spacing between title and site title (#704) * docs: document configure opengraph image (#706) * [Docs] document using og:image * Make example title page match others * clarify wording * chore: update tailwind css to latest version 4.1.8 (#703) * fix: wrong SRI hash for katex.css (#702) * Correct URL given in 'dev.toml' * stylesheet 'katex.css': fix SRI hash * fix(build): run npm update to fix postcss complaint * feat(tags): improve usability of tags (#698) * feat(tags): improve usability of tags * Tags can be shown also at docs * Documented tag-related config flags * Added example tags to the site * Made rendered tags active * Move tags listing to ToC * Hide tags section on no tags * feat(math): add optional MathJax support (#707) * feat: add MathJax option * docs: move math engine note * refactor: update LaTeX documentation and improve MathJax integration - Adjusted LaTeX documentation for clarity and formatting. - Enhanced MathJax configuration in the templates to support both KaTeX and MathJax rendering. - Removed deprecated comments and streamlined the script loading process for MathJax. - Updated the passthrough extension settings in the Hugo configuration for better compatibility with LaTeX math expressions. * docs: simplify LaTeX documentation and clarify configuration steps - Updated LaTeX documentation to reflect that KaTeX is enabled by default, removing the need for manual activation. - Added examples for using LaTeX math expressions and clarified the configuration for the passthrough extension in Hugo. - Enhanced MathJax section to emphasize its use as an alternative rendering engine. * fix(tabs): add null check for panels container and update example items * fix(tabs): improve tab group key handling and add validation for items parameter * refactor(tabs): comment out sync option in configuration and adjust tab formatting in documentation --------- Co-authored-by: hobobandy <[email protected]> Co-authored-by: Matt Dodson <[email protected]> Co-authored-by: Andreas Deininger <[email protected]> Co-authored-by: yuri <[email protected]>
