Welcome to mirror list, hosted at ThFree Co, Russian Federation.

github.com/dillonzq/LoveIt.git - Unnamed repository; edit this file 'description' to name the repository.
summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorDillon <dillonzq@outlook.com>2022-05-21 18:32:17 +0300
committerDillon <dillonzq@outlook.com>2022-05-21 18:32:17 +0300
commit7543423430f9eaee28d4e705adbcf6a223f43315 (patch)
tree23be6a97d2584c5ff158b42fccecb5e3c54c1926
parent45df8d42576098a285c2e494296bdb3c372f701f (diff)
feat: subtile config and docs
-rw-r--r--config.toml584
-rw-r--r--exampleSite/config.toml1082
-rw-r--r--exampleSite/content/posts/theme-documentation-basics/index.en.md206
-rw-r--r--exampleSite/content/posts/theme-documentation-basics/index.zh-cn.md211
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 >}}