极简 Wiki：02-首页模式

极简(jijian) 主题提供三种首页展示模式，由原 PaperMod 主题基础上重新命名而来，更加直观易懂：

jijian 主题	原 PaperMod 主题	说明
Blog Mode（博客模式）	Regular Mode	首页直接显示文章列表
Portal Mode（门户模式）	Home-Info Mode	顶部显示个人信息卡片，下方显示文章列表
Card Mode（名片模式）	Profile Mode	居中显示个人头像、标题和社交图标，无文章列表

Blog Mode（博客模式）

配置方法

这是默认模式，无需特殊配置。如需指定首页显示的内容分区：

1
2
3
4
params:
  mainSections:
    - posts
    - docs

说明：

mainSections 指定首页显示的内容目录
如果不配置，默认显示所有文章

完整示例

1
2
3
4
5
6
7
8
9
baseURL: https://your-domain.com/
title: 我的博客
theme: jijian

params:
  # Blog Mode 是默认模式，无需特殊配置
  mainSections:
    - posts
    - docs

Portal Mode（门户模式）

配置方法

1
2
3
4
5
6
params:
  portalMode:
    enabled: true                     # 启用门户模式
    Title: 你的名字                    # 标题
    Content: 欢迎来到我的小站...        # 内容描述（支持 Markdown）
    AlignSocialIconsTo: center         # 社交图标对齐方式

参数说明

参数	类型	必需	说明
`enabled`	boolean	是	是否启用门户模式
`Title`	string	是	显示的标题
`Content`	string	是	显示的内容描述，支持 Markdown
`AlignSocialIconsTo`	string	否	社交图标对齐方式：`left`、`center`、`right`

社交图标配置

在Portal Mode（门户模式）下，还支持配置社交图标，在 params.socialIcons 中配置：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
params:
  socialIcons:
    - name: bilibili
      title: 哔哩哔哩
      url: https://space.bilibili.com/xxxxxx
      hoverImage: /img/bilibili-qr.png
    - name: wechat
      url: "javascript:void(0);"    # 无跳转链接
      hoverImage: /img/wechat-qr.png
      title: 微信二维码

参数说明

参数	类型	必需	说明
`name`	string	是	图标名称
`title`	string	否	图标标题
`url`	string	否	跳转链接
`hoverImage`	string	否	鼠标悬停时显示的图片路径

悬浮二维码功能：配置 hoverImage 参数后，鼠标悬停在图标上会弹出图片/二维码。

支持的平台

name	平台	name	平台
`bilibili`	哔哩哔哩	`douyin`	抖音
`wechat`	微信	`weibo`	微博
`xiaohongshu`	小红书	`shipinhao`	视频号
`zhihu`	知乎	`douban`	豆瓣
`qq`	QQ	`qzone`	QQ 空间
`tieba`	百度贴吧	`juejin`	掘金
`github`	GitHub	`gitlab`	GitLab
`gitea`	Gitea	`git`	Git
`codepen`	CodePen
`twitter` / `x`	Twitter/X	`bluesky`	Bluesky
`mastodon`	Mastodon	`discord`	Discord
`reddit`	Reddit	`facebook`	Facebook
`instagram`	Instagram	`youtube`	YouTube
`tiktok`	TikTok
`email`	邮箱	`rss`	RSS 订阅
`goodreads`	Goodreads
`other`	感叹号为缺省值

完整示例

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
params:
  portalMode:
    enabled: true
    Title: 莫莫先生
    Content: |
      👋 Hello! 欢迎来到我的小站
      
      这里是一段其他的什么不得了的描述。
    AlignSocialIconsTo: center

  socialIcons:
    - name: github
      url: https://github.com/yourname
      hoverImage: /img/github-qr.png
    - name: email
      title: 发送邮件
      url: mailto:your@email.com

Card Mode（名片模式）

配置方法

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
params:
  cardMode:
    enabled: true                     # 启用名片模式
    title: 你的网站名字                   # 主标题
    subtitle: 欢迎来到我的小站        # 副标题/签名
    imageUrl: /img/avatar.png         # 头像图片路径
    imageWidth: 120                   # 图片宽度（像素）
    imageHeight: 120                  # 图片高度（像素）
    imageTitle: 头像                  # 图片标题（alt 属性）
    buttons:                          # 可选按钮
      - name: 文章
        url: posts
      - name: 关于
        url: about

参数说明

参数	类型	必需	说明
`enabled`	boolean	是	是否启用名片模式
`title`	string	否	显示的主标题
`subtitle`	string	否	显示的副标题或签名
`imageUrl`	string	否	头像图片路径
`imageWidth`	integer	否	图片宽度（像素），默认 120
`imageHeight`	integer	否	图片高度（像素），默认 120
`imageTitle`	string	否	图片 alt 文本
`buttons`	array	否	快捷按钮列表

按钮配置

每个按钮支持以下参数：

参数	类型	必需	说明
`name`	string	是	按钮显示文字
`url`	string	是	跳转链接，支持相对路径和绝对路径

完整示例

Card Mode（名片模式）也支持配置社交图标，在 params.socialIcons 中配置：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
params:
  cardMode:
    enabled: true
    title: 莫莫先生
    subtitle: 👋 Hello! 欢迎来到我的小站
    imageUrl: /img/avatar.png
    imageWidth: 120
    imageHeight: 120
    imageTitle: 莫莫先生
    buttons:
      - name: 📝 文章
        url: posts
      - name: 📂 归档
        url: archives
      - name: 🔍 搜索
        url: search
      - name: ℹ️ 关于
        url: about

  socialIcons:
    - name: github
      url: https://github.com/yourname
      hoverImage: /img/github-qr.png
    - name: email
      title: 发送邮件
      url: mailto:your@email.com