Hextra shortcodes not in sidebar / fixed #824
Conversation
✅ Deploy Preview for hugo-hextra ready!
To edit notification comments on pull requests, go to your Netlify project configuration. |
![gemini-code-assist[bot]](https://avatars.githubusercontent.com/in/956858?s=60&v=4){kind=small}
There was a problem hiding this comment.
Summary of Changes
Hello @jmetzger, I'm Gemini Code Assist1! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!
This pull request addresses a user experience issue by making the Hextra shortcodes documentation readily accessible through the sidebar navigation. Previously, these pages were hidden, requiring users to rely on search to find them. This change enhances the usability of the documentation by ensuring important content is easily discoverable.
Highlights
- Documentation Visibility: The Hextra shortcodes documentation pages are now configured to appear in the sidebar navigation, improving their discoverability.
- Configuration Change: The "sidebar: exclude: true" directive has been removed from the front matter of the Hextra shortcodes documentation files across multiple languages.
Using Gemini Code Assist
The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.
Invoking Gemini
You can request assistance from Gemini at any point in your pull request via creating an issue comment (i.e. comment on the pull request page) using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands.
| Feature | Command | Description |
|---|---|---|
| Code Review | /gemini review |
Performs a code review for the current pull request in its current state. |
| Pull Request Summary | /gemini summary |
Provides a summary of the current pull request in its current state. |
| Comment | @gemini-code-assist | Responds in comments when explicitly tagged, both in issue comments and review comments. |
| Help | /gemini help |
Displays a list of available commands. |
Customization
To customize Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.
Limitations & Feedback
Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counter productive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for Github and other Google products, sign up here.
You can also get AI-powered code generation, chat, as well as code reviews directly in the IDE at no cost with the Gemini Code Assist IDE Extension.
Footnotes
-
Review the Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution. ↩
There was a problem hiding this comment.
Code Review
This pull request correctly makes the 'Hextra Shortcodes' documentation pages visible in the sidebar by removing the sidebar.exclude: true property from their frontmatter. This change addresses the problem described and improves the discoverability of these pages for users. The modification has been applied consistently across all language versions of the document, and the implementation is clean and correct. No issues were found in this change.
|
Thanks for the PR! This was actually intentional, these are internal Hextra shortcodes, and I avoided putting all shortcodes in the sidebar since they’ll likely be grouped into a dedicated section later. |
|
Fully get that. But being a starter, working on a project, it was really painfull, because everytime i wanted to use the specific hextra codes, it was hard to figure out (over and over again) where to find them. Eventually I used the search, but doing it like so, it was not handy... and it slowed down the usage. (And i found that the hextra shortcodes where the most important ones) |
2 participants
That hextra-shortcodes are not in the sidebar.
This is annoying, when you are working on a project, because you can only find it through the search.