From 666bf335d0f5458554f9a496b3e8b6d1088efad8 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?S=C3=B6ren=20Weber?= Date: Tue, 15 Mar 2022 20:59:24 +0100 Subject: [PATCH] docs: finalizing README for next release --- README.md | 3 ++- exampleSite/content/_index.en.md | 3 ++- exampleSite/content/basics/migration/_index.en.md | 12 +++++++++--- exampleSite/content/cont/icons.en.md | 6 +++--- 4 files changed, 16 insertions(+), 8 deletions(-) diff --git a/README.md b/README.md index 87af27cec2..282e6c500a 100644 --- a/README.md +++ b/README.md @@ -18,7 +18,8 @@ The theme is a fork of the great [Learn theme](https://github.com/matcornic/hugo - Attachments files - List child pages - Mermaid diagram (flowchart, sequence, gantt) -- Customizable look and feel and theme variants +- Customizable look and feel +- Light, dark and various other predefined color variants - Buttons - Tip/Note/Info/Warning boxes - Expand diff --git a/exampleSite/content/_index.en.md b/exampleSite/content/_index.en.md index 47c743529d..afcc330c81 100644 --- a/exampleSite/content/_index.en.md +++ b/exampleSite/content/_index.en.md @@ -24,7 +24,8 @@ See [what's new]({{% relref "basics/migration" %}}) within the latest update. * [Attachments files]({{%relref "shortcodes/attachments" %}}) * [List child pages]({{%relref "shortcodes/children" %}}) * [Mermaid diagram]({{%relref "shortcodes/mermaid" %}}) (flowchart, sequence, gantt) -* [Customizable look and feel and light or dark theme variants]({{%relref "basics/customization"%}}) +* [Customizable look and feel]({{%relref "basics/customization"%}}) +* [Predefined (light, dark) and customizable color variants]({{%relref "basics/generator" %}}) * [Buttons]({{%relref "shortcodes/button" %}}) * [Tip/Note/Info/Warning boxes]({{%relref "shortcodes/notice" %}}) * [Expand]({{%relref "shortcodes/expand" %}}) diff --git a/exampleSite/content/basics/migration/_index.en.md b/exampleSite/content/basics/migration/_index.en.md index c623f0baf6..d8c298c34d 100644 --- a/exampleSite/content/basics/migration/_index.en.md +++ b/exampleSite/content/basics/migration/_index.en.md @@ -14,6 +14,10 @@ This document shows you what's new in the latest release. For a detailed list of --- +## 3.1.0 + +- **New**: [`attachment`]({{% relref "shortcodes/attachments" %}}) and [`notice`]({{% relref "shortcodes/notice" %}}) shortcodes have a new parameter to override the default icon. Allowed values are all [Font Awesome 5 Free](https://fontawesome.com/v5/search?m=free) icons. + ## 3.0.0 - **Breaking**: We made changes to the menu footer. If you have your `menu-footer.html` [partial overridden]({{%relref "basics/customization" %}}), you may have to review the styling (eg. margins/paddings) in your partial. For a reference take a look into the `menu-footer.html` partial that is coming with the exampleSite. @@ -26,7 +30,9 @@ This document shows you what's new in the latest release. For a detailed list of Note, that this will also affect your site if viewed with Internet Explorer 11 but in this case it can not be reconfigured as Internet Explorer does not support CSS variables. -- **Change**: Due to a bug, that we couldn't fix in a general manner for color variants, we decided to remove `--MENU-SEARCH-BOX-ICONS-color`. +- **Change**: Due to a bug, that we couldn't fix in a general manner for color variants, we decided to removed `--MENU-SEARCH-BOX-ICONS-color` and introduced `--MENU-SEARCH-color` instead. You don't need to change anything in your custom color stylesheet as the old name will be used as a fallback. + +- **Change**: For consistency reasons, we renamed `--MENU-SEARCH-BOX-color` to `--MENU-SEARCH-BORDER-color`. You don't need to change anything in your custom color stylesheet as the old name will be used as a fallback. - **New**: With this release you are now capable to define your own *dark mode* variants. @@ -144,9 +150,9 @@ This document shows you what's new in the latest release. For a detailed list of - **Change**: Syntaxhighlightning was switched to the [built in Hugo mechanism](https://gohugo.io/content-management/syntax-highlighting/). You may need to configure a new stylesheet or decide to roll you own as described on in the Hugo documentation -- **Change**: In the predefined stylesheets there was a typo and `--MENU-HOME-LINK-HOVERED-color` must be changed to `--MENU-HOME-LINK-HOVER-color`. +- **Change**: In the predefined stylesheets there was a typo and `--MENU-HOME-LINK-HOVERED-color` must be changed to `--MENU-HOME-LINK-HOVER-color`. You don't need to change anything in your custom color stylesheet as the old name will be used as a fallback. -- **Change**: `--MENU-HOME-LINK-color` and `--MENU-HOME-LINK-HOVER-color` were missing in the documentation. You should add them to your custom stylesheets. +- **Change**: `--MENU-HOME-LINK-color` and `--MENU-HOME-LINK-HOVER-color` were missing in the documentation. You should add them to your custom stylesheets if you want to override the defaults. - **Change**: Arrow navigation and `children` shortcode were ignoring setting for `ordersectionsby`. This is now changed and may result in different sorting order of your sub pages. diff --git a/exampleSite/content/cont/icons.en.md b/exampleSite/content/cont/icons.en.md index a763b2ad4f..013bf8cf31 100644 --- a/exampleSite/content/cont/icons.en.md +++ b/exampleSite/content/cont/icons.en.md @@ -7,9 +7,9 @@ The Relearn theme for Hugo loads the [**Font Awesome**](https://fontawesome.com) ## Finding an icon -Browse through the available icons in the [Font Awesome Gallery](https://fontawesome.com/icons?d=gallery&m=free). Notice that the **free** filter is enabled, as only the free icons are available by default. +Browse through the available icons in the [Font Awesome Gallery](https://fontawesome.com/v5/search?m=free). Notice that the **free** filter is enabled, as only the free icons are available by default. -Once on the Font Awesome page for a specific icon, for example the page for the [heart](https://fontawesome.com/icons/heart?style=solid), copy the HTML reference and paste into the Markdown content. +Once on the Font Awesome page for a specific icon, for example the page for the [heart](https://fontawesome.com/v5/icons/heart?s=solid), copy the HTML reference and paste into the Markdown content. The HTML to include the heart icon is: @@ -33,7 +33,7 @@ Built with by Relearn and Hugo Font Awesome provides many ways to modify the icon -* Change colour (by default the icon will inherit the parent colour) +* Change color (by default the icon will inherit the parent color) * Increase or decrease size * Rotate * Combine with other icons