diff --git a/ChangeLog.md b/ChangeLog.md
index e84cfd3..b45ba8c 100644
--- a/ChangeLog.md
+++ b/ChangeLog.md
@@ -1,10 +1,10 @@
## ToC
-- [v5.0](#v50)
-- [v4.0](#v40)
-- [v3.0](#v30)
-- [v2.0](#v20)
-- [v1.0](#v10)
+- [v5.0](#v50)
+- [v4.0](#v40)
+- [v3.0](#v30)
+- [v2.0](#v20)
+- [v1.0](#v10)
---
@@ -12,56 +12,56 @@
[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 `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 support for `rtl` and `ltr` shortcodes
-- Add Translations of `Japanese`, `Hungarian`, `Catalan`, `Uzbek`, `Hebrew`, `Arabic`, `Portuguese`
-- Add social icons of `snapchat`, `gitea`, `unsplash`, `itchio`, `ctftime`
-- Add browser-level lazy-loading of images
-- Improve overall design to fit Prev Next post links and remove borders
-- Improve scrollbar styling
-- Tweak Fuse options for search
-- Improve theme changes when JS is disabled
-- Fix code highlight when HLJS is disabled
-- Fix colors in embeded gist
-- Fix `...` being shown for smaller summary in posts
-- Update internal templates from hugo
-- Miscellaneous improvements, fixes and accessibility enhancements
+- 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 `editPost` - adds option to show link in meta data for editing posts
+- Add support for `rtl` and `ltr` shortcodes
+- Add Translations of `Japanese`, `Hungarian`, `Catalan`, `Uzbek`, `Hebrew`, `Arabic`, `Portuguese`
+- Add social icons of `snapchat`, `gitea`, `unsplash`, `itchio`, `ctftime`
+- Add browser-level lazy-loading of images
+- Improve overall design to fit Prev Next post links and remove borders
+- Improve scrollbar styling
+- Tweak Fuse options for search
+- Improve theme changes when JS is disabled
+- Fix code highlight when HLJS is disabled
+- Fix colors in embeded gist
+- Fix `...` being shown for smaller summary in posts
+- Update internal templates from hugo
+- Miscellaneous improvements, fixes and accessibility enhancements
### v4.0
[Compare v3.0...v4.0](https://github.com/adityatelange/hugo-PaperMod/compare/v3.0...v4.0)
-- Added `AccessKeys`
-- Improve `theme-switch` logic
-- Port `Anchored Headings` from [Codex](https://github.com/jakewies/hugo-theme-codex)
-- Added social-icons for `Discord, Mastodon, Keybase, Ko-Fi, Kakaotalk, Nuget, Reddit`
-- Update `HLJS to v10.2.1`
-- Added `Search` feature with fuse.js and options to tweak search & keyboard navigation in search results
-- Add `emojify` in Language-Switch
-- Load stylesheet resource with wildcard
-- 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
-- Social-Icons name can match even when case does not match with set name
-- Add option to `disable fingerprinting`
-- Add option to `disable highlight.js`
-- Retain `anchor link '#'` in URL when clicked on anchored headings
-- Add support for `custom taxonomy URLs`
-- 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/`
-- Do not smooth-scroll when user has preferred to not
-- Fix `broken anchor Link` scroll for Table of Contents and non-ASCII chars
-- Fix Lang Name hidden when LanguageName was unset
-- Fix scroll-bar track on various conditions
-- Fix menu items overflow instead of horizontal scroll
-- Fix Trailing slash in menu urls
-- Fix figure captions added to Table of Contents
-- Fix embeded gist colored dark
-- Fix wrong load stylesheet and JS on multihost (multilingual)
-- Fix Go-To-Top button not shown on code-background in light mode
-- Translations added: Bahasa(id), Italian(it), improvements to german(de)
-- Miscellaneous improvements, fixes and accessibility enhancements
+- Added `AccessKeys`
+- Improve `theme-switch` logic
+- Port `Anchored Headings` from [Codex](https://github.com/jakewies/hugo-theme-codex)
+- Added social-icons for `Discord, Mastodon, Keybase, Ko-Fi, Kakaotalk, Nuget, Reddit`
+- Update `HLJS to v10.2.1`
+- Added `Search` feature with fuse.js and options to tweak search & keyboard navigation in search results
+- Add `emojify` in Language-Switch
+- Load stylesheet resource with wildcard
+- 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
+- Social-Icons name can match even when case does not match with set name
+- Add option to `disable fingerprinting`
+- Add option to `disable highlight.js`
+- Retain `anchor link '#'` in URL when clicked on anchored headings
+- Add support for `custom taxonomy URLs`
+- 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/`
+- Do not smooth-scroll when user has preferred to not
+- Fix `broken anchor Link` scroll for Table of Contents and non-ASCII chars
+- Fix Lang Name hidden when LanguageName was unset
+- Fix scroll-bar track on various conditions
+- Fix menu items overflow instead of horizontal scroll
+- Fix Trailing slash in menu urls
+- Fix figure captions added to Table of Contents
+- Fix embeded gist colored dark
+- Fix wrong load stylesheet and JS on multihost (multilingual)
+- Fix Go-To-Top button not shown on code-background in light mode
+- Translations added: Bahasa(id), Italian(it), improvements to german(de)
+- 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)
-- enhanced templates a/c to theme for `social-meta`
-- add support for `Rich Results`
-- add option to customize `NavBar Label`
-- i18n: more translations (thanks to contributors)
-- add support for `extended_head` and `extended_footer`
-- add support for `Right Aligned Text` for multilingual mode
-- add support for `responsive cover image`
-- add support for `multiple authors`
-- add automatic `#hashtag` generator for twitter share with `tags` from a post
-- add `Language switch`, an improvement to multilingual feature
-- miscellaneous improvements, fixes and accessibility enhancements
+- enhanced templates a/c to theme for `social-meta`
+- add support for `Rich Results`
+- add option to customize `NavBar Label`
+- i18n: more translations (thanks to contributors)
+- add support for `extended_head` and `extended_footer`
+- add support for `Right Aligned Text` for multilingual mode
+- add support for `responsive cover image`
+- add support for `multiple authors`
+- add automatic `#hashtag` generator for twitter share with `tags` from a post
+- add `Language switch`, an improvement to multilingual feature
+- 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)
-- added support for `cover image` with captions
-- add option to allow `disabling of special 1st post`
-- improved `taxonomy` pages
-- added option to `open toc` by deafult(for each post)
-- theme: `automatic` based on browser theme
-- update `HLJS to v10.2.0`
-- `ToC`: improvements, fixes (custom implementation)
-- Archives: improvements
-- added `Menu Location indicator`
-- i18n: more translations (thanks to contributors)
-- profile-mode: subtitle
-- added `theme-toggle` to switch between dark and light
-- footer: user-defined copyright
-- `favicon` can be set to custom path
-- comments can be disabled for a page
-- miscellaneous improvements, fixes and accessibility enhancements
+- added support for `cover image` with captions
+- add option to allow `disabling of special 1st post`
+- improved `taxonomy` pages
+- added option to `open toc` by deafult(for each post)
+- theme: `automatic` based on browser theme
+- update `HLJS to v10.2.0`
+- `ToC`: improvements, fixes (custom implementation)
+- Archives: improvements
+- added `Menu Location indicator`
+- i18n: more translations (thanks to contributors)
+- profile-mode: subtitle
+- added `theme-toggle` to switch between dark and light
+- footer: user-defined copyright
+- `favicon` can be set to custom path
+- comments can be disabled for a page
+- miscellaneous improvements, fixes and accessibility enhancements
---
@@ -110,24 +110,24 @@
[Compare ...v1.0](https://github.com/adityatelange/hugo-PaperMod/compare/4330c8b...v1.0)
-- use of `hugo's asset generator with pipelining`
-- asset `fingerprinting`, `bundling` and `minification` by default
-- seperated `layouts` and `partials` into more readable parts
-- separated `css stylesheets` into parts
-- added `archive` layout
-- added `Home-Info` Mode
-- added `Table of content` genration
-- added `smooth scroll` between in page tags
-- added `Taxonomy pages` (tags, categories)
-- added themed `scrollbar`
-- added `Scroll-to-Top` button
-- added post `Share` buttons
-- added `draft` page indicator
-- added google siteverification tag vars
-- add option to disable post meta
-- save `menu scroll position` in browser's storage
-- added `Profile-Mode` with buttons
-- added `Social Icons`
-- updated `HLJS`
-- added `multilingual support`
-- micellaneous `additions`, `improvements` and `fixes`
+- use of `hugo's asset generator with pipelining`
+- asset `fingerprinting`, `bundling` and `minification` by default
+- seperated `layouts` and `partials` into more readable parts
+- separated `css stylesheets` into parts
+- added `archive` layout
+- added `Home-Info` Mode
+- added `Table of content` genration
+- added `smooth scroll` between in page tags
+- added `Taxonomy pages` (tags, categories)
+- added themed `scrollbar`
+- added `Scroll-to-Top` button
+- added post `Share` buttons
+- added `draft` page indicator
+- added google siteverification tag vars
+- add option to disable post meta
+- save `menu scroll position` in browser's storage
+- added `Profile-Mode` with buttons
+- added `Social Icons`
+- updated `HLJS`
+- added `multilingual support`
+- micellaneous `additions`, `improvements` and `fixes`
diff --git a/FAQs.md b/FAQs.md
index 652c67f..8f15253 100644
--- a/FAQs.md
+++ b/FAQs.md
@@ -1,25 +1,25 @@
## ToC
-- [Intro](#intro)
-- [Override theme template](#override-theme-template)
-- [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--)
-- [Bundling Custom css with theme's assets](#bundling-custom-css-with-themes-assets)
-- [Custom Head / Footer](#custom-head--footer)
-- [Add menu to site](#add-menu-to-site)
-- [Pin a Post](#pin-a-post)
-- [Adding Custom Favicon(s)](#adding-custom-favicons)
-- [Centering image in markdown](#centering-image-in-markdown)
-- [Using Hugo's Syntax highlighter "chroma"](#using-hugos-syntax-highlighter-chroma)
-- [References](#references)
+- [Intro](#intro)
+- [Override theme template](#override-theme-template)
+- [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--)
+- [Bundling Custom css with theme's assets](#bundling-custom-css-with-themes-assets)
+- [Custom Head / Footer](#custom-head--footer)
+- [Add menu to site](#add-menu-to-site)
+- [Pin a Post](#pin-a-post)
+- [Adding Custom Favicon(s)](#adding-custom-favicons)
+- [Centering image in markdown](#centering-image-in-markdown)
+- [Using Hugo's Syntax highlighter "chroma"](#using-hugos-syntax-highlighter-chroma)
+- [References](#references)
---
## 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
params:
- env: production
+ env: production
```
or set `HUGO_ENV` as "production" in system env-vars
@@ -69,21 +69,21 @@ Set the following in `config.yml`
```yml
params:
- assets:
- disableFingerprinting: true
+ assets:
+ disableFingerprinting: true
```
Linked Issues:
-- 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://blog.gerardbeckerleg.com/posts/hugo-failed-to-find-a-valid-digest-in-the-integrity-attribute-for-resource/
+- 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://blog.gerardbeckerleg.com/posts/hugo-failed-to-find-a-valid-digest-in-the-integrity-attribute-for-resource/
---
## 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
@@ -105,7 +105,7 @@ All `css` files inside `assets/css/extended` will be bundled !
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
menu:
- main:
- - identifier: categories
- name: categories
- url: /categories/
- weight: 10
- - identifier: tags
- name: tags
- url: /tags/
- weight: 20
- - identifier: example
- name: example.org
- url: https://example.org
- weight: 30
+ main:
+ - identifier: categories
+ name: categories
+ url: /categories/
+ weight: 10
+ - identifier: tags
+ name: tags
+ url: /tags/
+ weight: 20
+ - identifier: example
+ name: example.org
+ url: https://example.org
+ weight: 30
```
`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
weight: 1
---
-
```
```yml
@@ -186,7 +185,6 @@ title: "My 2nd Important post"
date: 2020-09-15T11:30:03+00:00
weight: 2
---
-
```
---
@@ -196,43 +194,43 @@ weight: 2
We support the following paths under `/static` directory
and can be added accordingly.
-- `favicon.ico`
-- `favicon-16x16.png`
-- `favicon-32x32.png`
-- `apple-touch-icon.png`
-- `safari-pinned-tab.svg`
+- `favicon.ico`
+- `favicon-16x16.png`
+- `favicon-32x32.png`
+- `apple-touch-icon.png`
+- `safari-pinned-tab.svg`
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.
- In site config add the following:
+ In site config add the following:
- ```
- params:
- assets:
- favicon: ""
- favicon16x16: ""
- favicon32x32: ""
- apple_touch_icon: ""
- safari_pinned_tab: ""
- ```
+ ```
+ params:
+ assets:
+ favicon: ""
+ favicon16x16: ""
+ favicon32x32: ""
+ apple_touch_icon: ""
+ safari_pinned_tab: ""
+ ```
- - `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:
- assets:
- favicon: "/favicon.ico"
- favicon16x16: "/favicon-16x16.png"
- favicon32x32: "/favicon-32x32.png"
- apple_touch_icon: "/apple-touch-icon.png"
- safari_pinned_tab: "/safari-pinned-tab.svg"
- ```
+ ```
+ params:
+ assets:
+ favicon: "/favicon.ico"
+ favicon16x16: "/favicon-16x16.png"
+ favicon32x32: "/favicon-32x32.png"
+ apple_touch_icon: "/apple-touch-icon.png"
+ safari_pinned_tab: "/safari-pinned-tab.svg"
+ ```
---
@@ -260,38 +258,38 @@ ex.
1. Disable Highlight.js in site `config.yml`
- ```yml
- params:
- assets:
- disableHLJS: true
- ```
+ ```yml
+ params:
+ assets:
+ disableHLJS: true
+ ```
2. Set hugo's markdown styling in site `config.yml`
- ```yml
- markup:
- highlight:
- # anchorLineNos: true
- codeFences: true
- guessSyntax: true
- lineNos: true
- # noClasses: false
- style: monokai
- ```
+ ```yml
+ markup:
+ highlight:
+ # anchorLineNos: true
+ codeFences: true
+ guessSyntax: true
+ lineNos: true
+ # noClasses: false
+ style: monokai
+ ```
3. If you want `lineNos: true`, the background won't be proper.
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)
- Add the following to `assets/css/extended/custom.css`
+ Add the following to `assets/css/extended/custom.css`
- ```css
- .chroma {
- background-color: unset;
- }
- ```
+ ```css
+ .chroma {
+ 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
-- [Override a Hugo theme](https://zwbetz.com/override-a-hugo-theme/)
+- [Override a Hugo theme](https://zwbetz.com/override-a-hugo-theme/)
diff --git a/Features.md b/Features.md
index f7ac1d2..0be8d16 100644
--- a/Features.md
+++ b/Features.md
@@ -206,6 +206,7 @@ layout: "search" # is necessary
# url: "/archive"
# description: "Description for Search"
summary: "search"
+placeholder: "placeholder text in search input box"
---
```
diff --git a/Home.md b/Home.md
index 521388b..5a9e9f6 100644
--- a/Home.md
+++ b/Home.md
@@ -13,16 +13,16 @@ Demo Site : https://adityatelange.github.io/hugo-PaperMod/
## 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)
diff --git a/Icons.md b/Icons.md
index c9b6a77..ff024e1 100644
--- a/Icons.md
+++ b/Icons.md
@@ -1,68 +1,71 @@
## ToC
-- [Social Icons](#social-icons)
-- [Share Icons](#share-icons)
+- [Social Icons](#social-icons)
+- [Share Icons](#share-icons)
## Social Icons
-| No. | Name | Platform Link |
-| --- | --------------- | ------------------------------- |
-| 1 | `123rf` | 123rf.com |
-| 2 | `adobestock` | stock.adobe.com |
-| 3 | `behance` | behance.net |
-| 4 | `buymeacoffee` | buymeacoffee.com |
-| 5 | `codepen` | codepen.io |
-| 6 | `cryptohack` | cryptohack.org |
-| 7 | `ctftime` | ctftime.org |
-| 8 | `dev` | dev.to |
-| 9 | `discogs` | discogs.com |
-| 10 | `discord` | discord.com |
-| 11 | `dreamstime` | dreamstime.com |
-| 12 | `dribbble` | dribbble.com |
-| 13 | `email` | - |
-| 14 | `facebook` | facebook.com |
-| 15 | `flickr` | flickr.com |
-| 16 | `freepik` | freepik.com |
-| 17 | `gitea` | gitea.io |
-| 18 | `github` | github.com |
-| 19 | `gitlab` | gitlab.com |
-| 20 | `goodreads` | goodreads.com |
-| 21 | `hackerone` | hackerone.com |
-| 22 | `hackerrank` | hackerrank.com |
-| 23 | `hackthebox` | hackthebox.eu |
-| 24 | `instagram` | instagram.com |
-| 25 | `itchio` | itch.io |
-| 26 | `kakaotalk` | kakaocorp.com/service/KakaoTalk |
-| 27 | `keybase` | keybase.io |
-| 28 | `kofi` | ko-fi.com |
-| 29 | `lastfm` | last.fm |
-| 30 | `liberapay` | liberapay.com |
-| 31 | `linkedin` | linkedin.com |
-| 32 | `mastodon` | mastodon.social |
-| 33 | `matrix` | matrix.org |
-| 34 | `medium` | medium.com |
-| 35 | `mixcloud` | mixcloud.com |
-| 36 | `nuget` | nuget.org |
-| 37 | `paypal` | paypal.com |
-| 38 | `qq` | qq.com |
-| 39 | `reddit` | reddit.com |
-| 40 | `rss` | - |
-| 41 | `serverfault` | serverfault.com |
-| 42 | `soundcloud` | soundcloud.com |
-| 43 | `shutterstock` | shutterstock.com |
-| 44 | `slack` | slack.com |
-| 45 | `snapchat` | snapchat.com/add |
-| 46 | `sourcerer` | sourcerer.io |
-| 47 | `spotify` | spotify.com |
-| 48 | `stackoverflow` | stackoverflow.com |
-| 49 | `steam` | steampowered.com |
-| 50 | `telegram` | telegram.org |
-| 51 | `twitch` | twitch.tv |
-| 52 | `twitter` | twitter.com |
-| 53 | `unsplash` | unsplash.com |
-| 54 | `xda` | xda-developers.com |
-| 55 | `youtube` | youtube.com |
-| 56 | `other` | - |
+| Name | Platform Link |
+| --------------- | ------------------------------- |
+| `123rf` | 123rf.com |
+| `adobestock` | stock.adobe.com |
+| `behance` | behance.net |
+| `buymeacoffee` | buymeacoffee.com |
+| `codepen` | codepen.io |
+| `cryptohack` | cryptohack.org |
+| `ctftime` | ctftime.org |
+| `dev` | dev.to |
+| `discogs` | discogs.com |
+| `discord` | discord.com |
+| `dreamstime` | dreamstime.com |
+| `dribbble` | dribbble.com |
+| `email` | - |
+| `facebook` | facebook.com |
+| `flickr` | flickr.com |
+| `freepik` | freepik.com |
+| `gitea` | gitea.io |
+| `github` | github.com |
+| `gitlab` | gitlab.com |
+| `goodreads` | goodreads.com |
+| `googlescholar` | scholar.google.com |
+| `hackerone` | hackerone.com |
+| `hackerrank` | hackerrank.com |
+| `hackthebox` | hackthebox.eu |
+| `instagram` | instagram.com |
+| `itchio` | itch.io |
+| `kakaotalk` | kakaocorp.com/service/KakaoTalk |
+| `keybase` | keybase.io |
+| `kofi` | ko-fi.com |
+| `lastfm` | last.fm |
+| `liberapay` | liberapay.com |
+| `linkedin` | linkedin.com |
+| `mastodon` | mastodon.social |
+| `matrix` | matrix.org |
+| `medium` | medium.com |
+| `mixcloud` | mixcloud.com |
+| `nuget` | nuget.org |
+| `paypal` | paypal.com |
+| `qq` | qq.com |
+| `reddit` | reddit.com |
+| `researchgate` | researchgate.net |
+| `rss` | - |
+| `serverfault` | serverfault.com |
+| `soundcloud` | soundcloud.com |
+| `shutterstock` | shutterstock.com |
+| `slack` | slack.com |
+| `snapchat` | snapchat.com/add |
+| `sourcerer` | sourcerer.io |
+| `spotify` | spotify.com |
+| `stackoverflow` | stackoverflow.com |
+| `steam` | steampowered.com |
+| `telegram` | telegram.org |
+| `twitch` | twitch.tv |
+| `twitter` | twitter.com |
+| `unsplash` | unsplash.com |
+| `xda` | xda-developers.com |
+| `ycombinator` | ycombinator.com |
+| `youtube` | youtube.com |
+| `other` | - |
Usage :
@@ -78,14 +81,14 @@ socialIcons:
## Share Icons
-| No. | Platform |
-| --- | --------------------------------------------------------------- |
-| 1 | `twitter` (also generates hash tags from tags linked with post) |
-| 2 | `linkedin` |
-| 3 | `reddit` |
-| 4 | `facebook` |
-| 5 | `whatsapp` |
-| 6 | `telegram` |
+| No. | Platform |
+| --------------------------------------------------------------- | -------- |
+| `twitter` (also generates hash tags from tags linked with post) |
+| `linkedin` |
+| `reddit` |
+| `facebook` |
+| `whatsapp` |
+| `telegram` |
Usage:
diff --git a/Installation.md b/Installation.md
index e44d021..cff4fd7 100644
--- a/Installation.md
+++ b/Installation.md
@@ -1,19 +1,19 @@
## ToC
-- [Guide](#guide)
- - [Method 1](#method-1)
- - [Method 2](#method-2)
- - [Method 3](#method-3)
- - [Finally ...](#finally-)
-- [Sample config.yml](#sample-configyml)
-- [Sample Page.md](#sample-pagemd)
+- [Guide](#guide)
+ - [Method 1](#method-1)
+ - [Method 2](#method-2)
+ - [Method 3](#method-3)
+ - [Finally ...](#finally-)
+- [Sample config.yml](#sample-configyml)
+- [Sample Page.md](#sample-pagemd)
---
## 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.**
-- You can find any [YML to TOML](https://www.google.com/search?q=yml+to+toml) converters if necessary.
+- **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.
---
@@ -69,12 +69,12 @@ Or you can Download as Zip from Github Page and extract in your themes directory
Direct Links:
-- [Master Branch (Latest)](https://github.com/adityatelange/hugo-PaperMod/archive/master.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)
-- [v3.0](https://github.com/adityatelange/hugo-PaperMod/archive/v3.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)
+- [Master Branch (Latest)](https://github.com/adityatelange/hugo-PaperMod/archive/master.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)
+- [v3.0](https://github.com/adityatelange/hugo-PaperMod/archive/v3.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 ...
@@ -88,17 +88,17 @@ theme: "PaperMod"
## 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
minify:
- disableXML: true
- minifyOutput: true
+ disableXML: true
+ minifyOutput: true
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: [""]
+ 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: ""
+ favicon16x16: ""
+ favicon32x32: ""
+ apple_touch_icon: ""
+ safari_pinned_tab: ""
+
+ label:
+ text: "Home"
+ icon: /apple-touch-icon.png
+ iconHeight: 35
+
+ # profile-mode
+ profileMode:
+ enabled: false # needs to be explicitly set
title: ExampleSite
- description: "ExampleSite description"
- keywords: [Blog, Portfolio, PaperMod]
- author: Me
- # author: ["Me", "You"] # multiple authors
- images: [""]
- DateFormat: "January 2, 2006"
- defaultTheme: auto # dark, light
- disableThemeToggle: false
+ subtitle: "This is subtitle"
+ imageUrl: "![]()
"
+ imageWidth: 120
+ imageHeight: 120
+ imageTitle: my image
+ buttons:
+ - name: Posts
+ url: posts
+ - name: Tags
+ url: tags
- ShowReadingTime: true
- ShowShareButtons: true
- ShowPostNavLinks: true
- ShowBreadCrumbs: true
- ShowCodeCopyButtons: false
- disableSpecial1stPost: false
- disableScrollToTop: false
- comments: false
- hidemeta: false
- hideSummary: false
- showtoc: false
- tocopen: false
+ # home-info mode
+ homeInfoParams:
+ Title: "Hi there \U0001F44B"
+ Content: Welcome to my blog
- assets:
- # disableHLJS: true # to disable highlight.js
- # disableFingerprinting: true
- favicon: ""
- favicon16x16: ""
- favicon32x32: ""
- apple_touch_icon: ""
- safari_pinned_tab: ""
+ socialIcons:
+ - name: twitter
+ url: "https://twitter.com/"
+ - name: stackoverflow
+ url: "https://stackoverflow.com"
+ - name: github
+ url: "https://github.com/"
- label:
- text: "Home"
- icon: /apple-touch-icon.png
- iconHeight: 35
+ analytics:
+ google:
+ SiteVerificationTag: "XYZabc"
+ bing:
+ SiteVerificationTag: "XYZabc"
+ yandex:
+ SiteVerificationTag: "XYZabc"
- # profile-mode
- profileMode:
- enabled: false # needs to be explicitly set
- title: ExampleSite
- subtitle: "This is subtitle"
- imageUrl: "![]()
"
- imageWidth: 120
- imageHeight: 120
- imageTitle: my image
- buttons:
- - name: Posts
- url: posts
- - name: Tags
- url: tags
+ cover:
+ hidden: true # hide everywhere but not in structured data
+ hiddenInList: true # hide on list pages and home
+ hiddenInSingle: true # hide on single page
- # home-info mode
- homeInfoParams:
- Title: "Hi there \U0001F44B"
- Content: Welcome to my blog
+ editPost:
+ URL: "https://github.com//content"
+ Text: "Suggest Changes" # edit text
+ appendFilePath: true # to append file path to Edit link
- socialIcons:
- - name: twitter
- url: "https://twitter.com/"
- - name: stackoverflow
- url: "https://stackoverflow.com"
- - name: github
- url: "https://github.com/"
-
- analytics:
- google:
- 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//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"]
+ # 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:
- main:
- - identifier: categories
- name: categories
- url: /categories/
- weight: 10
- - identifier: tags
- name: tags
- url: /tags/
- weight: 20
- - identifier: example
- name: example.org
- url: https://example.org
- weight: 30
+ main:
+ - identifier: categories
+ name: categories
+ url: /categories/
+ weight: 10
+ - identifier: tags
+ name: tags
+ url: /tags/
+ weight: 20
+ - identifier: example
+ name: example.org
+ url: https://example.org
+ weight: 30
# Read: https://github.com/adityatelange/hugo-PaperMod/wiki/FAQs#using-hugos-syntax-highlighter-chroma
# pygmentsUseClasses: true
# markup:
diff --git a/Translations.md b/Translations.md
index 3adbf16..2a41716 100644
--- a/Translations.md
+++ b/Translations.md
@@ -1,34 +1,38 @@
## Languages Supported
-| Name | ISO Code | Available Translations |
-| ---------- | -------- | ------------------------------------------------------------------------------------------- |
-| Arabic | ar | prev_page, next_page, read_time, toc, translations, home |
-| 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 |
-| Catalan | ca | prev_page, next_page, read_time, toc, translations, home |
-| German | de | prev_page, next_page, read_time, toc, translations, edit_post |
-| English | en | 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 |
-| Spanish | es | prev_page, next_page, read_time, toc, translations |
-| Farsi | fa | prev_page, next_page, read_time, toc, translations |
-| French | fr | prev_page, next_page |
-| Hebrew | he | prev_page, next_page, read_time, toc, translations, home |
-| Hindi | hi | prev_page, next_page, read_time, toc, translations |
-| Hungarian | hu | prev_page, next_page, read_time, toc, translations |
-| Indonesian | id | prev_page, next_page, read_time, toc, translations |
-| Italian | it | prev_page, next_page, read_time, toc, translations |
-| Japanese | ja | prev_page, next_page, read_time, toc, translations |
-| Korean | ko | prev_page, next_page |
-| Mongolian | mn | prev_page, next_page, read_time, toc, translations, home, code_copy, code_copied |
-| Dutch | nl | prev_page, next_page, read_time, toc, translations, home, edit_post, code_copy, code_copied |
-| Polish | pl | prev_page, next_page, read_time, toc, translations, home, edit_post, code_copy, code_copied |
-| Portuguese | pt | prev_page, next_page, read_time, toc, translations |
-| Russian | ru | prev_page, next_page, read_time, toc, translations |
-| Turkish | tr | 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 |
-| Chinese | zh | prev_page, next_page, read_time, toc, translations, home, code_copy, code_copied |
+| Name | ISO Code | Available Translations |
+| ---------------------------- | -------- | ------------------------------------------------------------------------------------------- |
+| Arabic | ar | prev_page, next_page, read_time, toc, translations, home |
+| 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 |
+| Catalan | ca | prev_page, next_page, read_time, toc, translations, home |
+| Northern and Central Kurdish | ckb | prev_page, next_page, read_time, toc, translations, home, code_copy, code_copied |
+| Danish | da | prev_page, next_page, read_time, toc, translations, home, edit_post, code_copy, code_copied |
+| German | de | prev_page, next_page, read_time, toc, translations, edit_post |
+| English | en | 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 |
+| Spanish | es | prev_page, next_page, read_time, toc, translations |
+| Farsi | fa | prev_page, next_page, read_time, toc, translations, home, code_copy, code_copied |
+| French | fr | prev_page, next_page |
+| Hebrew | he | prev_page, next_page, read_time, toc, translations, home |
+| Hindi | hi | prev_page, next_page, read_time, toc, translations |
+| Hungarian | hu | prev_page, next_page, read_time, toc, translations |
+| Indonesian | id | prev_page, next_page, read_time, toc, translations |
+| Italian | it | prev_page, next_page, read_time, toc, translations |
+| Japanese | ja | prev_page, next_page, read_time, toc, translations, code_copy, code_copied |
+| Korean | ko | prev_page, next_page |
+| Kurdish | ku | prev_page, next_page, read_time, toc, translations, home, code_copy, code_copied |
+| Mongolian | mn | prev_page, next_page, read_time, toc, translations, home, code_copy, code_copied |
+| Dutch | nl | prev_page, next_page, read_time, toc, translations, home, edit_post, code_copy, code_copied |
+| Polish | pl | prev_page, next_page, read_time, toc, translations, home, edit_post, code_copy, code_copied |
+| Portuguese | pt | prev_page, next_page, read_time, toc, translations |
+| Russian | ru | prev_page, next_page, read_time, toc, translations |
+| Turkish | tr | 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 ?
diff --git a/Variables.md b/Variables.md
index 267fce1..ac20860 100644
--- a/Variables.md
+++ b/Variables.md
@@ -1,49 +1,52 @@
## ToC
-- [Site Variables](#site-variables)
-- [Page Variables](#page-variables)
+- [Site Variables](#site-variables)
+- [Page Variables](#page-variables)
---
### Site Variables under `Params`
-| name | type | example | Description |
-| -------------------------------------- | ------------- | ------------------------ | ----------------------------------------------------------------------------------------- |
-| `env` | string | 'production' | To set env to production |
-| `title` | string | 'My Blog' | To set title |
-| `description` | string | 'This is a blog of mine' | To set site description |
-| `author` | string \|list | 'Me' \| ['Me','You'] | To show multiple Authors |
-| `images` | string | 'myimage.png' | Link or path of image for opengraph, twitter-cards |
-| `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/) |
-| `languageAltTitle` | string | "English" | Alternate title in Multilingual Mode |
-| `ShowReadingTime` | boolean | true \| false | To show read time in post meta |
-| `ShowShareButtons` | boolean | true \| false | To show/hide share buttons under post |
-| `ShowCodeCopyButtons` | boolean | true \| false | To show/hide Code Copy button |
-| `ShowFullTextinRSS` | boolean | true \| false | To show Content in RSS feed |
-| `defaultTheme` | string | light \| dark \| auto | To set default theme |
-| `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 |
-| `disableScrollToTop` | boolean | true \| false | To disable ScrollToTop button |
-| `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 |
-| `hideSummary` | boolean | true \| false | To Hide summary being shown in list pages |
-| `showtoc` | boolean | true \| false | To show/hide Table of Contents |
-| `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 |
-| `ShowBreadCrumbs` | boolean | true \| false | Show BreadCrumb Navigation above single post/page |
-| `comments` | boolean | true \| false | To show/hide comments |
-| `analytics.google.SiteVerificationTag` | string | "XYZabc" | Site Verification Tag for Google Analytics |
-| `analytics.bing.SiteVerificationTag` | string | "XYZabc" | Site Verification Tag for Bing |
-| `analytics.yandex.SiteVerificationTag` | string | "XYZabc" | Site Verification Tag for Yandex |
-| `schema` | - | - | [Details](#schema) |
-| `fuseOpts` | - | - | [Details](#fuseOpts) |
-| `socialIcons` | - | - | [Details](#socialIcons) |
-| `label` | - | - | [Details](#label) |
-| `assets` | - | - | [Details](#assets) |
-| `cover` | - | - | [Details](#cover) |
-| `profileMode` | - | - | [Details](#profilemode) |
-| `editPost` | - | - | [Details](#editPost) |
+| name | type | example | Description |
+| -------------------------------------- | ------------- | ------------------------- | ----------------------------------------------------------------------------------------- |
+| `env` | string | 'production' | To set env to production |
+| `title` | string | 'My Blog' | To set title |
+| `description` | string | 'This is a blog of mine' | To set site description |
+| `author` | string \|list | 'Me' \| ['Me','You'] | To show multiple Authors |
+| `images` | string | 'myimage.png' | Link or path of image for opengraph, twitter-cards |
+| `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/) |
+| `languageAltTitle` | string | "English" | Alternate title in Multilingual Mode |
+| `ShowReadingTime` | boolean | true \| false | To show read time in post meta |
+| `ShowShareButtons` | boolean | true \| false | To show/hide share buttons under post |
+| `ShowCodeCopyButtons` | boolean | true \| false | To show/hide Code Copy button |
+| `ShowFullTextinRSS` | boolean | true \| false | To show Content in RSS feed |
+| `defaultTheme` | string | light \| dark \| auto | To set default theme |
+| `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 |
+| `disableScrollToTop` | boolean | true \| false | To disable ScrollToTop button |
+| `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 |
+| `hideSummary` | boolean | true \| false | To Hide summary being shown in list pages |
+| `showtoc` | boolean | true \| false | To show/hide Table of Contents |
+| `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 |
+| `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 |
+| `hideFooter` | boolean | true \| false | To Hide Footer Text om the end of page |
+| `CanonicalLinkText` | string | 'Originally published at' | To show text before canonical URL's hostname |
+| `analytics.google.SiteVerificationTag` | string | "XYZabc" | Site Verification Tag for Google Analytics |
+| `analytics.bing.SiteVerificationTag` | string | "XYZabc" | Site Verification Tag for Bing |
+| `analytics.yandex.SiteVerificationTag` | string | "XYZabc" | Site Verification Tag for Yandex |
+| `schema` | - | - | [Details](#schema) |
+| `fuseOpts` | - | - | [Details](#fuseOpts) |
+| `socialIcons` | - | - | [Details](#socialIcons) |
+| `label` | - | - | [Details](#label) |
+| `assets` | - | - | [Details](#assets) |
+| `cover` | - | - | [Details](#cover) |
+| `profileMode` | - | - | [Details](#profilemode) |
+| `editPost` | - | - | [Details](#editPost) |
### Site Variables
@@ -156,18 +159,24 @@ editPost:
| `comments` | boolean | true \| false | To show/hide comments |
| `description` | string | 'description text' | Show Post Description under Title |
| `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 |
| `disableHLJS` | boolean | true \| false | To disable Highlight.js loading |
| `disableAnchoredHeadings` | boolean | true \| false | To disable Anchored Headings |
| `searchHidden` | boolean | true \| false | Hide page from search |
| `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 |
| `ShowBreadCrumbs` | boolean | true \| false | Show BreadCrumb Navigation above single post/page |
| `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 |
| `cover.image` | string | 'featured.jpg' | To add a 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.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 |
+| `ShareButtons` | list | ["linkedin", "twitter"] | To customize which share buttons to be enabled on page |