dsrkafuu / hugo-theme-fuji

A minimal Hugo theme with nice theme color. | ไธ€ไธชไธป้ข˜่‰ฒๆž็ฎ€ Hugo ไธป้ข˜ใ€‚
https://github.dsrkafuu.net/hugo-theme-fuji/
Apache License 2.0
368 stars 98 forks source link
dark-mode hugo hugo-theme i18n minimal responsive theme

๐Ÿฅ Fuji ๐Ÿฅ

Fuji is a minimal Hugo theme with full dark mode support and GitHub Primer markdown style.

GitHub release GitHub build status GitHub license

English | ็ฎ€ไฝ“ไธญๆ–‡

Checkout the brand new VSCode Aofuji Light Theme which has similar color scheme to Aofuji!

Supported languages: cs, de, en, eo, fr, ja, nl, pl, pt-pt, zh-hans, zh-hant. Check the i18n folder to add more languages.

๐Ÿ“‘ Table of contents

๐Ÿ’ป Live demos

Live Demo (GitHub Pages)

Screenshot of Fuji

โ— Notice

Remember to add summary divider <!--more--> to your post .md files to show blockquotes, links and codes with proper style in list pages' summary part.

๐Ÿฃ Getting started

Inside the folder of your Hugo site run:

git submodule add https://github.com/dsrkafuu/hugo-theme-fuji.git themes/fuji

For more information read the official setup guide of Hugo.

Then copy the config.toml in the exampleSite to the root of your Hugo site, and use it as a reference for your config file. It contains all of the settings for site menus, search pages and other features, you'll need this file to make your site work properly.

๐Ÿ†• Update the theme

You can watch (release only) this repo to receive update notifications.

Inside the folder of your Hugo site run:

git submodule update --remote --merge

โš™๏ธ Configuration

๐ŸŽจ Favicon

Create [SITEROOT]/layouts/partials/favicon.html to cover theme's favicon.

You can generate your favicons in realfavicongenerator.net.

โŒ License, toc and comments

Globally in config.toml:

showLicense = true # Enable or disable license for all post
showToc = true # Enable or disable ToC for all post

Or in posts' front matter:

showLicense = true # Enable or disable license for this specific post
showToc = true # Enable or disable ToC for this specific post

To disable comment area for specific post, add this in front matter:

showComments = false # Do not show comments in this post

๐ŸŽต APlayer

In-post APlayer supported, you use the aplayer shortcode:

{{< aplayer urls="/aplayer/fluid.mp3" names="Fluid" artists="Crowander" covers="/aplayer/crowander.jpg" >}}

Checkout the exampleSite/content/post/aplayer-test.md for more example usage such as using multiple files.

๐Ÿ“ Render LaTeX with KaTex

You can write LaTeX directly in markdown with escape characters:

$$
\begin{matrix}
  a & b \\\\ c & d
\end{matrix}
$$

Or use the short code, display style:

{{< math >}}
\begin{matrix}
  a & b \\
  c & d
\end{matrix}
{{< /math >}}

Inline style:

{{< math "inline" >}}
\begin{matrix}
  a & b \\
  c & d
\end{matrix}
{{< /math >}}

Don't forget to add math = true in your front matter or config.toml.

๐Ÿ“ท Image zoom and lazyload settings

Zoomable, not lazyloaded:

![Alt text](test/example.png)

Zoomable, lazyloaded:

{{< img-lazy "16x9" "Alt text here" "test/example.png" >}}

Not zoomable, not lazyloaded, optional ext link:

{{< img-nz "Alt text here" "test/example.png" >}}

Not zoomable, lazyloaded, optional ext link:

{{< img-nz-lazy "16x9" "Alt text here" "test/example.png" >}}

Available image aspect ratios:

โš“ Markdown render hook

You can create the files below in your site to adjust the markdown render hook, see Hugo's Official Docs.

You can use [SITEROOT]/layouts/_default/_markup/render-link.html to decide whether or not links in the markdown content will open in new tab:

<a href="https://github.com/dsrkafuu/hugo-theme-fuji/blob/master/{{ .Destination | safeURL }}"{{ with .Title }} title="{{ . }}"{{ end }}{{ if strings.HasPrefix .Destination "http" }} target="_blank"{{ end }}>{{ .Text | safeHTML }}</a>

๐Ÿ“จ Comments area

Theme supports Disqus, utterances and DisqusJS (for Mainland China user)ใ€‚

by default, disqus uses {{ .Permalink }} as url, {{ .File.ContentBaseName }} as identifier.

Use the [SITEROOT]/layouts/partials/comment-*.html to cover themes/fuji/layouts/partials/comment-*.html. Then you can customize the url and identifier, or set multiple api key, add more settings for using DisqusJS. If you want to use DisqusJS, please remember to set disqusJSApi to anything in your config.toml to load CSS.

๐Ÿ”ง Custom stylesheet configuration

Hugo extended version needed.

You can override theme's internal SCSS variables with your own. Create [SITEROOT]/assets/scss/_custom_var.scss to cover variables in SCSS.

Variables available:

$body-font: -apple-system, BlinkMacSystemFont, 'SF Pro Text', 'Helvetica Neue', 'Helvetica',
  'Arial', 'PingFang SC', 'Hiragino Sans GB', 'Source Han Sans CN', 'Source Han Sans SC',
  'Microsoft YaHei', 'WenQuanYi Micro Hei', sans-serif;
$mono-font: 'Cascadia Code', 'SF Mono', 'Fira Code', 'Consolas', $body-font;
$title-font: 'Product Sans', $body-font;
$body-font-size: 16px;

$light-color-primary: #8aa2d3; // https://irocore.com/aofuji/
$light-color-secondary: #8f82bc; // https://irocore.com/fujimurasaki/
$light-color-focus: #3b469b; // https://irocore.com/aomurasaki/
$light-color-mute: #9ea1a3; // https://irocore.com/suzu-iro/
$light-color-font: #3f4551; // https://irocore.com/konnezu/
$light-color-divider: #e5e2e4; // https://irocore.com/komachinezu/
$light-color-bg: #fffffd; // https://irocore.com/shiro/
$light-color-codebg: #f6f8fa; // GitHub

$dark-color-primary: #8aa2d3; // https://irocore.com/aofuji/
$dark-color-secondary: #bab1df; // https://irocore.com/fujimurasaki/
$dark-color-focus: #e6e6e6; // https://irocore.com/shironezumi/
$dark-color-mute: #9ea1a3; // https://irocore.com/suzu-iro/
$dark-color-font: #c0c0c0; // https://irocore.com/gin-iro/
$dark-color-divider: #4d5158; // Discord
$dark-color-bg: #2f3136; // Discord
$dark-color-codebg: #414449; // GitHub

To override SCSS rules, create [SITEROOT]/assets/scss/_custom_rules.scss. This file will have priority over anything regarding CSS rules, but is useless for changing variables that are used elsewhere in the theme.

โœ๏ธ Issue and contributing

Feel free to use the issue tracker. The theme has only been fully tested on Firefox, so if there are some problems when accessing with Chrome or others please also report an issue.

๐Ÿ“ License

The theme is released under the Apache License 2.0, for more information read the License.

Copyright ยฉ 2019-present DSRKafuU https://dsrkafuu.net/

๐Ÿค Annotations

Thanks to community contributors for great help.

Learned a lot in Sukka's Blog.