If you like this theme, please give me a star!
An Apple style theme for Hugo, inspired by astro-air-blog
Before you start, make sure you have installed Hugo.
Here's the demo site repo
git clone --recurse-submodules https://github.com/floyd-li/itheme-demo-site.git my-site
cd ./my-site && hugo server -D
Then you can visit https://localhost:1313
to see the demo site!
git submodule add https://github.com/floyd-li/hugo-theme-itheme.git themes/hugo-theme-itheme
echo "theme = 'hugo-theme-itheme'" >> config.toml
Then you need to add some configuration to config.toml
, please flow the Site Configuration.
Light
andDark
mode for post- Three different sizes for images in the post
i18n
support (currently only supporten
andzh-hans
, there is a great need for contributing translation)- Algolia search integration
- Custom JavaScript/CSS support (You may put these files in
static/
directory)
defaultContentLanguage = "en" # current only supported 'en' and 'zh-hans', see the 'i18n' folder
[params]
defaultCover = 'https://example.com/cover.jpg' # default cover image for post not setting cover
email = '[email protected]' # the email address display in the footer
[params.algolia] # Algolia search configuration
enabled = true # enable Algolia search
appId = 'YOUR_KEY' # appid for Algolia search
appKey = 'YOUR_APP_KEY' # appkey for Algolia search
searchIndex = 'YOUR_INDEX' # index for Algolia search
[[params.css]] # custom css stylesheet, you can add one or more, url is relative in 'static' folder
url = 'css1.css'
[[params.css]]
url = 'css2.css'
[[params.js]] # custom javascript, you can add one or more, url is relative in 'static' folder
url = 'js1.js'
[[params.js]]
url = 'js2.js'
[[params.socialMedia]] # custom social links display in the footer, you can add one or more
name = 'Github'
url = 'https://github.com/floyd-li'
[[params.socialMedia]]
name = 'Twitter'
url = 'https://twitter.com/some-one'
[[params.blogroll]] # blogroll links display in the footer, you can add one or more
name = 'Apple'
url = 'https://Apple.com/'
[[params.blogroll]]
name = 'Google'
url = 'https://Google.com/'
---
title: 'Some Article'
date: '2022-10-27T13:06:38+08:00'
draft: true
description: 'some description of the article'
author: 'author of this article'
cover: 'https://example.com/cover.jpg' // if not set cover, it will use the 'defaultCover' in site configuration
tags: ["tag1", "tag2", "tag3"]
theme: "dark" // you can set 'light' or 'dark' here
---
The three display modes of images are: inline
, big
, wide
, you can visit the demo site for preview
When you edit your markdown file, you can add inline
, big
or wide
to the image alt, like this:
![alt content|wide](a.png)
The Separator is |
, and the default mode is big
.