Update docs upto 1033afc

Aditya Telange 2021-10-30 13:07:13 +05:30
parent 06a6720c54
commit c12676754c
No known key found for this signature in database
GPG Key ID: 82E844EF3DA99E77
8 changed files with 467 additions and 452 deletions

@ -1,10 +1,10 @@
## ToC ## ToC
- [v5.0](#v50) - [v5.0](#v50)
- [v4.0](#v40) - [v4.0](#v40)
- [v3.0](#v30) - [v3.0](#v30)
- [v2.0](#v20) - [v2.0](#v20)
- [v1.0](#v10) - [v1.0](#v10)
--- ---
@ -12,56 +12,56 @@
[Compare v4.0...v5.0](https://github.com/adityatelange/hugo-PaperMod/compare/v4.0...v5.0) [Compare v4.0...v5.0](https://github.com/adityatelange/hugo-PaperMod/compare/v4.0...v5.0)
- Add Feature `ShowPostNavLinks` - shows Prev Next post links on single post page - Add Feature `ShowPostNavLinks` - shows Prev Next post links on single post page
- Add Feature `BreadCrumbNavigation` - adds Breadcrumb navigation above title of single page/post - Add Feature `BreadCrumbNavigation` - adds Breadcrumb navigation above title of single page/post
- Add feature `editPost` - adds option to show link in meta data for editing posts - Add feature `editPost` - adds option to show link in meta data for editing posts
- Add support for `rtl` and `ltr` shortcodes - Add support for `rtl` and `ltr` shortcodes
- Add Translations of `Japanese`, `Hungarian`, `Catalan`, `Uzbek`, `Hebrew`, `Arabic`, `Portuguese` - Add Translations of `Japanese`, `Hungarian`, `Catalan`, `Uzbek`, `Hebrew`, `Arabic`, `Portuguese`
- Add social icons of `snapchat`, `gitea`, `unsplash`, `itchio`, `ctftime` - Add social icons of `snapchat`, `gitea`, `unsplash`, `itchio`, `ctftime`
- Add browser-level lazy-loading of images - Add browser-level lazy-loading of images
- Improve overall design to fit Prev Next post links and remove borders - Improve overall design to fit Prev Next post links and remove borders
- Improve scrollbar styling - Improve scrollbar styling
- Tweak Fuse options for search - Tweak Fuse options for search
- Improve theme changes when JS is disabled - Improve theme changes when JS is disabled
- Fix code highlight when HLJS is disabled - Fix code highlight when HLJS is disabled
- Fix colors in embeded gist - Fix colors in embeded gist
- Fix `...` being shown for smaller summary in posts - Fix `...` being shown for smaller summary in posts
- Update internal templates from hugo - Update internal templates from hugo
- Miscellaneous improvements, fixes and accessibility enhancements - Miscellaneous improvements, fixes and accessibility enhancements
### v4.0 ### v4.0
[Compare v3.0...v4.0](https://github.com/adityatelange/hugo-PaperMod/compare/v3.0...v4.0) [Compare v3.0...v4.0](https://github.com/adityatelange/hugo-PaperMod/compare/v3.0...v4.0)
- Added `AccessKeys` - Added `AccessKeys`
- Improve `theme-switch` logic - Improve `theme-switch` logic
- Port `Anchored Headings` from [Codex](https://github.com/jakewies/hugo-theme-codex) - Port `Anchored Headings` from [Codex](https://github.com/jakewies/hugo-theme-codex)
- Added social-icons for `Discord, Mastodon, Keybase, Ko-Fi, Kakaotalk, Nuget, Reddit` - Added social-icons for `Discord, Mastodon, Keybase, Ko-Fi, Kakaotalk, Nuget, Reddit`
- Update `HLJS to v10.2.1` - Update `HLJS to v10.2.1`
- Added `Search` feature with fuse.js and options to tweak search & keyboard navigation in search results - Added `Search` feature with fuse.js and options to tweak search & keyboard navigation in search results
- Add `emojify` in Language-Switch - Add `emojify` in Language-Switch
- Load stylesheet resource with wildcard - Load stylesheet resource with wildcard
- Unset line-clamp in Home-Info mode, content can be as long as one wants it to be - Unset line-clamp in Home-Info mode, content can be as long as one wants it to be
- Disable indexing website when not in production - Disable indexing website when not in production
- Social-Icons name can match even when case does not match with set name - Social-Icons name can match even when case does not match with set name
- Add option to `disable fingerprinting` - Add option to `disable fingerprinting`
- Add option to `disable highlight.js` - Add option to `disable highlight.js`
- Retain `anchor link '#'` in URL when clicked on anchored headings - Retain `anchor link '#'` in URL when clicked on anchored headings
- Add support for `custom taxonomy URLs` - Add support for `custom taxonomy URLs`
- Add option to hide cover images from list, single but retain in structured-data and share links - Add option to hide cover images from list, single but retain in structured-data and share links
- `Extended css` can be directly added to asset bundle, all .css under `assets/css/extended/` - `Extended css` can be directly added to asset bundle, all .css under `assets/css/extended/`
- Do not smooth-scroll when user has preferred to not - Do not smooth-scroll when user has preferred to not
- Fix `broken anchor Link` scroll for Table of Contents and non-ASCII chars - Fix `broken anchor Link` scroll for Table of Contents and non-ASCII chars
- Fix Lang Name hidden when LanguageName was unset - Fix Lang Name hidden when LanguageName was unset
- Fix scroll-bar track on various conditions - Fix scroll-bar track on various conditions
- Fix menu items overflow instead of horizontal scroll - Fix menu items overflow instead of horizontal scroll
- Fix Trailing slash in menu urls - Fix Trailing slash in menu urls
- Fix figure captions added to Table of Contents - Fix figure captions added to Table of Contents
- Fix embeded gist colored dark - Fix embeded gist colored dark
- Fix wrong load stylesheet and JS on multihost (multilingual) - Fix wrong load stylesheet and JS on multihost (multilingual)
- Fix Go-To-Top button not shown on code-background in light mode - Fix Go-To-Top button not shown on code-background in light mode
- Translations added: Bahasa(id), Italian(it), improvements to german(de) - Translations added: Bahasa(id), Italian(it), improvements to german(de)
- Miscellaneous improvements, fixes and accessibility enhancements - Miscellaneous improvements, fixes and accessibility enhancements
--- ---
@ -69,17 +69,17 @@
[Compare v2.0...v3.0](https://github.com/adityatelange/hugo-PaperMod/compare/v2.0...v3.0) [Compare v2.0...v3.0](https://github.com/adityatelange/hugo-PaperMod/compare/v2.0...v3.0)
- enhanced templates a/c to theme for `social-meta` - enhanced templates a/c to theme for `social-meta`
- add support for `Rich Results` - add support for `Rich Results`
- add option to customize `NavBar Label` - add option to customize `NavBar Label`
- i18n: more translations (thanks to contributors) - i18n: more translations (thanks to contributors)
- add support for `extended_head` and `extended_footer` - add support for `extended_head` and `extended_footer`
- add support for `Right Aligned Text` for multilingual mode - add support for `Right Aligned Text` for multilingual mode
- add support for `responsive cover image` - add support for `responsive cover image`
- add support for `multiple authors` - add support for `multiple authors`
- add automatic `#hashtag` generator for twitter share with `tags` from a post - add automatic `#hashtag` generator for twitter share with `tags` from a post
- add `Language switch`, an improvement to multilingual feature - add `Language switch`, an improvement to multilingual feature
- miscellaneous improvements, fixes and accessibility enhancements - miscellaneous improvements, fixes and accessibility enhancements
--- ---
@ -87,22 +87,22 @@
[Compare v1.0...v2.0](https://github.com/adityatelange/hugo-PaperMod/compare/v1.0...v2.0) [Compare v1.0...v2.0](https://github.com/adityatelange/hugo-PaperMod/compare/v1.0...v2.0)
- added support for `cover image` with captions - added support for `cover image` with captions
- add option to allow `disabling of special 1st post` - add option to allow `disabling of special 1st post`
- improved `taxonomy` pages - improved `taxonomy` pages
- added option to `open toc` by deafult(for each post) - added option to `open toc` by deafult(for each post)
- theme: `automatic` based on browser theme - theme: `automatic` based on browser theme
- update `HLJS to v10.2.0` - update `HLJS to v10.2.0`
- `ToC`: improvements, fixes (custom implementation) - `ToC`: improvements, fixes (custom implementation)
- Archives: improvements - Archives: improvements
- added `Menu Location indicator` - added `Menu Location indicator`
- i18n: more translations (thanks to contributors) - i18n: more translations (thanks to contributors)
- profile-mode: subtitle - profile-mode: subtitle
- added `theme-toggle` to switch between dark and light - added `theme-toggle` to switch between dark and light
- footer: user-defined copyright - footer: user-defined copyright
- `favicon` can be set to custom path - `favicon` can be set to custom path
- comments can be disabled for a page - comments can be disabled for a page
- miscellaneous improvements, fixes and accessibility enhancements - miscellaneous improvements, fixes and accessibility enhancements
--- ---
@ -110,24 +110,24 @@
[Compare ...v1.0](https://github.com/adityatelange/hugo-PaperMod/compare/4330c8b...v1.0) [Compare ...v1.0](https://github.com/adityatelange/hugo-PaperMod/compare/4330c8b...v1.0)
- use of `hugo's asset generator with pipelining` - use of `hugo's asset generator with pipelining`
- asset `fingerprinting`, `bundling` and `minification` by default - asset `fingerprinting`, `bundling` and `minification` by default
- seperated `layouts` and `partials` into more readable parts - seperated `layouts` and `partials` into more readable parts
- separated `css stylesheets` into parts - separated `css stylesheets` into parts
- added `archive` layout - added `archive` layout
- added `Home-Info` Mode - added `Home-Info` Mode
- added `Table of content` genration - added `Table of content` genration
- added `smooth scroll` between in page tags - added `smooth scroll` between in page tags
- added `Taxonomy pages` (tags, categories) - added `Taxonomy pages` (tags, categories)
- added themed `scrollbar` - added themed `scrollbar`
- added `Scroll-to-Top` button - added `Scroll-to-Top` button
- added post `Share` buttons - added post `Share` buttons
- added `draft` page indicator - added `draft` page indicator
- added google siteverification tag vars - added google siteverification tag vars
- add option to disable post meta - add option to disable post meta
- save `menu scroll position` in browser's storage - save `menu scroll position` in browser's storage
- added `Profile-Mode` with buttons - added `Profile-Mode` with buttons
- added `Social Icons` - added `Social Icons`
- updated `HLJS` - updated `HLJS`
- added `multilingual support` - added `multilingual support`
- micellaneous `additions`, `improvements` and `fixes` - micellaneous `additions`, `improvements` and `fixes`

172
FAQs.md

@ -1,25 +1,25 @@
## ToC ## ToC
- [Intro](#intro) - [Intro](#intro)
- [Override theme template](#override-theme-template) - [Override theme template](#override-theme-template)
- [Enable Social-Metadata and SEO](#enable-social-metadata-and-seo) - [Enable Social-Metadata and SEO](#enable-social-metadata-and-seo)
- [Failed to find a valid digest in the 'integrity' attribute for resource ... ?](#failed-to-find-a-valid-digest-in-the-integrity-attribute-for-resource--) - [Failed to find a valid digest in the 'integrity' attribute for resource ... ?](#failed-to-find-a-valid-digest-in-the-integrity-attribute-for-resource--)
- [Bundling Custom css with theme's assets](#bundling-custom-css-with-themes-assets) - [Bundling Custom css with theme's assets](#bundling-custom-css-with-themes-assets)
- [Custom Head / Footer](#custom-head--footer) - [Custom Head / Footer](#custom-head--footer)
- [Add menu to site](#add-menu-to-site) - [Add menu to site](#add-menu-to-site)
- [Pin a Post](#pin-a-post) - [Pin a Post](#pin-a-post)
- [Adding Custom Favicon(s)](#adding-custom-favicons) - [Adding Custom Favicon(s)](#adding-custom-favicons)
- [Centering image in markdown](#centering-image-in-markdown) - [Centering image in markdown](#centering-image-in-markdown)
- [Using Hugo's Syntax highlighter "chroma"](#using-hugos-syntax-highlighter-chroma) - [Using Hugo's Syntax highlighter "chroma"](#using-hugos-syntax-highlighter-chroma)
- [References](#references) - [References](#references)
--- ---
## 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.
--- ---
@ -50,7 +50,7 @@ These include OpenGraph, Twitter Cards and Schema.
```yml ```yml
params: params:
env: production env: production
``` ```
or set `HUGO_ENV` as "production" in system env-vars or set `HUGO_ENV` as "production" in system env-vars
@ -69,21 +69,21 @@ Set the following in `config.yml`
```yml ```yml
params: params:
assets: assets:
disableFingerprinting: true disableFingerprinting: true
``` ```
Linked Issues: Linked Issues:
- https://stackoverflow.com/questions/65056585/hugo-theme-not-loading - https://stackoverflow.com/questions/65056585/hugo-theme-not-loading
- https://stackoverflow.com/questions/65040931/hugo-failed-to-find-a-valid-digest-in-the-integrity-attribute-for-resource - https://stackoverflow.com/questions/65040931/hugo-failed-to-find-a-valid-digest-in-the-integrity-attribute-for-resource
- https://blog.gerardbeckerleg.com/posts/hugo-failed-to-find-a-valid-digest-in-the-integrity-attribute-for-resource/ - https://blog.gerardbeckerleg.com/posts/hugo-failed-to-find-a-valid-digest-in-the-integrity-attribute-for-resource/
--- ---
## Bundling Custom css with theme's assets ## Bundling Custom css with theme's assets
- For adding custom css to be bundled inside one minimized css - For adding custom css to be bundled inside one minimized css
Create folder in yout project directory as Create folder in yout project directory as
@ -105,7 +105,7 @@ All `css` files inside `assets/css/extended` will be bundled !
Linked Issues: Linked Issues:
- [Papermod Theme: How to add custom CSS?](https://discourse.gohugo.io/t/papermod-theme-how-to-add-custom-css/30165) - [Papermod Theme: How to add custom CSS?](https://discourse.gohugo.io/t/papermod-theme-how-to-add-custom-css/30165)
--- ---
@ -142,19 +142,19 @@ To do so, add a `menu` section to your site's `config.yml`:
```yml ```yml
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
``` ```
`name` controls what will be displayed for the menu entry. `name` controls what will be displayed for the menu entry.
@ -177,7 +177,6 @@ title: "My Important post"
date: 2020-09-15T11:30:03+00:00 date: 2020-09-15T11:30:03+00:00
weight: 1 weight: 1
--- ---
``` ```
```yml ```yml
@ -186,7 +185,6 @@ title: "My 2nd Important post"
date: 2020-09-15T11:30:03+00:00 date: 2020-09-15T11:30:03+00:00
weight: 2 weight: 2
--- ---
``` ```
--- ---
@ -196,43 +194,43 @@ weight: 2
We support the following paths under `/static` directory We support the following paths under `/static` directory
and can be added accordingly. and can be added accordingly.
- `favicon.ico` - `favicon.ico`
- `favicon-16x16.png` - `favicon-16x16.png`
- `favicon-32x32.png` - `favicon-32x32.png`
- `apple-touch-icon.png` - `apple-touch-icon.png`
- `safari-pinned-tab.svg` - `safari-pinned-tab.svg`
1. Favicon(s) can be generated by [Favicon.io](https://favicon.io) 1. Favicon(s) can be generated by [Favicon.io](https://favicon.io)
and can be simply put in `/static` folder. and can be simply put in `/static` folder.
2. Other way is to add favicon(s) NOT located in `/static` folder. 2. Other way is to add favicon(s) NOT located in `/static` folder.
In site config add the following: In site config add the following:
``` ```
params: params:
assets: assets:
favicon: "<link / absolute url>" favicon: "<link / absolute url>"
favicon16x16: "<link / absolute url>" favicon16x16: "<link / absolute url>"
favicon32x32: "<link / absolute url>" favicon32x32: "<link / absolute url>"
apple_touch_icon: "<link / absolute url>" apple_touch_icon: "<link / absolute url>"
safari_pinned_tab: "<link / absolute url>" safari_pinned_tab: "<link / absolute url>"
``` ```
- `absolute url` means direct links to external resource: ex. https://web.site/someimage.png - `absolute url` means direct links to external resource: ex. https://web.site/someimage.png
example: example:
``` ```
params: params:
assets: assets:
favicon: "/favicon.ico" favicon: "/favicon.ico"
favicon16x16: "/favicon-16x16.png" favicon16x16: "/favicon-16x16.png"
favicon32x32: "/favicon-32x32.png" favicon32x32: "/favicon-32x32.png"
apple_touch_icon: "/apple-touch-icon.png" apple_touch_icon: "/apple-touch-icon.png"
safari_pinned_tab: "/safari-pinned-tab.svg" safari_pinned_tab: "/safari-pinned-tab.svg"
``` ```
--- ---
@ -260,38 +258,38 @@ ex.
1. Disable Highlight.js in site `config.yml` 1. Disable Highlight.js in site `config.yml`
```yml ```yml
params: params:
assets: assets:
disableHLJS: true disableHLJS: true
``` ```
2. Set hugo's markdown styling in site `config.yml` 2. Set hugo's markdown styling in site `config.yml`
```yml ```yml
markup: markup:
highlight: highlight:
# anchorLineNos: true # anchorLineNos: true
codeFences: true codeFences: true
guessSyntax: true guessSyntax: true
lineNos: true lineNos: true
# noClasses: false # noClasses: false
style: monokai style: monokai
``` ```
3. If you want `lineNos: true`, the background won't be proper. 3. If you want `lineNos: true`, the background won't be proper.
This will only work with `noClasses: false` or `pygmentsUseClasses: true`. This will only work with `noClasses: false` or `pygmentsUseClasses: true`.
Read [Generate Syntax Highlighter CSS](https://gohugo.io/content-management/syntax-highlighting/#generate-syntax-highlighter-css) Read [Generate Syntax Highlighter CSS](https://gohugo.io/content-management/syntax-highlighting/#generate-syntax-highlighter-css)
Add the following to `assets/css/extended/custom.css` Add the following to `assets/css/extended/custom.css`
```css ```css
.chroma { .chroma {
background-color: unset; background-color: unset;
} }
``` ```
More Info : [Configure Markup - Highlight](https://gohugo.io/getting-started/configuration-markup#highlight) More Info : [Configure Markup - Highlight](https://gohugo.io/getting-started/configuration-markup#highlight)
--- ---
@ -315,4 +313,4 @@ xhr.open("GET", "https://example.com/index.json");
## References ## References
- [Override a Hugo theme](https://zwbetz.com/override-a-hugo-theme/) - [Override a Hugo theme](https://zwbetz.com/override-a-hugo-theme/)

@ -206,6 +206,7 @@ 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"
--- ---
``` ```

14
Home.md

@ -13,16 +13,16 @@ Demo Site : https://adityatelange.github.io/hugo-PaperMod/
## Quick Links ## Quick Links
- ### [Install / Update](./Installation) - ### [Install / Update](./Installation)
- ### [Features](./Features) - ### [Features](./Features)
- ### [Icons](./Icons) - ### [Icons](./Icons)
- ### [FAQs](./FAQs) - ### [FAQs](./FAQs)
- ### [Variables](./Variables) - ### [Variables](./Variables)
- ### [Translations](./Translations) - ### [Translations](./Translations)
- ### [ChangeLog](./ChangeLog) - ### [ChangeLog](./ChangeLog)

139
Icons.md

@ -1,68 +1,71 @@
## ToC ## ToC
- [Social Icons](#social-icons) - [Social Icons](#social-icons)
- [Share Icons](#share-icons) - [Share Icons](#share-icons)
## 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 | | `behance` | behance.net |
| 4 | `buymeacoffee` | buymeacoffee.com | | `buymeacoffee` | buymeacoffee.com |
| 5 | `codepen` | codepen.io | | `codepen` | codepen.io |
| 6 | `cryptohack` | cryptohack.org | | `cryptohack` | cryptohack.org |
| 7 | `ctftime` | ctftime.org | | `ctftime` | ctftime.org |
| 8 | `dev` | dev.to | | `dev` | dev.to |
| 9 | `discogs` | discogs.com | | `discogs` | discogs.com |
| 10 | `discord` | discord.com | | `discord` | discord.com |
| 11 | `dreamstime` | dreamstime.com | | `dreamstime` | dreamstime.com |
| 12 | `dribbble` | dribbble.com | | `dribbble` | dribbble.com |
| 13 | `email` | - | | `email` | - |
| 14 | `facebook` | facebook.com | | `facebook` | facebook.com |
| 15 | `flickr` | flickr.com | | `flickr` | flickr.com |
| 16 | `freepik` | freepik.com | | `freepik` | freepik.com |
| 17 | `gitea` | gitea.io | | `gitea` | gitea.io |
| 18 | `github` | github.com | | `github` | github.com |
| 19 | `gitlab` | gitlab.com | | `gitlab` | gitlab.com |
| 20 | `goodreads` | goodreads.com | | `goodreads` | goodreads.com |
| 21 | `hackerone` | hackerone.com | | `googlescholar` | scholar.google.com |
| 22 | `hackerrank` | hackerrank.com | | `hackerone` | hackerone.com |
| 23 | `hackthebox` | hackthebox.eu | | `hackerrank` | hackerrank.com |
| 24 | `instagram` | instagram.com | | `hackthebox` | hackthebox.eu |
| 25 | `itchio` | itch.io | | `instagram` | instagram.com |
| 26 | `kakaotalk` | kakaocorp.com/service/KakaoTalk | | `itchio` | itch.io |
| 27 | `keybase` | keybase.io | | `kakaotalk` | kakaocorp.com/service/KakaoTalk |
| 28 | `kofi` | ko-fi.com | | `keybase` | keybase.io |
| 29 | `lastfm` | last.fm | | `kofi` | ko-fi.com |
| 30 | `liberapay` | liberapay.com | | `lastfm` | last.fm |
| 31 | `linkedin` | linkedin.com | | `liberapay` | liberapay.com |
| 32 | `mastodon` | mastodon.social | | `linkedin` | linkedin.com |
| 33 | `matrix` | matrix.org | | `mastodon` | mastodon.social |
| 34 | `medium` | medium.com | | `matrix` | matrix.org |
| 35 | `mixcloud` | mixcloud.com | | `medium` | medium.com |
| 36 | `nuget` | nuget.org | | `mixcloud` | mixcloud.com |
| 37 | `paypal` | paypal.com | | `nuget` | nuget.org |
| 38 | `qq` | qq.com | | `paypal` | paypal.com |
| 39 | `reddit` | reddit.com | | `qq` | qq.com |
| 40 | `rss` | - | | `reddit` | reddit.com |
| 41 | `serverfault` | serverfault.com | | `researchgate` | researchgate.net |
| 42 | `soundcloud` | soundcloud.com | | `rss` | - |
| 43 | `shutterstock` | shutterstock.com | | `serverfault` | serverfault.com |
| 44 | `slack` | slack.com | | `soundcloud` | soundcloud.com |
| 45 | `snapchat` | snapchat.com/add | | `shutterstock` | shutterstock.com |
| 46 | `sourcerer` | sourcerer.io | | `slack` | slack.com |
| 47 | `spotify` | spotify.com | | `snapchat` | snapchat.com/add |
| 48 | `stackoverflow` | stackoverflow.com | | `sourcerer` | sourcerer.io |
| 49 | `steam` | steampowered.com | | `spotify` | spotify.com |
| 50 | `telegram` | telegram.org | | `stackoverflow` | stackoverflow.com |
| 51 | `twitch` | twitch.tv | | `steam` | steampowered.com |
| 52 | `twitter` | twitter.com | | `telegram` | telegram.org |
| 53 | `unsplash` | unsplash.com | | `twitch` | twitch.tv |
| 54 | `xda` | xda-developers.com | | `twitter` | twitter.com |
| 55 | `youtube` | youtube.com | | `unsplash` | unsplash.com |
| 56 | `other` | - | | `xda` | xda-developers.com |
| `ycombinator` | ycombinator.com |
| `youtube` | youtube.com |
| `other` | - |
Usage : Usage :
@ -78,14 +81,14 @@ socialIcons:
## 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:

@ -1,19 +1,19 @@
## ToC ## ToC
- [Guide](#guide) - [Guide](#guide)
- [Method 1](#method-1) - [Method 1](#method-1)
- [Method 2](#method-2) - [Method 2](#method-2)
- [Method 3](#method-3) - [Method 3](#method-3)
- [Finally ...](#finally-) - [Finally ...](#finally-)
- [Sample config.yml](#sample-configyml) - [Sample config.yml](#sample-configyml)
- [Sample Page.md](#sample-pagemd) - [Sample Page.md](#sample-pagemd)
--- ---
## 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.
--- ---
@ -69,12 +69,12 @@ 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) - [v5.0](https://github.com/adityatelange/hugo-PaperMod/archive/v5.0.zip)
- [v4.0](https://github.com/adityatelange/hugo-PaperMod/archive/v4.0.zip) - [v4.0](https://github.com/adityatelange/hugo-PaperMod/archive/v4.0.zip)
- [v3.0](https://github.com/adityatelange/hugo-PaperMod/archive/v3.0.zip) - [v3.0](https://github.com/adityatelange/hugo-PaperMod/archive/v3.0.zip)
- [v2.0](https://github.com/adityatelange/hugo-PaperMod/archive/v2.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) - [v1.0](https://github.com/adityatelange/hugo-PaperMod/archive/v1.0.zip)
### Finally ... ### Finally ...
@ -88,17 +88,17 @@ theme: "PaperMod"
## Quick Links ## Quick Links
- ### [Features](./Features) - ### [Features](./Features)
- ### [Icons](./Icons) - ### [Icons](./Icons)
- ### [FAQs](./FAQs) - ### [FAQs](./FAQs)
- ### [Variables](./Variables) - ### [Variables](./Variables)
- ### [Translations](./Translations) - ### [Translations](./Translations)
- ### [ChangeLog](./ChangeLog) - ### [ChangeLog](./ChangeLog)
--- ---
@ -122,118 +122,118 @@ buildExpired: false
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
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:

@ -1,34 +1,38 @@
## Languages Supported ## Languages Supported
| Name | ISO Code | Available Translations | | Name | ISO Code | Available Translations |
| ---------- | -------- | ------------------------------------------------------------------------------------------- | | ---------------------------- | -------- | ------------------------------------------------------------------------------------------- |
| Arabic | ar | prev_page, next_page, read_time, toc, translations, home | | Arabic | ar | prev_page, next_page, read_time, toc, translations, home |
| Bulgarian | bg | prev_page, next_page, read_time, toc, translations | | Bulgarian | bg | prev_page, next_page, read_time, toc, translations |
| Bengali | bn | prev_page, next_page, read_time, toc, translations, home, edit_post, code_copy, code_copied | | Bengali | bn | prev_page, next_page, read_time, toc, translations, home, edit_post, code_copy, code_copied |
| Catalan | ca | prev_page, next_page, read_time, toc, translations, home | | Catalan | ca | prev_page, next_page, read_time, toc, translations, home |
| German | de | prev_page, next_page, read_time, toc, translations, edit_post | | Northern and Central Kurdish | ckb | prev_page, next_page, read_time, toc, translations, home, code_copy, code_copied |
| English | en | prev_page, next_page, read_time, toc, translations, home, edit_post, code_copy, code_copied | | Danish | da | prev_page, next_page, read_time, toc, translations, home, edit_post, code_copy, code_copied |
| Esperanto | eo | prev_page, next_page, read_time, toc, translations, home, code_copy, code_copied | | German | de | prev_page, next_page, read_time, toc, translations, edit_post |
| Spanish | es | prev_page, next_page, read_time, toc, translations | | English | en | prev_page, next_page, read_time, toc, translations, home, edit_post, code_copy, code_copied |
| Farsi | fa | prev_page, next_page, read_time, toc, translations | | Esperanto | eo | prev_page, next_page, read_time, toc, translations, home, code_copy, code_copied |
| French | fr | prev_page, next_page | | Spanish | es | prev_page, next_page, read_time, toc, translations |
| Hebrew | he | prev_page, next_page, read_time, toc, translations, home | | Farsi | fa | prev_page, next_page, read_time, toc, translations, home, code_copy, code_copied |
| Hindi | hi | prev_page, next_page, read_time, toc, translations | | French | fr | prev_page, next_page |
| Hungarian | hu | prev_page, next_page, read_time, toc, translations | | Hebrew | he | prev_page, next_page, read_time, toc, translations, home |
| Indonesian | id | prev_page, next_page, read_time, toc, translations | | Hindi | hi | prev_page, next_page, read_time, toc, translations |
| Italian | it | prev_page, next_page, read_time, toc, translations | | Hungarian | hu | prev_page, next_page, read_time, toc, translations |
| Japanese | ja | prev_page, next_page, read_time, toc, translations | | Indonesian | id | prev_page, next_page, read_time, toc, translations |
| Korean | ko | prev_page, next_page | | Italian | it | prev_page, next_page, read_time, toc, translations |
| Mongolian | mn | prev_page, next_page, read_time, toc, translations, home, code_copy, code_copied | | Japanese | ja | prev_page, next_page, read_time, toc, translations, code_copy, code_copied |
| Dutch | nl | prev_page, next_page, read_time, toc, translations, home, edit_post, code_copy, code_copied | | Korean | ko | prev_page, next_page |
| Polish | pl | prev_page, next_page, read_time, toc, translations, home, edit_post, code_copy, code_copied | | Kurdish | ku | prev_page, next_page, read_time, toc, translations, home, code_copy, code_copied |
| Portuguese | pt | prev_page, next_page, read_time, toc, translations | | Mongolian | mn | prev_page, next_page, read_time, toc, translations, home, code_copy, code_copied |
| Russian | ru | prev_page, next_page, read_time, toc, translations | | Dutch | nl | prev_page, next_page, read_time, toc, translations, home, edit_post, code_copy, code_copied |
| Turkish | tr | prev_page, next_page, read_time, toc, translations, home, code_copy, code_copied | | Polish | pl | prev_page, next_page, read_time, toc, translations, home, edit_post, code_copy, code_copied |
| Ukrainian | uk | prev_page, next_page, read_time, toc, translations, home, code_copy, code_copied | | Portuguese | pt | prev_page, next_page, read_time, toc, translations |
| Uzbek | uz | prev_page, next_page, read_time, toc, translations, home | | Russian | ru | prev_page, next_page, read_time, toc, translations |
| Vietnamese | vi | prev_page, next_page, read_time, toc, translations, home, code_copy, code_copied | | Turkish | tr | prev_page, next_page, read_time, toc, translations, home, code_copy, code_copied |
| Chinese | zh | prev_page, next_page, read_time, toc, translations, home, code_copy, code_copied | | Ukrainian | uk | prev_page, next_page, read_time, toc, translations, home, code_copy, code_copied |
| Uzbek | uz | prev_page, next_page, read_time, toc, translations, home |
| Vietnamese | vi | prev_page, next_page, read_time, toc, translations, home, code_copy, code_copied |
| Taiwanese Chinese | zh-tw | rev_page, next_page, read_time, toc, translations, home, code_copy, code_copied |
| Chinese | zh | prev_page, next_page, read_time, toc, translations, home, code_copy, code_copied |
## Want to add your Language ? ## Want to add your Language ?

@ -1,49 +1,52 @@
## ToC ## ToC
- [Site Variables](#site-variables) - [Site Variables](#site-variables)
- [Page Variables](#page-variables) - [Page Variables](#page-variables)
--- ---
### 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 |
| `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 |
| `comments` | boolean | true \| false | To show/hide comments | | `ShareButtons` | list | ["linkedin", "twitter"] | To customize which share buttons to be enabled on page |
| `analytics.google.SiteVerificationTag` | string | "XYZabc" | Site Verification Tag for Google Analytics | | `comments` | boolean | true \| false | To show/hide comments |
| `analytics.bing.SiteVerificationTag` | string | "XYZabc" | Site Verification Tag for Bing | | `hideFooter` | boolean | true \| false | To Hide Footer Text om the end of page |
| `analytics.yandex.SiteVerificationTag` | string | "XYZabc" | Site Verification Tag for Yandex | | `CanonicalLinkText` | string | 'Originally published at' | To show text before canonical URL's hostname |
| `schema` | - | - | [Details](#schema) | | `analytics.google.SiteVerificationTag` | string | "XYZabc" | Site Verification Tag for Google Analytics |
| `fuseOpts` | - | - | [Details](#fuseOpts) | | `analytics.bing.SiteVerificationTag` | string | "XYZabc" | Site Verification Tag for Bing |
| `socialIcons` | - | - | [Details](#socialIcons) | | `analytics.yandex.SiteVerificationTag` | string | "XYZabc" | Site Verification Tag for Yandex |
| `label` | - | - | [Details](#label) | | `schema` | - | - | [Details](#schema) |
| `assets` | - | - | [Details](#assets) | | `fuseOpts` | - | - | [Details](#fuseOpts) |
| `cover` | - | - | [Details](#cover) | | `socialIcons` | - | - | [Details](#socialIcons) |
| `profileMode` | - | - | [Details](#profilemode) | | `label` | - | - | [Details](#label) |
| `editPost` | - | - | [Details](#editPost) | | `assets` | - | - | [Details](#assets) |
| `cover` | - | - | [Details](#cover) |
| `profileMode` | - | - | [Details](#profilemode) |
| `editPost` | - | - | [Details](#editPost) |
### Site Variables ### Site Variables
@ -156,18 +159,24 @@ 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 |
| `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 |