From 997937af5a6dc317da56ae294dce927ec5930a4b Mon Sep 17 00:00:00 2001
From: Geoffrey Garrett <g.h.garrett13@gmail.com>
Date: Mon, 27 Jun 2022 22:45:48 +0000
Subject: [PATCH] docs(config.md): Added short explainer on favicons
---
content/notes/config.md | 63 ++++++++++++++++++++++++++++++-
1 files changed, 61 insertions(+), 2 deletions(-)
diff --git a/content/notes/config.md b/content/notes/config.md
index a5c194f..8c758ed 100644
--- a/content/notes/config.md
+++ b/content/notes/config.md
@@ -12,6 +12,7 @@
```yaml
name: Your name here! # Shows in the footer
enableToc: true # Whether to show a Table of Contents
+enableLinkPreview: true # whether to render card previews for links
description: Page description to show to search engines
page_title: Quartz Example Page # Default Page Title
@@ -22,6 +23,46 @@
link: https://github.com/jackyzha0
```
+### HTML Favicons
+
+A Favicon is most commonly seen preceding the URL in a browser. Some
+other examples include (but are not limited to) bookmarks, search history, and
+app icons (i.e. "save page to homescreen" on mobile devices). [File format support](https://en.wikipedia.org/wiki/Favicon#File_format_support)
+and the [use of favicons](https://en.wikipedia.org/wiki/Favicon#Use_of_favicon) differ
+across the combination of platforms and browsers.
+
+If you would like to customize the favicons of your website, you can add them to the `data/config.yaml` file. The **default** without any set `favicon` key is:
+
+```html
+<link rel="shortcut icon" href="icon.png" type="image/png">
+```
+
+The default can be overridden by defining a value to the `favicon` key in your `data/config.yaml` file. Here is a `List[Dictionary]` example format, which is equivalent to the default:
+
+```yaml
+favicon:
+ - { rel: "shortcut icon", href: "icon.png", type: "image/png" }
+```
+
+In this format, the following keys are available:
+- `rel`: The `rel` attribute of the `<link>` tag.
+- `type`: The `type` attribute of the `<link>` tag.
+- `href` (optional): The `href` attribute of the `<link>` tag.
+- `sizes` (optional): The `sizes` attribute of the `<link>` tag.
+
+If you plan to add multiple favicons generated by a website, it may be easier to define it as HTML:
+
+```yaml
+favicon: |
+ <link rel="shortcut icon" href="icon.png" type="image/png">
+```
+
+Some websites that **generate favicons** for you (ordered alphabetically) include:
+- [`favicon.io`](https://favicon.io/)
+- [`realfavicongenerator.net`](https://realfavicongenerator.net/)
+- [`www.favicon.cc`](https://www.favicon.cc/)
+
+
### Graph View
To customize the Interactive Graph view, you can poke around `data/graphConfig.yaml`.
@@ -36,7 +77,7 @@
## Styling
-Want to go even more in-depth? You can add custom CSS styling and change existing colours through editing `assets/custom.scss`. If you'd like to target specific parts of the site, you can add ids and classes to the HTML partials in `/layouts/partials`.
+Want to go even more in-depth? You can add custom CSS styling and change existing colours through editing `assets/styles/custom.scss`. If you'd like to target specific parts of the site, you can add ids and classes to the HTML partials in `/layouts/partials`.
### Partials
Partials are what dictate what actually gets rendered to the page. Want to change how pages are styled and structured? You can edit the appropriate layout in `/layouts`.
@@ -45,4 +86,22 @@
More info about partials on [Hugo's website.](https://gohugo.io/templates/partials/)
-Still having problems? Checkout our [FAQ and Troubleshooting guide](notes/troubleshooting.md).
\ No newline at end of file
+Still having problems? Checkout our [FAQ and Troubleshooting guide](notes/troubleshooting.md).
+
+## Multilingual
+[CJK + Latex Support (测试)](notes/CJK%20+%20Latex%20Support%20(测试).md) comes out of the box with Quartz.
+
+Want to support languages that read from right-to-left (like Arabic)? Hugo (and by proxy, Quartz) supports this natively.
+
+Follow the steps [Hugo provides here](https://gohugo.io/content-management/multilingual/#configure-languages) and modify your `config.toml`
+
+For example:
+
+```toml
+defaultContentLanguage = 'ar'
+[languages]
+ [languages.ar]
+ languagedirection = 'rtl'
+ title = 'مدونتي'
+ weight = 1
+```
--
Gitblit v1.10.0