mirrors/hugo-PaperMod
1
0
Fork 0
mirror of https://github.com/adityatelange/hugo-PaperMod.git synced 2023-12-21 10:22:58 +01:00
Code Issues Packages Projects Releases Wiki Activity

Update docs from wiki and prettify

Browse Source
This commit is contained in:
Aditya Telange 2022-06-10 21:49:13 +05:30
parent 5c8078a888
commit fb3fb4d325
No known key found for this signature in database
GPG Key ID: 82E844EF3DA99E77
4 changed files with 346 additions and 294 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

121
content/posts/papermod/papermod-features/index.md
View File

@ -10,9 +10,9 @@ author: "Aditya Telange"
### Intro ### Intro
- **We'll be using `yml/yaml` format for all examples down below, I recommend using `yml` over `toml` as it is easier to read.** - **We'll be using `yml/yaml` format for all examples down below, I recommend using `yml` over `toml` as it is easier to read.**
- You can find any [YML to TOML](https://www.google.com/search?q=yml+to+toml) converters if necessary. - You can find any [YML to TOML](https://www.google.com/search?q=yml+to+toml) converters if necessary.
--- ---
@ -20,9 +20,9 @@ author: "Aditya Telange"
The following is enabled by default The following is enabled by default
- [minification](https://gohugo.io/hugo-pipes/minification/) - makes the assets size smallest as possible. - [minification](https://gohugo.io/hugo-pipes/minification/) - makes the assets size smallest as possible.
- [bundling](https://gohugo.io/hugo-pipes/bundling/) - bundles all the styles in one single asset - [bundling](https://gohugo.io/hugo-pipes/bundling/) - bundles all the styles in one single asset
- [fingerprint/integrity](https://gohugo.io/hugo-pipes/fingerprint/) check. - [fingerprint/intergity](https://gohugo.io/hugo-pipes/fingerprint/) check.
--- ---
@ -30,9 +30,9 @@ The following is enabled by default
```yml ```yml
params: params:
# defaultTheme: light # defaultTheme: light
# defaultTheme: dark # defaultTheme: dark
defaultTheme: auto # to switch between dark or light according to browser theme defaultTheme: auto # to switch between dark or light according to browser theme
``` ```
</details> </details>
@ -86,7 +86,6 @@ layout: "archives"
url: "/archives/" url: "/archives/"
summary: archives summary: archives
--- ---
``` ```
**Note:** Archives Layout does not support Multilingual Month Translations. **Note:** Archives Layout does not support Multilingual Month Translations.
@ -122,8 +121,6 @@ params:
url: "<link2>" url: "<link2>"
``` ```
ex. [config.yml#L106](https://github.com/adityatelange/hugo-PaperMod/blob/exampleSite/config.yml#L106)
--- ---
### Profile Mode ### Profile Mode
@ -146,15 +143,15 @@ params:
imageHeight: 120 # custom size imageHeight: 120 # custom size
buttons: buttons:
- name: Archive - name: Archive
url: "/archive" url: "/archive"
- name: Github - name: Github
url: "https://github.com/" url: "https://github.com/"
socialIcons: # optional socialIcons: # optional
- name: "<platform>" - name: "<platform>"
url: "<link>" url: "<link>"
- name: "<platform 2>" - name: "<platform 2>"
url: "<link2>" url: "<link2>"
``` ```
--- ---
@ -167,10 +164,10 @@ Add the following to site config, `config.yml`
```yml ```yml
outputs: outputs:
home: home:
- HTML - HTML
- RSS - RSS
- JSON # is necessary - JSON # is necessary
``` ```
Create a page with `search.md` in `content` directory with following content Create a page with `search.md` in `content` directory with following content
@ -182,8 +179,8 @@ layout: "search" # is necessary
# url: "/archive" # url: "/archive"
# description: "Description for Search" # description: "Description for Search"
summary: "search" summary: "search"
placeholder: "placeholder text in search input box"
--- ---
``` ```
To hide a particular page from being searched, add it in post's fron't matter To hide a particular page from being searched, add it in post's fron't matter
@ -197,9 +194,9 @@ ex: [search.md](https://raw.githubusercontent.com/adityatelange/hugo-PaperMod/ex
> Search Page also has Key bindings: > Search Page also has Key bindings:
> >
> - Arrow keys to move up/down the list > - Arrow keys to move up/down the list
> - Enter key (return) or Right Arrow key to Go to highlighted page > - Enter key (return) or Right Arrow key to Go to highlighted page
> - Escape key to clear searchbox and results > - Escape key to clear searchbox and results
For Multilingual use `search.<lang>.md` ex. `search.es.md`. For Multilingual use `search.<lang>.md` ex. `search.es.md`.
@ -211,14 +208,14 @@ Refer https://fusejs.io/api/options.html for Options, Add those as shown below.
```yml ```yml
params: params:
fuseOpts: fuseOpts:
isCaseSensitive: false isCaseSensitive: false
shouldSort: true shouldSort: true
location: 0 location: 0
distance: 1000 distance: 1000
threshold: 0.4 threshold: 0.4
minMatchCharLength: 0 minMatchCharLength: 0
keys: ["title", "permalink", "summary", "content"] keys: ["title", "permalink", "summary", "content"]
``` ```
--- ---
@ -235,12 +232,12 @@ In post's page-variables add :
```yml ```yml
cover: cover:
image: "<image path/url>" image: "<image path/url>"
# can also paste direct link from external site # can also paste direct link from external site
# ex. https://i.ibb.co/K0HVPBd/paper-mod-profilemode.png # ex. https://i.ibb.co/K0HVPBd/paper-mod-profilemode.png
alt: "<alt text>" alt: "<alt text>"
caption: "<text>" caption: "<text>"
relative: false # To use relative path for cover image, used in hugo Page-bundles relative: false # To use relative path for cover image, used in hugo Page-bundles
``` ```
When you include images in the [Page Bundle](https://gohugo.io/content-management/page-bundles/), multiple sizes of the image will automatically be provided using the HTML5 `srcset` field. When you include images in the [Page Bundle](https://gohugo.io/content-management/page-bundles/), multiple sizes of the image will automatically be provided using the HTML5 `srcset` field.
@ -249,16 +246,16 @@ To reduce generation time and size of the site, you can disable this feature usi
```yml ```yml
params: params:
cover: cover:
responsiveImages: false responsiveImages: false
``` ```
To enable hyperlinks to the full image size on post pages, use To enable hyperlinks to the full image size on post pages, use
```yml ```yml
params: params:
cover: cover:
linkFullImages: true linkFullImages: true
``` ```
--- ---
@ -271,7 +268,7 @@ to show share buttons add
```yml ```yml
params: params:
ShowShareButtons: true ShowShareButtons: true
``` ```
--- ---
@ -284,7 +281,7 @@ To show reading time add
```yml ```yml
Params: Params:
ShowReadingTime: true ShowReadingTime: true
``` ```
--- ---
@ -313,7 +310,7 @@ Adds BreadCrumb Navigation above Post's Title to show subsections and Navigation
```yml ```yml
params: params:
ShowBreadCrumbs: true ShowBreadCrumbs: true
``` ```
Can be diabled for particular page's front-matter Can be diabled for particular page's front-matter
@ -322,7 +319,6 @@ Can be diabled for particular page's front-matter
--- ---
ShowBreadCrumbs: false ShowBreadCrumbs: false
--- ---
``` ```
--- ---
@ -335,10 +331,10 @@ For site config use:
```yml ```yml
Params: Params:
editPost: editPost:
URL: "https://github.com/<path_to_repo>/content" URL: "https://github.com/<path_to_repo>/content"
Text: "Suggest Changes" # edit text Text: "Suggest Changes" # edit text
appendFilePath: true # to append file path to Edit link appendFilePath: true # to append file path to Edit link
``` ```
Can be modified for individual pages Can be modified for individual pages
@ -346,11 +342,10 @@ Can be modified for individual pages
```yml ```yml
--- ---
editPost: editPost:
URL: "https://github.com/<path_to_repo>/content" URL: "https://github.com/<path_to_repo>/content"
Text: "Suggest Changes" # edit text Text: "Suggest Changes" # edit text
appendFilePath: true # to append file path to Edit link appendFilePath: true # to append file path to Edit link
--- ---
``` ```
The example above would yield the following link for the post file `posts/post-name.md`: The example above would yield the following link for the post file `posts/post-name.md`:
@ -374,7 +369,18 @@ Adds a Previous / Next post suggestion under a single post
```yml ```yml
params: params:
ShowPostNavLinks: true ShowPostNavLinks: true
```
---
### Code Copy Button
Adds a `copy` button in code block to copy the code it contains
```yml
params:
ShowCodeCopyButtons: true
``` ```
--- ---
@ -387,14 +393,13 @@ To Use multiple authors for a post, in post-variables:
--- ---
author: ["Me", "You"] author: ["Me", "You"]
--- ---
``` ```
To use Multiple Authors Site-wide, in `config.yml`: To use Multiple Authors Site-wide, in `config.yml`:
```yml ```yml
params: params:
author: ["Me", "You"] author: ["Me", "You"]
``` ```
--- ---
@ -411,7 +416,7 @@ also in config add this
```yml ```yml
params: params:
comments: true comments: true
``` ```
read more about this [hugo-comments](https://gohugo.io/content-management/comments/) read more about this [hugo-comments](https://gohugo.io/content-management/comments/)
@ -436,7 +441,7 @@ t - Theme toggle
**Enabled only when `env: production`** **Enabled only when `env: production`**
- [Rich Results/Snippets Support](https://support.google.com/webmasters/answer/7506797?hl=en) - [Rich Results/Snippets Support](https://support.google.com/webmasters/answer/7506797?hl=en)
#### Twitter Cards Support #### Twitter Cards Support

165
content/posts/papermod/papermod-icons.md
View File

@ -11,87 +11,107 @@ draft: true
## Social Icons ## Social Icons
| No. | Name | Platform Link | | Name | Platform Link |
| --- | --------------- | ------------------------------- | | --------------- | ------------------------------- |
| 1 | `123rf` | 123rf.com | | `123rf` | 123rf.com |
| 2 | `adobestock` | stock.adobe.com | | `adobestock` | stock.adobe.com |
| 3 | `behance` | behance.net | | `apple music` | music.apple.com |
| 4 | `buymeacoffee` | buymeacoffee.com | | `behance` | behance.net |
| 5 | `codepen` | codepen.io | | `bilibili` | bilibili.com |
| 6 | `cryptohack` | cryptohack.org | | `bitcoin` | - |
| 7 | `ctftime` | ctftime.org | | `buymeacoffee` | buymeacoffee.com |
| 8 | `dev` | dev.to | | `codepen` | codepen.io |
| 9 | `discogs` | discogs.com | | `cryptohack` | cryptohack.org |
| 10 | `discord` | discord.com | | `ctftime` | ctftime.org |
| 11 | `dreamstime` | dreamstime.com | | `cv` | - |
| 12 | `dribbble` | dribbble.com | | `deezer` | deezer.com |
| 13 | `email` | - | | `dev` | dev.to |
| 14 | `facebook` | facebook.com | | `discogs` | discogs.com |
| 15 | `flickr` | flickr.com | | `discord` | discord.com |
| 16 | `freepik` | freepik.com | | `dreamstime` | dreamstime.com |
| 17 | `gitea` | gitea.io | | `dribbble` | dribbble.com |
| 18 | `github` | github.com | | `email` | - |
| 19 | `gitlab` | gitlab.com | | `facebook` | facebook.com |
| 20 | `goodreads` | goodreads.com | | `flickr` | flickr.com |
| 21 | `hackerone` | hackerone.com | | `freepik` | freepik.com |
| 22 | `hackerrank` | hackerrank.com | | `gitea` | gitea.io |
| 23 | `hackthebox` | hackthebox.eu | | `github` | github.com |
| 24 | `instagram` | instagram.com | | `gitlab` | gitlab.com |
| 25 | `itchio` | itch.io | | `goodreads` | goodreads.com |
| 26 | `kakaotalk` | kakaocorp.com/service/KakaoTalk | | `googlescholar` | scholar.google.com |
| 27 | `keybase` | keybase.io | | `guruShots` | gurushots.com |
| 28 | `kofi` | ko-fi.com | | `hackerone` | hackerone.com |
| 29 | `lastfm` | last.fm | | `hackerrank` | hackerrank.com |
| 30 | `liberapay` | liberapay.com | | `hackthebox` | hackthebox.eu |
| 31 | `linkedin` | linkedin.com | | `instagram` | instagram.com |
| 32 | `mastodon` | mastodon.social | | `itchio` | itch.io |
| 33 | `matrix` | matrix.org | | `kaggle` | - |
| 34 | `medium` | medium.com | | `kakaotalk` | kakaocorp.com/service/KakaoTalk |
| 35 | `mixcloud` | mixcloud.com | | `key` | - |
| 36 | `nuget` | nuget.org | | `keybase` | keybase.io |
| 37 | `paypal` | paypal.com | | `kofi` | ko-fi.com |
| 38 | `qq` | qq.com | | `komoot` | - |
| 39 | `reddit` | reddit.com | | `lastfm` | last.fm |
| 40 | `rss` | - | | `letterboxd` | - |
| 41 | `serverfault` | serverfault.com | | `liberapay` | liberapay.com |
| 42 | `soundcloud` | soundcloud.com | | `linkedin` | linkedin.com |
| 43 | `shutterstock` | shutterstock.com | | `mastodon` | mastodon.social |
| 44 | `slack` | slack.com | | `matrix` | matrix.org |
| 45 | `snapchat` | snapchat.com/add | | `medium` | medium.com |
| 46 | `sourcerer` | sourcerer.io | | `monero` | - |
| 47 | `spotify` | spotify.com | | `mixcloud` | mixcloud.com |
| 48 | `stackoverflow` | stackoverflow.com | | `nuget` | nuget.org |
| 49 | `steam` | steampowered.com | | `paypal` | paypal.com |
| 50 | `telegram` | telegram.org | | `peertube` | - |
| 51 | `twitch` | twitch.tv | | `pgp` | - |
| 52 | `twitter` | twitter.com | | `phone` | - |
| 53 | `unsplash` | unsplash.com | | `ploywork` | ploywork.com |
| 54 | `xda` | xda-developers.com | | `qq` | qq.com |
| 55 | `youtube` | youtube.com | | `reddit` | reddit.com |
| 56 | `other` | - | | `researchgate` | researchgate.net |
| `rss` | - |
| `serverfault` | serverfault.com |
| `soundcloud` | soundcloud.com |
| `shutterstock` | shutterstock.com |
| `slack` | slack.com |
| `snapchat` | snapchat.com/add |
| `spotify` | spotify.com |
| `stackoverflow` | stackoverflow.com |
| `steam` | steampowered.com |
| `strava` | strava.com |
| `telegram` | telegram.org |
| `tiktok | tiktok.com |
| `twitch` | twitch.tv |
| `twitter` | twitter.com |
| `unsplash` | unsplash.com |
| `xda` | xda-developers.com |
| `xing` | xing.com |
| `ycombinator` | ycombinator.com |
| `youtube` | youtube.com |
| `other` | - |
Usage : Usage :
``` ```
socialIcons: socialIcons:
- name: "kofi" - name: "kofi"
url: "https://kofi.com" url: "https://kofi.com"
- name: "twitter" - name: "twitter"
url: "https://twitter.com" url: "https://twitter.com"
``` ```
--- ---
## Share Icons ## Share Icons
| No. | Platform | | No. | Platform |
| --- | --------------------------------------------------------------- | | --------------------------------------------------------------- | -------- |
| 1 | `twitter` (also generates hash tags from tags linked with post) | | `twitter` (also generates hash tags from tags linked with post) |
| 2 | `linkedin` | | `linkedin` |
| 3 | `reddit` | | `reddit` |
| 4 | `facebook` | | `facebook` |
| 5 | `whatsapp` | | `whatsapp` |
| 6 | `telegram` | | `telegram` |
Usage: Usage:
@ -99,3 +119,8 @@ Usage:
params: params:
ShowShareButtons: true ShowShareButtons: true
``` ```
```yml
params:
ShareButtons: ["linkedin", "twitter"] # To customize which share buttons to be enabled on page
```

248
content/posts/papermod/papermod-installation.md
View File

@ -11,8 +11,8 @@ author: "Aditya Telange"
## Intro ## Intro
- **We'll be using `yml/yaml` format for all examples down below, I recommend using `yml` over `toml` as it is easier to read.** - **We'll be using `yml/yaml` format for all examples down below, I recommend using `yml` over `toml` as it is easier to read.**
- You can find any [YML to TOML](https://www.google.com/search?q=yml+to+toml) converters if necessary. - You can find any [YML to TOML](https://www.google.com/search?q=yml+to+toml) converters if necessary.
--- ---
@ -47,10 +47,10 @@ git clone https://github.com/adityatelange/hugo-PaperMod themes/PaperMod --depth
### Method 2 ### Method 2
You can use as [submodule](https://www.atlassian.com/git/tutorials/git-submodule) with you can use as [submodule](https://www.atlassian.com/git/tutorials/git-submodule) with
```bash ```bash
git submodule add https://github.com/adityatelange/hugo-PaperMod.git themes/PaperMod --depth=1 git submodule add --depth=1 https://github.com/adityatelange/hugo-PaperMod.git themes/PaperMod
git submodule update --init --recursive # needed when you reclone your repo (submodules may not get cloned automatically) git submodule update --init --recursive # needed when you reclone your repo (submodules may not get cloned automatically)
``` ```
@ -68,12 +68,13 @@ Or you can Download as Zip from Github Page and extract in your themes directory
Direct Links: Direct Links:
- [Master Branch (Latest)](https://github.com/adityatelange/hugo-PaperMod/archive/master.zip) - [Master Branch (Latest)](https://github.com/adityatelange/hugo-PaperMod/archive/master.zip)
- [v5.0](https://github.com/adityatelange/hugo-PaperMod/archive/v5.0.zip) - [v6.0](https://github.com/adityatelange/hugo-PaperMod/archive/v6.0.zip)
- [v4.0](https://github.com/adityatelange/hugo-PaperMod/archive/v4.0.zip) - [v5.0](https://github.com/adityatelange/hugo-PaperMod/archive/v5.0.zip)
- [v3.0](https://github.com/adityatelange/hugo-PaperMod/archive/v3.0.zip) - [v4.0](https://github.com/adityatelange/hugo-PaperMod/archive/v4.0.zip)
- [v2.0](https://github.com/adityatelange/hugo-PaperMod/archive/v2.0.zip) - [v3.0](https://github.com/adityatelange/hugo-PaperMod/archive/v3.0.zip)
- [v1.0](https://github.com/adityatelange/hugo-PaperMod/archive/v1.0.zip) - [v2.0](https://github.com/adityatelange/hugo-PaperMod/archive/v2.0.zip)
- [v1.0](https://github.com/adityatelange/hugo-PaperMod/archive/v1.0.zip)
### Finally ... ### Finally ...
@ -137,132 +138,135 @@ enableRobotsTXT: true
buildDrafts: false buildDrafts: false
buildFuture: false buildFuture: false
buildExpired: false buildExpired: false
pygmentsUseClasses: true
googleAnalytics: UA-123-45 googleAnalytics: UA-123-45
minify: minify:
disableXML: true disableXML: true
minifyOutput: true minifyOutput: true
params: params:
env: production # to enable google analytics, opengraph, twitter-cards and schema. env: production # to enable google analytics, opengraph, twitter-cards and schema.
title: ExampleSite
description: "ExampleSite description"
keywords: [Blog, Portfolio, PaperMod]
author: Me
# author: ["Me", "You"] # multiple authors
images: ["<link or path of image for opengraph, twitter-cards>"]
DateFormat: "January 2, 2006"
defaultTheme: auto # dark, light
disableThemeToggle: false
ShowReadingTime: true
ShowShareButtons: true
ShowPostNavLinks: true
ShowBreadCrumbs: true
ShowCodeCopyButtons: false
ShowWordCount: true
ShowRssButtonInSectionTermList: true
UseHugoToc: true
disableSpecial1stPost: false
disableScrollToTop: false
comments: false
hidemeta: false
hideSummary: false
showtoc: false
tocopen: false
assets:
# disableHLJS: true # to disable highlight.js
# disableFingerprinting: true
favicon: "<link / abs url>"
favicon16x16: "<link / abs url>"
favicon32x32: "<link / abs url>"
apple_touch_icon: "<link / abs url>"
safari_pinned_tab: "<link / abs url>"
label:
text: "Home"
icon: /apple-touch-icon.png
iconHeight: 35
# profile-mode
profileMode:
enabled: false # needs to be explicitly set
title: ExampleSite title: ExampleSite
description: "ExampleSite description" subtitle: "This is subtitle"
keywords: [Blog, Portfolio, PaperMod] imageUrl: "<img location>"
author: Me imageWidth: 120
# author: ["Me", "You"] # multiple authors imageHeight: 120
images: ["<link or path of image for opengraph, twitter-cards>"] imageTitle: my image
DateFormat: "January 2, 2006" buttons:
defaultTheme: auto # dark, light - name: Posts
disableThemeToggle: false url: posts
- name: Tags
url: tags
ShowReadingTime: true # home-info mode
ShowShareButtons: true homeInfoParams:
ShowPostNavLinks: true Title: "Hi there \U0001F44B"
ShowBreadCrumbs: true Content: Welcome to my blog
ShowCodeCopyButtons: false
disableSpecial1stPost: false
disableScrollToTop: false
comments: false
hidemeta: false
hideSummary: false
showtoc: false
tocopen: false
assets: socialIcons:
# disableHLJS: true # to disable highlight.js - name: twitter
# disableFingerprinting: true url: "https://twitter.com/"
favicon: "<link / abs url>" - name: stackoverflow
favicon16x16: "<link / abs url>" url: "https://stackoverflow.com"
favicon32x32: "<link / abs url>" - name: github
apple_touch_icon: "<link / abs url>" url: "https://github.com/"
safari_pinned_tab: "<link / abs url>"
label: analytics:
text: "Home" google:
icon: /apple-touch-icon.png SiteVerificationTag: "XYZabc"
iconHeight: 35 bing:
SiteVerificationTag: "XYZabc"
yandex:
SiteVerificationTag: "XYZabc"
# profile-mode cover:
profileMode: hidden: true # hide everywhere but not in structured data
enabled: false # needs to be explicitly set hiddenInList: true # hide on list pages and home
title: ExampleSite hiddenInSingle: true # hide on single page
subtitle: "This is subtitle"
imageUrl: "<img location>"
imageWidth: 120
imageHeight: 120
imageTitle: my image
buttons:
- name: Posts
url: posts
- name: Tags
url: tags
# home-info mode editPost:
homeInfoParams: URL: "https://github.com/<path_to_repo>/content"
Title: "Hi there \U0001F44B" Text: "Suggest Changes" # edit text
Content: Welcome to my blog appendFilePath: true # to append file path to Edit link
socialIcons: # for search
- name: twitter # https://fusejs.io/api/options.html
url: "https://twitter.com/" fuseOpts:
- name: stackoverflow isCaseSensitive: false
url: "https://stackoverflow.com" shouldSort: true
- name: github location: 0
url: "https://github.com/" distance: 1000
threshold: 0.4
analytics: minMatchCharLength: 0
google: keys: ["title", "permalink", "summary", "content"]
SiteVerificationTag: "XYZabc"
bing:
SiteVerificationTag: "XYZabc"
yandex:
SiteVerificationTag: "XYZabc"
cover:
hidden: true # hide everywhere but not in structured data
hiddenInList: true # hide on list pages and home
hiddenInSingle: true # hide on single page
editPost:
URL: "https://github.com/<path_to_repo>/content"
Text: "Suggest Changes" # edit text
appendFilePath: true # to append file path to Edit link
# for search
# https://fusejs.io/api/options.html
fuseOpts:
isCaseSensitive: false
shouldSort: true
location: 0
distance: 1000
threshold: 0.4
minMatchCharLength: 0
keys: ["title", "permalink", "summary", "content"]
menu: menu:
main: main:
- identifier: categories - identifier: categories
name: categories name: categories
url: /categories/ url: /categories/
weight: 10 weight: 10
- identifier: tags - identifier: tags
name: tags name: tags
url: /tags/ url: /tags/
weight: 20 weight: 20
- identifier: example - identifier: example
name: example.org name: example.org
url: https://example.org url: https://example.org
weight: 30 weight: 30
# Read: https://github.com/adityatelange/hugo-PaperMod/wiki/FAQs#using-hugos-syntax-highlighter-chroma # Read: https://github.com/adityatelange/hugo-PaperMod/wiki/FAQs#using-hugos-syntax-highlighter-chroma
# pygmentsUseClasses: true pygmentsUseClasses: true
# markup: markup:
# highlight: highlight:
# # anchorLineNos: true noClasses: false
# codeFences: true # anchorLineNos: true
# guessSyntax: true # codeFences: true
# lineNos: true # guessSyntax: true
# style: monokai # lineNos: true
# style: monokai
``` ```
--- ---
@ -293,7 +297,9 @@ searchHidden: true
ShowReadingTime: true ShowReadingTime: true
ShowBreadCrumbs: true ShowBreadCrumbs: true
ShowPostNavLinks: true ShowPostNavLinks: true
ShowWordCount: true
ShowRssButtonInSectionTermList: true ShowRssButtonInSectionTermList: true
UseHugoToc: true
cover: cover:
image: "<image path/url>" # image path/url image: "<image path/url>" # image path/url
alt: "<alt text>" # alt text alt: "<alt text>" # alt text

106
content/posts/papermod/papermod-variables.md
View File

@ -14,44 +14,49 @@ weight: 5
### Site Variables under `Params` ### Site Variables under `Params`
| name | type | example | Description | | name | type | example | Description |
| -------------------------------------- | ------------- | ------------------------ | ----------------------------------------------------------------------------------------- | | -------------------------------------- | ------------- | ------------------------- | ----------------------------------------------------------------------------------------- |
| `env` | string | 'production' | To set env to production | | `env` | string | 'production' | To set env to production |
| `title` | string | 'My Blog' | To set title | | `title` | string | 'My Blog' | To set title |
| `description` | string | 'This is a blog of mine' | To set site description | | `description` | string | 'This is a blog of mine' | To set site description |
| `author` | string \|list | 'Me' \| ['Me','You'] | To show multiple Authors | | `author` | string \|list | 'Me' \| ['Me','You'] | To show multiple Authors |
| `images` | string | 'myimage.png' | Link or path of image for opengraph, twitter-cards | | `images` | string | 'myimage.png' | Link or path of image for opengraph, twitter-cards |
| `keywords` | list | [blog, page] | Add keywords for Home page | | `keywords` | list | [blog, page] | Add keywords for Home page |
| `DateFormat` | string | "January 2, 2006" | The format of date strings in the website. [Details](https://gohugo.io/functions/format/) | | `DateFormat` | string | "January 2, 2006" | The format of date strings in the website. [Details](https://gohugo.io/functions/format/) |
| `languageAltTitle` | string | "English" | Alternate title in Multilingual Mode | | `languageAltTitle` | string | "English" | Alternate title in Multilingual Mode |
| `ShowReadingTime` | boolean | true \| false | To show read time in post meta | | `ShowReadingTime` | boolean | true \| false | To show read time in post meta |
| `ShowShareButtons` | boolean | true \| false | To show/hide share buttons under post | | `ShowShareButtons` | boolean | true \| false | To show/hide share buttons under post |
| `ShowCodeCopyButtons` | boolean | true \| false | To show/hide Code Copy button | | `ShowCodeCopyButtons` | boolean | true \| false | To show/hide Code Copy button |
| `ShowRssButtonInSectionTermList` | boolean | true \| false | To show/hide RSS Copy button in Section and Term list | | `ShowFullTextinRSS` | boolean | true \| false | To show Content in RSS feed |
| `ShowFullTextinRSS` | boolean | true \| false | To show Content in RSS feed | | `defaultTheme` | string | light \| dark \| auto | To set default theme |
| `defaultTheme` | string | light \| dark \| auto | To set default theme | | `disableThemeToggle` | boolean | true \| false | To disable theme toggle icon shown besides label |
| `disableThemeToggle` | boolean | true \| false | To disable theme toggle icon shown besides label | | `disableSpecial1stPost` | boolean | true \| false | To disable no-card special appearance of 1st post |
| `disableSpecial1stPost` | boolean | true \| false | To disable no-card special appearance of 1st post | | `disableScrollToTop` | boolean | true \| false | To disable ScrollToTop button |
| `disableScrollToTop` | boolean | true \| false | To disable ScrollToTop button | | `disableAnchoredHeadings` | boolean | true \| false | To disable Anchored Headings |
| `disableAnchoredHeadings` | boolean | true \| false | To disable Anchored Headings | | `hideMeta` | boolean | true \| false | To Hide meta elements : date, read-time, author and available-translations for page |
| `hideMeta` | boolean | true \| false | To Hide meta elements : date, read-time, author and available-translations for page | | `hideSummary` | boolean | true \| false | To Hide summary being shown in list pages |
| `hideSummary` | boolean | true \| false | To Hide summary being shown in list pages | | `showtoc` | boolean | true \| false | To show/hide Table of Contents |
| `showtoc` | boolean | true \| false | To show/hide Table of Contents | | `tocopen` | boolean | true \| false | To keep open ToC by default on page load |
| `tocopen` | boolean | true \| false | To keep open ToC by default on page load | | `ShowPostNavLinks` | boolean | true \| false | Show Previous and Next Posts below a Post |
| `ShowPostNavLinks` | boolean | true \| false | Show Previous and Next Posts below a Post | | `ShowBreadCrumbs` | boolean | true \| false | Show BreadCrumb Navigation above single post/page |
| `ShowBreadCrumbs` | boolean | true \| false | Show BreadCrumb Navigation above single post/page | | `ShareButtons` | list | ["linkedin", "twitter"] | To customize which share buttons to be enabled on page |
| `comments` | boolean | true \| false | To show/hide comments | | `ShowWordCount` | boolean | true \| false | To word count to metadata |
| `analytics.google.SiteVerificationTag` | string | "XYZabc" | Site Verification Tag for Google Analytics | | `ShowRssButtonInSectionTermList` | boolean | true \| false | To show RSS icon in Section, Term and List pages |
| `analytics.bing.SiteVerificationTag` | string | "XYZabc" | Site Verification Tag for Bing | | `UseHugoToc` | boolean | true \| false | To use Hugo's default Toc instead of custom |
| `analytics.yandex.SiteVerificationTag` | string | "XYZabc" | Site Verification Tag for Yandex | | `comments` | boolean | true \| false | To show/hide comments |
| `schema` | - | - | [Details](#schema) | | `hideFooter` | boolean | true \| false | To Hide Footer Text om the end of page |
| `fuseOpts` | - | - | [Details](#fuseOpts) | | `CanonicalLinkText` | string | 'Originally published at' | To show text before canonical URL's hostname |
| `socialIcons` | - | - | [Details](#socialIcons) | | `analytics.google.SiteVerificationTag` | string | "XYZabc" | Site Verification Tag for Google Analytics |
| `label` | - | - | [Details](#label) | | `analytics.bing.SiteVerificationTag` | string | "XYZabc" | Site Verification Tag for Bing |
| `assets` | - | - | [Details](#assets) | | `analytics.yandex.SiteVerificationTag` | string | "XYZabc" | Site Verification Tag for Yandex |
| `cover` | - | - | [Details](#cover) | | `schema` | - | - | [Details](#schema) |
| `profileMode` | - | - | [Details](#profilemode) | | `fuseOpts` | - | - | [Details](#fuseOpts) |
| `editPost` | - | - | [Details](#editPost) | | `socialIcons` | - | - | [Details](#socialIcons) |
| `label` | - | - | [Details](#label) |
| `assets` | - | - | [Details](#assets) |
| `cover` | - | - | [Details](#cover) |
| `profileMode` | - | - | [Details](#profilemode) |
| `editPost` | - | - | [Details](#editPost) |
### Site Variables ### Site Variables
@ -93,11 +98,13 @@ profileMode:
#### assets #### assets
| name | type | example | Description | | name | type | example | Description |
| ------------------------------ | ------- | ------------- | -------------------------------------------- | | -------------------------------- | ------- | ------------- | -------------------------------------------- |
| `assets.favicon` | string | 'icon.ico' | To set favicon, can be path or external link | | `assets.favicon` | string | 'icon.ico' | To set favicon, can be path or external link |
| `assets.disableHLJS` | boolean | true \| false | To disable Highlight.js loading | | `assets.disableHLJS` | boolean | true \| false | To disable Highlight.js loading |
| `assets.disableFingerprinting` | boolean | true \| false | To disable Sub-Resource integrity for assets | | `assets.disableFingerprinting` | boolean | true \| false | To disable Sub-Resource integrity for assets |
| `assets.theme_color` | string | '#color' | To set custom meta theme-color |
| `assets.msapplication_TileColor` | string | '#color' | To set custom msapplication_TileColor |
#### cover #### cover
@ -164,19 +171,28 @@ editPost:
| `comments` | boolean | true \| false | To show/hide comments | | `comments` | boolean | true \| false | To show/hide comments |
| `description` | string | 'description text' | Show Post Description under Title | | `description` | string | 'description text' | Show Post Description under Title |
| `canonicalURL` | string | "https://canonical.url/to/page" | To add canonical URL to posts | | `canonicalURL` | string | "https://canonical.url/to/page" | To add canonical URL to posts |
| `ShowCanonicalLink` | boolean | true \| false | To show canonical URL's hostname |
| `CanonicalLinkText` | string | 'Originally published at' | To show text before canonical URL's hostname |
| `disableShare` | boolean | true \| false | To hide/show share icons under a page | | `disableShare` | boolean | true \| false | To hide/show share icons under a page |
| `disableHLJS` | boolean | true \| false | To disable Highlight.js loading | | `disableHLJS` | boolean | true \| false | To disable Highlight.js loading |
| `disableAnchoredHeadings` | boolean | true \| false | To disable Anchored Headings | | `disableAnchoredHeadings` | boolean | true \| false | To disable Anchored Headings |
| `searchHidden` | boolean | true \| false | Hide page from search | | `searchHidden` | boolean | true \| false | Hide page from search |
| `hideSummary` | boolean | true \| false | To Hide summary being shown in list pages | | `hideSummary` | boolean | true \| false | To Hide summary being shown in list pages |
| `hideFooter` | boolean | true \| false | To Hide Footer Text om the end of page |
| `ShowReadingTime` | boolean | true \| false | To show read time in post meta | | `ShowReadingTime` | boolean | true \| false | To show read time in post meta |
| `ShowBreadCrumbs` | boolean | true \| false | Show BreadCrumb Navigation above single post/page | | `ShowBreadCrumbs` | boolean | true \| false | Show BreadCrumb Navigation above single post/page |
| `ShowPostNavLinks` | boolean | true \| false | Show Previous and Next Posts below a Post | | `ShowPostNavLinks` | boolean | true \| false | Show Previous and Next Posts below a Post |
| `ShowRssButtonInSectionTermList` | boolean | true \| false | To show/hide RSS Copy button in Section and Term list | | `ShowCodeCopyButtons` | boolean | true \| false | To show/hide Code Copy button |
| `author` | string \|list | 'Me' \| ['Me','You'] | To show multiple Authors | | `author` | string \|list | 'Me' \| ['Me','You'] | To show multiple Authors |
| `cover.image` | string | 'featured.jpg' | To add a cover image | | `cover.image` | string | 'featured.jpg' | To add a cover image |
| `cover.caption ` | string | 'caption for image' | To add caption to cover image | | `cover.caption ` | string | 'caption for image' | To add caption to cover image |
| `cover.alt` | string | 'this is cover image' | Alternate text to show if image doesn't load/show up | | `cover.alt` | string | 'this is cover image' | Alternate text to show if image doesn't load/show up |
| `cover.relative` | boolean | true \| false | To use relative path for cover image, used in hugo Page-bundles | | `cover.relative` | boolean | true \| false | To use relative path for cover image, used in hugo Page-bundles |
| `cover.hidden ` | boolean | true \| false | To hide on current single page | | `cover.responsiveImages` | boolean | true \| false | To enable/disable generation of responsive cover images |
| `cover.hidden` | boolean | true \| false | To hide on current single page |
| `weight ` | integer | 5 | To set page order or to pin a post to Top of list | | `weight ` | integer | 5 | To set page order or to pin a post to Top of list |
| `ShareButtons` | list | ["linkedin", "twitter"] | To customize which share buttons to be enabled on page |
| `ShowWordCount` | boolean | true \| false | To word count to metadata |
| `ShowRssButtonInSectionTermList` | boolean | true \| false | To show RSS icon in Section, Term and List pages |
| `UseHugoToc` | boolean | true \| false | To use Hugo's default Toc instead of custom |
| `robotsNoIndex` | boolean | true \| false | To hide a particular page from indexing by search engines |