Skip to content


Repository files navigation

🍥 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 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

❌ 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/ for more example usage such as using multiple files.

📐 Render LaTeX with KaTex

You can write LaTeX directly in markdown with escape characters:

  a & b \\\\ c & d

Or use the short code, display style:

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

Inline style:

{{< math "inline" >}}
  a & b \\
  c & d
{{< /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:

  • 40x9
  • 32x9
  • 21x9
  • 18x9
  • 16x9
  • 16x10
  • 3x2
  • 4x3
  • 1x1
  • 3x4
  • 2x3
  • 10x16
  • 9x16
  • 9x18
  • 9x21
  • 9x32

⚓ 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="{{ .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; //
$light-color-secondary: #8f82bc; //
$light-color-focus: #3b469b; //
$light-color-mute: #9ea1a3; //
$light-color-font: #3f4551; //
$light-color-divider: #e5e2e4; //
$light-color-bg: #fffffd; //
$light-color-codebg: #f6f8fa; // GitHub

$dark-color-primary: #8aa2d3; //
$dark-color-secondary: #bab1df; //
$dark-color-focus: #e6e6e6; //
$dark-color-mute: #9ea1a3; //
$dark-color-font: #c0c0c0; //
$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

🤝 Annotations

Thanks to community contributors for great help.

Learned a lot in Sukka's Blog.