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

165 lines
14 KiB
Markdown
Raw Normal View History

update :P
2020-09-24 08:24:04 +02:00
---
revamp 🌟 [WIP] prepare for 4.0 release
2021-01-13 16:02:37 +01:00
title: "Variables | Front Matter"
papermod: add summary to all papermod posts
2020-10-27 14:26:59 +01:00
summary: List of Front Matter variables used by PaperMod
add icons and vars link vars on install page
2021-01-20 15:47:35 +01:00
date: 2021-01-20
lint
2020-10-27 14:16:08 +01:00
tags: ["PaperMod"]
update :P
2020-09-24 08:24:04 +02:00
author: "Aditya Telange"
draft: true
add icons and vars link vars on install page
2021-01-20 15:47:35 +01:00
weight: 5
update :P
2020-09-24 08:24:04 +02:00
---
papermod: variables: add more vars
2020-10-31 19:21:10 +01:00
**Below are variables used with this theme...**
lint
2020-10-27 14:16:08 +01:00
papermod: variables: add more vars
2020-10-31 19:21:10 +01:00
---
update :P
2020-09-24 08:24:04 +02:00
add icons and vars link vars on install page
2021-01-20 15:47:35 +01:00
### Site Variables under `Params`
lint
2020-10-27 14:16:08 +01:00
update docs from wiki
2021-03-28 06:35:47 +02:00
| 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 |
Update docs from wiki
2021-03-31 08:10:14 +02:00
| `keywords` | list | [blog, page] | Add keywords for Home page |
update docs from wiki
2021-03-28 06:35:47 +02:00
| `DateFormat` | string | "January 2, 2006" | The format of date strings in the website. [Details](https://gohugo.io/functions/format/) |
Update docs from wiki 0c64647
2021-05-01 18:30:28 +02:00
| `languageAltTitle` | string | "English" | Alternate title in Multilingual Mode |
update docs from wiki
2021-03-28 06:35:47 +02:00
| `ShowReadingTime` | boolean | true \| false | To show read time in post meta |
| `ShowShareButtons` | boolean | true \| false | To show/hide share buttons under post |
Update docs from wiki 0c64647
2021-05-01 18:30:28 +02:00
| `ShowCodeCopyButtons` | boolean | true \| false | To show/hide Code Copy button |
| `ShowFullTextinRSS` | boolean | true \| false | To show Content in RSS feed |
update docs from wiki
2021-03-28 06:35:47 +02:00
| `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 |
Update docs from wiki
2021-03-31 08:10:14 +02:00
| `hideMeta` | boolean | true \| false | To Hide meta elements : date, read-time, author and available-translations for page |
update docs from wiki
2021-03-28 06:35:47 +02:00
| `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 |
| `fuseOpts` | - | - | [Details](#fuseOpts) |
| `socialIcons` | - | - | [Details](#socialIcons) |
| `label` | - | - | [Details](#label) |
| `assets` | - | - | [Details](#assets) |
| `cover` | - | - | [Details](#cover) |
| `profileMode` | - | - | [Details](#profilemode) |
| `editPost` | - | - | [Details](#editPost) |
update demo
2021-02-01 06:47:12 +01:00
#### label
update docs from wiki
2021-02-07 17:25:52 +01:00
| name | type | example | Description |
| ------------------ | ------- | ----------------------- | ------------------------------------------------ |
| `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.iconHeight` | integer | 35 | To set size of label logo image |
update demo
2021-02-01 06:47:12 +01:00
#### profileMode
update docs from wiki
2021-02-07 17:25:52 +01:00
| name | type | example | Description |
| ------------------------- | ------- | ---------------------------------------------- | ---------------------------------------------------- |
| `profileMode.enabled` | boolean | true \| false | For enabling profileMode, needs to be explicitly set |
| `profileMode.title` | string | "Title" | Title |
| `profileMode.subtitle` | string | "subtitle here" | Subtitle |
| `profileMode.imageUrl` | string | "image.png" \| "https://example.com/image.jpg" | Image URL or Link |
| `profileMode.imageWidth ` | string | "150" | Width of image |
| `profileMode.imageHeight` | string | "150" | Height of image |
| `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/"
```
update demo
2021-02-01 06:47:12 +01:00
#### assets
update docs from wiki
2021-02-07 17:25:52 +01:00
| name | type | example | Description |
| ------------------------------ | ------- | ------------- | -------------------------------------------- |
| `assets.favicon` | string | 'icon.ico' | To set favicon, can be path or external link |
| `assets.disableHLJS` | boolean | true \| false | To disable Highlight.js loading |
| `assets.disableFingerprinting` | boolean | true \| false | To disable Sub-Resource integrity for assets |
update demo
2021-02-01 06:47:12 +01:00
#### cover
update docs from wiki
2021-02-07 17:25:52 +01:00
| name | type | example | Description |
| ------------------------ | ------- | ------------- | ------------------------------------------------------- |
| `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.hidden` | boolean | true \| false | To hide everywhere but not in structured data |
| `cover.hiddenInList` | boolean | true \| false | To hide on list pages and home |
| `cover.hiddenInSingle ` | boolean | true \| false | To hide on list pages and home |
update demo
2021-02-01 06:47:12 +01:00
#### fuseOpts
update docs from wiki
2021-02-07 17:25:52 +01:00
Refer: https://fusejs.io/api/options.html
update demo
2021-02-01 06:47:12 +01:00
```yml
fuseOpts:
isCaseSensitive: false
shouldSort: true
location: 0
distance: 1000
threshold: 0.4
minMatchCharLength: 0
keys: ["title", "permalink", "summary", "content"] ## can be less but not more than shown in list
```
#### socialIcons
```yml
socialIcons:
- name: "<platform>"
url: "<link>"
- name: "<platform 2>"
url: "<link2>"
```
update docs from wiki
2021-03-28 06:35:47 +02:00
#### editPost
```yml
editPost:
URL: "https://github.com/<path_to_repo>/content"
Text: "Suggest Changes" # edit text
appendFilePath: true # to append file path to Edit link
```
> Note: Same format is being used by Page Variables
papermod: variables: add more vars
2020-10-31 19:21:10 +01:00
---
update :P
2020-09-24 08:24:04 +02:00
### Page Variables
Update docs from wiki 0c64647
2021-05-01 18:30:28 +02:00
| Name | Type | Example | Description |
| ------------------ | ------------- | ------------------------------- | ----------------------------------------------------------------------------------- |
| `showtoc` | boolean | true \| false | To show/hide Table of Contents |
| `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 |
| `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 |
| `disableShare` | boolean | true \| false | To hide/show share icons under a page |
| `disableHLJS` | boolean | true \| false | To disable Highlight.js loading |
| `searchHidden` | boolean | true \| false | Hide page from search |
| `hideSummary` | boolean | true \| false | To Hide summary being shown in list pages |
| `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 |
| `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 |
| `weight ` | integer | 5 | To set page order or to pin a post to Top of list |
Reference in New Issue Copy Permalink