hugo-theme-wondermod/content/posts/papermod/papermod-features.md

203 lines
3.7 KiB
Markdown
Raw Normal View History

2020-09-17 10:58:09 +02:00
---
title: "Papermod - Features"
date: 2020-09-16T11:30:03+05:30
showToc: true
weight: 2
aliases: ['/papermod-features']
tags: ['PaperMod']
author: "Aditya Telange"
2020-09-24 08:24:04 +02:00
tocopen: true
2020-09-17 10:58:09 +02:00
---
## Assets (js/css)
The following is enabled by default
- [minification](https://gohugo.io/hugo-pipes/minification/) - makes the assets size smallest as possible.
- [bundling](https://gohugo.io/hugo-pipes/bundling/) - bundles all the styles in one single asset
- [fingerprint/intergity](https://gohugo.io/hugo-pipes/fingerprint/) check.
---
## Default Theme light/dark
```yml
params:
defaultTheme: light
```
or
```yml
params:
defaultTheme: dark
```
2020-09-24 07:48:03 +02:00
or
```yml
params:
defaultTheme: auto # to switch between dark or light according to browser theme
```
</details>
2020-09-17 10:58:09 +02:00
---
## Archives Layout
Add vars below to page-variables
```yml
layout: "archives"
```
ex: [here](https://raw.githubusercontent.com/adityatelange/hugo-PaperMod/exampleSite/content/archives.md)
![](https://i.ibb.co/cNWc7GZ/paper-mod-archives.png)
---
## Home-Info Mode
Use 1st entry as some Information
add following to config file
```yml
params:
homeInfoParams:
Title: Hi there wave
Content: Can be Info, links, about...
socialIcons: # optional
- name: "<platform>"
url: "<link>"
- name: "<platform 2>"
url: "<link2>"
```
ex. [here](https://github.com/adityatelange/hugo-PaperMod/blob/exampleSite/config.toml#L14)
![](https://i.ibb.co/zsq6fLr/papermod-homeinfo.png)
---
## Profile Mode
Shows Index/Home page as Full Page with Social Links and Image
add following to config file
```yml
params:
profileMode:
enabled: true
title: "<Title>" # optional default will be site title
imageUrl: "<image link>" # optional
imageTitle: "<title of image as alt>" # optional
buttons:
- name: Archive
url: "/archive"
- name: Github
url: "https://github.com/"
socialIcons: # optional
- name: "<platform>"
url: "<link>"
- name: "<platform 2>"
url: "<link2>"
```
![](https://i.ibb.co/K0HVPBd/paper-mod-profilemode.png)
---
## [Draft](https://gohugo.io/getting-started/usage/#draft-future-and-expired-content) Page indication
adds `[draft]` mark to indicate draft pages.
---
2020-09-24 07:48:03 +02:00
## Cover for a Post
In post's page-variables add :
```yml
2020-09-24 08:24:04 +02:00
cover = "<absolute image url>"
# can also paste direct link from external site
# ex. https://i.ibb.co/K0HVPBd/paper-mod-profilemode.png
2020-09-24 07:48:03 +02:00
```
![](https://user-images.githubusercontent.com/21258296/93084795-3579ae80-f6b2-11ea-98c1-eee4061eb836.png)
2020-09-24 08:24:04 +02:00
---
## Scroll-to-Top Button (by default)
Displays a Scroll-to-Top button in right-bottom corner
2020-09-17 10:58:09 +02:00
---
## Share Buttons on post
Displays Share Buttons at Bottom of each post
to show share buttons add
```yml
params:
ShowShareButtons: true
```
![](https://i.ibb.co/sPN8bgd/paper-mod-share-butons.png)
---
## Show post reading time
Displays Reading Time (the estimated time, in minutes, it takes to read the content.)
To show reading time add
```yml
Params:
ShowReadingTime: true
```
---
2020-09-24 08:24:04 +02:00
## Show Table of Contents (Toc) on blog post
2020-09-17 10:58:09 +02:00
Displays ToC on blog-pages
To show ToC add following to page-variables
```yml
ShowToc: true
```
2020-09-24 08:24:04 +02:00
To keep Toc Open **by default** on a post add following to page-variables:
2020-09-24 07:48:03 +02:00
```yml
TocOpen: true
```
2020-09-17 10:58:09 +02:00
---
## Comments
to add comments, create a html file
`layouts/partials/comments.html`
and paste code provided by your comments provider
also in config add this
2020-09-24 08:24:04 +02:00
2020-09-17 10:58:09 +02:00
```yml
params:
comments: true
```
2020-09-24 08:24:04 +02:00
read more about this [here](https://gohugo.io/content-management/comments/)
2020-09-17 10:58:09 +02:00
---
2020-09-24 08:24:04 +02:00
## Scroll-Bar themed (by default)
2020-09-17 10:58:09 +02:00
---
2020-09-24 08:24:04 +02:00
## Smooth Scroll between in-page links (by default)