| 
									
										
										
										
											2023-08-14 21:56:26 +01:00
										 |  |  | {{- $context := .context -}} | 
					
						
							| 
									
										
										
										
											2023-08-24 22:29:53 +01:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2023-08-14 21:56:26 +01:00
										 |  |  | {{- $disableSidebar := .disableSidebar | default false -}} | 
					
						
							| 
									
										
										
										
											2023-08-24 22:29:53 +01:00
										 |  |  | {{- $displayPlaceholder := .displayPlaceholder | default false -}} | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2025-03-29 12:51:42 +00:00
										 |  |  | {{- $sidebarClass := cond $disableSidebar (cond $displayPlaceholder "hx:md:hidden hx:xl:block" "hx:md:hidden") "hx:md:sticky" -}} | 
					
						
							| 
									
										
										
										
											2023-08-07 23:48:07 +01:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2023-08-14 21:56:26 +01:00
										 |  |  | {{- $navRoot := cond (eq site.Home.Type "docs") site.Home $context.FirstSection -}} | 
					
						
							|  |  |  | {{- $pageURL := $context.RelPermalink -}} | 
					
						
							| 
									
										
										
										
											2023-08-07 23:48:07 +01:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2023-11-17 18:00:05 -05:00
										 |  |  | {{/* EXPERIMENTAL */}} | 
					
						
							|  |  |  | {{- if .context.Params.sidebar.hide -}} | 
					
						
							|  |  |  |   {{- $disableSidebar = true -}} | 
					
						
							|  |  |  |   {{- $displayPlaceholder = true -}} | 
					
						
							|  |  |  | {{- end -}} | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2023-08-07 23:48:07 +01:00
										 |  |  | 
 | 
					
						
							| 
									
										
											  
											
												refactor(css): add prefix to component classes for consistency (#744)
* 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
											
										 
											2025-08-13 22:55:38 +08:00
										 |  |  | <aside class="hextra-sidebar-container hx:flex hx:flex-col hx:print:hidden hx:md:top-16 hx:md:shrink-0 hx:md:w-64 hx:md:self-start hx:max-md:[transform:translate3d(0,-100%,0)] {{ $sidebarClass }}"> | 
					
						
							| 
									
										
										
										
											2023-08-06 15:23:37 +01:00
										 |  |  |   <!-- Search bar on small screen --> | 
					
						
							| 
									
										
										
										
											2025-03-29 12:51:42 +00:00
										 |  |  |   <div class="hx:px-4 hx:pt-4 hx:md:hidden"> | 
					
						
							| 
									
										
										
										
											2023-08-06 15:23:37 +01:00
										 |  |  |     {{ partial "search.html" }} | 
					
						
							|  |  |  |   </div> | 
					
						
							| 
									
										
										
										
											2025-03-29 12:51:42 +00:00
										 |  |  |   <div class="hextra-scrollbar hx:overflow-y-auto hx:overflow-x-hidden hx:p-4 hx:grow hx:md:h-[calc(100vh-var(--navbar-height)-var(--menu-height))]"> | 
					
						
							|  |  |  |     <ul class="hx:flex hx:flex-col hx:gap-1 hx:md:hidden"> | 
					
						
							| 
									
										
										
										
											2023-08-07 23:48:07 +01:00
										 |  |  |       <!-- Nav --> | 
					
						
							| 
									
										
										
										
											2023-08-23 01:00:36 +01:00
										 |  |  |       {{ template "sidebar-main" (dict "context" site.Home "pageURL" $pageURL "page" $context "toc" true) -}} | 
					
						
							|  |  |  |       {{ template "sidebar-footer" }} | 
					
						
							| 
									
										
										
										
											2023-08-06 15:23:37 +01:00
										 |  |  |     </ul> | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |     <!-- Sidebar on large screen --> | 
					
						
							| 
									
										
										
										
											2023-08-24 22:29:53 +01:00
										 |  |  |     {{- if $disableSidebar -}} | 
					
						
							| 
									
										
										
										
											2025-03-29 12:51:42 +00:00
										 |  |  |       {{- if $displayPlaceholder }}<div class="hx:max-xl:hidden hx:h-0 hx:w-64 hx:shrink-0"></div>{{ end -}} | 
					
						
							| 
									
										
										
										
											2023-08-07 23:48:07 +01:00
										 |  |  |       {{ .context.Scratch.Set "enableFooterSwitches" true }} | 
					
						
							| 
									
										
										
										
											2023-08-14 21:56:26 +01:00
										 |  |  |     {{- else -}} | 
					
						
							| 
									
										
										
										
											2025-03-29 12:51:42 +00:00
										 |  |  |       <ul class="hx:flex hx:flex-col hx:gap-1 hx:max-md:hidden"> | 
					
						
							| 
									
										
										
										
											2023-08-20 00:42:46 +01:00
										 |  |  |         {{ template "sidebar-main" (dict "context" $navRoot "page" $context  "pageURL" $pageURL) }} | 
					
						
							| 
									
										
										
										
											2023-08-07 23:48:07 +01:00
										 |  |  |         {{ template "sidebar-footer" }} | 
					
						
							|  |  |  |       </ul> | 
					
						
							| 
									
										
										
										
											2023-08-14 21:56:26 +01:00
										 |  |  |     {{ end -}} | 
					
						
							| 
									
										
										
										
											2023-07-27 00:05:47 +01:00
										 |  |  |   </div> | 
					
						
							| 
									
										
										
										
											2023-08-07 23:48:07 +01:00
										 |  |  |   {{/* Hide theme switch when sidebar is disabled */}} | 
					
						
							| 
									
										
										
										
											2025-03-29 12:51:42 +00:00
										 |  |  |   {{ $switchesClass := cond $disableSidebar "hx:md:hidden" "" -}} | 
					
						
							| 
									
										
										
										
											2023-10-21 17:18:04 -04:00
										 |  |  |   {{ $displayThemeToggle := (site.Params.theme.displayToggle | default true) -}} | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2024-05-29 10:11:25 +02:00
										 |  |  |   {{ if or hugo.IsMultilingual $displayThemeToggle }} | 
					
						
							| 
									
										
										
										
											2025-04-10 00:11:19 +02:00
										 |  |  |     <div class="{{ $switchesClass }} {{ with hugo.IsMultilingual }}hx:justify-end{{ end }} hx:sticky hx:bottom-0 hx:max-h-(--menu-height) hx:bg-white hx:dark:bg-dark hx:mx-4 hx:py-4 hx:shadow-[0_-12px_16px_#fff] hx:flex hx:items-center hx:gap-2 hx:border-gray-200 hx:dark:border-neutral-800 hx:dark:shadow-[0_-12px_16px_#111] hx:contrast-more:border-neutral-400 hx:contrast-more:shadow-none hx:contrast-more:dark:shadow-none hx:border-t" data-toggle-animation="show"> | 
					
						
							| 
									
										
										
										
											2024-05-29 10:11:25 +02:00
										 |  |  |       {{- with hugo.IsMultilingual -}} | 
					
						
							| 
									
										
										
										
											2023-10-21 17:18:04 -04:00
										 |  |  |         {{- partial "language-switch" (dict "context" $context "grow" true) -}} | 
					
						
							| 
									
										
										
										
											2025-08-20 00:26:32 +02:00
										 |  |  |         {{- with $displayThemeToggle }}{{ partial "theme-toggle" (dict "hideLabel" true "location" "bottom-right") }}{{ end -}} | 
					
						
							| 
									
										
										
										
											2023-10-21 17:18:04 -04:00
										 |  |  |       {{- else -}} | 
					
						
							|  |  |  |         {{- with $displayThemeToggle -}} | 
					
						
							| 
									
										
										
										
											2025-03-29 12:51:42 +00:00
										 |  |  |           <div class="hx:flex hx:grow hx:flex-col">{{ partial "theme-toggle" }}</div> | 
					
						
							| 
									
										
										
										
											2023-10-21 17:18:04 -04:00
										 |  |  |         {{- end -}} | 
					
						
							|  |  |  |       {{- end -}} | 
					
						
							|  |  |  |     </div> | 
					
						
							|  |  |  |   {{- end -}} | 
					
						
							| 
									
										
										
										
											2023-08-06 15:23:37 +01:00
										 |  |  | </aside> | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2023-08-07 23:48:07 +01:00
										 |  |  | {{- define "sidebar-main" -}} | 
					
						
							| 
									
										
										
										
											2023-08-20 00:42:46 +01:00
										 |  |  |   {{ template "sidebar-tree" (dict "context" .context "level" 0 "page" .page "pageURL" .pageURL "toc" (.toc | default false)) }} | 
					
						
							| 
									
										
										
										
											2023-08-06 15:23:37 +01:00
										 |  |  | {{- end -}} | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | {{- define "sidebar-tree" -}} | 
					
						
							| 
									
										
										
										
											2023-08-14 21:56:26 +01:00
										 |  |  |   {{- if ge .level 4 -}} | 
					
						
							|  |  |  |     {{- return -}} | 
					
						
							|  |  |  |   {{- end -}} | 
					
						
							| 
									
										
										
										
											2023-08-06 15:23:37 +01:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2023-08-14 21:56:26 +01:00
										 |  |  |   {{- $context := .context -}} | 
					
						
							| 
									
										
										
										
											2023-08-20 00:42:46 +01:00
										 |  |  |   {{- $page := .page }} | 
					
						
							|  |  |  |   {{- $pageURL := .page.RelPermalink -}} | 
					
						
							| 
									
										
										
										
											2023-08-14 21:56:26 +01:00
										 |  |  |   {{- $level := .level -}} | 
					
						
							|  |  |  |   {{- $toc := .toc | default false -}} | 
					
						
							| 
									
										
										
										
											2023-08-06 15:23:37 +01:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2023-08-20 00:42:46 +01:00
										 |  |  |   {{- with $items := union .context.RegularPages .context.Sections -}} | 
					
						
							| 
									
										
										
										
											2023-11-17 18:00:05 -05:00
										 |  |  |     {{- $items = where $items "Params.sidebar.exclude" "!=" true -}} | 
					
						
							| 
									
										
										
										
											2023-08-14 21:56:26 +01:00
										 |  |  |     {{- if eq $level 0 -}} | 
					
						
							|  |  |  |       {{- range $items.ByWeight }} | 
					
						
							| 
									
										
										
										
											2023-11-12 09:03:30 -05:00
										 |  |  |         {{- if .Params.sidebar.separator -}} | 
					
						
							| 
									
										
										
										
											2025-03-29 12:51:42 +00:00
										 |  |  |           <li class="[word-break:break-word] hx:mt-5 hx:mb-2 hx:px-2 hx:py-1.5 hx:text-sm hx:font-semibold hx:text-gray-900 hx:first:mt-0 hx:dark:text-gray-100"> | 
					
						
							|  |  |  |             <span class="hx:cursor-default">{{ partial "utils/title" . }}</span> | 
					
						
							| 
									
										
										
										
											2023-11-12 09:03:30 -05:00
										 |  |  |           </li> | 
					
						
							|  |  |  |         {{- else -}} | 
					
						
							|  |  |  |           {{- $active := eq $pageURL .RelPermalink -}} | 
					
						
							|  |  |  |           {{- $shouldOpen := or (.Params.sidebar.open) (.IsAncestor $page) $active | default true }} | 
					
						
							|  |  |  |           <li class="{{ if $shouldOpen }}open{{ end }}"> | 
					
						
							| 
									
										
										
										
											2024-03-19 22:16:10 +00:00
										 |  |  |             {{- $linkTitle := partial "utils/title" . -}} | 
					
						
							|  |  |  |             {{- template "sidebar-item-link" dict "context" . "active" $active "title" $linkTitle "link" .RelPermalink -}} | 
					
						
							| 
									
										
										
										
											2023-11-12 09:03:30 -05:00
										 |  |  |             {{- if and $toc $active -}} | 
					
						
							|  |  |  |               {{- template "sidebar-toc" dict "page" . -}} | 
					
						
							|  |  |  |             {{- end -}} | 
					
						
							|  |  |  |             {{- template "sidebar-tree" dict "context" . "page" $page "pageURL" $pageURL "level" (add $level 1) "toc" $toc -}} | 
					
						
							|  |  |  |           </li> | 
					
						
							|  |  |  |         {{- end -}} | 
					
						
							| 
									
										
										
										
											2023-08-14 21:56:26 +01:00
										 |  |  |       {{- end -}} | 
					
						
							|  |  |  |     {{- else -}} | 
					
						
							| 
									
										
										
										
											2025-03-29 12:51:42 +00:00
										 |  |  |       <div class="hx:ltr:pr-0 hx:overflow-hidden"> | 
					
						
							|  |  |  |         <ul class='hx:relative hx:flex hx:flex-col hx:gap-1 hx:before:absolute hx:before:inset-y-1 hx:before:w-px hx:before:bg-gray-200 hx:before:content-[""] hx:ltr:ml-3 hx:ltr:pl-3 hx:ltr:before:left-0 hx:rtl:mr-3 hx:rtl:pr-3 hx:rtl:before:right-0 hx:dark:before:bg-neutral-800'> | 
					
						
							| 
									
										
										
										
											2023-08-14 21:56:26 +01:00
										 |  |  |           {{- range $items.ByWeight }} | 
					
						
							|  |  |  |             {{- $active := eq $pageURL .RelPermalink -}} | 
					
						
							| 
									
										
										
										
											2023-08-20 00:42:46 +01:00
										 |  |  |             {{- $shouldOpen := or (.Params.sidebar.open) (.IsAncestor $page) $active | default true }} | 
					
						
							| 
									
										
										
										
											2024-03-19 22:16:10 +00:00
										 |  |  |             {{- $linkTitle := partial "utils/title" . -}} | 
					
						
							| 
									
										
										
										
											2025-03-29 12:51:42 +00:00
										 |  |  |             <li class="hx:flex hx:flex-col {{ if $shouldOpen }}open{{ end }}"> | 
					
						
							| 
									
										
										
										
											2024-03-19 22:16:10 +00:00
										 |  |  |               {{- template "sidebar-item-link" dict "context" . "active" $active "title" $linkTitle "link" .RelPermalink -}} | 
					
						
							| 
									
										
										
										
											2023-08-14 21:56:26 +01:00
										 |  |  |               {{- if and $toc $active -}} | 
					
						
							|  |  |  |                 {{ template "sidebar-toc" dict "page" . }} | 
					
						
							|  |  |  |               {{- end }} | 
					
						
							| 
									
										
										
										
											2023-08-20 00:42:46 +01:00
										 |  |  |               {{ template "sidebar-tree" dict "context" . "page" $page "pageURL" $pageURL "level" (add $level 1) "toc" $toc }} | 
					
						
							| 
									
										
										
										
											2023-08-14 21:56:26 +01:00
										 |  |  |             </li> | 
					
						
							|  |  |  |           {{- end -}} | 
					
						
							|  |  |  |         </ul> | 
					
						
							|  |  |  |       </div> | 
					
						
							|  |  |  |     {{- end -}} | 
					
						
							|  |  |  |   {{- end }} | 
					
						
							| 
									
										
										
										
											2023-08-06 15:23:37 +01:00
										 |  |  | {{- end -}} | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | {{- define "sidebar-toc" -}} | 
					
						
							|  |  |  |   {{ $page := .page }} | 
					
						
							|  |  |  |   {{ with $page.Fragments.Headings }} | 
					
						
							| 
									
										
										
										
											2025-03-29 12:51:42 +00:00
										 |  |  |     <ul class='hx:flex hx:flex-col hx:gap-1 hx:relative hx:before:absolute hx:before:inset-y-1 hx:before:w-px hx:before:bg-gray-200 hx:before:content-[""] hx:dark:before:bg-neutral-800 hx:ltr:pl-3 hx:ltr:before:left-0 hx:rtl:pr-3 hx:rtl:before:right-0 hx:ltr:ml-3 hx:rtl:mr-3'> | 
					
						
							| 
									
										
										
										
											2023-08-15 21:55:14 +01:00
										 |  |  |       {{- range . }} | 
					
						
							|  |  |  |         {{- with .Headings }} | 
					
						
							|  |  |  |           {{- range . -}} | 
					
						
							| 
									
										
										
										
											2023-08-06 15:23:37 +01:00
										 |  |  |             <li> | 
					
						
							|  |  |  |               <a | 
					
						
							|  |  |  |                 href="#{{ anchorize .ID }}" | 
					
						
							| 
									
										
										
										
											2025-03-29 12:51:42 +00:00
										 |  |  |                 class="hx:flex hx:rounded-sm hx:px-2 hx:py-1.5 hx:text-sm hx:transition-colors [word-break:break-word] hx:cursor-pointer [-webkit-tap-highlight-color:transparent] [-webkit-touch-callout:none] hx:contrast-more:border hx:gap-2 hx:before:opacity-25 hx:before:content-['#'] hx:text-gray-500 hx:hover:bg-gray-100 hx:hover:text-gray-900 hx:dark:text-neutral-400 hx:dark:hover:bg-primary-100/5 hx:dark:hover:text-gray-50 hx:contrast-more:text-gray-900 hx:contrast-more:dark:text-gray-50 hx:contrast-more:border-transparent hx:contrast-more:hover:border-gray-900 hx:contrast-more:dark:hover:border-gray-50" | 
					
						
							| 
									
										
										
										
											2023-08-06 15:23:37 +01:00
										 |  |  |               > | 
					
						
							| 
									
										
										
										
											2025-02-26 23:26:21 +00:00
										 |  |  |                 {{- .Title | safeHTML | plainify | htmlUnescape -}} | 
					
						
							| 
									
										
										
										
											2023-08-06 15:23:37 +01:00
										 |  |  |               </a> | 
					
						
							|  |  |  |             </li> | 
					
						
							| 
									
										
										
										
											2023-08-15 21:55:14 +01:00
										 |  |  |           {{ end -}} | 
					
						
							|  |  |  |         {{ end -}} | 
					
						
							|  |  |  |       {{ end -}} | 
					
						
							| 
									
										
										
										
											2023-08-06 15:23:37 +01:00
										 |  |  |     </ul> | 
					
						
							|  |  |  |   {{ end }} | 
					
						
							|  |  |  | {{- end -}} | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2023-08-14 21:56:26 +01:00
										 |  |  | {{- define "sidebar-footer" -}} | 
					
						
							|  |  |  |   {{- range site.Menus.sidebar -}} | 
					
						
							| 
									
										
										
										
											2023-08-27 17:32:44 +01:00
										 |  |  |     {{- $name := or (T .Identifier) .Name -}} | 
					
						
							| 
									
										
										
										
											2023-08-14 21:56:26 +01:00
										 |  |  |     {{ if eq .Params.type "separator" }} | 
					
						
							| 
									
										
										
										
											2025-03-29 12:51:42 +00:00
										 |  |  |       <li class="[word-break:break-word] hx:mt-5 hx:mb-2 hx:px-2 hx:py-1.5 hx:text-sm hx:font-semibold hx:text-gray-900 hx:first:mt-0 hx:dark:text-gray-100"> | 
					
						
							|  |  |  |         <span class="hx:cursor-default">{{ $name }}</span> | 
					
						
							| 
									
										
										
										
											2023-08-14 21:56:26 +01:00
										 |  |  |       </li> | 
					
						
							|  |  |  |     {{ else }} | 
					
						
							| 
									
										
										
										
											2025-03-01 02:39:36 -06:00
										 |  |  |       {{- $link := .URL -}} | 
					
						
							|  |  |  |       {{- with .PageRef -}} | 
					
						
							|  |  |  |         {{- if hasPrefix . "/" -}} | 
					
						
							|  |  |  |           {{- $link = relLangURL (strings.TrimPrefix "/" .) -}} | 
					
						
							|  |  |  |         {{- end -}} | 
					
						
							|  |  |  |       {{- end -}} | 
					
						
							|  |  |  |       <li>{{ template "sidebar-item-link" dict "active" false "title" $name "link" $link }}</li> | 
					
						
							| 
									
										
										
										
											2023-08-14 21:56:26 +01:00
										 |  |  |     {{ end }} | 
					
						
							|  |  |  |   {{- end -}} | 
					
						
							|  |  |  | {{- end -}} | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2023-08-06 15:23:37 +01:00
										 |  |  | {{- define "sidebar-item-link" -}} | 
					
						
							| 
									
										
										
										
											2023-08-20 00:42:46 +01:00
										 |  |  |   {{- $external := strings.HasPrefix .link "http" -}} | 
					
						
							|  |  |  |   {{- $open := .open | default true -}} | 
					
						
							| 
									
										
										
										
											2023-08-06 15:23:37 +01:00
										 |  |  |   <a | 
					
						
							| 
									
										
										
										
											2025-03-29 12:51:42 +00:00
										 |  |  |     class="hx:flex hx:items-center hx:justify-between hx:gap-2 hx:cursor-pointer hx:rounded-sm hx:px-2 hx:py-1.5 hx:text-sm hx:transition-colors [-webkit-tap-highlight-color:transparent] [-webkit-touch-callout:none] [word-break:break-word] | 
					
						
							| 
									
										
										
										
											2023-08-06 15:23:37 +01:00
										 |  |  |     {{- if .active }} | 
					
						
							| 
									
										
											  
											
												refactor(css): add prefix to component classes for consistency (#744)
* 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
											
										 
											2025-08-13 22:55:38 +08:00
										 |  |  |       hextra-sidebar-active-item hx:bg-primary-100 hx:font-semibold hx:text-primary-800 hx:contrast-more:border hx:contrast-more:border-primary-500 hx:dark:bg-primary-400/10 hx:dark:text-primary-600 hx:contrast-more:dark:border-primary-500 | 
					
						
							| 
									
										
										
										
											2023-08-06 15:23:37 +01:00
										 |  |  |     {{- else }} | 
					
						
							| 
									
										
										
										
											2025-03-29 12:51:42 +00:00
										 |  |  |       hx:text-gray-500 hx:hover:bg-gray-100 hx:hover:text-gray-900 hx:contrast-more:border hx:contrast-more:border-transparent hx:contrast-more:text-gray-900 hx:contrast-more:hover:border-gray-900 hx:dark:text-neutral-400 hx:dark:hover:bg-primary-100/5 hx:dark:hover:text-gray-50 hx:contrast-more:dark:text-gray-50 hx:contrast-more:dark:hover:border-gray-50 | 
					
						
							| 
									
										
										
										
											2023-08-06 15:23:37 +01:00
										 |  |  |     {{- end -}}" | 
					
						
							|  |  |  |     href="{{ .link }}" | 
					
						
							| 
									
										
										
										
											2024-11-01 18:12:14 +08:00
										 |  |  |     {{ if $external }}target="_blank" rel="noreferrer"{{ end }} | 
					
						
							| 
									
										
										
										
											2023-08-06 15:23:37 +01:00
										 |  |  |   > | 
					
						
							|  |  |  |     {{- .title -}} | 
					
						
							| 
									
										
										
										
											2023-08-20 00:42:46 +01:00
										 |  |  |     {{- with .context }} | 
					
						
							|  |  |  |       {{- if or .RegularPages .Sections }} | 
					
						
							|  |  |  |         <span class="hextra-sidebar-collapsible-button"> | 
					
						
							| 
									
										
										
										
											2023-11-12 21:47:20 +08:00
										 |  |  |           {{- template "sidebar-collapsible-button" -}} | 
					
						
							| 
									
										
										
										
											2023-08-20 00:42:46 +01:00
										 |  |  |         </span> | 
					
						
							|  |  |  |       {{- end }} | 
					
						
							|  |  |  |     {{ end -}} | 
					
						
							| 
									
										
										
										
											2023-08-06 15:23:37 +01:00
										 |  |  |   </a> | 
					
						
							|  |  |  | {{- end -}} | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2023-11-12 21:47:20 +08:00
										 |  |  | {{- define "sidebar-collapsible-button" -}} | 
					
						
							| 
									
										
										
										
											2025-03-29 12:51:42 +00:00
										 |  |  |   <svg fill="none" viewBox="0 0 24 24" stroke="currentColor" class="hx:h-[18px] hx:min-w-[18px] hx:rounded-xs hx:p-0.5 hx:hover:bg-gray-800/5 hx:dark:hover:bg-gray-100/5"><path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M9 5l7 7-7 7" class="hx:origin-center hx:transition-transform hx:rtl:-rotate-180"></path></svg> | 
					
						
							| 
									
										
										
										
											2023-08-20 00:42:46 +01:00
										 |  |  | {{- end -}} |