Skip to content

Conversation

@yuri1969
Copy link
Contributor

@yuri1969 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

@netlify
Copy link

netlify bot commented Jun 1, 2025

Deploy Preview for hugo-hextra ready!

Name Link
🔨 Latest commit 1692f2a
🔍 Latest deploy log https://app.netlify.com/projects/hugo-hextra/deploys/6849e70e70c1e300089f9851
😎 Deploy Preview https://deploy-preview-698--hugo-hextra.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

Copy link
Owner

@imfing imfing left a 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?

@yuri1969
Copy link
Contributor Author

yuri1969 commented Jun 5, 2025

@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?

@imfing
Copy link
Owner

imfing commented Jun 10, 2025

@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.

image

yuri1969 added 2 commits June 11, 2025 21:48
* Tags can be shown also at docs
* Documented tag-related config flags
* Added example tags to the site
* Made rendered tags active
@yuri1969
Copy link
Contributor Author

@imfing I've moved the tags listing to a new section of ToC and adjusted configuration accordingly.

Copy link
Owner

@imfing imfing left a 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

@imfing imfing merged commit e22b8d5 into imfing:main Jun 13, 2025
4 checks passed
@yuri1969 yuri1969 deleted the doc-tags branch June 14, 2025 09:11
yuri1969 added a commit to yuri1969/hextra that referenced this pull request Jun 14, 2025
Generated missing translations related to tags.

Related to imfing#698
yuri1969 added a commit to yuri1969/hextra that referenced this pull request Jun 14, 2025
Generated missing translations related to tags.

Related to imfing#698
imfing pushed a commit that referenced this pull request Jul 21, 2025
* 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
imfing added a commit that referenced this pull request Jul 21, 2025
* 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]>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants