From e23f596e06262cf027e75a97db637ea47d4ff67b Mon Sep 17 00:00:00 2001 From: Thibaud Lepretre Date: Wed, 3 Jul 2019 17:57:06 +0200 Subject: Preparing next release 0.5.0-SNAPSHOT --- docs/user.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'docs/user.md') diff --git a/docs/user.md b/docs/user.md index 1c9c9c5..8669915 100644 --- a/docs/user.md +++ b/docs/user.md @@ -55,7 +55,7 @@ If you want to report a bug or ask a question, [create an issue](https://github. ## General - **Authors**: [Louis Barranqueiro (LouisBarranqueiro)](https://github.com/LouisBarranqueiro) and [Thibaud Leprêtre (kakawait)](https://github.com/kakawait) -- **Version**: 0.4.8-BETA (based on Hexo version 1.10.0) +- **Version**: 0.5.0-SNAPSHOT (based on Hexo version 3.1.0) - **Compatibility**: Hugo v0.53 ## Features -- cgit v1.2.3 From 33930d6adc3476c358acf25d69d2c4cfee7201cb Mon Sep 17 00:00:00 2001 From: Thibaud Lepretre Date: Thu, 4 Jul 2019 15:01:16 +0200 Subject: Sync from 1cafcb39c8a101893ae30f92a0a789e2c1d8b85b - [x] SCSS - [x] JS - [x] i18n files - [x] HTML - [x] gitalk - [x] FontAwesome 5 - [ ] Docs Fixes #287 --- docs/user.md | 18 +++++++++--------- 1 file changed, 9 insertions(+), 9 deletions(-) (limited to 'docs/user.md') diff --git a/docs/user.md b/docs/user.md index 8669915..b850229 100644 --- a/docs/user.md +++ b/docs/user.md @@ -219,58 +219,58 @@ You can add groups of links and links much as you want. weight = 0 identifier = "home" name = "Home" - pre = "" + pre = "" url = "/" [[menu.main]] weight = 1 identifier = "categories" name = "Categories" - pre = "" + pre = "" url = "/categories" [[menu.main]] weight = 2 identifier = "tags" name = "Tags" - pre = "" + pre = "" url = "/tags" [[menu.main]] weight = 3 identifier = "archives" name = "Archives" - pre = "" + pre = "" url = "/archives" [[menu.main]] weight = 4 identifier = "search" name = "Search" - pre = "" + pre = "" url = "/#search" class = "st-search-show-outputs" [[menu.main]] weight = 4 identifier = "about" name = "About" - pre = "" + pre = "" url = "/#about" [[menu.links]] weight = 0 identifier = "github" name = "GitHub" - pre = "" + pre = "" url = "https://github.com/kakawait" [[menu.links]] weight = 1 identifier = "stackoverflow" name = "Stack Overflow" - pre = "" + pre = "" url = "https://stackoverflow.com/users/636472/kakawait" [[menu.misc]] weight = 0 identifier = "rss" name = "RSS" - pre = "" + pre = "" url = "/index.xml" ``` -- cgit v1.2.3 From 49f8b214712b155172e6e9829b0e084b12d3b3e7 Mon Sep 17 00:00:00 2001 From: Thibaud Lepretre Date: Wed, 28 Jul 2021 23:48:15 +0200 Subject: Update fontawesome to v5 --- docs/user.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) (limited to 'docs/user.md') diff --git a/docs/user.md b/docs/user.md index b850229..9b8634d 100644 --- a/docs/user.md +++ b/docs/user.md @@ -257,13 +257,13 @@ You can add groups of links and links much as you want. weight = 0 identifier = "github" name = "GitHub" - pre = "" + pre = "" url = "https://github.com/kakawait" [[menu.links]] weight = 1 identifier = "stackoverflow" name = "Stack Overflow" - pre = "" + pre = "" url = "https://stackoverflow.com/users/636472/kakawait" [[menu.misc]] @@ -436,17 +436,17 @@ googleAnalytics = [params] [[params.sharingOptions]] name = "Facebook" - icon = "fa-facebook-official" + icon = "fab fa-facebook" url = "https://www.facebook.com/sharer/sharer.php?u=%s" [[params.sharingOptions]] name = "Twitter" - icon = "fa-twitter" + icon = "fab fa-twitter" url = "https://twitter.com/intent/tweet?text=%s" [[params.sharingOptions]] name = "Google+" - icon = "fa-google-plus" + icon = "fab fa-google-plus" url = "https://plus.google.com/share?url=%s" ``` -- cgit v1.2.3 From d5d15554b9820d6933eb1966504d48c026f4cbb4 Mon Sep 17 00:00:00 2001 From: Thibaud Lepretre Date: Sat, 31 Jul 2021 00:00:51 +0200 Subject: Update doc --- docs/user.md | 169 +++++++++++++++++++++++++++++++++++++++-------------------- 1 file changed, 113 insertions(+), 56 deletions(-) (limited to 'docs/user.md') diff --git a/docs/user.md b/docs/user.md index 9b8634d..ef5e7a3 100644 --- a/docs/user.md +++ b/docs/user.md @@ -14,47 +14,53 @@ If you want to report a bug or ask a question, [create an issue](https://github. - [General](#general) - [Features](#features) - * [Missing features from original *Hexo* version](#missing-features-from-original-hexo-version) + - [Missing features from original *Hexo* version](#missing-features-from-original-hexo-version) - [Requirements](#requirements) - [Installation](#installation) - [Tranquilpeak configuration](#tranquilpeak-configuration) - - [Language configuration](#language-configuration) - * [Menu translation](#menu-translation) - - [Theme configuration](#theme-configuration) - * [Define date format](#define-date-format) - * [Define global keywords](#define-global-keywords) - * [Sidebar](#sidebar) - * [Header](#header) - * [Author](#author) - * [Customization](#customization) - * [Integrated services](#integrated-services) - * [Sharing options](#sharing-options) - * [Enable pages](#enable-pages) + - [Language configuration](#language-configuration) + - [Menu translation](#menu-translation) + - [Setting up default theme to Tranquilpeak](#setting-up-default-theme-to-tranquilpeak) + - [Define date format](#define-date-format) + - [Define global keywords](#define-global-keywords) + - [Theme configuration](#theme-configuration) + - [Sidebar](#sidebar) + - [Header](#header) + - [Author](#author) + - [Customization](#customization) + - [Add custom JS or CSS using configuration](#add-custom-js-or-css-using-configuration) + - [Integrated services](#integrated-services) + - [Disqus](#disqus) + - [Gitalk](#gitalk) + - [Google Analytics](#google-analytics) + - [Gravatar](#gravatar) + - [Facebook](#facebook) + - [Sharing options](#sharing-options) + - [Enable pages](#enable-pages) - [Integrated services configuration](#integrated-services-configuration) - * [Google Analytics](#google-analytics) - * [Exclude hostname (localhost) while writing articles](#exclude-hostname-localhost-while-writing-articles) - * [Social cards](#social-cards) + - [Google Analytics](#google-analytics-1) + - [Exclude hostname (localhost) while writing articles](#exclude-hostname-localhost-while-writing-articles) + - [Social cards](#social-cards) - [Quick & easy modifications](#quick--easy-modifications) - * [Prerequisites](#prerequisites) - * [Change global style](#change-global-style) - * [Change code coloration (Highlight.js theme)](#change-code-coloration-highlightjs-theme) + - [Prerequisites](#prerequisites) + - [Change global style](#change-global-style) + - [Change code coloration (Highlight.js theme)](#change-code-coloration-highlightjs-theme) - [Writing posts](#writing-posts) - * [Front-matter settings](#front-matter-settings) - * [Define post excerpt](#define-post-excerpt) - * [Display table of contents](#display-table-of-contents) - * [Tags](#tags) - * [Alert](#alert) - * [Highlight text](#highlight-text) - * [Image](#image) - * [Tabbed code block](#tabbed-code-block) - * [Wide image](#wide-image) - * [Fancybox](#fancybox) + - [Front-matter settings](#front-matter-settings) + - [Define post excerpt](#define-post-excerpt) + - [Display table of contents](#display-table-of-contents) + - [Tags](#tags) + - [Alert](#alert) + - [Highlight Text](#highlight-text) + - [Image](#image) + - [Tabbed code block](#tabbed-code-block) + - [Wide image](#wide-image) - [Writing pages](#writing-pages) - [Running](#running) ## General -- **Authors**: [Louis Barranqueiro (LouisBarranqueiro)](https://github.com/LouisBarranqueiro) and [Thibaud Leprêtre (kakawait)](https://github.com/kakawait) +- **Authors**: [Thibaud Leprêtre (kakawait)](https://github.com/kakawait) and [Louis Barranqueiro (LouisBarranqueiro)](https://github.com/LouisBarranqueiro) - **Version**: 0.5.0-SNAPSHOT (based on Hexo version 3.1.0) - **Compatibility**: Hugo v0.53 @@ -87,13 +93,13 @@ If you want to report a bug or ask a question, [create an issue](https://github. **Integrated services:** - Disqus +- Gitalk - Google analytics - Gravatar - Facebook Insights ### Missing features from original *Hexo* version -- [ ] Baidu analytics - [ ] Algolia (https://github.com/kakawait/hugo-tranquilpeak-theme/issues/8) - [ ] Pagination custumization `tagPagination`, `categoryPagination` and `archivePagination` (https://github.com/kakawait/hugo-tranquilpeak-theme/issues/17) @@ -139,8 +145,10 @@ by one of the following code (code is between `()`): - Japanase (`ja`) - Portuguese (`pt-br`) - Russian (`ru`) -- Spanish (`es`) +- Spanish (`es-es`) - Vietnamese (`vi`) +- Dutch (`nl-nl`) +- Swedish (`sv-se`) If your language is not available, follow this guidelines (E.g : add swedish language (`sv-se`)) : @@ -216,41 +224,34 @@ You can add groups of links and links much as you want. ```toml [[menu.main]] - weight = 0 + weight = 1 identifier = "home" name = "Home" - pre = "" + pre = "" url = "/" [[menu.main]] - weight = 1 + weight = 2 identifier = "categories" name = "Categories" - pre = "" + pre = "" url = "/categories" [[menu.main]] - weight = 2 + weight = 3 identifier = "tags" name = "Tags" - pre = "" + pre = "" url = "/tags" [[menu.main]] - weight = 3 + weight = 4 identifier = "archives" name = "Archives" - pre = "" + pre = "" url = "/archives" [[menu.main]] - weight = 4 - identifier = "search" - name = "Search" - pre = "" - url = "/#search" - class = "st-search-show-outputs" -[[menu.main]] - weight = 4 + weight = 5 identifier = "about" name = "About" - pre = "" + pre = "" url = "/#about" [[menu.links]] @@ -270,7 +271,7 @@ You can add groups of links and links much as you want. weight = 0 identifier = "rss" name = "RSS" - pre = "" + pre = "" url = "/index.xml" ``` @@ -406,16 +407,74 @@ Futhermore, even if previous syntax is still supported (`customJS = ["js/myscrip #### Integrated services +For privacy settings please refer to https://gohugo.io/about/hugo-and-gdpr/ + +##### Disqus + ```toml disqusShortname = +[params.comment.disqus] + enable = true +``` + +| Variable | Description | +|----------|-------------| +| disqusShortname | Your Disqus shortname | +| enable | Toggle disqus globally | + +##### Gitalk + +```toml +[params.comment.gitalk] + enable = true + # clientId = + # clientSecret = + # owner = + # repo = + # See all options: https://github.com/gitalk/gitalk#options + [params.comment.gitalk.options] + language = "en" + perPage = 10 + distractionFreeMode = false + enableHotKey = true + pagerDirection = "first" +``` + +| Variable | Description | +|----------|-------------| +| enable | Toggle gitalk globally | +| clientId | GitHub Application Client ID | +| clientSecret | GitHub Application Client Secret | +| owner | GitHub repository owner. Can be personal user or organization | +| repo | GitHub repository | +| _options_ | See all available options on https://github.com/gitalk/gitalk#options | + +##### Google Analytics + +```toml googleAnalytics = +[params.googleAnalytics] + async = true ``` +| Variable | Description | +|----------|-------------| +| googleAnalytics | Your Google analystics web property ID : UA-XXXXX-X | +| async | Load Google analytics asynchronously | + +##### Gravatar + ```toml [author] gravatarEmail = ``` +| Variable | Description | +|----------|-------------| +| gravatarEmail | Your gravatar email. Overwrite `author.picture` everywhere in the blog | + +##### Facebook + ```toml [params] fbAdminIds = @@ -423,10 +482,7 @@ googleAnalytics = ``` | Variable | Description | -|---------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| disqusShortname | Your Disqus shortname. | -| gravatarEmail | Your gravatar email. Overwrite `author.picture` everywhere in the blog | -| googleAnalytics | Your Google analystics web property ID : UA-XXXXX-X | +|----------|-------------| | fbAdminIds | Your Facebook user ids used to connect your blog with your facebook user accounts (Facebook Insights). Use array syntax. E.g : `[9830047, 1003342]`. Visit [Facebook docs](https://developers.facebook.com/docs/platforminsights/domains) for more information. | | fbAppId | Your Facebook app id used to connect your blog with your facebook app account (Facebook Insights). E.g : `9841307`. Visit [Facebook docs](https://developers.facebook.com/docs/platforminsights/domains) for more information. | @@ -456,7 +512,7 @@ You can comment and uncomment to enable or disable sharing options. If your own [params] [[params.sharingOptions]] name = "Foo bar" - icon = "fa-foo-bar" + icon = "fas fa-foo-bar" url = "https://www.foo-bar.com/sharer/sharer.php?u=%s" ``` @@ -512,7 +568,7 @@ You can configure how links to your site will appear in Twitter and/or Facebook. Since you are going to edit the theme, you have to install all the necessary to build it after changes : [Installation](https://github.com/kakawait/hugo-tranquilpeak-theme/blob/master/docs/developer.md#installation) -**Run command in theme folder : `hexo-blog/themes/tranquilpeak`** +**Run command in theme folder : `hugo-blog/themes/tranquilpeak`** ### Change global style @@ -592,6 +648,7 @@ summary: "This is a custom summary and does *not* appear in the post." |showMeta|`true`: Show post meta (date, categories).| |showActions|`true`: Show post actions (navigation, share links).| |summary|Custom excerpt text to show on the homepage.| +|link|Override default URL/link for a given article/page.| Example: A post on index page will look like this with :`thumbnailImagePosition` set to `bottom`: -- cgit v1.2.3 From 06615cb2e300f7178bb8b5c2cf4f2982d109e0d8 Mon Sep 17 00:00:00 2001 From: phillc <15082+phillc@users.noreply.github.com> Date: Sun, 4 Aug 2019 09:02:57 -0400 Subject: Class on sidebar menu does not work --- docs/user.md | 1 - 1 file changed, 1 deletion(-) (limited to 'docs/user.md') diff --git a/docs/user.md b/docs/user.md index ef5e7a3..c9e0714 100644 --- a/docs/user.md +++ b/docs/user.md @@ -282,7 +282,6 @@ You can add groups of links and links much as you want. | name | title to be display | string | | pre | icon to be display a left of the name | template.HTML | | url | menu entry url | string | -| class | CSS Class added to the `a` link tag | string | `identifier` can be use for translation see [Menu translation](#menu-translation). -- cgit v1.2.3 From c251857a1060dcbe2ecc794d897278e589e29bb0 Mon Sep 17 00:00:00 2001 From: Thibaud Lepretre Date: Thu, 5 Aug 2021 19:56:10 +0200 Subject: Update package.json dependencies --- docs/user.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'docs/user.md') diff --git a/docs/user.md b/docs/user.md index c9e0714..999dd35 100644 --- a/docs/user.md +++ b/docs/user.md @@ -491,7 +491,7 @@ googleAnalytics = [params] [[params.sharingOptions]] name = "Facebook" - icon = "fab fa-facebook" + icon = "fab fa-facebook-square" url = "https://www.facebook.com/sharer/sharer.php?u=%s" [[params.sharingOptions]] -- cgit v1.2.3 From a98bf8ca122e88fc7d108a2360b02870a124b72c Mon Sep 17 00:00:00 2001 From: Thibaud Lepretre Date: Sat, 7 Aug 2021 13:49:57 +0200 Subject: Add new shortcode toc to support new markup fixes #395 --- docs/user.md | 20 +++++++++++++++++--- 1 file changed, 17 insertions(+), 3 deletions(-) (limited to 'docs/user.md') diff --git a/docs/user.md b/docs/user.md index 999dd35..af432df 100644 --- a/docs/user.md +++ b/docs/user.md @@ -668,10 +668,24 @@ Use: ### Display table of contents -As post excerpt feature enable with `` comment, you can display the table of contents of a post with ``. Place this comment where you want to display the table of content. +Hugo Tranquilpeak theme provides a shortcode for adding table of content inside your content. -Here is what looks like the table of contents generated: -![thumbnail-image-position-left](https://s3-ap-northeast-1.amazonaws.com/tranquilpeak-hexo-theme/docs/1.4.0/toc-400.png) +syntgax: +``` +{{< toc >}} +``` + +However you may have to update your hugo `config.toml` configuration to be sure that `startLevel` is matching your content. By default (see [official documentation](https://gohugo.io/getting-started/configuration-markup/#table-of-contents)) Hugo detects table of content starting level 2, that mean `

my title

` or `## my title`. + +If you used to write `# my title` and so transformed to `

my title

`, the table of content will be empty by default if you're not updating `startLevel` to `startLevel = 1` + +```toml +[markup] + [markup.tableOfContents] + endLevel = 3 + ordered = false + startLevel = 1 +``` ### Tags -- cgit v1.2.3 From 2ea44e0c29f1899b2d169941f7f0bdc678ca362a Mon Sep 17 00:00:00 2001 From: Thibaud Lepretre Date: Wed, 11 Aug 2021 14:09:27 +0200 Subject: Update version to 0.5.0-BETA --- docs/user.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'docs/user.md') diff --git a/docs/user.md b/docs/user.md index af432df..9e860cf 100644 --- a/docs/user.md +++ b/docs/user.md @@ -61,7 +61,7 @@ If you want to report a bug or ask a question, [create an issue](https://github. ## General - **Authors**: [Thibaud Leprêtre (kakawait)](https://github.com/kakawait) and [Louis Barranqueiro (LouisBarranqueiro)](https://github.com/LouisBarranqueiro) -- **Version**: 0.5.0-SNAPSHOT (based on Hexo version 3.1.0) +- **Version**: 0.5.0-BETA (based on Hexo version 3.1.0) - **Compatibility**: Hugo v0.53 ## Features -- cgit v1.2.3