* refactor(mermaid): enhance Mermaid JS loading logic for flexibility
- Updated the Mermaid JS loader to support configurable remote or local asset loading based on site parameters.
- Improved error handling for asset retrieval and added comments for clarity on behavior based on different configurations.
- Ensured that the default behavior falls back to a CDN if no base is provided, enhancing usability and maintainability.
* chore: clean up comments
* fix: comment typo
* refactor(navbar): add hextra prefix to navbar and hamburger menu classes
- Updated CSS class names from `nav-container` to `hextra-nav-container` and `hamburger-menu` to `hextra-hamburger-menu` for improved clarity and consistency across the project.
- Adjusted related JavaScript and documentation to reflect the new class names.
* refactor(search): update class names for search components
- Renamed CSS classes from `search-wrapper`, `search-input`, `active`, `no-result`, `prefix`, `excerpt`, and `match` to `hextra-search-wrapper`, `hextra-search-input`, `hextra-search-active`, `hextra-search-no-result`, `hextra-search-prefix`, `hextra-search-excerpt`, and `hextra-search-match` for improved clarity and consistency.
- Updated JavaScript selectors to match the new class names, ensuring functionality remains intact.
- Adjusted HTML structure to reflect the new class naming convention.
* refactor(search): update search component class names for consistency
- Renamed existing search-related CSS classes to include the `hextra` prefix for improved clarity and consistency.
- Added optional nested classes for enhanced customization of the search UI, including titles, active states, and result snippets.
- Removed outdated breadcrumb section as no specific class is available.
* refactor(sidebar): rename sidebar classes for consistency
- Updated CSS and JavaScript to replace `sidebar-container` with `hextra-sidebar-container` and `sidebar-active-item` with `hextra-sidebar-active-item` for improved clarity and consistency across the project.
- Adjusted related documentation to reflect the new class names.
* refactor(language & theme): update class names for consistency
- Renamed language switcher and theme toggle classes to include the `hextra` prefix for improved clarity and consistency across the project.
- Updated related JavaScript selectors and documentation to reflect the new class names.
* refactor(css & html): rename classes for consistency and clarity
- Updated various CSS class names to include the `hextra` prefix, enhancing consistency across the project. This includes renaming classes such as `content` to `hextra-content`, `filename` to `hextra-code-filename`, and `steps` to `hextra-steps`.
- Adjusted related HTML and JavaScript to reflect the new class names, ensuring functionality and styling remain intact.
- Updated documentation to include the new class names for better clarity.
* refactor(language): update class names for language options
- Renamed the `language-options` class to `hextra-language-options` for consistency with the existing `hextra` prefix convention.
- Updated the corresponding HTML to reflect the new class name, ensuring clarity and uniformity across the project.
* refactor(css & html): rename classes for consistency and clarity
- Renamed CSS classes to include the `hextra` prefix, such as changing `subheading-anchor` to `hextra-subheading-anchor` and `footnotes` to `hextra-footnotes`, enhancing consistency across the project.
- Updated related HTML and documentation to reflect the new class names, ensuring clarity and uniformity.
* feat(typography): add styling for horizontal lines
- Introduced new styles for horizontal lines to enhance visual separation in content. The styles apply margin and border color adjustments, ensuring consistency with the overall design.
* feat(blog): add draft release announcement for Hextra v0.10.0
- Created a new markdown file for the draft release announcement of Hextra v0.10.0, including upgrade instructions and author details.
- The announcement is currently marked as a draft and may be updated before the official release.
* refactor(css & html): rename `hextra-content` class to `content` for consistency
- Updated the `hextra-content` class to simply `content` across various HTML files and CSS, enhancing clarity and consistency in the codebase.
- Adjusted the `package.json` script for the development server to include the `-F` flag for better functionality.
* refactor(typography & markdown): enhance table styling and markdown syntax
- Updated CSS for tables to improve styling, including adjustments to margins, borders, and text properties for better readability.
- Revised markdown documentation to standardize table formatting and improve clarity, including consistent syntax for headers and lists.
- Enhanced examples in the documentation to reflect the updated styling and ensure accurate representation of output.
* fix(blog): update text color for improved accessibility
- Modified the text color in the blog single layout to enhance readability in dark mode by adding a dark text color class.
- Ensured consistency in styling for better user experience across different themes.
* docs(blog): update draft release announcement for Hextra v0.10.0
- Revised the "What's New" section to include a TODO placeholder for future updates.
- Added a comprehensive migration guide detailing the CSS class prefix changes to enhance consistency and avoid conflicts.
- Updated the announcement to reflect the new class naming conventions for various components.
* chore: rebuild css
* refactor(math): update LaTeX guide and enhance KaTeX integration
- Revised the LaTeX documentation for clarity and improved structure, changing section titles and descriptions for better understanding.
- Added support for chemistry expressions using the mhchem extension.
- Introduced a new KaTeX CSS loader partial to streamline the integration of KaTeX, allowing for configurable remote or local asset loading.
- Updated the head partial to utilize the new KaTeX loader, enhancing the flexibility of math rendering options.
* refactor(mathjax): simplify MathJax script URL configuration
- Removed the dynamic version assignment for MathJax and set a fixed version in the script URL for consistency and clarity.
* docs(latex): enhance LaTeX guide and clarify chemistry expressions
- Updated section titles for better clarity, changing "Supported Functions" to "Chemistry Expressions."
- Improved description of the mhchem extension for rendering chemistry equations.
- Removed redundant instructions regarding the passthrough extension in Hugo.
- Corrected minor typographical errors in references to MathJax.
* chore: remove standard development mode command from CLAUDE.md
* docs(toc): add TOC scroll functionality documentation
- Added detailed comments to toc-scroll.js explaining the purpose and functionality of the TOC scroll spy feature.
- Clarified the requirements for proper operation, including the need for a .hextra-toc element and matching heading IDs.
* refactor(fragments): enhance fragment processing and documentation
- Improved the fragments.html partial to better handle page content splitting into searchable fragments based on headings.
- Added comprehensive documentation within the file, detailing parameters, return values, and examples for clarity.
- Updated content handling to ensure whitespace is trimmed
* refactor(tags): enhance tag rendering and styling in toc
- Updated the tags.html partial to utilize a context variable for improved accessibility.
- Enhanced the styling of tag links for better visual consistency across different themes.
- Modified toc.html and list.html to pass the context to the tags partial, ensuring consistent rendering.
* chore: run `task css`
* feat(toc): add Table of Contents scroll highlighting
- Introduced a new toc.css file for styling the Table of Contents with active link highlighting.
- Implemented toc-scroll.js to manage scroll behavior and link activation based on viewport visibility.
- Updated core.html to include the new JavaScript file and ensure proper loading of the Table of Contents functionality.
* chore: lower root heading font weight for TOC
* chore: run `task css`
* chore: update dependencies in package.json and package-lock.json to version 4.1.11 for @tailwindcss/postcss and tailwindcss, and update @jridgewell packages to latest versions
* feat(llms): add llms txt output format
- Introduced a new output format 'llms' in the configuration.
- Updated the example site to utilize the new 'llms' format for the home output.
- Added a new layout file 'llms.txt' for rendering content in the LLMS format.
* docs: add llms.txt support documentation
- Introduced a new section in the configuration guide detailing how to enable the llms.txt output format for improved accessibility to large language models.
- Provided example configuration for adding the 'llms' output format in the site's hugo.yaml.
- Explained the content structure of the generated llms.txt file, including site title, section listings, page summaries, and direct links.
* Update configuration.md
* fix(favicon): dynamic favicon switching based on color scheme in js
* refactor(favicon): simplify favicon logic and ensure dynamic switching based on color scheme
* docs(favicon): enhance favicon setup instructions with dark mode support and adaptive SVG guidance
* feat(pagination): add blog pagination component
- Introduced a new blog pagination component for improved navigation on list pages.
- Updated the blog list layout to utilize pagination, allowing for better content organization.
- Added a new parameter for pagination size in the configuration file.
* chore: increase pager size for blog
* 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 <30026704+hobobandy@users.noreply.github.com>
Co-authored-by: Matt Dodson <47385188+MattDodsonEnglish@users.noreply.github.com>
Co-authored-by: Andreas Deininger <adeininger@urbanonline.de>
Co-authored-by: yuri <1969yuri1969@gmail.com>
* 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.
* 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: implement child menu support in main navbar
- Added a new JavaScript file for handling dropdown functionality in the navbar.
- Implemented event listeners for toggling dropdowns, closing them on outside clicks, and dismissing with the Escape key.
- Updated navbar HTML to support dropdown items with children, enhancing the navigation experience.
- Adjusted core script imports to include the new dropdown functionality.
* chore: update menu identifiers and add missing translations for development versions
* chore: update hugo stats
* chore: update script name
* chore: update menu item names to include arrows for external links
* fix: CSS loading logic for production and theme dev environments
- Updated the CSS loading logic to differentiate between production and theme environments.
* fix: streamline CSS loading logic for production and development environments
- Refactored the CSS loading logic to ensure proper handling of stylesheets in both production and development modes.
- Consolidated the CSS concatenation and minification process for production, while simplifying the development loading process.
* fix: simplify development CSS loading in head partial
- Updated the CSS loading logic in head.html to streamline the process for development environments by renaming the variable for clarity and ensuring proper handling of stylesheets.
* Allow authors to set the reverse pagination setting of a page using front matter
* Adding some documentation of the reversePagination front matter custom parameter along with an example of how to use it and why you might want to use it
* refactor: update page width handling and CSS structure
- Changed the default page width from 1280px to 80rem in hugo.yaml.
- Replaced dynamic page width partials with a new CSS class 'hextra-max-page-width' across multiple layout files for consistency.
- Introduced a new head-config-css.html partial for managing CSS styles related to page width.
- Removed the outdated page-width utility partial to streamline the codebase.
* feat: introduce CSS variables for layout widths and update footer/navbar styles
- Added a new configs.css file to define CSS variables for page, navbar, and footer widths.
- Updated footer and navbar partials to utilize the new CSS classes for consistent width management.
- Refactored head-config-css.html to include the new navbar width variable.
- Enhanced the overall styling structure for better maintainability and responsiveness.
* Refactor: Rename configs.css to variables.css and update references
Remove head-config-css.html and update references to use variables.css instead of configs.css
* Update assets/css/variables.css
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
* Update layouts/partials/head.html
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
---------
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Add a `noindex` param to page front matter to block Google indexing for specific pages or directories. This is useful for avoiding duplicate content in search results or preventing indexing of pages that shouldn't appear in search engines.
- Adjust `head.html` for optional `noindex` param (default: false)
- Document usage in `configuration.md` and clarify Flexsearch section
* chore: migrate PostCSS configuration to v4
* chore: update dependencies in package.json and package-lock.json
- Bump versions for autoprefixer, postcss, postcss-cli, prettier, and tailwindcss.
- Remove unused dependencies to streamline the project.
* chore: add @tailwindcss/postcss and update package-lock.json
* fix: update import paths in CSS files for consistency
* fix: change prefix from `hx-` to `hx:`
* chore: migrate primary color theme variables to CSS
* fix: remove unnecessary text decoration property from anchor styles in typography CSS
* fix: update CSS styles for improved consistency and clarity across components
* chore: clean up package.json and package-lock.json, remove unused dependencies, and update CSS imports for better organization
* fix: bulk replace prefix `hx-` with `hx:`
* fix: update tailwind css prefix
* fix: styling consistent issues
- steps counter fix in v4
- removed tailwind.css
- update hr border colors
- fix button cursor in v4
- fix border colors in various places
* fix: update class prefixes for consistency in menu and sidebar components
* fix: refine CSS classes and transitions for navbar and sidebar components
- Updated hamburger menu styles for improved animation and structure.
- Adjusted sidebar transition duration for smoother effects.
- Standardized class prefixes for consistency across components.
* fix: update border color in hero badge component for improved styling consistency
* fix: update tab button cursor style for improved user interaction
* chore: recompile css
* fix: dark mode color not applied for before / after elements
* fix: docs navigation
* chore: recompile CSS
* chore: update Tailwind CSS and PostCSS dependencies to version 4.0.17, recompile CSS, and add safelist
* fix: typo in class name and add back decoration-from-font for typography a tags
* fix: update class syntax for Tailwind CSS compatibility in mermaid code block
* sidebar: fix more menu item with multilingual
Fixes#593
Correctly parses multilingual URL in sidebar, particularly if
lang code follows a nested sub directory.
For instance, GH pages hosting where the baseurl might be of the
format `https://<USERNAME>.github.io/<REPO>/`.
* Update sidebar.html
---------
Co-authored-by: Xin <xin@imfing.com>
* Change processing method to more generic hugo .Process and allow resources from local .Page.Resources as well as global resources
* Add comments
* Fix double curly brackets error
Co-authored-by: Xin <fuxin1997@gmail.com>
* Maintain backward compatibility by using defaulting $process to $methd $options
https://github.com/imfing/hextra/pull/538#discussion_r1903250264
* Use printf instead of delimit
Co-authored-by: Xin <fuxin1997@gmail.com>
---------
Co-authored-by: Xin <fuxin1997@gmail.com>
* feat: add icon support to badge shortcodes
- Introduced an optional icon parameter to both badge.html files.
- Updated the badge rendering to include the icon alongside the content.
- Enhanced the layout for better alignment of icon and text.
* feat: add new feature shortcode
* docs: update badge doc
