* 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
* feat: support link in code block title
* refactor: simplify code block filename link implementation
* docs: update syntax-highlighting.md
* chore: rename `filename_uri_base` to `base_url`
[skip ci]
* refactor: use `base_url` int code block implementation
---------
Co-authored-by: Xin <xin@imfing.com>
* Add support for custom footer
* amend how the custom footer section is displayed
* Add missing class
* add missing class
* Remove context variable and flag in hugo.yaml
* update hugo_stats
* Only show footer section for copyright and PoweredBy if they are enabled
* Add missing compiled css
* Added necessary variables for correct styling of the custom footer in some cases
* make padding consistent for copyright section and custom footer
* chore: update css
* chore: clean up css
* docs: update customization instructions
* fix: footer padding
---------
Co-authored-by: Xin <xin@imfing.com>
