mirror of
https://github.com/adityatelange/hugo-PaperMod.git
synced 2023-12-21 10:22:58 +01:00
update docs from wiki
This commit is contained in:
Aditya Telange
parent
632ffe5377
commit
5feed2f148
@ -76,33 +76,6 @@ Linked Issues:
|
|||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## Archive Page
|
|
||||||
|
|
||||||
```shell
|
|
||||||
.
|
|
||||||
├── config.yml
|
|
||||||
├── content/
|
|
||||||
│ ├── archives.md <--- Create archive.md here
|
|
||||||
│ └── posts/
|
|
||||||
├── static/
|
|
||||||
└── themes/
|
|
||||||
└── hugo-PaperMod/
|
|
||||||
```
|
|
||||||
|
|
||||||
and add the following to it
|
|
||||||
|
|
||||||
```yml
|
|
||||||
---
|
|
||||||
title: "Archive"
|
|
||||||
layout: "archives"
|
|
||||||
url: "/archives/"
|
|
||||||
summary: archives
|
|
||||||
---
|
|
||||||
|
|
||||||
```
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 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
|
||||||
@ -117,8 +90,8 @@ Create folder in yout project directory as
|
|||||||
└── assets/
|
└── assets/
|
||||||
└── css/
|
└── css/
|
||||||
└── extended/ <---
|
└── extended/ <---
|
||||||
│ ├── custom_css1.css <---
|
├── custom_css1.css <---
|
||||||
│ └── any_name.css <---
|
└── any_name.css <---
|
||||||
```
|
```
|
||||||
|
|
||||||
All `css` files inside `assets/css/extended` will be bundled !
|
All `css` files inside `assets/css/extended` will be bundled !
|
||||||
@ -303,7 +276,7 @@ Add `#center` after image to center align an image
|
|||||||
}
|
}
|
||||||
```
|
```
|
||||||
|
|
||||||
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)
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
|
|||||||
@ -139,6 +139,7 @@ params:
|
|||||||
profileMode:
|
profileMode:
|
||||||
enabled: true
|
enabled: true
|
||||||
title: "<Title>" # optional default will be site title
|
title: "<Title>" # optional default will be site title
|
||||||
|
subtitle: "This is subtitle"
|
||||||
imageUrl: "<image link>" # optional
|
imageUrl: "<image link>" # optional
|
||||||
imageTitle: "<title of image as alt>" # optional
|
imageTitle: "<title of image as alt>" # optional
|
||||||
imageWidth: 120 # custom size
|
imageWidth: 120 # custom size
|
||||||
@ -158,7 +159,7 @@ params:
|
|||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
### Search
|
### Search Page
|
||||||
|
|
||||||
PaperMod uses [Fuse.js Basic](https://fusejs.io/getting-started/different-builds.html#explanation-of-different-builds) for seach functionality
|
PaperMod uses [Fuse.js Basic](https://fusejs.io/getting-started/different-builds.html#explanation-of-different-builds) for seach functionality
|
||||||
|
|
||||||
@ -194,6 +195,12 @@ searchHidden: true
|
|||||||
|
|
||||||
ex: [search.md](https://raw.githubusercontent.com/adityatelange/hugo-PaperMod/exampleSite/content/search.md)
|
ex: [search.md](https://raw.githubusercontent.com/adityatelange/hugo-PaperMod/exampleSite/content/search.md)
|
||||||
|
|
||||||
|
> Search Page also has Key bindings:
|
||||||
|
>
|
||||||
|
> - Arrow keys to move up/down the list
|
||||||
|
> - Enter key (return) or Right Arrow key to Go to highlighted page
|
||||||
|
> - Escape key to clear searchbox and results
|
||||||
|
|
||||||
For Multilingual use `search.<lang>.md` ex. `search.es.md`.
|
For Multilingual use `search.<lang>.md` ex. `search.es.md`.
|
||||||
|
|
||||||
**Note:** Search will work only on current language, user is currently on !
|
**Note:** Search will work only on current language, user is currently on !
|
||||||
@ -318,6 +325,8 @@ ShowBreadCrumbs: false
|
|||||||
|
|
||||||
```
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
### Other Posts suggestion below a post
|
### Other Posts suggestion below a post
|
||||||
|
|
||||||
Adds a Previous / Next post suggestion under a single post
|
Adds a Previous / Next post suggestion under a single post
|
||||||
@ -327,6 +336,8 @@ params:
|
|||||||
ShowPostNavLinks: true
|
ShowPostNavLinks: true
|
||||||
```
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
### Multiple Authors
|
### Multiple Authors
|
||||||
|
|
||||||
To Use multiple authors for a post, in post-variables:
|
To Use multiple authors for a post, in post-variables:
|
||||||
|
|||||||
@ -11,75 +11,75 @@ draft: true
|
|||||||
|
|
||||||
## Social Icons
|
## Social Icons
|
||||||
|
|
||||||
| No. | Name | Platform Link |
|
| No. | Name | Platform Link |
|
||||||
| --- | ------------- | ------------------------------- |
|
| --- | --------------- | ------------------------------- |
|
||||||
| 1 | 123rf | 123rf.com |
|
| 1 | `123rf` | 123rf.com |
|
||||||
| 2 | adobestock | stock.adobe.com |
|
| 2 | `adobestock` | stock.adobe.com |
|
||||||
| 3 | behance | behance.net |
|
| 3 | `behance` | behance.net |
|
||||||
| 4 | buymeacoffee | buymeacoffee.com |
|
| 4 | `buymeacoffee` | buymeacoffee.com |
|
||||||
| 5 | codepen | codepen.io |
|
| 5 | `codepen` | codepen.io |
|
||||||
| 6 | cryptohack | cryptohack.org |
|
| 6 | `cryptohack` | cryptohack.org |
|
||||||
| 7 | dev | dev.to |
|
| 7 | `dev` | dev.to |
|
||||||
| 8 | discogs | discogs.com |
|
| 8 | `discogs` | discogs.com |
|
||||||
| 9 | discord | discord.com |
|
| 9 | `discord` | discord.com |
|
||||||
| 10 | dreamstime | dreamstime.com |
|
| 10 | `dreamstime` | dreamstime.com |
|
||||||
| 11 | dribbble | dribbble.com |
|
| 11 | `dribbble` | dribbble.com |
|
||||||
| 12 | email | - |
|
| 12 | `email` | - |
|
||||||
| 13 | facebook | facebook.com |
|
| 13 | `facebook` | facebook.com |
|
||||||
| 14 | freepik | freepik.com |
|
| 14 | `freepik` | freepik.com |
|
||||||
| 15 | github | github.com |
|
| 15 | `github` | github.com |
|
||||||
| 16 | gitlab | gitlab.com |
|
| 16 | `gitlab` | gitlab.com |
|
||||||
| 17 | hackerrank | hackerrank.com |
|
| 17 | `hackerrank` | hackerrank.com |
|
||||||
| 18 | hackthebox | hackthebox.eu |
|
| 18 | `hackthebox` | hackthebox.eu |
|
||||||
| 19 | instagram | instagram.com |
|
| 19 | `instagram` | instagram.com |
|
||||||
| 20 | kakaotalk | kakaocorp.com/service/KakaoTalk |
|
| 20 | `kakaotalk` | kakaocorp.com/service/KakaoTalk |
|
||||||
| 21 | keybase | keybase.io |
|
| 21 | `keybase` | keybase.io |
|
||||||
| 22 | kofi | ko-fi.com |
|
| 22 | `kofi` | ko-fi.com |
|
||||||
| 23 | lastfm | last.fm |
|
| 23 | `lastfm` | last.fm |
|
||||||
| 24 | linkedin | linkedin.com |
|
| 24 | `linkedin` | linkedin.com |
|
||||||
| 25 | mastodon | mastodon.social |
|
| 25 | `mastodon` | mastodon.social |
|
||||||
| 26 | medium | medium.com |
|
| 26 | `medium` | medium.com |
|
||||||
| 27 | mixcloud | mixcloud.com |
|
| 27 | `mixcloud` | mixcloud.com |
|
||||||
| 28 | nuget | nuget.org |
|
| 28 | `nuget` | nuget.org |
|
||||||
| 29 | paypal | paypal.com |
|
| 29 | `paypal` | paypal.com |
|
||||||
| 30 | qq | qq.com |
|
| 30 | `qq` | qq.com |
|
||||||
| 31 | reddit | reddit.com |
|
| 31 | `reddit` | reddit.com |
|
||||||
| 32 | rss | - |
|
| 32 | `rss` | - |
|
||||||
| 33 | soundcloud | soundcloud.com |
|
| 33 | `soundcloud` | soundcloud.com |
|
||||||
| 34 | shutterstock | shutterstock.com |
|
| 34 | `shutterstock` | shutterstock.com |
|
||||||
| 35 | slack | slack.com |
|
| 35 | `slack` | slack.com |
|
||||||
| 36 | snapchat | snapchat.com/add |
|
| 36 | `snapchat` | snapchat.com/add |
|
||||||
| 37 | sourcerer | sourcerer.io |
|
| 37 | `sourcerer` | sourcerer.io |
|
||||||
| 38 | stackoverflow | stackoverflow.com |
|
| 38 | `stackoverflow` | stackoverflow.com |
|
||||||
| 39 | steam | steampowered.com |
|
| 39 | `steam` | steampowered.com |
|
||||||
| 40 | telegram | telegram.org |
|
| 40 | `telegram` | telegram.org |
|
||||||
| 41 | twitch | twitch.tv |
|
| 41 | `twitch` | twitch.tv |
|
||||||
| 42 | twitter | twitter.com |
|
| 42 | `twitter` | twitter.com |
|
||||||
| 43 | youtube | youtube.com |
|
| 43 | `youtube` | youtube.com |
|
||||||
| 44 | other | - |
|
| 44 | `other` | - |
|
||||||
|
|
||||||
Usage :
|
Usage :
|
||||||
|
|
||||||
```
|
```
|
||||||
socialIcons: # optional
|
socialIcons:
|
||||||
- name: "<NAME>"
|
- name: "kofi"
|
||||||
url: "<link>"
|
url: "https://kofi.com"
|
||||||
- name: "<NAME>"
|
- name: "twitter"
|
||||||
url: "<link2>"
|
url: "https://twitter.com"
|
||||||
```
|
```
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## Share Icons
|
## Share Icons
|
||||||
|
|
||||||
| No. | Platform |
|
| No. | Platform |
|
||||||
| --- | -------- |
|
| --- | --------------------------------------------------------------- |
|
||||||
| 1 | twitter |
|
| 1 | `twitter` (also generates hash tags from tags linked with post) |
|
||||||
| 2 | linkedin |
|
| 2 | `linkedin` |
|
||||||
| 3 | reddit |
|
| 3 | `reddit` |
|
||||||
| 4 | facebook |
|
| 4 | `facebook` |
|
||||||
| 5 | whatsapp |
|
| 5 | `whatsapp` |
|
||||||
| 6 | telegram |
|
| 6 | `telegram` |
|
||||||
|
|
||||||
Usage:
|
Usage:
|
||||||
|
|
||||||
|
|||||||
@ -9,9 +9,21 @@ tags: ["PaperMod"]
|
|||||||
author: "Aditya Telange"
|
author: "Aditya Telange"
|
||||||
---
|
---
|
||||||
|
|
||||||
|
|
||||||
|
## 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.
|
||||||
|
|
||||||
|
---
|
||||||
## Guide
|
## Guide
|
||||||
|
|
||||||
Follow [Quick Start](https://gohugo.io/getting-started/quick-start/) guide to setup hugo and create a new site.
|
Follow [Quick Start](https://gohugo.io/getting-started/quick-start/) guide to setup hugo and create a new site.
|
||||||
|
|
||||||
|
> Note: Use -f to select yml format
|
||||||
|
>
|
||||||
|
> `hugo new site <name of site> -f yml`
|
||||||
|
|
||||||
Make sure you install latest version of **`hugo(>=0.74.0)`**.
|
Make sure you install latest version of **`hugo(>=0.74.0)`**.
|
||||||
|
|
||||||
After you have created a new site, at [Step 3](https://gohugo.io/getting-started/quick-start/#step-3-add-a-theme) follow the steps:
|
After you have created a new site, at [Step 3](https://gohugo.io/getting-started/quick-start/#step-3-add-a-theme) follow the steps:
|
||||||
@ -39,7 +51,7 @@ you can use as [submodule](https://www.atlassian.com/git/tutorials/git-submodule
|
|||||||
|
|
||||||
```bash
|
```bash
|
||||||
git submodule add https://github.com/adityatelange/hugo-PaperMod.git themes/PaperMod --depth=1
|
git submodule add https://github.com/adityatelange/hugo-PaperMod.git themes/PaperMod --depth=1
|
||||||
git submodule update --init --recursive
|
git submodule update --init --recursive # needed when you reclone your repo (submodules may not get cloned automatically)
|
||||||
```
|
```
|
||||||
|
|
||||||
**Note**: You may use ` --branch v4.0` to end of above command if you want to stick to specific release.
|
**Note**: You may use ` --branch v4.0` to end of above command if you want to stick to specific release.
|
||||||
@ -146,6 +158,7 @@ params:
|
|||||||
profileMode:
|
profileMode:
|
||||||
enabled: false # needs to be explicitly set
|
enabled: false # needs to be explicitly set
|
||||||
title: ExampleSite
|
title: ExampleSite
|
||||||
|
subtitle: "This is subtitle"
|
||||||
imageUrl: "<img location>"
|
imageUrl: "<img location>"
|
||||||
imageWidth: 120
|
imageWidth: 120
|
||||||
imageHeight: 120
|
imageHeight: 120
|
||||||
|
|||||||
@ -14,75 +14,88 @@ weight: 5
|
|||||||
|
|
||||||
### Site Variables under `Params`
|
### Site Variables under `Params`
|
||||||
|
|
||||||
| name | type | example | Description |
|
| name | type | example | Description |
|
||||||
| ------------------------------------ | ------------- | ------------------------ | ----------------------------------------------------------------------------------- |
|
| -------------------------------------- | ------------- | ------------------------ | ----------------------------------------------------------------------------------- |
|
||||||
| env | string | 'production' | To set env to production |
|
| `env` | string | 'production' | To set env to production |
|
||||||
| title | string | 'My Blog' | To set title |
|
| `title` | string | 'My Blog' | To set title |
|
||||||
| description | string | 'This is a blog of mine' | To set site description |
|
| `description` | string | 'This is a blog of mine' | To set site description |
|
||||||
| author | string \|list | 'Me' \| ['Me','You'] | To show multiple Authors |
|
| `author` | string \|list | 'Me' \| ['Me','You'] | To show multiple Authors |
|
||||||
| images | string | 'myimage.png' | Link or path of image for opengraph, twitter-cards |
|
| `images` | string | 'myimage.png' | Link or path of image for opengraph, twitter-cards |
|
||||||
| 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 |
|
||||||
| 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 |
|
||||||
| 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 |
|
||||||
| 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 |
|
| `comments` | boolean | true \| false | To show/hide comments |
|
||||||
| analytics.google.SiteVerificationTag | string | "XYZabc" | Site Verification Tag for Google Analytics |
|
| `analytics.google.SiteVerificationTag` | string | "XYZabc" | Site Verification Tag for Google Analytics |
|
||||||
| analytics.bing.SiteVerificationTag | string | "XYZabc" | Site Verification Tag for Bing |
|
| `analytics.bing.SiteVerificationTag` | string | "XYZabc" | Site Verification Tag for Bing |
|
||||||
| analytics.yandex.SiteVerificationTag | string | "XYZabc" | Site Verification Tag for Yandex |
|
| `analytics.yandex.SiteVerificationTag` | string | "XYZabc" | Site Verification Tag for Yandex |
|
||||||
| | | | |
|
| `fuseOpts` | - | - | [Details](#fuseOpts) |
|
||||||
| fuseOpts | - | - | [Details](#fuseOpts) |
|
| `socialIcons` | - | - | [Details](#socialIcons) |
|
||||||
| socialIcons | - | - | [Details](#socialIcons) |
|
| `label` | - | - | [Details](#label) |
|
||||||
| label | - | - | [Details](#label) |
|
| `assets` | - | - | [Details](#assets) |
|
||||||
| assets | - | - | [Details](#assets) |
|
| `cover` | - | - | [Details](#cover) |
|
||||||
| cover | - | - | [Details](#cover) |
|
| `profileMode` | - | - | [Details](#profilemode) |
|
||||||
| profileMode | - | - | [Details](#profilemode) |
|
|
||||||
|
|
||||||
#### label
|
#### label
|
||||||
|
|
||||||
| name | type | example | Description |
|
| name | type | example | Description |
|
||||||
| ---------------- | ------- | ----------------------- | ------------------------------------------------ |
|
| ------------------ | ------- | ----------------------- | ------------------------------------------------ |
|
||||||
| label.text | string | 'Home' | To display different label text other than title |
|
| `label.text` | string | 'Home' | To display different label text other than title |
|
||||||
| label.icon | string | '/apple-touch-icon.png' | To display a logo image in label |
|
| `label.icon` | string | '/apple-touch-icon.png' | To display a logo image in label |
|
||||||
| label.iconHeight | integer | 35 | To set size of label logo image |
|
| `label.iconHeight` | integer | 35 | To set size of label logo image |
|
||||||
|
|
||||||
#### profileMode
|
#### profileMode
|
||||||
|
|
||||||
| name | type | example | Description |
|
| name | type | example | Description |
|
||||||
| ----------------------- | ------- | ---------------------------------------------- | ----------- |
|
| ------------------------- | ------- | ---------------------------------------------- | ---------------------------------------------------- |
|
||||||
| profileMode.enabled | boolean | true \| false | |
|
| `profileMode.enabled` | boolean | true \| false | For enabling profileMode, needs to be explicitly set |
|
||||||
| profileMode.title | string | "Title" | |
|
| `profileMode.title` | string | "Title" | Title |
|
||||||
| profileMode.imageUrl | string | "image.png" \| "https://example.com/image.jpg" | |
|
| `profileMode.subtitle` | string | "subtitle here" | Subtitle |
|
||||||
| profileMode.imageWidth | string | "" | |
|
| `profileMode.imageUrl` | string | "image.png" \| "https://example.com/image.jpg" | Image URL or Link |
|
||||||
| profileMode.imageHeight | string | "" | |
|
| `profileMode.imageWidth ` | string | "150" | Width of image |
|
||||||
| profileMode.imageTitle | string | "This image is a picture of .." | |
|
| `profileMode.imageHeight` | string | "150" | Height of image |
|
||||||
| profileMode.buttons | - | - | |
|
| `profileMode.imageTitle` | string | "This image is a picture of .." | Title of image |
|
||||||
|
| `profileMode.buttons` | - | - | [Details](#profileModebuttons) |
|
||||||
|
|
||||||
|
##### profileMode.buttons
|
||||||
|
|
||||||
|
```yml
|
||||||
|
profileMode:
|
||||||
|
buttons:
|
||||||
|
- name: Archive
|
||||||
|
url: "/archive"
|
||||||
|
- name: Github
|
||||||
|
url: "https://github.com/"
|
||||||
|
```
|
||||||
|
|
||||||
#### assets
|
#### assets
|
||||||
|
|
||||||
| name | type | example | Description |
|
| name | type | example | Description |
|
||||||
| ---------------------------- | ------- | ---------- | -------------------------------------------- |
|
| ------------------------------ | ------- | ------------- | -------------------------------------------- |
|
||||||
| assets.favicon | string | 'icon.ico' | To set favicon, can be path or external link |
|
| `assets.favicon` | string | 'icon.ico' | To set favicon, can be path or external link |
|
||||||
| assets.disableHLJS | boolean | | |
|
| `assets.disableHLJS` | boolean | true \| false | To disable Highlight.js loading |
|
||||||
| assets.disableFingerprinting | boolean | | |
|
| `assets.disableFingerprinting` | boolean | true \| false | To disable Sub-Resource integrity for assets |
|
||||||
|
|
||||||
#### cover
|
#### cover
|
||||||
|
|
||||||
| name | type | example | Description |
|
| name | type | example | Description |
|
||||||
| ---------------------- | ------- | ------------- | ------------------------------------------------------- |
|
| ------------------------ | ------- | ------------- | ------------------------------------------------------- |
|
||||||
| cover.linkFullImages | boolean | true \| false | To open full size cover images on click on cover |
|
| `cover.linkFullImages` | boolean | true \| false | To open full size cover images on click on cover |
|
||||||
| cover.responsiveImages | boolean | true \| false | To enable/disable generation of responsive cover images |
|
| `cover.responsiveImages` | boolean | true \| false | To enable/disable generation of responsive cover images |
|
||||||
| cover.hidden | boolean | true \| fals | |
|
| `cover.hidden` | boolean | true \| false | To hide everywhere but not in structured data |
|
||||||
| cover.hiddenInList | boolean | true \| fals | |
|
| `cover.hiddenInList` | boolean | true \| false | To hide on list pages and home |
|
||||||
| cover.hiddenInSingle | boolean | true \| fals | |
|
| `cover.hiddenInSingle ` | boolean | true \| false | To hide on list pages and home |
|
||||||
|
|
||||||
#### fuseOpts
|
#### fuseOpts
|
||||||
|
|
||||||
|
Refer: https://fusejs.io/api/options.html
|
||||||
|
|
||||||
```yml
|
```yml
|
||||||
fuseOpts:
|
fuseOpts:
|
||||||
isCaseSensitive: false
|
isCaseSensitive: false
|
||||||
@ -104,37 +117,25 @@ socialIcons:
|
|||||||
url: "<link2>"
|
url: "<link2>"
|
||||||
```
|
```
|
||||||
|
|
||||||
####
|
|
||||||
|
|
||||||
```yml
|
|
||||||
profileMode:
|
|
||||||
buttons:
|
|
||||||
- name: Archive
|
|
||||||
url: "/archive"
|
|
||||||
- name: Github
|
|
||||||
url: "https://github.com/"
|
|
||||||
```
|
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
### Page Variables
|
### Page Variables
|
||||||
|
|
||||||
| Name | Type | Example | Description |
|
| Name | Type | Example | Description |
|
||||||
| --------------- | ------------- | --------------------- | ----------------------------------------------------------------------------------- |
|
| ----------------- | ------------- | --------------------- | ----------------------------------------------------------------------------------- |
|
||||||
| 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 |
|
||||||
| 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 |
|
||||||
| 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 |
|
||||||
| 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 | |
|
| `disableHLJS` | boolean | true \| false | To disable Highlight.js loading |
|
||||||
| searchHidden | boolean | true \| false | |
|
| `searchHidden` | boolean | true \| false | Hide page from search |
|
||||||
| ShowBreadCrumbs | boolean | true \| false | Show BreadCrumb Navigation above single post/page |
|
| `ShowBreadCrumbs` | boolean | true \| false | Show BreadCrumb Navigation above single post/page |
|
||||||
| 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 | |
|
| `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 |
|
|
||||||
|
|||||||
Loading…
Reference in New Issue
Block a user