From b85471e94673c2e22db6515d450afe68087b1671 Mon Sep 17 00:00:00 2001 From: Aditya Telange <21258296+adityatelange@users.noreply.github.com> Date: Sun, 28 Mar 2021 10:05:47 +0530 Subject: [PATCH] update docs from wiki --- .../posts/papermod/papermod-features/index.md | 41 +++++++ content/posts/papermod/papermod-icons.md | 59 +++++----- content/posts/papermod/papermod-variables.md | 108 ++++++++++-------- 3 files changed, 135 insertions(+), 73 deletions(-) diff --git a/content/posts/papermod/papermod-features/index.md b/content/posts/papermod/papermod-features/index.md index e2f4ee87..28f8542b 100644 --- a/content/posts/papermod/papermod-features/index.md +++ b/content/posts/papermod/papermod-features/index.md @@ -327,6 +327,47 @@ ShowBreadCrumbs: false --- +### Edit Link for Posts + +Add a button to suggest changes by using the file path of the post to link to a edit destination. + +For site config use: + +```yml +Params: + editPost: + URL: "https://github.com//content" + Text: "Suggest Changes" # edit text + appendFilePath: true # to append file path to Edit link +``` + +Can be modified for individual pages + +```yml +--- +editPost: + URL: "https://github.com//content" + Text: "Suggest Changes" # edit text + appendFilePath: true # to append file path to Edit link +--- + +``` + +The example above would yield the following link for the post file `posts/post-name.md`: +https://github.com//content/posts/post-name.md + +| Parameter | Required | Default Value | +| ----------------------- | -------- | ------------- | +| editPost.URL | true | - | +| editPost.appendFilePath | false | false | +| editPost.Text | false | "Edit" | + +Since the link generated is a regular HTML anchor tag ``, you can +also use other URL schemas like `mailto://`, e.g. +`URL: "mailto://mail@example.com?subject=Suggesting changes for "` + +--- + ### Other Posts suggestion below a post Adds a Previous / Next post suggestion under a single post diff --git a/content/posts/papermod/papermod-icons.md b/content/posts/papermod/papermod-icons.md index 18d94b72..e8b9f80e 100644 --- a/content/posts/papermod/papermod-icons.md +++ b/content/posts/papermod/papermod-icons.md @@ -29,34 +29,37 @@ draft: true | 14 | `freepik` | freepik.com | | 15 | `github` | github.com | | 16 | `gitlab` | gitlab.com | -| 17 | `hackerrank` | hackerrank.com | -| 18 | `hackthebox` | hackthebox.eu | -| 19 | `instagram` | instagram.com | -| 20 | `kakaotalk` | kakaocorp.com/service/KakaoTalk | -| 21 | `keybase` | keybase.io | -| 22 | `kofi` | ko-fi.com | -| 23 | `lastfm` | last.fm | -| 24 | `linkedin` | linkedin.com | -| 25 | `mastodon` | mastodon.social | -| 26 | `medium` | medium.com | -| 27 | `mixcloud` | mixcloud.com | -| 28 | `nuget` | nuget.org | -| 29 | `paypal` | paypal.com | -| 30 | `qq` | qq.com | -| 31 | `reddit` | reddit.com | -| 32 | `rss` | - | -| 33 | `soundcloud` | soundcloud.com | -| 34 | `shutterstock` | shutterstock.com | -| 35 | `slack` | slack.com | -| 36 | `snapchat` | snapchat.com/add | -| 37 | `sourcerer` | sourcerer.io | -| 38 | `stackoverflow` | stackoverflow.com | -| 39 | `steam` | steampowered.com | -| 40 | `telegram` | telegram.org | -| 41 | `twitch` | twitch.tv | -| 42 | `twitter` | twitter.com | -| 43 | `youtube` | youtube.com | -| 44 | `other` | - | +| 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` | - | Usage : diff --git a/content/posts/papermod/papermod-variables.md b/content/posts/papermod/papermod-variables.md index 8a7c79b1..950b61d3 100644 --- a/content/posts/papermod/papermod-variables.md +++ b/content/posts/papermod/papermod-variables.md @@ -14,33 +14,37 @@ weight: 5 ### Site Variables under `Params` -| 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 | -| `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 | -| `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 | -| `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) | +| 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 | +| `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 | +| `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 | +| `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 | +| `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) | #### label @@ -117,25 +121,39 @@ socialIcons: url: "" ``` +#### editPost + +```yml +editPost: + URL: "https://github.com//content" + Text: "Suggest Changes" # edit text + appendFilePath: true # to append file path to Edit link +``` + +> Note: Same format is being used by Page Variables + --- ### Page Variables -| 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 | -| `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 | -| `ShowBreadCrumbs` | boolean | true \| false | Show BreadCrumb Navigation above single post/page | -| `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 | +| 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 | +| `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 |