From d185ecccaabcaf4a9cced394d5b72f246bc2e5e7 Mon Sep 17 00:00:00 2001 From: amzrk2 Date: Thu, 4 Jun 2020 15:56:03 +0800 Subject: Allow disable license globally --- README.md | 78 ++++++++++++++++++++++++++++++++++----------------------------- 1 file changed, 42 insertions(+), 36 deletions(-) (limited to 'README.md') diff --git a/README.md b/README.md index a8e5b0f..8d0283c 100644 --- a/README.md +++ b/README.md @@ -1,4 +1,4 @@ -# Fuji +# ๐Ÿฅ Fuji ๐Ÿฅ Fuji is a minimal Hugo theme with full dark mode support and GitHub Primer markdown style. @@ -6,36 +6,36 @@ Fuji is a minimal Hugo theme with full dark mode support and GitHub Primer markd [English](https://github.com/amzrk2/hugo-theme-fuji#readme) | [็ฎ€ไฝ“ไธญๆ–‡](https://github.com/amzrk2/hugo-theme-fuji/blob/master/README_CN.md) -## Table of contents - -- [Live demos](#live-demos) -- [Notice](#notice) -- [Getting started](#getting-started) -- [Update the theme](#update-the-theme) -- [Configration](#configration) - - [Favicon](#favicon) - - [In-post license & comments](#in-post-license--comments) - - [APlayer](#aplayer) - - [Image zoom and lazyload settings](#image-zoom-and-lazyload-settings) - - [Markdown render hook](#markdown-render-hook) - - [Comments area](#comments-area) - - [Load main CSS und JS from CDN](#load-main-css-und-js-from-cdn) - - [Advanced configuration](#advanced-configuration) -- [Report und contributing](#report-und-contributing) -- [License](#license) -- [Annotations](#annotations) - -## Live demos +## ๐Ÿ“‘ Table of contents + +- [๐Ÿ’ป Live demos](#live-demos) +- [โ— Notice](#notice) +- [๐Ÿฃ Getting started](#getting-started) +- [๐Ÿ†• Update the theme](#update-the-theme) +- [โš™๏ธ Configration](#configration) + - [๐ŸŽจ Favicon](#favicon) + - [โŒ In-post license & comments](#in-post-license--comments) + - [๐ŸŽต APlayer](#aplayer) + - [๐Ÿ“ท Image zoom and lazyload settings](#image-zoom-and-lazyload-settings) + - [โš“ Markdown render hook](#markdown-render-hook) + - [๐Ÿ“จ Comments area](#comments-area) + - [โฑ๏ธ Load main CSS und JS from CDN](#load-main-css-und-js-from-cdn) + - [๐Ÿ”ง Advanced configuration](#advanced-configuration) +- [โœ๏ธ Report und contributing](#report-und-contributing) +- [๐Ÿ“ License](#license) +- [๐Ÿค Annotations](#annotations) + +## ๐Ÿ’ป Live demos [**Live Demo (en)**](https://themes.gohugo.io/theme/hugo-theme-fuji/) | [My Blog (zh-Hans)](https://blog.amzrk2.cc/) ![Screenshot of Fuji](https://raw.githubusercontent.com/amzrk2/hugo-theme-fuji/master/images/screenshot.png) -## Notice +## โ— Notice Remember to add [summary divider](https://gohugo.io/content-management/summaries/#manual-summary-splitting) `` to your post `.md` files to show blockquotes, links and codes with proper style in list pages' summary part. -## Getting started +## ๐Ÿฃ Getting started Inside the folder of your Hugo site run: @@ -55,7 +55,7 @@ $ hugo server If you want to generate your site, just run `hugo` or `hugo --minify`. -## Update the theme +## ๐Ÿ†• Update the theme Inside the folder of your Hugo site run: @@ -63,15 +63,15 @@ Inside the folder of your Hugo site run: $ git submodule update --remote --merge ``` -## Configration +## โš™๏ธ Configration -### Favicon +### ๐ŸŽจ Favicon Create `[SITEROOT]/layouts/partials/favicon.html` to cover theme's favicon. You can generate your favicons in [realfavicongenerator.net](https://realfavicongenerator.net/). -### In-post license & comments +### โŒ In-post license & comments You can set variables below in post's front matter to disable them: @@ -80,7 +80,13 @@ noLicense = true # Do not show license in this post noComments = true # Do not show comments in this post ``` -### APlayer +Or you can disable the license globally, set this below to false or comment it in your `config.toml`: + +```toml +showLicense = false +``` + +### ๐ŸŽต APlayer In-post APlayer supported, you can set these variables in post's front matter: @@ -91,7 +97,7 @@ playerURL = "..." # Audio URL, support aac, mp3, wav and ogg playerCover = "..." # Audio cover ``` -### Image zoom and lazyload settings +### ๐Ÿ“ท Image zoom and lazyload settings Zoomable, not lazyloaded: @@ -123,7 +129,7 @@ Not zoomable, lazyloaded, optional ext link: `img-lazy` will show a 16x9 placeholder before image is loaded, so `img-lazy-row` will show a 32x9 placeholder and `img-lazy-col` will show a 8x9 placeholder. You can choose different aspect ratios you want for different images. The placeholder image can be set in site's `config.toml`. -### Markdown render hook +### โš“ Markdown render hook You can create the files below in your site to adjust the markdown render hook, see [Hugo's Official Docs](https://gohugo.io/getting-started/configuration-markup#markdown-render-hooks). @@ -133,7 +139,7 @@ You can use `[SITEROOT]/layouts/_default/_markup/render-link.html` to decide whe {{ .Text | safeHTML }} ``` -### Comments area +### ๐Ÿ“จ Comments area ไธป้ข˜ๆ”ฏๆŒไธ‰็ง่ฏ„่ฎบ็ณป็ปŸ๏ผŒDisqusใ€utterances ๅ’Œ DisqusJS (็ป™ๅคง้™†็”จๆˆท็š„)ใ€‚ @@ -146,15 +152,15 @@ You can check my blog for example of using DisqusJS and add more settings and ap - [`config.toml`]() - [`comment-disqusjs.html`]() -### Load main CSS und JS from CDN +### โฑ๏ธ Load main CSS und JS from CDN Without the demand of custmize the CSS, you can uncomment `mainAssetsCDN = true` in `config.toml` to load `fuji.min.css` and `fuji.min.js` from jsDelivr. -### Advanced configuration +### ๐Ÿ”ง Advanced configuration See [Report und contributing](#report-und-contributing). -## Report und contributing +## โœ๏ธ Report und contributing Note that to keep the `master` branch clean, the main development work is made under `dev` branch. Please set base branch to `dev`, then make commitment or pull request. @@ -178,7 +184,7 @@ Build: npm run build ``` -## License +## ๐Ÿ“ License The theme is released under the ```Apache License 2.0```, for more information read the [License](https://github.com/amzrk2/hugo-theme-fuji/blob/master/LICENSE). @@ -191,7 +197,7 @@ The theme is released under the ```Apache License 2.0```, for more information r > ยฉ 2020 DSRKafuU(amzrk2) [Twitter](https://twitter.com/amzrk2) [GitHub]() -## Annotations +## ๐Ÿค Annotations Thanks to [community contributors](https://github.com/amzrk2/hugo-theme-fuji/graphs/contributors) for great help. -- cgit v1.2.3