| | |
|---|
| | | 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`. |
|---|
| | | |
|---|
| | |
|---|
| | | |
|---|
| | | |
|---|
| | | ## 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`. |
|---|
| | |
|---|
| | | 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` |
|---|
| | |
|---|
| | | languagedirection = 'rtl' |
|---|
| | | title = 'مدونتي' |
|---|
| | | weight = 1 |
|---|
| | | ``` |
|---|
| | | ``` |
|---|
