From d199f5540f56e2fddbdb89bc6874324d67529e9a Mon Sep 17 00:00:00 2001
From: Aditya Telange <21258296+adityatelange@users.noreply.github.com>
Date: Wed, 11 Nov 2020 10:21:56 +0530
Subject: [PATCH] papermod howtos: Adding Custom Favicon(s)

---
 content/posts/papermod/papermod-how-to.md | 46 +++++++++++++++++++++++
 1 file changed, 46 insertions(+)

diff --git a/content/posts/papermod/papermod-how-to.md b/content/posts/papermod/papermod-how-to.md
index 7e09db90..ff1cd5d2 100644
--- a/content/posts/papermod/papermod-how-to.md
+++ b/content/posts/papermod/papermod-how-to.md
@@ -128,6 +128,52 @@ weight: 2
 
 ---
 
+## Adding Custom Favicon(s)
+
+We support the following paths under `/static` directory
+and can be added accordingly.
+
+-   `favicon.ico`
+-   `favicon-16x16.png`
+-   `favicon-32x32.png`
+-   `apple-touch-icon.png`
+-   `safari-pinned-tab.svg`
+-   `site.webmanifest`
+
+1. Favicon(s) can be generated by [Favicon.io](https://favicon.io)
+
+    and can be simply put in `/static` folder.
+
+2. Other way is to add favicon(s) NOT located in `/static` folder.
+
+    In site config add the following:
+
+    ```
+    params:
+    assets:
+        favicon: "<link / absolute url>"
+        favicon16x16:  "<link / absolute url>"
+        favicon32x32:  "<link / absolute url>"
+        apple_touch_icon:  "<link / absolute url>"
+        safari_pinned_tab:  "<link / absolute url>"
+    ```
+
+    - `absolute url` means direct links to external resource: ex. https://web.site/someimage.png
+
+    example:
+
+    ```
+    params:
+    assets:
+        favicon: "/favicon.ico"
+        favicon16x16:  "/favicon-16x16.png"
+        favicon32x32:  "/favicon-32x32.png"
+        apple_touch_icon:  "/apple-touch-icon.png"
+        safari_pinned_tab:  "/safari-pinned-tab.svg"
+    ```
+
+---
+
 ## References
 
 -   [Override a Hugo theme](https://zwbetz.com/override-a-hugo-theme/)