papermod: variables: add more vars

This commit is contained in:
Aditya Telange 2020-10-31 23:51:10 +05:30
parent 8898a77d1d
commit fba8e58b11
No known key found for this signature in database
GPG Key ID: 82E844EF3DA99E77
1 changed files with 37 additions and 17 deletions

View File

@ -9,27 +9,47 @@ author: "Aditya Telange"
draft: true
---
## Variables in PaperMod
**Below are variables used with this theme...**
Below are variables used with this theme...
---
### Site Variables
| name | type | example |
| ---------------------- | ------- | --------------------- |
| ShowReadingTime | boolean | true \| false |
| defaultTheme | string | light \| dark \| auto |
| ShowShareButtons | boolean | true \| false |
| cover.linkFullImages | boolean | true \| false |
| cover.responsiveImages | boolean | true \| false |
| 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 | ["Me","You"] | list | To show multiple Authors |
| images | string | 'myimage.png' | Link or path of image for opengraph, twitter-cards |
| ShowReadingTime | boolean | true \| false | To show read time in post meta |
| ShowShareButtons | boolean | true \| false | To show/hide share buttons under post |
| 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 |
| | | | |
| 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 |
| assets.favicon | string | 'icon.ico' | To set favicon, can be path or external link |
| 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 |
---
### Page Variables
| name | type | example |
| ------------- | ------- | ---------------- |
| showtoc | boolean | true \| false |
| tocopen | boolean | true \| false |
| hidemeta | boolean | true \| false |
| cover.image | string | `'featured.jpg'` |
| cover.caption | string | `'<text>'` |
| cover.alt | string | `'<alt text>'` |
| 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 |
| 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 |
| comments | boolean | true \| false | To show/hide comments |
| disableShare | boolean | true \| false | To hide/show share icons under a page |
| author | ["Me","You"] | list | To show multiple Authors |
| | | | |
| weight | integer | 5 | To set page order or to pin a post to Top of list |