From 42f87544cdc636b4070b663dd052740a39d000da Mon Sep 17 00:00:00 2001
From: Cell <1024@lruihao.cn>
Date: Sat, 23 Jul 2022 17:31:47 +0800
Subject: [PATCH] :heavy_plus_sign: Feat: add theme core configuration settings
file
---
CHANGELOG.md | 1 +
config.toml | 694 ++++++++++++++++++
.../theme-documentation-basics/index.en.md | 32 +-
.../theme-documentation-basics/index.zh-cn.md | 20 +-
4 files changed, 721 insertions(+), 26 deletions(-)
create mode 100644 config.toml
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 70bfc647..5b890059 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -26,6 +26,7 @@ All notable changes to this project will be documented in this file.
- :art: Style: add theme colors variables and add common color styles
- :art: Style: add scroll bar for auto toc ([#136](https://github.com/Lruihao/FixIt/issues/136))
- :memo: Docs: revise theme documentations
+- :heavy_plus_sign: Feat: add theme core configuration settings file
- :wrench: Feat(cdn): add unpkg cdn support
- :wrench: Chore: change the theme minimum supported Hugo versions above **0.84.0**
- :arrow_up: Chore(libs): update some third-party libraries
diff --git a/config.toml b/config.toml
new file mode 100644
index 00000000..dd66bb4d
--- /dev/null
+++ b/config.toml
@@ -0,0 +1,694 @@
+# =====================================================================================
+# It's recommended to use Alternate Theme Config to configure FixIt
+# Modifying this file may result in merge conflict
+# See: https://fixit.lruihao.cn/theme-documentation-basics/#site-configuration
+# =====================================================================================
+
+# -------------------------------------------------------------------------------------
+# Menu Settings
+# See: https://fixit.lruihao.cn/theme-documentation-basics/#menu-advanced-configuration
+# -------------------------------------------------------------------------------------
+
+[menu]
+ [[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
+ [[menu.main]]
+ identifier = "categories"
+ pre = ""
+ post = ""
+ name = "Categories"
+ url = "/categories/"
+ title = ""
+ weight = 2
+ [[menu.main]]
+ identifier = "tags"
+ pre = ""
+ post = ""
+ name = "Tags"
+ url = "/tags/"
+ title = ""
+ weight = 3
+
+# -------------------------------------------------------------------------------------
+# Theme Core Configuration Settings
+# -------------------------------------------------------------------------------------
+
+[params]
+ # FixIt 0.2.15 | CHANGED FixIt theme version
+ version = "0.2.X" # e.g. "0.2.X", "0.2.15", "v0.2.15" etc.
+ # site description
+ description = "This is My New Hugo Site"
+ # site keywords
+ keywords = ["Theme", "Hugo"]
+ # site default theme ("light", "dark", "auto")
+ defaultTheme = "auto"
+ # public git repo url only then enableGitInfo is true
+ gitRepo = ""
+ # FixIt 0.1.1 | NEW which hash function used for SRI, when empty, no SRI is used
+ # ("sha256", "sha384", "sha512", "md5")
+ fingerprint = ""
+ # FixIt 0.2.0 | NEW date format
+ dateFormat = "2006-01-02"
+ # website images for Open Graph and Twitter Cards
+ images = ["/logo.png"]
+ # FixIt 0.2.12 | NEW enable PWA
+ enablePWA = true
+ # FixIt 0.2.14 | NEW whether to add external Icon for external links automatically
+ externalIcon = false
+ # FixIt 0.2.14 | NEW FixIt will, by default, inject a theme meta tag in the HTML head on the home page only.
+ # You can turn it off, but we would really appreciate if you don’t, as this is a good way to watch FixIt's popularity on the rise.
+ disableThemeInject = false
+
+ # FixIt 0.2.0 | NEW App icon config
+ [params.app]
+ # optional site title override for the app when added to an iOS home screen or Android launcher
+ title = "FixIt"
+ # whether to omit favicon resource links
+ noFavicon = false
+ # modern SVG favicon to use in place of older style .png and .ico files
+ svgFavicon = ""
+ # Safari mask icon color
+ iconColor = "#5bbad5"
+ # Windows v8-10 tile color
+ tileColor = "#da532c"
+ # FixIt 0.2.12 | CHANGED Android browser theme color
+ [params.app.themeColor]
+ light = "#ffffff"
+ dark = "#252627"
+
+ # FixIt 0.2.0 | NEW 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 = ""
+ # FixIt 0.2.1 | NEW max number of results length
+ maxResultLength = 10
+ # FixIt 0.2.3 | NEW snippet length of the result
+ snippetLength = 30
+ # FixIt 0.2.1 | NEW HTML tag name of the highlight part in results
+ highlightTag = "em"
+ # FixIt 0.2.4 | NEW 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]
+ # FixIt 0.2.13 | CHANGED desktop header mode ("sticky", "normal", "auto")
+ desktopMode = "sticky"
+ # FixIt 0.2.13 | CHANGED mobile header mode ("sticky", "normal", "auto")
+ mobileMode = "auto"
+ # FixIt 0.2.0 | NEW Header title config
+ [params.header.title]
+ # URL of the LOGO
+ logo = "/images/fixit.svg"
+ # title name
+ name = "My New Hugo Site"
+ # 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 = ""
+ # FixIt 0.2.5 | NEW whether to use typeit animation for title name
+ typeit = false
+ # FixIt 0.2.12 | NEW Header subtitle config
+ [params.header.subtitle]
+ # subtitle name
+ name = ""
+ # whether to use typeit animation for subtitle name
+ typeit = false
+
+ # Footer config
+ [params.footer]
+ enable = true
+ # FixIt 0.2.0 | NEW Custom content (HTML format is supported)
+ custom = ''
+ # FixIt 0.2.0 | NEW whether to show Hugo and theme info
+ hugo = true
+ # FixIt 0.2.0 | NEW whether to show copyright info
+ copyright = true
+ # FixIt 0.2.0 | NEW whether to show the author
+ author = true
+ # Site creation year
+ since = 2019
+ # FixIt 0.2.14 | NEW Site creation time
+ siteTime = '' # e.g. '2019-02-03T19:30:34+08:00'
+ # FixIt 0.2.14 | NEW whether to show total word count of site content
+ wordCount = true
+ # FixIt 0.2.12 | NEW Public network security only in China (HTML format is supported)
+ gov = ""
+ # ICP info only in China (HTML format is supported)
+ icp = ""
+ # license info (HTML format is supported)
+ license = 'CC BY-NC 4.0'
+
+ # FixIt 0.2.0 | NEW Section (all posts) page config
+ [params.section]
+ # special amount of posts in each section page
+ paginate = 20
+ # date format (month and day)
+ dateFormat = "01-02"
+ # amount of RSS pages
+ rss = 10
+ # FixIt 0.2.13 | NEW recently updated posts settings
+ [params.section.recentlyUpdated]
+ enable = false
+ rss = false
+ days = 30
+ maxCount = 10
+
+ # FixIt 0.2.0 | NEW List (category or tag) page config
+ [params.list]
+ # special amount of posts in each list page
+ paginate = 20
+ # date format (month and day)
+ dateFormat = "01-02"
+ # amount of RSS pages
+ rss = 10
+
+ # Home page config
+ [params.home]
+ # FixIt 0.2.0 | NEW amount of RSS pages
+ rss = 10
+ # Home page profile
+ [params.home.profile]
+ enable = true
+ # FixIt 0.2.13 | NEW Gravatar mirror site domain, default: "www.gravatar.com"
+ # FixIt 0.2.14 | CHANGED FixIt 0.2.15 | DELETED The parameter `home.profile.gravatarSite` is deprecated since v0.2.14, use `gravatar.host` instead
+ # gravatarSite = ""
+ # Gravatar Email for preferred avatar in home page
+ gravatarEmail = ""
+ # URL of avatar shown in home page
+ avatarURL = ""
+ # FixIt 0.2.7 | CHANGED title shown in home page (HTML format is supported)
+ title = ""
+ # subtitle shown in home page
+ subtitle = "This is My New Hugo Site"
+ # whether to use typeit animation for subtitle
+ typeit = true
+ # whether to show social links
+ social = true
+ # FixIt 0.2.0 | NEW disclaimer (HTML format is supported)
+ disclaimer = ""
+ # Home page posts
+ [params.home.posts]
+ enable = true
+ # special amount of posts in each home posts page
+ paginate = 6
+
+ # Social config about the author
+ [params.social]
+ GitHub = "Lruihao"
+ 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 = ""
+ # ORCID, ... , CSDN FixIt 0.2.13 | NEW
+ ORCID = ""
+ Liberapay = ""
+ Ko-Fi = ""
+ BuyMeaCoffee = ""
+ Linktree = ""
+ QQ = ""
+ QQGroup = "" # https://qun.qq.com/join.html
+ Diaspora = ""
+ CSDN = ""
+ Email = ""
+ RSS = true # FixIt 0.2.0 | NEW
+
+ # FixIt 0.2.0 | CHANGED Page config
+ [params.page]
+ # FixIt 0.2.0 | NEW whether to hide a page from home page
+ hiddenFromHomePage = false
+ # FixIt 0.2.0 | NEW whether to hide a page from search results
+ hiddenFromSearch = false
+ # FixIt 0.2.0 | NEW whether to enable twemoji
+ twemoji = false
+ # whether to enable lightgallery
+ lightgallery = false
+ # FixIt 0.2.0 | NEW whether to enable the ruby extended syntax
+ ruby = true
+ # FixIt 0.2.0 | NEW whether to enable the fraction extended syntax
+ fraction = true
+ # FixIt 0.2.0 | NEW whether to enable the fontawesome extended syntax
+ fontawesome = true
+ # license info (HTML format is supported)
+ license = 'CC BY-NC 4.0'
+ # whether to show link to Raw Markdown content of the content
+ linkToMarkdown = true
+ # FixIt 0.2.4 | NEW whether to show the full text content in RSS
+ rssFullText = false
+ # FixIt 0.2.13 | NEW Page style ("narrow", "normal", "wide", ...)
+ pageStyle = "normal"
+ # FixIt 0.2.14 | NEW Gravatar is force-used as the author's avatar
+ gravatarForce = false
+ # FixIt 0.2.15 | NEW Repost config
+ [params.page.repost]
+ enable = false
+ url = ""
+ # FixIt 0.2.0 | NEW Table of the contents config
+ [params.page.toc]
+ # whether to enable the table of the contents
+ enable = true
+ # FixIt 0.2.9 | NEW 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
+ # FixIt 0.2.13 | NEW position of TOC ("left", "right")
+ position = "right"
+ # FixIt 0.2.13 | NEW Display a message at the beginning of an article to warn the reader that its content might be expired
+ [params.page.expirationReminder]
+ enable = false
+ # Display the reminder if the last modified time is more than 90 days ago
+ reminder = 90
+ # Display warning if the last modified time is more than 180 days ago
+ warning = 180
+ # If the article expires, close the comment or not
+ closeComment = false
+ # FixIt 0.2.0 | CHANGED KaTeX mathematical formulas (https://katex.org)
+ [params.page.math]
+ enable = true
+ # default block delimiter is $$ ... $$ and \\[ ... \\]
+ blockLeftDelimiter = ""
+ blockRightDelimiter = ""
+ # default inline delimiter is $ ... $ and \\( ... \\)
+ inlineLeftDelimiter = ""
+ inlineRightDelimiter = ""
+ # KaTeX extension copy_tex
+ copyTex = true
+ # KaTeX extension mhchem
+ mhchem = true
+ # FixIt 0.2.0 | NEW Code config
+ [params.page.code]
+ # whether to show the copy button of the code block
+ copy = true
+ # FixIt 0.2.13 | NEW whether to show the edit button of the code block
+ edit = true
+ # the maximum number of lines of displayed code by default
+ maxShownLines = 10
+ # FixIt 0.2.14 | NEW Post edit
+ [params.page.edit]
+ enable = false
+ # url = "https://github.com/user-name/repo-name/edit/branch-name/subdirectory-name" # Link for fork & edit
+ url = "" # Link for fork & edit
+ # FixIt 0.2.0 | NEW Mapbox GL JS config (https://docs.mapbox.com/mapbox-gl-js)
+ [params.page.mapbox]
+ # access token of Mapbox GL JS
+ accessToken = ""
+ # style for the light theme
+ lightStyle = "mapbox://styles/mapbox/light-v9"
+ # style for the dark theme
+ darkStyle = "mapbox://styles/mapbox/dark-v9"
+ # whether to add NavigationControl
+ navigation = true
+ # whether to add GeolocateControl
+ geolocate = true
+ # whether to add ScaleControl
+ scale = true
+ # whether to add FullscreenControl
+ fullscreen = true
+ # FixIt 0.2.0 | CHANGED social share links in post page
+ [params.page.share]
+ enable = true
+ Twitter = true
+ Facebook = true
+ Linkedin = false
+ Whatsapp = true
+ Pinterest = false
+ Tumblr = false
+ HackerNews = false
+ Reddit = false
+ VK = false
+ Buffer = false
+ Xing = false
+ Line = true
+ Instapaper = false
+ Pocket = false
+ Digg = false
+ Stumbleupon = false
+ Flipboard = false
+ Weibo = true
+ Renren = false
+ Myspace = true
+ Blogger = true
+ Baidu = false
+ Odnoklassniki = false
+ Evernote = true
+ Skype = false
+ Trello = false
+ Mix = false
+ # FixIt 0.2.15 | CHANGED Comment config
+ [params.page.comment]
+ enable = false
+ # FixIt 0.2.13 | NEW Artalk comment config (https://artalk.js.org/)
+ [params.page.comment.artalk]
+ enable = false
+ server = "https://yourdomain/api/"
+ site = "默认站点"
+ placeholder = ""
+ noComment = ""
+ sendBtn = ""
+ editorTravel = true
+ flatMode = 'auto'
+ maxNesting = 3
+ # It take effect when `params.page.lightgallery` is enabled
+ lightgallery = false
+ locale = "" # FixIt 0.2.15 | NEW
+ # FixIt 0.1.1 | NEW Disqus comment config (https://disqus.com)
+ [params.page.comment.disqus]
+ enable = false
+ # Disqus shortname to use Disqus in posts
+ shortname = ""
+ # FixIt 0.1.1 | NEW Gitalk comment config (https://github.com/gitalk/gitalk)
+ [params.page.comment.gitalk]
+ enable = false
+ owner = ""
+ repo = ""
+ clientId = ""
+ clientSecret = ""
+ # Valine comment config (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 = ""
+ # FixIt 0.2.6 | NEW emoji data file name, default is "google.yml"
+ # ("apple.yml", "google.yml", "facebook.yml", "twitter.yml")
+ # located in "themes/FixIt/assets/data/emoji/" directory
+ # you can store your own data files in the same path under your project:
+ # "assets/data/emoji/"
+ emoji = ""
+ commentCount = true # FixIt 0.2.13 | NEW
+ # FixIt 0.2.13 | NEW Waline comment config (https://waline.js.org)
+ [params.page.comment.waline]
+ enable = false
+ serverURL = ""
+ pageview = false # FixIt 0.2.15 | NEW
+ emoji = ['//unpkg.com/@waline/emojis@1.0.1/weibo']
+ meta = ['nick', 'mail', 'link']
+ requiredMeta = []
+ login = 'enable'
+ wordLimit = 0
+ pageSize = 10
+ imageUploader = false # FixIt 0.2.15 | NEW
+ highlighter = false # FixIt 0.2.15 | NEW
+ comment = false # FixIt 0.2.15 | NEW
+ # visitor = false # FixIt 0.2.15 | DELETED renamed to pageview
+ # uploadImage = false # FixIt 0.2.15 | DELETED renamed to imageUploader
+ # highlight = true # FixIt 0.2.15 | DELETED renamed to highlighter
+ # mathTagSupport = false FixIt 0.2.15 | DELETED
+ # commentCount = false FixIt 0.2.15 | DELETED renamed to comment
+ # Facebook comment config (https://developers.facebook.com/docs/plugins/comments)
+ [params.page.comment.facebook]
+ enable = false
+ width = "100%"
+ numPosts = 10
+ appId = ""
+ languageCode = ""
+ # FixIt 0.2.0 | NEW Telegram comments config (https://comments.app)
+ [params.page.comment.telegram]
+ enable = false
+ siteID = ""
+ limit = 5
+ height = ""
+ color = ""
+ colorful = true
+ dislikes = false
+ outlined = false
+ # FixIt 0.2.0 | NEW Commento comment config (https://commento.io)
+ [params.page.comment.commento]
+ enable = false
+ # FixIt 0.2.5 | NEW Utterances comment config (https://utteranc.es)
+ [params.page.comment.utterances]
+ enable = false
+ # owner/repo
+ repo = ""
+ issueTerm = "pathname"
+ label = ""
+ lightTheme = "github-light"
+ darkTheme = "github-dark"
+ # FixIt 0.2.13 | NEW Twikoo comment config (https://twikoo.js.org/)
+ [params.page.comment.twikoo]
+ enable = false
+ envId = ""
+ region = ""
+ path = ""
+ visitor = true
+ commentCount = true
+ # It take effect when `params.page.lightgallery` is enabled
+ lightgallery = false
+ # FixIt 0.2.14 | NEW Giscus comments config
+ [params.page.comment.giscus]
+ enable = false
+ repo = ""
+ repoId = ""
+ category = ""
+ categoryId = ""
+ mapping = ""
+ reactionsEnabled = "1"
+ emitMetadata = "0"
+ inputPosition = "bottom" # top, bottom
+ lightTheme = "light"
+ darkTheme = "dark"
+ lazyLoad = true
+ # FixIt 0.2.7 | NEW Third-party library config
+ [params.page.library]
+ [params.page.library.css]
+ # someCSS = "some.css"
+ # located in "assets/"
+ # Or
+ # someCSS = "https://cdn.example.com/some.css"
+ [params.page.library.js]
+ # someJavascript = "some.js"
+ # located in "assets/"
+ # Or
+ # someJavascript = "https://cdn.example.com/some.js"
+ # FixIt 0.2.10 | CHANGED Page SEO config
+ [params.page.seo]
+ # image URL
+ images = []
+ # Publisher info
+ [params.page.seo.publisher]
+ name = ""
+ logoUrl = ""
+
+ # FixIt 0.2.5 | NEW TypeIt config
+ [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)
+ cursorChar = "|"
+ # cursor duration after typing finishing (measured in milliseconds, "-1" means unlimited)
+ duration = -1
+
+ # FixIt 0.2.15 | NEW Mermaid config
+ [params.mermaid]
+ # For values, see https://mermaid-js.github.io/mermaid/#/Setup?id=theme
+ themes = ['neutral', 'dark']
+
+ # FixIt 0.2.12 | NEW PanguJS config
+ [params.pangu]
+ # For Chinese writing
+ enable = false
+
+ # FixIt 0.2.12 | NEW Watermark config
+ # Detail config see https://github.com/Lruihao/watermark#readme
+ [params.watermark]
+ enable = false
+ # watermark's text (HTML format is supported)
+ content = ''
+ # watermark's transparency
+ opacity = 0.1
+ # parent of watermark's container
+ appendTo = '.wrapper>main'
+ # watermark's width. unit: px
+ width = 150
+ # watermark's height. unit: px
+ height = 20
+ # row spacing of watermarks. unit: px
+ rowSpacing = 60
+ # col spacing of watermarks. unit: px
+ colSpacing = 30
+ # watermark's tangent angle. unit: deg
+ rotate = 15
+ # watermark's fontSize. unit: rem
+ fontSize = 0.85
+ # FixIt 0.2.13 | NEW watermark's fontFamily
+ fontFamily = 'inherit'
+
+ # FixIt 0.2.12 | NEW Busuanzi count
+ [params.ibruce]
+ enable = false
+ # Enable in post meta
+ enablePost = false
+ # FixIt 0.2.14 | CHANGED FixIt 0.2.15 | DELETED Site creation time
+ # The parameter `ibruce.siteTime` is deprecated since v0.2.14, use `footer.siteTime` instead
+ # siteTime = '' # e.g. '2019-02-03T19:30:34+08:00'
+
+ # Site verification code config for Google/Bing/Yandex/Pinterest/Baidu/360/Sogou
+ [params.verification]
+ google = ""
+ bing = ""
+ yandex = ""
+ pinterest = ""
+ baidu = ""
+ so = ""
+ sogou = ""
+
+ # FixIt 0.2.10 | NEW Site SEO config
+ [params.seo]
+ # image URL
+ image = ""
+ # thumbnail URL
+ thumbnailUrl = ""
+
+ # FixIt 0.2.0 | NEW Analytics config
+ [params.analytics]
+ enable = false
+ # Google Analytics
+ [params.analytics.google]
+ id = ""
+ # whether to anonymize IP
+ anonymizeIP = true
+ # Fathom Analytics
+ [params.analytics.fathom]
+ id = ""
+ # server url for your tracker if you're self hosting
+ server = ""
+
+ # FixIt 0.2.7 | NEW Cookie consent config
+ [params.cookieconsent]
+ enable = true
+ # text strings used for Cookie consent banner
+ [params.cookieconsent.content]
+ message = ""
+ dismiss = ""
+ link = ""
+
+ # FixIt 0.2.7 | CHANGED CDN config for third-party library files
+ [params.cdn]
+ # CDN data file name, disabled by default
+ # ("jsdelivr.yml", "unpkg.yml")
+ # located in "themes/FixIt/assets/data/cdn/" directory
+ # you can store your own data files in the same path under your project:
+ # "assets/data/cdn/"
+ # data = "unpkg"
+
+ # FixIt 0.2.8 | NEW Compatibility config
+ [params.compatibility]
+ # whether to use Polyfill.io to be compatible with older browsers
+ polyfill = false
+ # whether to use object-fit-images to be compatible with older browsers
+ objectFit = false
+
+ # FixIt 0.2.12 | NEW Custom JS at last
+ # "_custom.js" located in "themes/FixIt/assets/js/"
+ # you can store your custom JS file in the same path under your project:
+ # "assets/js/_custom.js"
+ [params.customJS]
+ enable = true
+ # FixIt 0.2.14 | NEW GitHub banner in the top-right or top-left corner
+ [params.githubCorner]
+ enable = false
+ permalink = "https://github.com/Lruihao/FixIt"
+ title = "View source on GitHub"
+ position = "right" # left, right
+ # FixIt 0.2.14 | NEW Gravatar config
+ [params.gravatar]
+ # Gravatar host, default: "www.gravatar.com"
+ host = "www.gravatar.com" # "cn.gravatar.com", "gravatar.loli.net"
+ style = "" # "", mp, identicon, monsterid, wavatar, retro, blank, robohash
+ # FixIt 0.2.15 | NEW Developer options
+ [params.dev]
+ enable = false
+ # Check for updates
+ c4u = false
+ # Please do not expose to public!
+ githubToken = ""
+ # Mobile Devtools confi
+ [params.dev.mDevtools]
+ enable = false
+ # "vConsole", "eruda" supported
+ type = "vConsole"
diff --git a/exampleSite/content/posts/theme-documentation-basics/index.en.md b/exampleSite/content/posts/theme-documentation-basics/index.en.md
index 08eef4de..095780be 100644
--- a/exampleSite/content/posts/theme-documentation-basics/index.en.md
+++ b/exampleSite/content/posts/theme-documentation-basics/index.en.md
@@ -107,14 +107,6 @@ theme = "FixIt"
# title will be shown when you hover on this menu link
title = ""
weight = 1
- [[menu.main]]
- identifier = "tags"
- pre = ""
- post = ""
- name = "Tags"
- url = "/tags/"
- title = ""
- weight = 2
[[menu.main]]
identifier = "categories"
pre = ""
@@ -122,6 +114,14 @@ theme = "FixIt"
name = "Categories"
url = "/categories/"
title = ""
+ weight = 2
+ [[menu.main]]
+ identifier = "tags"
+ pre = ""
+ post = ""
+ name = "Tags"
+ url = "/tags/"
+ title = ""
weight = 3
# Markup related configuration in Hugo
@@ -203,7 +203,7 @@ Please open the code block below to view the complete sample configuration :(fa-
```toml
[params]
# {{< version 0.2.15 changed >}} FixIt theme version
- version = "0.2.X" # e.g. "0.2.X", "0.2.15", "v0.2.15"
+ version = "0.2.X" # e.g. "0.2.X", "0.2.15", "v0.2.15" etc.
# site description
description = "This is My New Hugo Site"
# site keywords
@@ -275,7 +275,7 @@ Please open the code block below to view the complete sample configuration :(fa-
# {{< version 0.2.0 >}} Header title config
[params.header.title]
# URL of the LOGO
- logo = ""
+ logo = "/images/fixit.svg"
# title name
name = ""
# you can add extra information before the name (HTML format is supported), such as icons
@@ -371,12 +371,12 @@ Please open the code block below to view the complete sample configuration :(fa-
# Social config about the author
[params.social]
- GitHub = "xxxx"
+ GitHub = "Lruihao"
Linkedin = ""
- Twitter = "xxxx"
- Instagram = "xxxx"
- Facebook = "xxxx"
- Telegram = "xxxx"
+ Twitter = ""
+ Instagram = ""
+ Facebook = ""
+ Telegram = ""
Medium = ""
Gitlab = ""
Youtubelegacy = ""
@@ -443,7 +443,7 @@ Please open the code block below to view the complete sample configuration :(fa-
QQGroup = "" # https://qun.qq.com/join.html
Diaspora = ""
CSDN = ""
- Email = "xxxx@xxxx.com"
+ Email = ""
RSS = true # {{< version 0.2.0 >}}
# {{< version 0.2.0 changed >}} Page config
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 30c8a476..dd87bba7 100644
--- a/exampleSite/content/posts/theme-documentation-basics/index.zh-cn.md
+++ b/exampleSite/content/posts/theme-documentation-basics/index.zh-cn.md
@@ -198,14 +198,14 @@ hugo
### 3.1 网站配置 {#site-configuration}
-除了 [Hugo 全局配置](https://gohugo.io/overview/configuration/) 和 [菜单配置](#basic-configuration) 之外,**FixIt** 主题还允许您在网站配置中定义以下参数(这是一个示例 `config.toml`, 其内容为默认值).
+除了 [Hugo 全局配置](https://gohugo.io/overview/configuration/) 和 [菜单配置](#basic-configuration) 之外,**FixIt** 主题还允许您在网站配置中定义以下参数(这是一个示例 `config.toml`, 其内容为默认值)。
请打开下面的代码块查看完整的示例配置 :(fa-regular fa-hand-point-down fa-fw)::
```toml
[params]
# {{< version 0.2.15 changed >}} FixIt 主题版本
- version = "0.2.X" # e.g. "0.2.X", "0.2.15", "v0.2.15"
+ version = "0.2.X" # 例如:"0.2.X", "0.2.15", "v0.2.15" 等
# 网站描述
description = "这是我的全新 Hugo 网站"
# 网站关键词
@@ -277,7 +277,7 @@ hugo
# {{< version 0.2.0 >}} 页面头部导航栏标题配置
[params.header.title]
# LOGO 的 URL
- logo = ""
+ logo = "/images/fixit.svg"
# 标题名称
name = ""
# 你可以在名称(允许 HTML 格式)之前添加其他信息,例如图标
@@ -373,12 +373,12 @@ hugo
# 作者的社交信息设置
[params.social]
- GitHub = "xxxx"
+ GitHub = "Lruihao"
Linkedin = ""
- Twitter = "xxxx"
- Instagram = "xxxx"
- Facebook = "xxxx"
- Telegram = "xxxx"
+ Twitter = ""
+ Instagram = ""
+ Facebook = ""
+ Telegram = ""
Medium = ""
Gitlab = ""
Youtubelegacy = ""
@@ -442,10 +442,10 @@ hugo
BuyMeaCoffee = ""
Linktree = ""
QQ = ""
- QQGroup = "" # https://qun.qq.com/join.html
+ QQGroup = "awbwdTtSQ_-H5QGzeJxdWgv6JMbNehNM" # https://qun.qq.com/join.html
Diaspora = ""
CSDN = ""
- Email = "xxxx@xxxx.com"
+ Email = ""
RSS = true # {{< version 0.2.0 >}}
# {{< version 0.2.0 changed >}} 文章页面配置