From 9c3af5b3f86d4df7c93ba6974c2c4e74e7f35e72 Mon Sep 17 00:00:00 2001
From: Aditya Telange <21258296+adityatelange@users.noreply.github.com>
Date: Wed, 31 Mar 2021 11:40:14 +0530
Subject: [PATCH] Update docs from wiki
---
content/posts/papermod/papermod-icons.md | 84 ++++++++++---------
.../posts/papermod/papermod-installation.md | 30 ++++++-
content/posts/papermod/papermod-variables.md | 3 +-
3 files changed, 71 insertions(+), 46 deletions(-)
diff --git a/content/posts/papermod/papermod-icons.md b/content/posts/papermod/papermod-icons.md
index e8b9f80e..f6e5c990 100644
--- a/content/posts/papermod/papermod-icons.md
+++ b/content/posts/papermod/papermod-icons.md
@@ -19,47 +19,49 @@ draft: true
| 4 | `buymeacoffee` | buymeacoffee.com |
| 5 | `codepen` | codepen.io |
| 6 | `cryptohack` | cryptohack.org |
-| 7 | `dev` | dev.to |
-| 8 | `discogs` | discogs.com |
-| 9 | `discord` | discord.com |
-| 10 | `dreamstime` | dreamstime.com |
-| 11 | `dribbble` | dribbble.com |
-| 12 | `email` | - |
-| 13 | `facebook` | facebook.com |
-| 14 | `freepik` | freepik.com |
-| 15 | `github` | github.com |
-| 16 | `gitlab` | gitlab.com |
-| 17 | `gitea` | gitea.io |
-| 18 | `hackerrank` | hackerrank.com |
-| 19 | `hackthebox` | hackthebox.eu |
-| 20 | `instagram` | instagram.com |
-| 21 | `itchio` | itch.io |
-| 22 | `kakaotalk` | kakaocorp.com/service/KakaoTalk |
-| 23 | `keybase` | keybase.io |
-| 24 | `kofi` | ko-fi.com |
-| 25 | `lastfm` | last.fm |
-| 26 | `linkedin` | linkedin.com |
-| 27 | `mastodon` | mastodon.social |
-| 28 | `medium` | medium.com |
-| 29 | `mixcloud` | mixcloud.com |
-| 30 | `nuget` | nuget.org |
-| 31 | `paypal` | paypal.com |
-| 32 | `qq` | qq.com |
-| 33 | `reddit` | reddit.com |
-| 34 | `rss` | - |
-| 35 | `soundcloud` | soundcloud.com |
-| 36 | `shutterstock` | shutterstock.com |
-| 37 | `slack` | slack.com |
-| 38 | `snapchat` | snapchat.com/add |
-| 39 | `sourcerer` | sourcerer.io |
-| 40 | `stackoverflow` | stackoverflow.com |
-| 41 | `steam` | steampowered.com |
-| 42 | `telegram` | telegram.org |
-| 43 | `twitch` | twitch.tv |
-| 44 | `twitter` | twitter.com |
-| 45 | `unsplash` | unsplash.com |
-| 46 | `youtube` | youtube.com |
-| 47 | `other` | - |
+| 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 | `freepik` | freepik.com |
+| 16 | `gitea` | gitea.io |
+| 17 | `github` | github.com |
+| 18 | `gitlab` | gitlab.com |
+| 19 | `hackerone` | hackerone.com |
+| 20 | `hackerrank` | hackerrank.com |
+| 21 | `hackthebox` | hackthebox.eu |
+| 22 | `instagram` | instagram.com |
+| 23 | `itchio` | itch.io |
+| 24 | `kakaotalk` | kakaocorp.com/service/KakaoTalk |
+| 25 | `keybase` | keybase.io |
+| 26 | `kofi` | ko-fi.com |
+| 27 | `lastfm` | last.fm |
+| 28 | `linkedin` | linkedin.com |
+| 29 | `mastodon` | mastodon.social |
+| 30 | `medium` | medium.com |
+| 31 | `mixcloud` | mixcloud.com |
+| 32 | `nuget` | nuget.org |
+| 33 | `paypal` | paypal.com |
+| 34 | `qq` | qq.com |
+| 35 | `reddit` | reddit.com |
+| 36 | `rss` | - |
+| 37 | `soundcloud` | soundcloud.com |
+| 38 | `shutterstock` | shutterstock.com |
+| 39 | `slack` | slack.com |
+| 40 | `snapchat` | snapchat.com/add |
+| 41 | `sourcerer` | sourcerer.io |
+| 42 | `stackoverflow` | stackoverflow.com |
+| 43 | `steam` | steampowered.com |
+| 44 | `telegram` | telegram.org |
+| 45 | `twitch` | twitch.tv |
+| 46 | `twitter` | twitter.com |
+| 47 | `unsplash` | unsplash.com |
+| 48 | `youtube` | youtube.com |
+| 49 | `other` | - |
Usage :
diff --git a/content/posts/papermod/papermod-installation.md b/content/posts/papermod/papermod-installation.md
index f6ef94a2..8c09ed23 100644
--- a/content/posts/papermod/papermod-installation.md
+++ b/content/posts/papermod/papermod-installation.md
@@ -9,13 +9,13 @@ tags: ["PaperMod"]
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
Follow [Quick Start](https://gohugo.io/getting-started/quick-start/) guide to setup hugo and create a new site.
@@ -54,7 +54,7 @@ git submodule add https://github.com/adityatelange/hugo-PaperMod.git themes/Pape
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 v5.0` to end of above command if you want to stick to specific release.
> Updating theme :
>
@@ -69,6 +69,7 @@ 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)
@@ -125,18 +126,23 @@ params:
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
disableSpecial1stPost: false
+ disableScrollToTop: false
comments: false
hidemeta: false
+ hideSummary: false
showtoc: false
tocopen: false
@@ -185,12 +191,21 @@ params:
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:
@@ -248,14 +263,21 @@ description: "Desc Text."
disableHLJS: true # to disable highlightjs
disableShare: false
disableHLJS: false
+hideSummary: false
searchHidden: true
+ShowReadingTime: true
+ShowBreadCrumbs: true
+ShowPostNavLinks: true
cover:
image: "" # image path/url
alt: "" # alt text
caption: "" # display caption under cover
relative: false # when using page bundles set this to true
hidden: true # only hide on current single page
-
+editPost:
+ URL: "https://github.com//content"
+ Text: "Suggest Changes" # edit text
+ appendFilePath: true # to append file path to Edit link
---
```
diff --git a/content/posts/papermod/papermod-variables.md b/content/posts/papermod/papermod-variables.md
index 950b61d3..93aa1c37 100644
--- a/content/posts/papermod/papermod-variables.md
+++ b/content/posts/papermod/papermod-variables.md
@@ -21,6 +21,7 @@ weight: 5
| `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/) |
| `ShowReadingTime` | boolean | true \| false | To show read time in post meta |
| `ShowShareButtons` | boolean | true \| false | To show/hide share buttons under post |
@@ -28,7 +29,7 @@ weight: 5
| `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 |
-| `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 |
| `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 |