mirror of
https://github.com/imfing/hextra.git
synced 2025-08-23 17:56:36 -04:00
7b27743159
* 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>
209 lines
4.0 KiB
YAML
209 lines
4.0 KiB
YAML
# Configuration
|
|
baseURL: "https://example.com/"
|
|
title: "Hextra"
|
|
|
|
enableRobotsTXT: true
|
|
# Parse Git commit
|
|
enableGitInfo: true
|
|
# enableEmoji: false
|
|
hasCJKLanguage: true
|
|
|
|
# services:
|
|
# googleAnalytics:
|
|
# ID: G-MEASUREMENT_ID
|
|
|
|
outputs:
|
|
home: [HTML]
|
|
page: [HTML]
|
|
section: [HTML, RSS]
|
|
|
|
defaultContentLanguage: en
|
|
languages:
|
|
en:
|
|
languageName: English
|
|
weight: 1
|
|
title: Hextra
|
|
fa:
|
|
languageName: فارسی
|
|
languageCode: fa
|
|
languageDirection: rtl
|
|
weight: 2
|
|
title: هگزترا
|
|
ja:
|
|
languageName: 日本語
|
|
languageCode: ja
|
|
weight: 3
|
|
title: Hextra
|
|
zh-cn:
|
|
languageName: 简体中文
|
|
languageCode: zh-CN
|
|
weight: 4
|
|
title: Hextra
|
|
|
|
module:
|
|
hugoVersion:
|
|
extended: true
|
|
min: "0.146.0"
|
|
|
|
workspace: hugo.work
|
|
imports:
|
|
- path: github.com/imfing/hextra
|
|
|
|
markup:
|
|
highlight:
|
|
noClasses: false
|
|
goldmark:
|
|
renderer:
|
|
unsafe: true
|
|
extensions:
|
|
passthrough:
|
|
delimiters:
|
|
block: [['\[', '\]'], ['$$', '$$']]
|
|
inline: [['\(', '\)']]
|
|
enable: true
|
|
|
|
enableInlineShortcodes: true
|
|
|
|
menu:
|
|
main:
|
|
- identifier: documentation
|
|
name: Documentation
|
|
pageRef: /docs
|
|
weight: 1
|
|
- identifier: versions
|
|
name: Versions
|
|
weight: 2
|
|
- identifier: blog
|
|
name: Blog
|
|
pageRef: /blog
|
|
weight: 3
|
|
- identifier: about
|
|
name: About
|
|
pageRef: /about
|
|
weight: 4
|
|
- identifier: showcase
|
|
name: Showcase
|
|
pageRef: /showcase
|
|
weight: 5
|
|
- name: Search
|
|
weight: 6
|
|
params:
|
|
type: search
|
|
- name: GitHub
|
|
weight: 7
|
|
url: "https://github.com/imfing/hextra"
|
|
params:
|
|
icon: github
|
|
- identifier: development
|
|
name: Development ↗
|
|
url: https://imfing.github.io/hextra/versions/latest/
|
|
parent: versions
|
|
- identifier: v0.9
|
|
name: v0.9 ↗
|
|
url: https://imfing.github.io/hextra/versions/v0.9/
|
|
parent: versions
|
|
|
|
sidebar:
|
|
- identifier: more
|
|
name: More
|
|
params:
|
|
type: separator
|
|
weight: 1
|
|
- identifier: about
|
|
name: "About"
|
|
pageRef: "/about"
|
|
weight: 2
|
|
- identifier: hugoDocs
|
|
name: "Hugo Docs ↗"
|
|
url: "https://gohugo.io/documentation/"
|
|
weight: 3
|
|
|
|
params:
|
|
description: Modern, responsive, batteries-included Hugo theme for creating beautiful static websites.
|
|
|
|
navbar:
|
|
displayTitle: true
|
|
displayLogo: true
|
|
logo:
|
|
path: images/logo.svg
|
|
dark: images/logo-dark.svg
|
|
# width: 40
|
|
# height: 20
|
|
# link: /
|
|
width: wide
|
|
|
|
theme:
|
|
# light | dark | system
|
|
default: system
|
|
displayToggle: true
|
|
|
|
footer:
|
|
enable: true
|
|
displayCopyright: true
|
|
displayPoweredBy: true
|
|
width: normal
|
|
|
|
# Display the last modification date
|
|
displayUpdatedDate: true
|
|
dateFormat: "January 2, 2006"
|
|
|
|
# Search
|
|
# flexsearch is enabled by default
|
|
search:
|
|
enable: true
|
|
type: flexsearch
|
|
|
|
flexsearch:
|
|
# index page by: content | summary | heading | title
|
|
index: content
|
|
# full | forward | reverse | strict
|
|
# https://github.com/nextapps-de/flexsearch/#tokenizer-prefix-search
|
|
tokenize: forward
|
|
|
|
editURL:
|
|
enable: true
|
|
base: "https://github.com/imfing/hextra/edit/main/exampleSite/content"
|
|
|
|
blog:
|
|
list:
|
|
displayTags: true
|
|
# date | lastmod | publishDate | title | weight
|
|
sortBy: date
|
|
sortOrder: desc # or "asc"
|
|
|
|
article:
|
|
displayPagination: true
|
|
|
|
toc:
|
|
displayTags: true
|
|
|
|
highlight:
|
|
copy:
|
|
enable: true
|
|
# hover | always
|
|
display: hover
|
|
|
|
page:
|
|
# full (100%), wide (90rem), normal (80rem)
|
|
width: normal
|
|
# tabs:
|
|
# sync: true
|
|
|
|
comments:
|
|
enable: false
|
|
type: giscus
|
|
|
|
# https://giscus.app/
|
|
giscus:
|
|
repo: imfing/hextra
|
|
repoId: R_kgDOJ9fJag
|
|
category: General
|
|
categoryId: DIC_kwDOJ9fJas4CY7gW
|
|
# mapping: pathname
|
|
# strict: 0
|
|
# reactionsEnabled: 1
|
|
# emitMetadata: 0
|
|
# inputPosition: top
|
|
# lang: en
|
|
# theme: noborder_dark
|