Introduce March 25, 2022

iTheme - 一个果味十足的Hugo主题

an introduce for iTheme

如果喜欢这个主题, 请给我点赞

介绍

English Readme

一个苹果味十足的Hugo主题,移植自astro-air-blog

预览

测试站点

快速开始

在开始之前,请先安装好Hugo

使用测试站点快速开始

这是测试站点的仓库

git clone https://github.com/floyd-li/itheme-demo-site.git my-site
cd ./my-site && hugo -server -D

然后,就可以访问http://localhost:1313查看效果啦~

作为一个已有项目的主题

git submodule add https://github.com/floyd-li/hugo-theme-itheme.git themes/hugo-theme-itheme
echo "theme = 'hugo-theme-itheme'" >> config.toml

可能需要在config.toml文件中添加一些配置,请参考后文的站点配置

截屏

screenshot
screenshot

特性

  • 支持文章明``暗两种风格
  • 文中配置支持三种不同的大小
  • 多语言支持(当前仅支持了中文和英文,欢迎提交其他语言的翻译)

配置

站点配置

defaultContentLanguage = "en" # 默认语言,当前仅支持英文(en)和简体中文(zh-hans),可以查看'i18n'文件夹
[params]
  defaultCover = 'https://example.com/cover.jpg' # 文章未设置封面时的默认封面图
  email = 'floyd.li@outlook.com' # 页脚显示的邮件地址the email address display in the footer
  [[params.socialMedia]] # 页脚显示的自定义的媒体链接,可添加多个
    name = 'Github'
    url = 'https://github.com/floyd-li'
  [[params.socialMedia]]
    name = 'Twitter'
    url = 'https://twitter.com/some-one'
  [[params.blogroll]] # 页脚显示的自定义的友情链接,可添加多个
    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' // 封面图,如果这里没有配置,将会使用站点配置中的defaultCover
tags: ["tag1", "tag2", "tag3"]
theme: "dark" // 设置文章的明暗主题(light/dark)
---

三种图片显示模式

三种图片显示模式分别为inline(中杯)big(大杯)wide(特大杯),具体效果可参见演示站点页面 在编辑Markdown文件时,可以在插入配图的alt属性上加上inline, bigwide即可。

![alt 这是一个特大杯|wide](a.png)

分隔符是英文字符|,如果未设置则默认显示大杯big

Copyright: Attribution-NonCommercial-ShareAlike 4.0 International (CC BY-NC-SA 4.0)

Author: Floyd Li

Posted on: March 25, 2022