diff options
author | Dillon <dillonzq@outlook.com> | 2022-05-21 18:32:17 +0300 |
---|---|---|
committer | Dillon <dillonzq@outlook.com> | 2022-05-21 18:32:17 +0300 |
commit | 7543423430f9eaee28d4e705adbcf6a223f43315 (patch) | |
tree | 23be6a97d2584c5ff158b42fccecb5e3c54c1926 | |
parent | 45df8d42576098a285c2e494296bdb3c372f701f (diff) |
feat: subtile config and docs
-rw-r--r-- | config.toml | 584 | ||||
-rw-r--r-- | exampleSite/config.toml | 1082 | ||||
-rw-r--r-- | exampleSite/content/posts/theme-documentation-basics/index.en.md | 206 | ||||
-rw-r--r-- | exampleSite/content/posts/theme-documentation-basics/index.zh-cn.md | 211 |
4 files changed, 1241 insertions, 842 deletions
diff --git a/config.toml b/config.toml new file mode 100644 index 00000000..a38391cc --- /dev/null +++ b/config.toml @@ -0,0 +1,584 @@ +[module] + [module.hugoVersion] + extended = true + min = "0.62.0" + +[params] + # site default theme ["auto", "light", "dark"] + # 网站默认主题 ["auto", "light", "dark"] + defaultTheme = "auto" + # public git repo url only then enableGitInfo is true + # 公共 git 仓库路径,仅在 enableGitInfo 设为 true 时有效 + gitRepo = "" + # which hash function used for SRI, when empty, no SRI is used + # ["sha256", "sha384", "sha512", "md5"] + # 哪种哈希函数用来 SRI, 为空时表示不使用 SRI + # ["sha256", "sha384", "sha512", "md5"] + fingerprint = "" + # date format + # 日期格式 + dateFormat = "2006-01-02" + # website title for Open Graph and Twitter Cards + # 网站标题, 用于 Open Graph 和 Twitter Cards + title = "My cool site" + # website description for RSS, SEO, Open Graph and Twitter Cards + # 网站描述, 用于 RSS, SEO, Open Graph 和 Twitter Cards + description = "This is my cool site" + # website images for Open Graph and Twitter Cards + # 网站图片, 用于 Open Graph 和 Twitter Cards + images = [] + + # Header config + # 页面头部导航栏配置 + [params.header] + # desktop header mode ["fixed", "normal", "auto"] + # 桌面端导航栏模式 ["fixed", "normal", "auto"] + desktopMode = "fixed" + # mobile header mode ["fixed", "normal", "auto"] + # 移动端导航栏模式 ["fixed", "normal", "auto"] + mobileMode = "auto" + # Header title config + # 页面头部导航栏标题配置 + [params.header.title] + # URL of the LOGO + # LOGO 的 URL + logo = "" + # title name + # 标题名称 + name = "My cool site" + # you can add extra information before the name (HTML format is supported), such as icons + # 你可以在名称 (允许 HTML 格式) 之前添加其他信息, 例如图标 + pre = "" + # you can add extra information after the name (HTML format is supported), such as icons + # 你可以在名称 (允许 HTML 格式) 之后添加其他信息, 例如图标 + post = "" + # whether to use typeit animation for title name + # 是否为标题显示打字机动画 + typeit = false + + # Footer config + # 页面底部信息配置 + [params.footer] + enable = true + # Custom content (HTML format is supported) + # 自定义内容 (支持 HTML 格式) + custom = "" + # whether to show Hugo and theme info + # 是否显示 Hugo 和主题信息 + hugo = true + # whether to show copyright info + # 是否显示版权信息 + copyright = true + # whether to show the author + # 是否显示作者 + author = true + # site creation time + # 网站创立年份 + since = 2022 + # ICP info only in China (HTML format is supported) + # ICP 备案信息,仅在中国使用 (支持 HTML 格式) + icp = "" + # license info (HTML format is supported) + # 许可协议信息 (支持 HTML 格式) + license= "" + + # Section (all posts) page config + # Section (所有文章) 页面配置 + [params.section] + # special amount of posts in each section page + # section 页面每页显示文章数量 + paginate = 20 + # date format (month and day) + # 日期格式 (月和日) + dateFormat = "01-02" + # amount of RSS pages + # RSS 文章数目 + rss = 10 + + # List (category or tag) page config + # List (目录或标签) 页面配置 + [params.list] + # special amount of posts in each list page + # list 页面每页显示文章数量 + paginate = 20 + # date format (month and day) + # 日期格式 (月和日) + dateFormat = "01-02" + # amount of RSS pages + # RSS 文章数目 + rss = 10 + + # App icon config + # 应用图标配置 + [params.app] + # optional site title override for the app when added to an iOS home screen or Android launcher + # 当添加到 iOS 主屏幕或者 Android 启动器时的标题, 覆盖默认标题 + title = "My cool site" + # whether to omit favicon resource links + # 是否隐藏网站图标资源链接 + noFavicon = false + # modern SVG favicon to use in place of older style .png and .ico files + # 更现代的 SVG 网站图标, 可替代旧的 .png 和 .ico 文件 + svgFavicon = "" + # Android browser theme color + # Android 浏览器主题色 + themeColor = "#ffffff" + # Safari mask icon color + # Safari 图标颜色 + iconColor = "#5bbad5" + # Windows v8-11 tile color + # Windows v8-11 磁贴颜色 + tileColor = "#da532c" + + # Search config + # 搜索配置 + [params.search] + enable = false + # type of search engine ["lunr", "algolia"] + # 搜索引擎的类型 ["lunr", "algolia"] + type = "lunr" + # max index length of the chunked content + # 文章内容最长索引长度 + contentLength = 4000 + # placeholder of the search bar + # 搜索框的占位提示语 + placeholder = "" + # max number of results length + # 最大结果数目 + maxResultLength = 10 + # snippet length of the result + # 结果内容片段长度 + snippetLength = 30 + # HTML tag name of the highlight part in results + # 搜索结果中高亮部分的 HTML 标签 + highlightTag = "em" + # whether to use the absolute URL based on the baseURL in search index + # 是否在搜索索引中使用基于 baseURL 的绝对路径 + absoluteURL = false + [params.search.algolia] + index = "" + appID = "" + searchKey = "" + + # Home page config + # 主页信息设置 + [params.home] + # amount of RSS pages + # RSS 文章数目 + rss = 10 + # Home page profile + # 主页个人信息 + [params.home.profile] + enable = true + # Gravatar Email for preferred avatar in home page + # Gravatar 邮箱,用于优先在主页显示的头像 + gravatarEmail = "" + # URL of avatar shown in home page + # 主页显示头像的 URL + avatarURL = "" + # title shown in home page (HTML format is supported) + # 主页显示的网站标题 (支持 HTML 格式) + title = "" + # subtitle shown in home page (HTML format is supported) + # 主页显示的网站副标题 (允许 HTML 格式) + subtitle = "This is my cool site" + # whether to use typeit animation for subtitle + # 是否为副标题显示打字机动画 + typeit = true + # whether to show social links + # 是否显示社交账号 + social = true + # disclaimer (HTML format is supported) + # 免责声明 (支持 HTML 格式) + disclaimer = "" + # Home page posts + # 主页文章列表 + [params.home.posts] + enable = true + # special amount of posts in each home posts page + # 主页每页显示文章数量 + paginate = 6 + # Social config in home page + # 主页的社交信息设置 + [params.social] + GitHub = "" + Linkedin = "" + Twitter = "" + Instagram = "" + Facebook = "" + Telegram = "" + Medium = "" + Gitlab = "" + Youtubelegacy = "" + Youtubecustom = "" + Youtubechannel = "" + Tumblr = "" + Quora = "" + Keybase = "" + Pinterest = "" + Reddit = "" + Codepen = "" + FreeCodeCamp = "" + Bitbucket = "" + Stackoverflow = "" + Weibo = "" + Odnoklassniki = "" + VK = "" + Flickr = "" + Xing = "" + Snapchat = "" + Soundcloud = "" + Spotify = "" + Bandcamp = "" + Paypal = "" + Fivehundredpx = "" + Mix = "" + Goodreads = "" + Lastfm = "" + Foursquare = "" + Hackernews = "" + Kickstarter = "" + Patreon = "" + Steam = "" + Twitch = "" + Strava = "" + Skype = "" + Whatsapp = "" + Zhihu = "" + Douban = "" + Angellist = "" + Slidershare = "" + Jsfiddle = "" + Deviantart = "" + Behance = "" + Dribbble = "" + Wordpress = "" + Vine = "" + Googlescholar = "" + Researchgate = "" + Mastodon = "" + Thingiverse = "" + Devto = "" + Gitea = "" + XMPP = "" + Matrix = "" + Bilibili = "" + Discord = "" + DiscordInvite = "" + Email = "" + RSS = "" + + # Page global config + # 文章页面全局配置 + [params.page] + # whether to hide a page from home page + # 是否在主页隐藏一篇文章 + hiddenFromHomePage = false + # whether to hide a page from search results + # 是否在搜索结果中隐藏一篇文章 + hiddenFromSearch = false + # whether to enable twemoji + # 是否使用 twemoji + twemoji = false + # whether to enable lightgallery + # 是否使用 lightgallery + lightgallery = false + # whether to enable the ruby extended syntax + # 是否使用 ruby 扩展语法 + ruby = true + # whether to enable the fraction extended syntax + # 是否使用 fraction 扩展语法 + fraction = true + # whether to enable the fontawesome extended syntax + # 是否使用 fontawesome 扩展语法 + fontawesome = true + # whether to show link to Raw Markdown content of the content + # 是否显示原始 Markdown 文档内容的链接 + linkToMarkdown = true + # whether to show the full text content in RSS + # 是否在 RSS 中显示全文内容 + rssFullText = false + # Table of the contents config + # 目录配置 + [params.page.toc] + # whether to enable the table of the contents + # 是否使用目录 + enable = true + # whether to keep the static table of the contents in front of the post + # 是否保持使用文章前面的静态目录 + keepStatic = false + # whether to make the table of the contents in the sidebar automatically collapsed + # 是否使侧边目录自动折叠展开 + auto = true + # Code config + # 代码配置 + [params.page.code] + # whether to show the copy button of the code block + # 是否显示代码块的复制按钮 + copy = true + # the maximum number of lines of displayed code by default + # 默认展开显示的代码行数 + maxShownLines = 50 + # KaTeX mathematical formulas config (KaTeX https://katex.org/) + # KaTeX 数学公式配置 (KaTeX https://katex.org/) + [params.page.math] + enable = false + # default inline delimiter is $ ... $ and \( ... \) + # 默认行内定界符是 $ ... $ 和 \( ... \) + inlineLeftDelimiter = "" + inlineRightDelimiter = "" + # default block delimiter is $$ ... $$, \[ ... \], \begin{equation} ... \end{equation} and some other functions + # 默认块定界符是 $$ ... $$, \[ ... \], \begin{equation} ... \end{equation} 和一些其它的函数 + blockLeftDelimiter = "" + blockRightDelimiter = "" + # KaTeX extension copy_tex + # KaTeX 插件 copy_tex + copyTex = true + # KaTeX extension mhchem + # KaTeX 插件 mhchem + mhchem = true + # Mapbox GL JS config (Mapbox GL JS https://docs.mapbox.com/mapbox-gl-js) + # Mapbox GL JS 配置 (Mapbox GL JS https://docs.mapbox.com/mapbox-gl-js) + [params.page.mapbox] + # access token of Mapbox GL JS + # Mapbox GL JS 的 access token + accessToken = "" + # style for the light theme + # 浅色主题的地图样式 + lightStyle = "mapbox://styles/mapbox/light-v10?optimize=true" + # style for the dark theme + # 深色主题的地图样式 + darkStyle = "mapbox://styles/mapbox/dark-v10?optimize=true" + # whether to add NavigationControl (https://docs.mapbox.com/mapbox-gl-js/api/#navigationcontrol) + # 是否添加 NavigationControl (https://docs.mapbox.com/mapbox-gl-js/api/#navigationcontrol) + navigation = true + # whether to add GeolocateControl (https://docs.mapbox.com/mapbox-gl-js/api/#geolocatecontrol) + # 是否添加 GeolocateControl (https://docs.mapbox.com/mapbox-gl-js/api/#geolocatecontrol) + geolocate = true + # whether to add ScaleControl (https://docs.mapbox.com/mapbox-gl-js/api/#scalecontrol) + # 是否添加 ScaleControl (https://docs.mapbox.com/mapbox-gl-js/api/#scalecontrol) + scale = true + # whether to add FullscreenControl (https://docs.mapbox.com/mapbox-gl-js/api/#fullscreencontrol) + # 是否添加 FullscreenControl (https://docs.mapbox.com/mapbox-gl-js/api/#fullscreencontrol) + fullscreen = true + # Social share links in post page + # 文章页面的分享信息设置 + [params.page.share] + enable = true + Twitter = true + Facebook = true + Linkedin = false + Whatsapp = false + Pinterest = false + Tumblr = false + HackerNews = true + Reddit = false + VK = false + Buffer = false + Xing = false + Line = true + Instapaper = false + Pocket = false + Flipboard = false + Weibo = true + Blogger = false + Baidu = false + Odnoklassniki = false + Evernote = false + Skype = false + Trello = false + Mix = false + # Comment config + # 评论系统设置 + [params.page.comment] + enable = false + # Disqus comment config (https://disqus.com/) + # Disqus 评论系统设置 (https://disqus.com/) + [params.page.comment.disqus] + enable = false + # Disqus shortname to use Disqus in posts + # Disqus 的 shortname,用来在文章中启用 Disqus 评论系统 + shortname = "" + # Gitalk comment config (https://github.com/gitalk/gitalk) + # Gitalk 评论系统设置 (https://github.com/gitalk/gitalk) + [params.page.comment.gitalk] + enable = false + owner = "" + repo = "" + clientId = "" + clientSecret = "" + # Valine comment config (https://github.com/xCss/Valine) + # Valine 评论系统设置 (https://github.com/xCss/Valine) + [params.page.comment.valine] + enable = false + appId = "" + appKey = "" + placeholder = "" + avatar = "mp" + meta= "" + pageSize = 10 + lang = "" + visitor = true + recordIP = true + highlight = true + enableQQ = false + serverURLs = "" + # emoji data file name, default is "google.yml" + # ["apple.yml", "google.yml", "facebook.yml", "twitter.yml"] + # located in "themes/LoveIt/assets/lib/valine/emoji/" directory + # you can store your own data files in the same path under your project: + # "assets/lib/valine/emoji/" + # emoji 数据文件名称, 默认是 "google.yml" + # ["apple.yml", "google.yml", "facebook.yml", "twitter.yml"] + # 位于 "themes/LoveIt/assets/lib/valine/emoji/" 目录 + # 可以在你的项目下相同路径存放你自己的数据文件: + # "assets/lib/valine/emoji/" + emoji = "" + # Facebook comment config (https://developers.facebook.com/docs/plugins/comments) + # Facebook 评论系统设置 (https://developers.facebook.com/docs/plugins/comments) + [params.page.comment.facebook] + enable = false + width = "100%" + numPosts = 10 + appId = "" + languageCode = "" + # Telegram comments config (https://comments.app/) + # Telegram comments 评论系统设置 (https://comments.app/) + [params.page.comment.telegram] + enable = false + siteID = "" + limit = 5 + height = "" + color = "" + colorful = true + dislikes = false + outlined = false + # Commento comment config (https://commento.io/) + # Commento comment 评论系统设置 (https://commento.io/) + [params.page.comment.commento] + enable = false + # Utterances comment config (https://utteranc.es/) + # Utterances comment 评论系统设置 (https://utteranc.es/) + [params.page.comment.utterances] + enable = false + # owner/repo + repo = "" + issueTerm = "pathname" + label = "" + lightTheme = "github-light" + darkTheme = "github-dark" + # Third-party library config + # 第三方库配置 + [params.page.library] + [params.page.library.css] + # someCSS = "some.css" + # located in "assets/" 位于 "assets/" + # Or 或者 + # someCSS = "https://cdn.example.com/some.css" + [params.page.library.js] + # someJavascript = "some.js" + # located in "assets/" 位于 "assets/" + # Or 或者 + # someJavascript = "https://cdn.example.com/some.js" + # Page SEO config + # 页面 SEO 配置 + [params.page.seo] + # image URL + # 图片 URL + images = [] + # Publisher info + # 出版者信息 + [params.page.seo.publisher] + name = "" + logoUrl = "" + + # TypeIt config + # TypeIt 配置 + [params.typeit] + # typing speed between each step (measured in milliseconds) + # 每一步的打字速度 (单位是毫秒) + speed = 100 + # blinking speed of the cursor (measured in milliseconds) + # 光标的闪烁速度 (单位是毫秒) + cursorSpeed = 1000 + # character used for the cursor (HTML format is supported) + # 光标的字符 (支持 HTML 格式) + cursorChar = "|" + # cursor duration after typing finishing (measured in milliseconds, "-1" means unlimited) + # 打字结束之后光标的持续时间 (单位是毫秒, "-1" 代表无限大) + duration = -1 + + # Site verification code for Google/Bing/Yandex/Pinterest/Baidu + # 网站验证代码,用于 Google/Bing/Yandex/Pinterest/Baidu + [params.verification] + google = "" + bing = "" + yandex = "" + pinterest = "" + baidu = "" + + # Site SEO config + # 网站 SEO 配置 + [params.seo] + # image URL + # 图片 URL + image = "" + # thumbnail URL + # 缩略图 URL + thumbnailUrl = "" + + # Analytics config + # 网站分析配置 + [params.analytics] + enable = false + # Google Analytics + [params.analytics.google] + id = "" + # whether to anonymize IP + # 是否匿名化用户 IP + anonymizeIP = true + # Fathom Analytics + [params.analytics.fathom] + id = "" + # server url for your tracker if you're self hosting + # 自行托管追踪器时的主机路径 + server = "" + # Plausible Analytics + [params.analytics.plausible] + dataDomain = "" + + # Cookie consent config + # Cookie 许可配置 + [params.cookieconsent] + enable = false + # text strings used for Cookie consent banner + # 用于 Cookie 许可横幅的文本字符串 + [params.cookieconsent.content] + message = "" + dismiss = "" + link = "" + + # CDN config for third-party library files + # 第三方库文件的 CDN 设置 + [params.cdn] + # CDN data file name, disabled by default + # ["jsdelivr.yml"] + # located in "themes/LoveIt/assets/data/cdn/" directory + # you can store your own data files in the same path under your project: + # "assets/data/cdn/" + # CDN 数据文件名称, 默认不启用 + # ["jsdelivr.yml"] + # 位于 "themes/LoveIt/assets/data/cdn/" 目录 + # 可以在你的项目下相同路径存放你自己的数据文件: + # "assets/data/cdn/" + data = "jsdelivr.yml" + + # Compatibility config + # 兼容性设置 + [params.compatibility] + # whether to use Polyfill.io to be compatible with older browsers + # 是否使用 Polyfill.io 来兼容旧式浏览器 + polyfill = false + # whether to use object-fit-images to be compatible with older browsers + # 是否使用 object-fit-images 来兼容旧式浏览器 + objectFit = false diff --git a/exampleSite/config.toml b/exampleSite/config.toml index c441853f..5c79bf9d 100644 --- a/exampleSite/config.toml +++ b/exampleSite/config.toml @@ -1,7 +1,5 @@ baseURL = "https://example.com" -# [en, zh-cn, fr, pl, ...] determines default content language -# [en, zh-cn, fr, pl, ...] 设置默认的语言 -defaultContentLanguage = "en" + # theme # 主题 theme = "LoveIt" @@ -13,6 +11,29 @@ themesDir = "../.." # 网站标题 title = "LoveIt" +# determines default content language ["en", "zh-cn", "fr", "pl", ...] +# 设置默认的语言 ["en", "zh-cn", "fr", "pl", ...] +defaultContentLanguage = "en" +# language code ["en", "zh-CN", "fr", "pl", ...] +# 网站语言, 仅在这里 CN 大写 ["en", "zh-CN", "fr", "pl", ...] +languageCode = "en" +# language name ["English", "简体中文", "Français", "Polski", ...] +# 语言名称 ["English", "简体中文", "Français", "Polski", ...] +languageName = "English" +# whether to include Chinese/Japanese/Korean +# 是否包括中日韩文字 +hasCJKLanguage = false + +# default amount of posts in each pages +# 默认每页列表显示的文章数目 +paginate = 12 +# google analytics code [UA-XXXXXXXX-X] +# 谷歌分析代号 [UA-XXXXXXXX-X] +googleAnalytics = "" +# copyright description used only for seo schema +# 版权描述,仅仅用于 SEO +copyright = "" + # whether to use robots.txt # 是否使用 robots.txt enableRobotsTXT = true @@ -23,619 +44,68 @@ enableGitInfo = true # 是否使用 emoji 代码 enableEmoji = true -[languages] - [languages.en] - weight = 1 - # language code - languageCode = "en" - # language name - languageName = "English" - # whether to include Chinese/Japanese/Korean - hasCJKLanguage = false - # default amount of posts in each pages - paginate = 12 - # [UA-XXXXXXXX-X] google analytics code - googleAnalytics = "" - # copyright description used only for seo schema - copyright = "This work is licensed under a Creative Commons Attribution-NonCommercial 4.0 International License." - # Menu config - [languages.en.menu] - [[languages.en.menu.main]] - identifier = "posts" - # you can add extra information before the name (HTML format is supported), such as icons - pre = "" - # you can add extra information after the name (HTML format is supported), such as icons - post = "" - name = "Posts" - url = "/posts/" - # title will be shown when you hover on this menu link. - title = "" - weight = 1 - [[languages.en.menu.main]] - identifier = "tags" - pre = "" - post = "" - name = "Tags" - url = "/tags/" - title = "" - weight = 2 - [[languages.en.menu.main]] - identifier = "categories" - pre = "" - post = "" - name = "Categories" - url = "/categories/" - title = "" - weight = 3 - [[languages.en.menu.main]] - identifier = "documentation" - pre = "" - post = "" - name = "Docs" - url = "/categories/documentation/" - title = "" - weight = 4 - [[languages.en.menu.main]] - identifier = "about" - pre = "" - post = "" - name = "About" - url = "/about/" - title = "" - weight = 5 - [[languages.en.menu.main]] - identifier = "github" - pre = "<i class='fab fa-github fa-fw'></i>" - post = "" - name = "" - url = "https://github.com/dillonzq/LoveIt" - title = "GitHub" - weight = 6 - [languages.en.params] - # site description - description = "About LoveIt Theme" - # site keywords - keywords = ["Theme", "Hugo"] - # App icon config - [languages.en.params.app] - # optional site title override for the app when added to an iOS home screen or Android launcher - title = "LoveIt" - # whether to omit favicon resource links - noFavicon = false - # modern SVG favicon to use in place of older style .png and .ico files - svgFavicon = "" - # Android browser theme color - themeColor = "#ffffff" - # Safari mask icon color - iconColor = "#5bbad5" - # Windows v8-10 tile color - tileColor = "#da532c" - # Search config - [languages.en.params.search] - enable = true - # type of search engine ("lunr", "algolia") - type = "algolia" - # max index length of the chunked content - contentLength = 4000 - # placeholder of the search bar - placeholder = "" - # max number of results length - maxResultLength = 10 - # snippet length of the result - snippetLength = 30 - # HTML tag name of the highlight part in results - highlightTag = "em" - # whether to use the absolute URL based on the baseURL in search index - absoluteURL = false - [languages.en.params.search.algolia] - index = "index.en" - appID = "PASDMWALPK" - searchKey = "b42948e51daaa93df92381c8e2ac0f93" - # Home page config - [languages.en.params.home] - # amount of RSS pages - rss = 10 - # Home page profile - [languages.en.params.home.profile] - enable = true - # Gravatar Email for preferred avatar in home page - gravatarEmail = "" - # URL of avatar shown in home page - avatarURL = "/images/avatar.png" - # title shown in home page (HTML format is supported) - title = "" - # subtitle shown in home page (HTML format is supported) - subtitle = "A Clean, Elegant but Advanced Hugo Theme" - # whether to use typeit animation for subtitle - typeit = true - # whether to show social links - social = true - # disclaimer (HTML format is supported) - disclaimer = "" - # Home page posts - [languages.en.params.home.posts] - enable = true - # special amount of posts in each home posts page - paginate = 6 - # Social config in home page - [languages.en.params.social] - GitHub = "xxxx" - Linkedin = "" - Twitter = "xxxx" - Instagram = "xxxx" - Facebook = "xxxx" - Telegram = "xxxx" - Medium = "" - Gitlab = "" - Youtubelegacy = "xxxx" - Youtubecustom = "" - Youtubechannel = "" - Tumblr = "" - Quora = "" - Keybase = "" - Pinterest = "" - Reddit = "" - Codepen = "" - FreeCodeCamp = "" - Bitbucket = "" - Stackoverflow = "" - Weibo = "" - Odnoklassniki = "" - VK = "" - Flickr = "" - Xing = "" - Snapchat = "" - Soundcloud = "" - Spotify = "" - Bandcamp = "" - Paypal = "" - Fivehundredpx = "" - Mix = "" - Goodreads = "" - Lastfm = "" - Foursquare = "" - Hackernews = "" - Kickstarter = "" - Patreon = "" - Steam = "" - Twitch = "" - Strava = "" - Skype = "" - Whatsapp = "" - Zhihu = "" - Douban = "" - Angellist = "" - Slidershare = "" - Jsfiddle = "" - Deviantart = "" - Behance = "" - Dribbble = "" - Wordpress = "" - Vine = "" - Googlescholar = "" - Researchgate = "" - Thingiverse = "" - Devto = "" - Gitea = "" - XMPP = "" - Matrix = "" - Bilibili = "" - Email = "xxxx@xxxx.com" - RSS = true - [languages.en.params.social.Mastodon] - id = "@xxxx" - prefix = "https://mastodon.technology/" +# Author config +# 作者配置 +[author] + name = "xxxx" + email = "" + link = "" - [languages.zh-cn] +# Menu config +# 菜单配置 +[menu] + [[menu.main]] + weight = 1 + identifier = "posts" + # you can add extra information before the name (HTML format is supported), such as icons + # 你可以在名称 (允许 HTML 格式) 之前添加其他信息, 例如图标 + pre = "" + # you can add extra information after the name (HTML format is supported), such as icons + # 你可以在名称 (允许 HTML 格式) 之后添加其他信息, 例如图标 + post = "" + name = "Posts" + url = "/posts/" + # title will be shown when you hover on this menu link + # 当您将鼠标悬停在此菜单链接上时, 将显示标题 + title = "" + [[menu.main]] weight = 2 - # 网站语言, 仅在这里 CN 大写 - languageCode = "zh-CN" - # 语言名称 - languageName = "简体中文" - # 是否包括中日韩文字 - hasCJKLanguage = true - # 默认每页列表显示的文章数目 - paginate = 12 - # [UA-XXXXXXXX-X] 谷歌分析代号 - googleAnalytics = "" - # 版权描述,仅仅用于 SEO - copyright = "This work is licensed under a Creative Commons Attribution-NonCommercial 4.0 International License." - # 菜单配置 - [languages.zh-cn.menu] - [[languages.zh-cn.menu.main]] - identifier = "posts" - # 你可以在名称 (允许 HTML 格式) 之前添加其他信息, 例如图标 - pre = "" - # 你可以在名称 (允许 HTML 格式) 之后添加其他信息, 例如图标 - post = "" - name = "所有文章" - url = "/posts/" - title = "" - weight = 1 - [[languages.zh-cn.menu.main]] - identifier = "tags" - pre = "" - post = "" - name = "标签" - url = "/tags/" - title = "" - weight = 2 - [[languages.zh-cn.menu.main]] - identifier = "categories" - pre = "" - post = "" - name = "分类" - url = "/categories/" - title = "" - weight = 3 - [[languages.zh-cn.menu.main]] - identifier = "documentation" - pre = "" - name = "文档" - url = "/categories/documentation/" - title = "" - weight = 4 - [[languages.zh-cn.menu.main]] - identifier = "about" - pre = "" - post = "" - name = "关于" - url = "/about/" - title = "" - weight = 5 - [[languages.zh-cn.menu.main]] - identifier = "github" - pre = "<i class='fab fa-github fa-fw'></i>" - post = "" - name = "" - url = "https://github.com/dillonzq/LoveIt" - title = "GitHub" - weight = 6 - [languages.zh-cn.params] - # 网站描述 - description = "关于 LoveIt 主题" - # 网站关键词 - keywords = ["Theme", "Hugo"] - # 应用图标配置 - [languages.zh-cn.params.app] - # 当添加到 iOS 主屏幕或者 Android 启动器时的标题, 覆盖默认标题 - title = "LoveIt" - # 是否隐藏网站图标资源链接 - noFavicon = false - # 更现代的 SVG 网站图标, 可替代旧的 .png 和 .ico 文件 - svgFavicon = "" - # Android 浏览器主题色 - themeColor = "#ffffff" - # Safari 图标颜色 - iconColor = "#5bbad5" - # Windows v8-10 磁贴颜色 - tileColor = "#da532c" - # 搜索配置 - [languages.zh-cn.params.search] - enable = true - # 搜索引擎的类型 ("lunr", "algolia") - type = "algolia" - # 文章内容最长索引长度 - contentLength = 4000 - # 搜索框的占位提示语 - placeholder = "" - # 最大结果数目 - maxResultLength = 10 - # 结果内容片段长度 - snippetLength = 50 - # 搜索结果中高亮部分的 HTML 标签 - highlightTag = "em" - # 是否在搜索索引中使用基于 baseURL 的绝对路径 - absoluteURL = false - [languages.zh-cn.params.search.algolia] - index = "index.zh-cn" - appID = "PASDMWALPK" - searchKey = "b42948e51daaa93df92381c8e2ac0f93" - # 主页信息设置 - [languages.zh-cn.params.home] - # RSS 文章数目 - rss = 10 - # 主页个人信息 - [languages.zh-cn.params.home.profile] - enable = true - # Gravatar 邮箱,用于优先在主页显示的头像 - gravatarEmail = "" - # 主页显示头像的 URL - avatarURL = "/images/avatar.png" - # 主页显示的网站标题 (支持 HTML 格式) - title = "" - # 主页显示的网站副标题 (支持 HTML 格式) - subtitle = "一个简洁、优雅且高效的 Hugo 主题" - # 是否为副标题显示打字机动画 - typeit = true - # 是否显示社交账号 - social = true - # 免责声明 (支持 HTML 格式) - disclaimer = "" - # 主页文章列表 - [languages.zh-cn.params.home.posts] - enable = true - # 主页每页显示文章数量 - paginate = 6 - # 主页的社交信息设置 - [languages.zh-cn.params.social] - GitHub = "xxxx" - Linkedin = "" - Twitter = "" - Instagram = "" - Facebook = "" - Telegram = "" - Medium = "" - Gitlab = "" - Youtubelegacy = "" - Youtubecustom = "" - Youtubechannel = "" - Tumblr = "" - Quora = "" - Keybase = "" - Pinterest = "" - Reddit = "" - Codepen = "" - FreeCodeCamp = "" - Bitbucket = "" - Stackoverflow = "" - Weibo = "xxxx" - Odnoklassniki = "" - VK = "" - Flickr = "" - Xing = "" - Snapchat = "" - Soundcloud = "" - Spotify = "" - Bandcamp = "" - Paypal = "" - Fivehundredpx = "" - Mix = "" - Goodreads = "" - Lastfm = "" - Foursquare = "" - Hackernews = "" - Kickstarter = "" - Patreon = "" - Steam = "xxxx" - Twitch = "" - Strava = "" - Skype = "" - Whatsapp = "" - Zhihu = "xxxx" - Douban = "xxxx" - Angellist = "" - Slidershare = "" - Jsfiddle = "" - Deviantart = "" - Behance = "" - Dribbble = "" - Wordpress = "" - Vine = "" - Googlescholar = "" - Researchgate = "" - Mastodon = "" - Thingiverse = "" - Devto = "xxxx" - Gitea = "" - XMPP = "" - Matrix = "" - Bilibili = "xxxx" - Email = "xxxx@xxxx.com" - RSS = true - - [languages.fr] + identifier = "tags" + pre = "" + post = "" + name = "Tags" + url = "/tags/" + title = "" + [[menu.main]] weight = 3 - # language code - languageCode = "fr" - # language name - languageName = "Français" - # whether to include Chinese/Japanese/Korean - hasCJKLanguage = false - # default amount of posts in each pages - paginate = 12 - # [UA-XXXXXXXX-X] google analytics code - googleAnalytics = "" - # copyright description used only for seo schema - copyright = "This work is licensed under a Creative Commons Attribution-NonCommercial 4.0 International License." - # Menu config - [languages.fr.menu] - [[languages.fr.menu.main]] - identifier = "posts" - pre = "" - post = "" - name = "Postes" - url = "/posts/" - title = "" - weight = 1 - [[languages.fr.menu.main]] - identifier = "tags" - pre = "" - post = "" - name = "Balises" - url = "/tags/" - title = "" - weight = 2 - [[languages.fr.menu.main]] - identifier = "categories" - pre = "" - post = "" - name = "Catégories" - url = "/categories/" - title = "" - weight = 3 - [[languages.fr.menu.main]] - identifier = "documentation" - pre = "" - post = "" - name = "Docs" - url = "/categories/documentation/" - title = "" - weight = 4 - [[languages.fr.menu.main]] - identifier = "about" - pre = "" - name = "À propos" - url = "/about/" - title = "" - weight = 5 - [[languages.fr.menu.main]] - identifier = "github" - pre = "<i class='fab fa-github fa-fw'></i>" - post = "" - name = "" - url = "https://github.com/dillonzq/LoveIt" - title = "GitHub" - weight = 6 - [languages.fr.params] - # site description - description = "À propos du thème LoveIt" - # site keywords - keywords = ["Thème", "Hugo"] - # App icon config - [languages.fr.params.app] - # optional site title override for the app when added to an iOS home screen or Android launcher - title = "LoveIt" - # whether to omit favicon resource links - noFavicon = false - # modern SVG favicon to use in place of older style .png and .ico files - svgFavicon = "" - # Android browser theme color - themeColor = "#ffffff" - # Safari mask icon color - iconColor = "#5bbad5" - # Windows v8-10 tile color - tileColor = "#da532c" - # Search config - [languages.fr.params.search] - enable = true - # type of search engine ("lunr", "algolia") - type = "algolia" - # max index length of the chunked content - contentLength = 4000 - # placeholder of the search bar - placeholder = "" - # max number of results length - maxResultLength = 10 - # snippet length of the result - snippetLength = 30 - # HTML tag name of the highlight part in results - highlightTag = "em" - # whether to use the absolute URL based on the baseURL in search index - absoluteURL = false - [languages.fr.params.search.algolia] - index = "index.fr" - appID = "PASDMWALPK" - searchKey = "b42948e51daaa93df92381c8e2ac0f93" - # Home page config - [languages.fr.params.home] - # amount of RSS pages - rss = 10 - # Home page profile - [languages.fr.params.home.profile] - enable = true - # Gravatar Email for preferred avatar in home page - gravatarEmail = "" - # URL of avatar shown in home page - avatarURL = "/images/avatar.png" - # title shown in home page (HTML format is supported) - title = "" - # subtitle shown in home page (HTML format is supported) - subtitle = "Un thème Hugo simple, élégant et efficace" - # whether to use typeit animation for subtitle - typeit = true - # whether to show social links - social = true - # disclaimer (HTML format is supported) - disclaimer = "" - # Home page posts - [languages.fr.params.home.posts] - enable = true - # special amount of posts in each home posts page - paginate = 6 - # Social config in home page - [languages.fr.params.social] - GitHub = "xxxx" - Linkedin = "xxxx" - Twitter = "xxxx" - Instagram = "" - Facebook = "" - Telegram = "" - Medium = "" - Gitlab = "" - Youtubelegacy = "" - Youtubecustom = "" - Youtubechannel = "" - Tumblr = "" - Quora = "" - Keybase = "" - Pinterest = "" - Reddit = "" - Codepen = "" - FreeCodeCamp = "" - Bitbucket = "" - Stackoverflow = "" - Weibo = "" - Odnoklassniki = "" - VK = "" - Flickr = "" - Xing = "" - Snapchat = "xxxx" - Soundcloud = "" - Spotify = "" - Bandcamp = "" - Paypal = "" - Fivehundredpx = "" - Mix = "" - Goodreads = "" - Lastfm = "" - Foursquare = "" - Hackernews = "xxxx" - Kickstarter = "" - Patreon = "" - Steam = "" - Twitch = "" - Strava = "" - Skype = "" - Whatsapp = "" - Zhihu = "" - Douban = "" - Angellist = "" - Slidershare = "" - Jsfiddle = "" - Deviantart = "" - Behance = "" - Dribbble = "xxxx" - Wordpress = "" - Vine = "" - Googlescholar = "" - Researchgate = "" - Mastodon = "" - Thingiverse = "" - Devto = "" - Gitea = "" - XMPP = "" - Matrix = "" - Bilibili = "" - Email = "xxxx@xxxx.com" - RSS = true + identifier = "categories" + pre = "" + post = "" + name = "Categories" + url = "/categories/" + title = "" [params] - # LoveIt theme version - # LoveIt 主题版本 - version = "0.2.X" - # site default theme ("light", "dark", "auto") - # 网站默认主题 ("light", "dark", "auto") + # site default theme ["auto", "light", "dark"] + # 网站默认主题 ["auto", "light", "dark"] defaultTheme = "auto" # public git repo url only then enableGitInfo is true # 公共 git 仓库路径,仅在 enableGitInfo 设为 true 时有效 gitRepo = "https://github.com/dillonzq/LoveIt" - # which hash function used for SRI, when empty, no SRI is used ("sha256", "sha384", "sha512", "md5") - # 哪种哈希函数用来 SRI, 为空时表示不使用 SRI ("sha256", "sha384", "sha512", "md5") + # which hash function used for SRI, when empty, no SRI is used + # ["sha256", "sha384", "sha512", "md5"] + # 哪种哈希函数用来 SRI, 为空时表示不使用 SRI + # ["sha256", "sha384", "sha512", "md5"] fingerprint = "" # date format # 日期格式 dateFormat = "2006-01-02" + # website title for Open Graph and Twitter Cards + # 网站标题, 用于 Open Graph 和 Twitter Cards + title = "LoveIt" + # website description for RSS, SEO, Open Graph and Twitter Cards + # 网站描述, 用于 RSS, SEO, Open Graph 和 Twitter Cards + description = "Hugo theme - LoveIt" # website images for Open Graph and Twitter Cards # 网站图片, 用于 Open Graph 和 Twitter Cards images = ["/logo.png"] @@ -643,11 +113,11 @@ enableEmoji = true # Header config # 页面头部导航栏配置 [params.header] - # desktop header mode ("fixed", "normal", "auto") - # 桌面端导航栏模式 ("fixed", "normal", "auto") + # desktop header mode ["fixed", "normal", "auto"] + # 桌面端导航栏模式 ["fixed", "normal", "auto"] desktopMode = "fixed" - # mobile header mode ("fixed", "normal", "auto") - # 移动端导航栏模式 ("fixed", "normal", "auto") + # mobile header mode ["fixed", "normal", "auto"] + # 移动端导航栏模式 ["fixed", "normal", "auto"] mobileMode = "auto" # Header title config # 页面头部导航栏标题配置 @@ -660,7 +130,7 @@ enableEmoji = true name = "LoveIt" # you can add extra information before the name (HTML format is supported), such as icons # 你可以在名称 (允许 HTML 格式) 之前添加其他信息, 例如图标 - pre = "<i class='far fa-kiss-wink-heart fa-fw'></i>" + pre = "<i class='far fa-kiss-wink-heart fa-fw' aria-hidden='true'></i>" # you can add extra information after the name (HTML format is supported), such as icons # 你可以在名称 (允许 HTML 格式) 之后添加其他信息, 例如图标 post = "" @@ -674,7 +144,7 @@ enableEmoji = true enable = true # Custom content (HTML format is supported) # 自定义内容 (支持 HTML 格式) - custom = '' + custom = "" # whether to show Hugo and theme info # 是否显示 Hugo 和主题信息 hugo = true @@ -720,8 +190,168 @@ enableEmoji = true # RSS 文章数目 rss = 10 - # Page config - # 文章页面配置 + # App icon config + # 应用图标配置 + [params.app] + # optional site title override for the app when added to an iOS home screen or Android launcher + # 当添加到 iOS 主屏幕或者 Android 启动器时的标题, 覆盖默认标题 + title = "LoveIt" + # whether to omit favicon resource links + # 是否隐藏网站图标资源链接 + noFavicon = false + # modern SVG favicon to use in place of older style .png and .ico files + # 更现代的 SVG 网站图标, 可替代旧的 .png 和 .ico 文件 + svgFavicon = "" + # Android browser theme color + # Android 浏览器主题色 + themeColor = "#ffffff" + # Safari mask icon color + # Safari 图标颜色 + iconColor = "#5bbad5" + # Windows v8-11 tile color + # Windows v8-11 磁贴颜色 + tileColor = "#da532c" + + # Search config + # 搜索配置 + [params.search] + enable = true + # type of search engine ["lunr", "algolia"] + # 搜索引擎的类型 ["lunr", "algolia"] + type = "algolia" + # max index length of the chunked content + # 文章内容最长索引长度 + contentLength = 4000 + # placeholder of the search bar + # 搜索框的占位提示语 + placeholder = "" + # max number of results length + # 最大结果数目 + maxResultLength = 10 + # snippet length of the result + # 结果内容片段长度 + snippetLength = 30 + # HTML tag name of the highlight part in results + # 搜索结果中高亮部分的 HTML 标签 + highlightTag = "em" + # whether to use the absolute URL based on the baseURL in search index + # 是否在搜索索引中使用基于 baseURL 的绝对路径 + absoluteURL = false + [params.search.algolia] + index = "" + appID = "" + searchKey = "" + + # Home page config + # 主页信息设置 + [params.home] + # amount of RSS pages + # RSS 文章数目 + rss = 10 + # Home page profile + # 主页个人信息 + [params.home.profile] + enable = true + # Gravatar Email for preferred avatar in home page + # Gravatar 邮箱,用于优先在主页显示的头像 + gravatarEmail = "" + # URL of avatar shown in home page + # 主页显示头像的 URL + avatarURL = "/images/avatar.png" + # title shown in home page (HTML format is supported) + # 主页显示的网站标题 (支持 HTML 格式) + title = "" + # subtitle shown in home page (HTML format is supported) + # 主页显示的网站副标题 (允许 HTML 格式) + subtitle = "A Clean, Elegant but Advanced Hugo Theme" + # whether to use typeit animation for subtitle + # 是否为副标题显示打字机动画 + typeit = true + # whether to show social links + # 是否显示社交账号 + social = true + # disclaimer (HTML format is supported) + # 免责声明 (支持 HTML 格式) + disclaimer = "" + # Home page posts + # 主页文章列表 + [params.home.posts] + enable = true + # special amount of posts in each home posts page + # 主页每页显示文章数量 + paginate = 6 + # Social config in home page + # 主页的社交信息设置 + [params.social] + GitHub = "" + Linkedin = "" + Twitter = "" + Instagram = "" + Facebook = "" + Telegram = "" + Medium = "" + Gitlab = "" + Youtubelegacy = "" + Youtubecustom = "" + Youtubechannel = "" + Tumblr = "" + Quora = "" + Keybase = "" + Pinterest = "" + Reddit = "" + Codepen = "" + FreeCodeCamp = "" + Bitbucket = "" + Stackoverflow = "" + Weibo = "" + Odnoklassniki = "" + VK = "" + Flickr = "" + Xing = "" + Snapchat = "" + Soundcloud = "" + Spotify = "" + Bandcamp = "" + Paypal = "" + Fivehundredpx = "" + Mix = "" + Goodreads = "" + Lastfm = "" + Foursquare = "" + Hackernews = "" + Kickstarter = "" + Patreon = "" + Steam = "" + Twitch = "" + Strava = "" + Skype = "" + Whatsapp = "" + Zhihu = "" + Douban = "" + Angellist = "" + Slidershare = "" + Jsfiddle = "" + Deviantart = "" + Behance = "" + Dribbble = "" + Wordpress = "" + Vine = "" + Googlescholar = "" + Researchgate = "" + Mastodon = "" + Thingiverse = "" + Devto = "" + Gitea = "" + XMPP = "" + Matrix = "" + Bilibili = "" + Discord = "" + DiscordInvite = "" + Email = "" + RSS = "" + + # Page global config + # 文章页面全局配置 [params.page] # whether to hide a page from home page # 是否在主页隐藏一篇文章 @@ -770,19 +400,19 @@ enableEmoji = true copy = true # the maximum number of lines of displayed code by default # 默认展开显示的代码行数 - maxShownLines = 10 + maxShownLines = 50 # KaTeX mathematical formulas config (KaTeX https://katex.org/) # KaTeX 数学公式配置 (KaTeX https://katex.org/) [params.page.math] enable = false - # default block delimiter is $$ ... $$ and \\[ ... \\] - # 默认块定界符是 $$ ... $$ 和 \\[ ... \\] - blockLeftDelimiter = "" - blockRightDelimiter = "" - # default inline delimiter is $ ... $ and \\( ... \\) - # 默认行内定界符是 $ ... $ 和 \\( ... \\) + # default inline delimiter is $ ... $ and \( ... \) + # 默认行内定界符是 $ ... $ 和 \( ... \) inlineLeftDelimiter = "" inlineRightDelimiter = "" + # default block delimiter is $$ ... $$, \[ ... \], \begin{equation} ... \end{equation} and some other functions + # 默认块定界符是 $$ ... $$, \[ ... \], \begin{equation} ... \end{equation} 和一些其它的函数 + blockLeftDelimiter = "" + blockRightDelimiter = "" # KaTeX extension copy_tex # KaTeX 插件 copy_tex copyTex = true @@ -831,12 +461,8 @@ enableEmoji = true Line = true Instapaper = false Pocket = false - Digg = false - Stumbleupon = false Flipboard = false Weibo = true - Renren = false - Myspace = false Blogger = false Baidu = false Odnoklassniki = false @@ -880,15 +506,15 @@ enableEmoji = true enableQQ = false serverURLs = "https://leancloud.hugoloveit.com" # emoji data file name, default is "google.yml" - # ("apple.yml", "google.yml", "facebook.yml", "twitter.yml") - # located in "themes/LoveIt/assets/data/emoji/" directory + # ["apple.yml", "google.yml", "facebook.yml", "twitter.yml"] + # located in "themes/LoveIt/assets/lib/valine/emoji/" directory # you can store your own data files in the same path under your project: - # "assets/data/emoji/" + # "assets/lib/valine/emoji/" # emoji 数据文件名称, 默认是 "google.yml" - # ("apple.yml", "google.yml", "facebook.yml", "twitter.yml") - # 位于 "themes/LoveIt/assets/data/emoji/" 目录 + # ["apple.yml", "google.yml", "facebook.yml", "twitter.yml"] + # 位于 "themes/LoveIt/assets/lib/valine/emoji/" 目录 # 可以在你的项目下相同路径存放你自己的数据文件: - # "assets/data/emoji/" + # "assets/lib/valine/emoji/" emoji = "" # Facebook comment config (https://developers.facebook.com/docs/plugins/comments) # Facebook 评论系统设置 (https://developers.facebook.com/docs/plugins/comments) @@ -999,6 +625,9 @@ enableEmoji = true # server url for your tracker if you're self hosting # 自行托管追踪器时的主机路径 server = "" + # Plausible Analytics + [params.analytics.plausible] + dataDomain = "" # Cookie consent config # Cookie 许可配置 @@ -1015,12 +644,12 @@ enableEmoji = true # 第三方库文件的 CDN 设置 [params.cdn] # CDN data file name, disabled by default - # ("jsdelivr.yml") + # ["jsdelivr.yml"] # located in "themes/LoveIt/assets/data/cdn/" directory # you can store your own data files in the same path under your project: # "assets/data/cdn/" # CDN 数据文件名称, 默认不启用 - # ("jsdelivr.yml") + # ["jsdelivr.yml"] # 位于 "themes/LoveIt/assets/data/cdn/" 目录 # 可以在你的项目下相同路径存放你自己的数据文件: # "assets/data/cdn/" @@ -1070,13 +699,6 @@ enableEmoji = true startLevel = 2 endLevel = 6 -# Author config -# 作者配置 -[author] - name = "xxxx" - email = "" - link = "" - # Sitemap config # 网站地图配置 [sitemap] @@ -1123,3 +745,189 @@ enableEmoji = true section = ["HTML", "RSS"] taxonomy = ["HTML", "RSS"] taxonomyTerm = ["HTML"] + +# Multilingual +# 多语言 +[languages] + [languages.en] + weight = 1 + languageCode = "en" + languageName = "English" + hasCJKLanguage = false + copyright = "This work is licensed under a Creative Commons Attribution-NonCommercial 4.0 International License." + [languages.en.menu] + [[languages.en.menu.main]] + weight = 1 + identifier = "posts" + pre = "" + post = "" + name = "Posts" + url = "/posts/" + title = "" + [[languages.en.menu.main]] + weight = 2 + identifier = "tags" + pre = "" + post = "" + name = "Tags" + url = "/tags/" + title = "" + [[languages.en.menu.main]] + weight = 3 + identifier = "categories" + pre = "" + post = "" + name = "Categories" + url = "/categories/" + title = "" + [[languages.en.menu.main]] + weight = 4 + identifier = "documentation" + pre = "" + post = "" + name = "Docs" + url = "/categories/documentation/" + title = "" + [[languages.en.menu.main]] + weight = 5 + identifier = "about" + pre = "" + post = "" + name = "About" + url = "/about/" + title = "" + [[languages.en.menu.main]] + weight = 6 + identifier = "github" + pre = "<i class='fab fa-github fa-fw' aria-hidden='true'></i>" + post = "" + name = "" + url = "https://github.com/dillonzq/LoveIt" + title = "GitHub" + [languages.en.params] + [languages.en.params.search] + enable = true + type = "algolia" + contentLength = 4000 + placeholder = "" + maxResultLength = 10 + snippetLength = 30 + highlightTag = "em" + absoluteURL = false + [languages.en.params.search.algolia] + index = "index.en" + appID = "PASDMWALPK" + searchKey = "b42948e51daaa93df92381c8e2ac0f93" + [languages.en.params.home] + rss = 10 + [languages.en.params.home.profile] + enable = true + gravatarEmail = "" + avatarURL = "/images/avatar.png" + title = "" + subtitle = "A Clean, Elegant but Advanced Hugo Theme" + typeit = true + social = true + disclaimer = "" + [languages.en.params.social] + GitHub = "xxxx" + Twitter = "xxxx" + Instagram = "xxxx" + Facebook = "xxxx" + Telegram = "xxxx" + Youtubelegacy = "xxxx" + Email = "xxxx@xxxx.com" + RSS = true + [languages.en.params.social.Mastodon] + id = "@xxxx" + prefix = "https://mastodon.technology/" + + [languages.zh-cn] + weight = 2 + languageCode = "zh-CN" + languageName = "简体中文" + hasCJKLanguage = true + copyright = "This work is licensed under a Creative Commons Attribution-NonCommercial 4.0 International License." + [languages.zh-cn.menu] + [[languages.zh-cn.menu.main]] + weight = 1 + identifier = "posts" + pre = "" + post = "" + name = "所有文章" + url = "/posts/" + title = "" + [[languages.zh-cn.menu.main]] + weight = 2 + identifier = "tags" + pre = "" + post = "" + name = "标签" + url = "/tags/" + title = "" + [[languages.zh-cn.menu.main]] + weight = 3 + identifier = "categories" + pre = "" + post = "" + name = "分类" + url = "/categories/" + title = "" + [[languages.zh-cn.menu.main]] + weight = 4 + identifier = "documentation" + pre = "" + name = "文档" + url = "/categories/documentation/" + title = "" + [[languages.zh-cn.menu.main]] + weight = 5 + identifier = "about" + pre = "" + post = "" + name = "关于" + url = "/about/" + title = "" + [[languages.zh-cn.menu.main]] + weight = 6 + identifier = "github" + pre = "<i class='fab fa-github fa-fw' aria-hidden='true'></i>" + post = "" + name = "" + url = "https://github.com/dillonzq/LoveIt" + title = "GitHub" + [languages.zh-cn.params] + [languages.zh-cn.params.search] + enable = true + type = "algolia" + contentLength = 4000 + placeholder = "" + maxResultLength = 10 + snippetLength = 50 + highlightTag = "em" + absoluteURL = false + [languages.zh-cn.params.search.algolia] + index = "index.zh-cn" + appID = "PASDMWALPK" + searchKey = "b42948e51daaa93df92381c8e2ac0f93" + [languages.zh-cn.params.home] + rss = 10 + [languages.zh-cn.params.home.profile] + enable = true + gravatarEmail = "" + avatarURL = "/images/avatar.png" + title = "" + subtitle = "一个简洁、优雅且高效的 Hugo 主题" + typeit = true + social = true + disclaimer = "" + [languages.zh-cn.params.social] + GitHub = "xxxx" + Weibo = "xxxx" + Steam = "xxxx" + Zhihu = "xxxx" + Douban = "xxxx" + Devto = "xxxx" + Bilibili = "xxxx" + Email = "xxxx@xxxx.com" + RSS = true diff --git a/exampleSite/content/posts/theme-documentation-basics/index.en.md b/exampleSite/content/posts/theme-documentation-basics/index.en.md index 5a0cd13f..6f541843 100644 --- a/exampleSite/content/posts/theme-documentation-basics/index.en.md +++ b/exampleSite/content/posts/theme-documentation-basics/index.en.md @@ -7,6 +7,7 @@ draft: false author: "Dillon" authorLink: "https://dillonzq.com" description: "Discover what the Hugo - LoveIt theme is all about and the core-concepts behind it." +images: [] resources: - name: "featured-image" src: "featured-image.jpg" @@ -76,21 +77,28 @@ The following is a basic configuration for the LoveIt theme: ```toml baseURL = "http://example.org/" -# [en, zh-cn, fr, ...] determines default content language -defaultContentLanguage = "en" -# language code -languageCode = "en" -title = "My New Hugo Site" # Change the default theme to be use when building the site with Hugo theme = "LoveIt" -[params] - # LoveIt theme version - version = "0.2.X" +# website title +title = "My New Hugo Site" + +# language code ["en", "zh-CN", "fr", "pl", ...] +languageCode = "en" +# language name ["English", "简体中文", "Français", "Polski", ...] +languageName = "English" +# Author config +[author] + name = "xxxx" + email = "" + link = "" + +# Menu config [menu] [[menu.main]] + weight = 1 identifier = "posts" # you can add extra information before the name (HTML format is supported), such as icons pre = "" @@ -100,23 +108,22 @@ theme = "LoveIt" url = "/posts/" # title will be shown when you hover on this menu link title = "" - weight = 1 [[menu.main]] + weight = 2 identifier = "tags" pre = "" post = "" name = "Tags" url = "/tags/" title = "" - weight = 2 [[menu.main]] + weight = 3 identifier = "categories" pre = "" post = "" name = "Categories" url = "/categories/" title = "" - weight = 3 # Markup related configuration in Hugo [markup] @@ -194,66 +201,27 @@ Please open the code block below to view the complete sample configuration :(far ```toml [params] - # {{< version 0.2.0 changed >}} LoveIt theme version - version = "0.2.X" - # site description - description = "This is My New Hugo Site" - # site keywords - keywords = ["Theme", "Hugo"] - # site default theme ("light", "dark", "auto") + # site default theme ["auto", "light", "dark"] defaultTheme = "auto" # public git repo url only then enableGitInfo is true gitRepo = "" # {{< version 0.1.1 >}} which hash function used for SRI, when empty, no SRI is used - # ("sha256", "sha384", "sha512", "md5") + # ["sha256", "sha384", "sha512", "md5"] fingerprint = "" # {{< version 0.2.0 >}} date format dateFormat = "2006-01-02" + # website title for Open Graph and Twitter Cards + title = "My cool site" + # website description for RSS, SEO, Open Graph and Twitter Cards + description = "This is my cool site" # website images for Open Graph and Twitter Cards images = ["/logo.png"] - # {{< version 0.2.0 >}} App icon config - [params.app] - # optional site title override for the app when added to an iOS home screen or Android launcher - title = "LoveIt" - # whether to omit favicon resource links - noFavicon = false - # modern SVG favicon to use in place of older style .png and .ico files - svgFavicon = "" - # Android browser theme color - themeColor = "#ffffff" - # Safari mask icon color - iconColor = "#5bbad5" - # Windows v8-10 tile color - tileColor = "#da532c" - - # {{< version 0.2.0 >}} Search config - [params.search] - enable = true - # type of search engine ("lunr", "algolia") - type = "lunr" - # max index length of the chunked content - contentLength = 4000 - # placeholder of the search bar - placeholder = "" - # {{< version 0.2.1 >}} max number of results length - maxResultLength = 10 - # {{< version 0.2.3 >}} snippet length of the result - snippetLength = 30 - # {{< version 0.2.1 >}} HTML tag name of the highlight part in results - highlightTag = "em" - # {{< version 0.2.4 >}} whether to use the absolute URL based on the baseURL in search index - absoluteURL = false - [params.search.algolia] - index = "" - appID = "" - searchKey = "" - # Header config [params.header] - # desktop header mode ("fixed", "normal", "auto") + # desktop header mode ["fixed", "normal", "auto"] desktopMode = "fixed" - # mobile header mode ("fixed", "normal", "auto") + # mobile header mode ["fixed", "normal", "auto"] mobileMode = "auto" # {{< version 0.2.0 >}} Header title config [params.header.title] @@ -304,6 +272,43 @@ Please open the code block below to view the complete sample configuration :(far # amount of RSS pages rss = 10 + # {{< version 0.2.0 >}} App icon config + [params.app] + # optional site title override for the app when added to an iOS home screen or Android launcher + title = "My cool site" + # whether to omit favicon resource links + noFavicon = false + # modern SVG favicon to use in place of older style .png and .ico files + svgFavicon = "" + # Android browser theme color + themeColor = "#ffffff" + # Safari mask icon color + iconColor = "#5bbad5" + # Windows v8-10 tile color + tileColor = "#da532c" + + # {{< version 0.2.0 >}} Search config + [params.search] + enable = true + # type of search engine ["lunr", "algolia"] + type = "lunr" + # max index length of the chunked content + contentLength = 4000 + # placeholder of the search bar + placeholder = "" + # {{< version 0.2.1 >}} max number of results length + maxResultLength = 10 + # {{< version 0.2.3 >}} snippet length of the result + snippetLength = 30 + # {{< version 0.2.1 >}} HTML tag name of the highlight part in results + highlightTag = "em" + # {{< version 0.2.4 >}} whether to use the absolute URL based on the baseURL in search index + absoluteURL = false + [params.search.algolia] + index = "" + appID = "" + searchKey = "" + # Home page config [params.home] # {{< version 0.2.0 >}} amount of RSS pages @@ -317,7 +322,7 @@ Please open the code block below to view the complete sample configuration :(far avatarURL = "/images/avatar.png" # {{< version 0.2.7 changed >}} title shown in home page (HTML format is supported) title = "" - # subtitle shown in home page + # subtitle shown in home page (HTML format is supported) subtitle = "This is My New Hugo Site" # whether to use typeit animation for subtitle typeit = true @@ -398,10 +403,12 @@ Please open the code block below to view the complete sample configuration :(far XMPP = "" Matrix = "" Bilibili = "" + Discord = "" + DiscordInvite = "" Email = "xxxx@xxxx.com" RSS = true # {{< version 0.2.0 >}} - # {{< version 0.2.0 changed >}} Page config + # {{< version 0.2.0 changed >}} Page global config [params.page] # {{< version 0.2.0 >}} whether to hide a page from home page hiddenFromHomePage = false @@ -432,12 +439,12 @@ Please open the code block below to view the complete sample configuration :(far # {{< version 0.2.0 changed >}} {{< link "https://katex.org/" KaTeX >}} mathematical formulas [params.page.math] enable = true - # default block delimiter is $$ ... $$ and \\[ ... \\] - blockLeftDelimiter = "" - blockRightDelimiter = "" - # default inline delimiter is $ ... $ and \\( ... \\) + # {{< version 0.2.11 changed >}} default inline delimiter is $ ... $ and \( ... \) inlineLeftDelimiter = "" inlineRightDelimiter = "" + # {{< version 0.2.11 changed >}} default block delimiter is $$ ... $$, \[ ... \], \begin{equation} ... \end{equation} and some other functions + blockLeftDelimiter = "" + blockRightDelimiter = "" # KaTeX extension copy_tex copyTex = true # KaTeX extension mhchem @@ -447,15 +454,15 @@ Please open the code block below to view the complete sample configuration :(far # whether to show the copy button of the code block copy = true # the maximum number of lines of displayed code by default - maxShownLines = 10 + maxShownLines = 50 # {{< version 0.2.0 >}} {{< link "https://docs.mapbox.com/mapbox-gl-js" "Mapbox GL JS" >}} config [params.page.mapbox] # access token of Mapbox GL JS accessToken = "" # style for the light theme - lightStyle = "mapbox://styles/mapbox/light-v9" + lightStyle = "mapbox://styles/mapbox/light-v10?optimize=true" # style for the dark theme - darkStyle = "mapbox://styles/mapbox/dark-v9" + darkStyle = "mapbox://styles/mapbox/dark-v10?optimize=true" # whether to add {{< link "https://docs.mapbox.com/mapbox-gl-js/api#navigationcontrol" NavigationControl >}} navigation = true # whether to add {{< link "https://docs.mapbox.com/mapbox-gl-js/api#geolocatecontrol" GeolocateControl >}} @@ -470,10 +477,10 @@ Please open the code block below to view the complete sample configuration :(far Twitter = true Facebook = true Linkedin = false - Whatsapp = true + Whatsapp = false Pinterest = false Tumblr = false - HackerNews = false + HackerNews = true Reddit = false VK = false Buffer = false @@ -481,22 +488,18 @@ Please open the code block below to view the complete sample configuration :(far Line = true Instapaper = false Pocket = false - Digg = false - Stumbleupon = false Flipboard = false Weibo = true - Renren = false - Myspace = true - Blogger = true + Blogger = false Baidu = false Odnoklassniki = false - Evernote = true + Evernote = false Skype = false Trello = false Mix = false # {{< version 0.2.0 changed >}} Comment config [params.page.comment] - enable = true + enable = false # {{< link "https://disqus.com/" Disqus >}} comment config [params.page.comment.disqus] # {{< version 0.1.1 >}} @@ -527,10 +530,10 @@ Please open the code block below to view the complete sample configuration :(far enableQQ = false serverURLs = "" # {{< version 0.2.6 >}} emoji data file name, default is "google.yml" - # ("apple.yml", "google.yml", "facebook.yml", "twitter.yml") - # located in "themes/LoveIt/assets/data/emoji/" directory + # ["apple.yml", "google.yml", "facebook.yml", "twitter.yml"] + # located in "themes/LoveIt/assets/lib/valine/emoji/" directory # you can store your own data files in the same path under your project: - # "assets/data/emoji/" + # "assets/lib/valine/emoji/" emoji = "" # {{< link "https://developers.facebook.com/docs/plugins/comments" "Facebook comment" >}} config [params.page.comment.facebook] @@ -621,6 +624,9 @@ Please open the code block below to view the complete sample configuration :(far id = "" # server url for your tracker if you're self hosting server = "" + # Plausible Analytics + [params.analytics.plausible] + dataDomain = "" # {{< version 0.2.7 >}} Cookie consent config [params.cookieconsent] @@ -634,7 +640,7 @@ Please open the code block below to view the complete sample configuration :(far # {{< version 0.2.7 changed >}} CDN config for third-party library files [params.cdn] # CDN data file name, disabled by default - # ("jsdelivr.yml") + # ["jsdelivr.yml"] # located in "themes/LoveIt/assets/data/cdn/" directory # you can store your own data files in the same path under your project: # "assets/data/cdn/" @@ -676,12 +682,6 @@ Please open the code block below to view the complete sample configuration :(far startLevel = 2 endLevel = 6 -# Author config -[author] - name = "xxxx" - email = "" - link = "" - # Sitemap config [sitemap] changefreq = "weekly" @@ -743,7 +743,7 @@ You could enable these features with `hugo serve -e production`. ```toml [params.cdn] # CDN data file name, disabled by default - # ("jsdelivr.yml") + # ["jsdelivr.yml"] data = "" ```` @@ -836,6 +836,7 @@ In `assets/css/_custom.scss`, you can add some css style code to customize the s |:-------------------- |:---------:|:---------------------:|:-----------------------------:|:-----------------------------:| | English | `en` | `en` | :(far fa-check-square fa-fw): | :(far fa-check-square fa-fw): | | Simplified Chinese | `zh-cn` | `zh-CN` | :(far fa-check-square fa-fw): | :(far fa-check-square fa-fw): | +| Traditional Chinese | `zh-tw` | `zh-TW` | :(far fa-square fa-fw): | :(far fa-check-square fa-fw): | | French | `fr` | `fr` | :(far fa-square fa-fw): | :(far fa-check-square fa-fw): | | Polish | `pl` | `pl` | :(far fa-square fa-fw): | :(far fa-square fa-fw): | | Brazilian Portuguese | `pt-br` | `pt-BR` | :(far fa-square fa-fw): | :(far fa-check-square fa-fw): | @@ -847,6 +848,11 @@ In `assets/css/_custom.scss`, you can add some css style code to customize the s | Russian | `ru` | `ru` | :(far fa-square fa-fw): | :(far fa-check-square fa-fw): | | Romanian | `ro` | `ro` | :(far fa-square fa-fw): | :(far fa-check-square fa-fw): | | Vietnamese | `vi` | `vi` | :(far fa-square fa-fw): | :(far fa-check-square fa-fw): | +| Arabic | `ar` | `ar` | :(far fa-square fa-fw): | :(far fa-check-square fa-fw): | +| Catalan | `ca` | `ca` | :(far fa-square fa-fw): | :(far fa-square fa-fw): | +| Thai | `th` | `th` | :(far fa-square fa-fw): | :(far fa-check-square fa-fw): | +| Telugu | `te` | `te` | :(far fa-square fa-fw): | :(far fa-square fa-fw): | +| Indonesian | `id` | `id` | :(far fa-square fa-fw): | :(far fa-square fa-fw): | ### 4.2 Basic Configuration @@ -855,7 +861,7 @@ After learning [how Hugo handle multilingual websites](https://gohugo.io/content For example with English, Chinese and French website: ```toml -# [en, zh-cn, fr, pl, ...] determines default content language +# determines default content language ["en", "zh-cn", "fr", "pl", ...] defaultContentLanguage = "en" [languages] @@ -865,62 +871,60 @@ defaultContentLanguage = "en" languageCode = "en" languageName = "English" [[languages.en.menu.main]] + weight = 1 identifier = "posts" pre = "" post = "" name = "Posts" url = "/posts/" title = "" - weight = 1 [[languages.en.menu.main]] + weight = 2 identifier = "tags" pre = "" post = "" name = "Tags" url = "/tags/" title = "" - weight = 2 [[languages.en.menu.main]] + weight = 3 identifier = "categories" pre = "" post = "" name = "Categories" url = "/categories/" title = "" - weight = 3 [languages.zh-cn] weight = 2 title = "我的全新 Hugo 网站" - # language code, CN only here languageCode = "zh-CN" languageName = "简体中文" - # whether to include Chinese/Japanese/Korean hasCJKLanguage = true [[languages.zh-cn.menu.main]] + weight = 1 identifier = "posts" pre = "" post = "" name = "文章" url = "/posts/" title = "" - weight = 1 [[languages.zh-cn.menu.main]] + weight = 2 identifier = "tags" pre = "" post = "" name = "标签" url = "/tags/" title = "" - weight = 2 [[languages.zh-cn.menu.main]] + weight = 3 identifier = "categories" pre = "" post = "" name = "分类" url = "/categories/" title = "" - weight = 3 [languages.fr] weight = 3 @@ -928,29 +932,29 @@ defaultContentLanguage = "en" languageCode = "fr" languageName = "Français" [[languages.fr.menu.main]] + weight = 1 identifier = "posts" pre = "" post = "" name = "Postes" url = "/posts/" title = "" - weight = 1 [[languages.fr.menu.main]] + weight = 2 identifier = "tags" pre = "" post = "" name = "Balises" url = "/tags/" title = "" - weight = 2 [[languages.fr.menu.main]] + weight = 3 identifier = "categories" name = "Catégories" pre = "" post = "" url = "/categories/" title = "" - weight = 3 ``` Then, for each new page, append the language code to the file name. @@ -1001,7 +1005,7 @@ Here is the search configuration in your [site configuration](#site-configuratio ```toml [params.search] enable = true - # type of search engine ("lunr", "algolia") + # type of search engine ["lunr", "algolia"] type = "lunr" # max index length of the chunked content contentLength = 4000 @@ -1035,7 +1039,7 @@ The following is a comparison of two search engines: {{< admonition tip "Tips about algolia" >}} You need to upload `index.json` files to algolia to activate searching. You could upload the `index.json` files by browsers but a CLI tool may be better. -[Algolia Atomic](https://github.com/chrisdmacrae/atomic-algolia) is a good choice. +The official [Algolia CLI](https://github.com/algolia/algolia-cli) is a good choice. To be compatible with Hugo multilingual mode, you need to upload different `index.json` for each language to the different index of algolia, such as `zh-cn/index.json` or `fr/index.json`... {{< /admonition >}} diff --git a/exampleSite/content/posts/theme-documentation-basics/index.zh-cn.md b/exampleSite/content/posts/theme-documentation-basics/index.zh-cn.md index 884e367d..f08e6e2f 100644 --- a/exampleSite/content/posts/theme-documentation-basics/index.zh-cn.md +++ b/exampleSite/content/posts/theme-documentation-basics/index.zh-cn.md @@ -7,6 +7,7 @@ draft: false author: "Dillon" authorLink: "https://dillonzq.com" description: "探索 Hugo - LoveIt 主题的全部内容和背后的核心概念." +images: [] resources: - name: "featured-image" src: "featured-image.jpg" @@ -76,24 +77,30 @@ git submodule add https://github.com/dillonzq/LoveIt.git themes/LoveIt ```toml baseURL = "http://example.org/" -# [en, zh-cn, fr, ...] 设置默认的语言 -defaultContentLanguage = "zh-cn" -# 网站语言, 仅在这里 CN 大写 -languageCode = "zh-CN" -# 是否包括中日韩文字 -hasCJKLanguage = true -# 网站标题 -title = "我的全新 Hugo 网站" # 更改使用 Hugo 构建网站时使用的默认主题 theme = "LoveIt" -[params] - # LoveIt 主题版本 - version = "0.2.X" +# 网站标题 +title = "我的全新 Hugo 网站" + +# 网站语言, 仅在这里 CN 大写 ["en", "zh-CN", "fr", "pl", ...] +languageCode = "zh-CN" +# 语言名称 ["English", "简体中文", "Français", "Polski", ...] +languageName = "简体中文" +# 是否包括中日韩文字 +hasCJKLanguage = true + +# 作者配置 +[author] + name = "xxxx" + email = "" + link = "" +# 菜单配置 [menu] [[menu.main]] + weight = 1 identifier = "posts" # 你可以在名称 (允许 HTML 格式) 之前添加其他信息, 例如图标 pre = "" @@ -103,23 +110,22 @@ theme = "LoveIt" url = "/posts/" # 当你将鼠标悬停在此菜单链接上时, 将显示的标题 title = "" - weight = 1 [[menu.main]] + weight = 2 identifier = "tags" pre = "" post = "" name = "标签" url = "/tags/" title = "" - weight = 2 [[menu.main]] + weight = 3 identifier = "categories" pre = "" post = "" name = "分类" url = "/categories/" title = "" - weight = 3 # Hugo 解析文档的配置 [markup] @@ -197,66 +203,27 @@ hugo ```toml [params] - # {{< version 0.2.0 changed >}} LoveIt 主题版本 - version = "0.2.X" - # 网站描述 - description = "这是我的全新 Hugo 网站" - # 网站关键词 - keywords = ["Theme", "Hugo"] - # 网站默认主题样式 ("light", "dark", "auto") + # 网站默认主题样式 ["auto", "light", "dark"] defaultTheme = "auto" # 公共 git 仓库路径,仅在 enableGitInfo 设为 true 时有效 gitRepo = "" # {{< version 0.1.1 >}} 哪种哈希函数用来 SRI, 为空时表示不使用 SRI - # ("sha256", "sha384", "sha512", "md5") + # ["sha256", "sha384", "sha512", "md5"] fingerprint = "" # {{< version 0.2.0 >}} 日期格式 dateFormat = "2006-01-02" + # 网站标题, 用于 Open Graph 和 Twitter Cards + title = "我的网站" + # 网站描述, 用于 RSS, SEO, Open Graph 和 Twitter Cards + description = "这是我的全新 Hugo 网站" # 网站图片, 用于 Open Graph 和 Twitter Cards images = ["/logo.png"] - # {{< version 0.2.0 >}} 应用图标配置 - [params.app] - # 当添加到 iOS 主屏幕或者 Android 启动器时的标题, 覆盖默认标题 - title = "LoveIt" - # 是否隐藏网站图标资源链接 - noFavicon = false - # 更现代的 SVG 网站图标, 可替代旧的 .png 和 .ico 文件 - svgFavicon = "" - # Android 浏览器主题色 - themeColor = "#ffffff" - # Safari 图标颜色 - iconColor = "#5bbad5" - # Windows v8-10磁贴颜色 - tileColor = "#da532c" - - # {{< version 0.2.0 >}} 搜索配置 - [params.search] - enable = true - # 搜索引擎的类型 ("lunr", "algolia") - type = "lunr" - # 文章内容最长索引长度 - contentLength = 4000 - # 搜索框的占位提示语 - placeholder = "" - # {{< version 0.2.1 >}} 最大结果数目 - maxResultLength = 10 - # {{< version 0.2.3 >}} 结果内容片段长度 - snippetLength = 50 - # {{< version 0.2.1 >}} 搜索结果中高亮部分的 HTML 标签 - highlightTag = "em" - # {{< version 0.2.4 >}} 是否在搜索索引中使用基于 baseURL 的绝对路径 - absoluteURL = false - [params.search.algolia] - index = "" - appID = "" - searchKey = "" - # 页面头部导航栏配置 [params.header] - # 桌面端导航栏模式 ("fixed", "normal", "auto") + # 桌面端导航栏模式 ["fixed", "normal", "auto"] desktopMode = "fixed" - # 移动端导航栏模式 ("fixed", "normal", "auto") + # 移动端导航栏模式 ["fixed", "normal", "auto"] mobileMode = "auto" # {{< version 0.2.0 >}} 页面头部导航栏标题配置 [params.header.title] @@ -307,6 +274,43 @@ hugo # RSS 文章数目 rss = 10 + # {{< version 0.2.0 >}} 应用图标配置 + [params.app] + # 当添加到 iOS 主屏幕或者 Android 启动器时的标题, 覆盖默认标题 + title = "我的网站" + # 是否隐藏网站图标资源链接 + noFavicon = false + # 更现代的 SVG 网站图标, 可替代旧的 .png 和 .ico 文件 + svgFavicon = "" + # Android 浏览器主题色 + themeColor = "#ffffff" + # Safari 图标颜色 + iconColor = "#5bbad5" + # Windows v8-10磁贴颜色 + tileColor = "#da532c" + + # {{< version 0.2.0 >}} 搜索配置 + [params.search] + enable = true + # 搜索引擎的类型 ["lunr", "algolia"] + type = "lunr" + # 文章内容最长索引长度 + contentLength = 4000 + # 搜索框的占位提示语 + placeholder = "" + # {{< version 0.2.1 >}} 最大结果数目 + maxResultLength = 10 + # {{< version 0.2.3 >}} 结果内容片段长度 + snippetLength = 50 + # {{< version 0.2.1 >}} 搜索结果中高亮部分的 HTML 标签 + highlightTag = "em" + # {{< version 0.2.4 >}} 是否在搜索索引中使用基于 baseURL 的绝对路径 + absoluteURL = false + [params.search.algolia] + index = "" + appID = "" + searchKey = "" + # 主页配置 [params.home] # {{< version 0.2.0 >}} RSS 文章数目 @@ -320,7 +324,7 @@ hugo avatarURL = "/images/avatar.png" # {{< version 0.2.7 changed >}} 主页显示的网站标题 (支持 HTML 格式) title = "" - # 主页显示的网站副标题 + # 主页显示的网站副标题 (允许 HTML 格式) subtitle = "这是我的全新 Hugo 网站" # 是否为副标题显示打字机动画 typeit = true @@ -401,10 +405,12 @@ hugo XMPP = "" Matrix = "" Bilibili = "" + Discord = "" + DiscordInvite = "" Email = "xxxx@xxxx.com" RSS = true # {{< version 0.2.0 >}} - # {{< version 0.2.0 changed >}} 文章页面配置 + # {{< version 0.2.0 changed >}} 文章页面全局配置 [params.page] # {{< version 0.2.0 >}} 是否在主页隐藏一篇文章 hiddenFromHomePage = false @@ -437,16 +443,16 @@ hugo # 是否显示代码块的复制按钮 copy = true # 默认展开显示的代码行数 - maxShownLines = 10 + maxShownLines = 50 # {{< version 0.2.0 changed >}} {{< link "https://katex.org/" KaTeX >}} 数学公式 [params.page.math] enable = true - # 默认块定界符是 $$ ... $$ 和 \\[ ... \\] - blockLeftDelimiter = "" - blockRightDelimiter = "" - # 默认行内定界符是 $ ... $ 和 \\( ... \\) + # {{< version 0.2.11 changed >}} 默认行内定界符是 $ ... $ 和 \( ... \) inlineLeftDelimiter = "" inlineRightDelimiter = "" + # {{< version 0.2.11 changed >}} 默认块定界符是 $$ ... $$, \[ ... \], \begin{equation} ... \end{equation} 和一些其它的函数 + blockLeftDelimiter = "" + blockRightDelimiter = "" # KaTeX 插件 copy_tex copyTex = true # KaTeX 插件 mhchem @@ -456,9 +462,9 @@ hugo # Mapbox GL JS 的 access token accessToken = "" # 浅色主题的地图样式 - lightStyle = "mapbox://styles/mapbox/light-v9" + lightStyle = "mapbox://styles/mapbox/light-v10?optimize=true" # 深色主题的地图样式 - darkStyle = "mapbox://styles/mapbox/dark-v9" + darkStyle = "mapbox://styles/mapbox/dark-v10?optimize=true" # 是否添加 {{< link "https://docs.mapbox.com/mapbox-gl-js/api#navigationcontrol" NavigationControl >}} navigation = true # 是否添加 {{< link "https://docs.mapbox.com/mapbox-gl-js/api#geolocatecontrol" GeolocateControl >}} @@ -473,10 +479,10 @@ hugo Twitter = true Facebook = true Linkedin = false - Whatsapp = true + Whatsapp = false Pinterest = false Tumblr = false - HackerNews = false + HackerNews = true Reddit = false VK = false Buffer = false @@ -484,22 +490,18 @@ hugo Line = true Instapaper = false Pocket = false - Digg = false - Stumbleupon = false Flipboard = false Weibo = true - Renren = false - Myspace = true - Blogger = true + Blogger = false Baidu = false Odnoklassniki = false - Evernote = true + Evernote = false Skype = false Trello = false Mix = false # {{< version 0.2.0 changed >}} 评论系统设置 [params.page.comment] - enable = true + enable = false # {{< link "https://disqus.com/" Disqus >}} 评论系统设置 [params.page.comment.disqus] # {{< version 0.1.1 >}} @@ -530,10 +532,10 @@ hugo enableQQ = false serverURLs = "" # {{< version 0.2.6 >}} emoji 数据文件名称, 默认是 "google.yml" - # ("apple.yml", "google.yml", "facebook.yml", "twitter.yml") - # 位于 "themes/LoveIt/assets/data/emoji/" 目录 + # ["apple.yml", "google.yml", "facebook.yml", "twitter.yml"] + # 位于 "themes/LoveIt/assets/lib/valine/emoji/" 目录 # 可以在你的项目下相同路径存放你自己的数据文件: - # "assets/data/emoji/" + # "assets/lib/valine/emoji/" emoji = "" # {{< link "https://developers.facebook.com/docs/plugins/comments" "Facebook 评论系统" >}}设置 [params.page.comment.facebook] @@ -624,6 +626,9 @@ hugo id = "" # 自行托管追踪器时的主机路径 server = "" + # Plausible Analytics + [params.analytics.plausible] + dataDomain = "" # {{< version 0.2.7 >}} Cookie 许可配置 [params.cookieconsent] @@ -637,7 +642,7 @@ hugo # {{< version 0.2.7 changed >}} 第三方库文件的 CDN 设置 [params.cdn] # CDN 数据文件名称, 默认不启用 - # ("jsdelivr.yml") + # ["jsdelivr.yml"] # 位于 "themes/LoveIt/assets/data/cdn/" 目录 # 可以在你的项目下相同路径存放你自己的数据文件: # "assets/data/cdn/" @@ -679,12 +684,6 @@ hugo startLevel = 2 endLevel = 6 -# 作者配置 -[author] - name = "xxxx" - email = "" - link = "" - # 网站地图配置 [sitemap] changefreq = "weekly" @@ -747,7 +746,7 @@ hugo ```toml [params.cdn] # CDN 数据文件名称, 默认不启用 - # ("jsdelivr.yml") + # ["jsdelivr.yml"] data = "" ```` @@ -840,6 +839,7 @@ $code-font-family: Fira Mono, Source Code Pro, Menlo, Consolas, Monaco, monospac |:---- |:----:|:----:|:----:|:----:| | 英语 | `en` | `en` | :(far fa-check-square fa-fw): | :(far fa-check-square fa-fw): | | 简体中文 | `zh-cn` | `zh-CN` | :(far fa-check-square fa-fw): | :(far fa-check-square fa-fw): | +| 繁體中文 | `zh-tw` | `zh-TW` | :(far fa-square fa-fw): | :(far fa-check-square fa-fw): | | 法语 | `fr` | `fr` | :(far fa-square fa-fw): | :(far fa-check-square fa-fw): | | 波兰语 | `pl` | `pl` | :(far fa-square fa-fw): | :(far fa-square fa-fw): | | 巴西葡萄牙语 | `pt-br` | `pt-BR` | :(far fa-square fa-fw): | :(far fa-check-square fa-fw): | @@ -850,6 +850,11 @@ $code-font-family: Fira Mono, Source Code Pro, Menlo, Consolas, Monaco, monospac | 俄语 | `ru` | `ru` | :(far fa-square fa-fw): | :(far fa-check-square fa-fw): | | 罗马尼亚语 | `ro` | `ro` | :(far fa-square fa-fw): | :(far fa-check-square fa-fw): | | 越南语 | `vi` | `vi` | :(far fa-square fa-fw): | :(far fa-check-square fa-fw): | +| 阿拉伯语 | `ar` | `ar` | :(far fa-square fa-fw): | :(far fa-check-square fa-fw): | +| 加泰罗尼亚语 | `ca` | `ca` | :(far fa-square fa-fw): | :(far fa-square fa-fw): | +| 泰语 | `th` | `th` | :(far fa-square fa-fw): | :(far fa-check-square fa-fw): | +| 泰卢固语 | `te` | `te` | :(far fa-square fa-fw): | :(far fa-square fa-fw): | +| 印尼语 | `id` | `id` | :(far fa-square fa-fw): | :(far fa-square fa-fw): | ### 4.2 基本配置 @@ -858,7 +863,7 @@ $code-font-family: Fira Mono, Source Code Pro, Menlo, Consolas, Monaco, monospac 例如, 一个支持英语, 中文和法语的网站配置: ```toml -# [en, zh-cn, fr, pl, ...] 设置默认的语言 +# 设置默认的语言 ["en", "zh-cn", "fr", "pl", ...] defaultContentLanguage = "zh-cn" [languages] @@ -868,62 +873,60 @@ defaultContentLanguage = "zh-cn" languageCode = "en" languageName = "English" [[languages.en.menu.main]] + weight = 1 identifier = "posts" pre = "" post = "" name = "Posts" url = "/posts/" title = "" - weight = 1 [[languages.en.menu.main]] + weight = 2 identifier = "tags" pre = "" post = "" name = "Tags" url = "/tags/" title = "" - weight = 2 [[languages.en.menu.main]] + weight = 3 identifier = "categories" pre = "" post = "" name = "Categories" url = "/categories/" title = "" - weight = 3 [languages.zh-cn] weight = 2 title = "我的全新 Hugo 网站" - # 网站语言, 仅在这里 CN 大写 languageCode = "zh-CN" languageName = "简体中文" - # 是否包括中日韩文字 hasCJKLanguage = true [[languages.zh-cn.menu.main]] + weight = 1 identifier = "posts" pre = "" post = "" name = "文章" url = "/posts/" title = "" - weight = 1 [[languages.zh-cn.menu.main]] + weight = 2 identifier = "tags" pre = "" post = "" name = "标签" url = "/tags/" title = "" - weight = 2 [[languages.zh-cn.menu.main]] + weight = 3 identifier = "categories" pre = "" post = "" name = "分类" url = "/categories/" title = "" - weight = 3 [languages.fr] weight = 3 @@ -931,29 +934,29 @@ defaultContentLanguage = "zh-cn" languageCode = "fr" languageName = "Français" [[languages.fr.menu.main]] + weight = 1 identifier = "posts" pre = "" post = "" name = "Postes" url = "/posts/" title = "" - weight = 1 [[languages.fr.menu.main]] + weight = 2 identifier = "tags" pre = "" post = "" name = "Balises" url = "/tags/" title = "" - weight = 2 [[languages.fr.menu.main]] + weight = 3 identifier = "categories" pre = "" post = "" name = "Catégories" url = "/categories/" title = "" - weight = 3 ``` 然后, 对于每个新页面, 将语言代码附加到文件名中. @@ -1005,7 +1008,7 @@ defaultContentLanguage = "zh-cn" ```toml [params.search] enable = true - # 搜索引擎的类型 ("lunr", "algolia") + # 搜索引擎的类型 ["lunr", "algolia"] type = "lunr" # 文章内容最长索引长度 contentLength = 4000 @@ -1037,6 +1040,6 @@ defaultContentLanguage = "zh-cn" {{< admonition tip "关于 algolia 的使用技巧" >}} 你需要上传 `index.json` 到 algolia 来激活搜索功能. 你可以使用浏览器来上传 `index.json` 文件但是一个自动化的脚本可能效果更好. -[Algolia Atomic](https://github.com/chrisdmacrae/atomic-algolia) 是一个不错的选择. +官方提供的 [Algolia CLI](https://github.com/algolia/algolia-cli) 是一个不错的选择. 为了兼容 Hugo 的多语言模式, 你需要上传不同语言的 `index.json` 文件到对应的 algolia index, 例如 `zh-cn/index.json` 或 `fr/index.json`... {{< /admonition >}} |