Hexo-Theme-Academia 说明文档

本文创建于 643 天前，更新于 643 天前，某些信息可能已经过时

这段时间除了整理这个荒废的 blog，另一件事情就是写了一个 Academic 的介绍页。本来想着写个单页直接扔到服务器上，但是发现好像功能太简单了就干脆包装成一个 Hexo 的主题发布了，也方便大家修改。（Github 上 theme 的 PR 已经通过，很快就能出现在主题清单里了）

「为什么需要 Academic Page 」

之前申请 PHD 的时候发现国外的很多组、教授、学生都喜欢做个人的展示页来展示自己或者实验室的成果，按国内许多老师的想法这是在炫耀成果或是觉得泄露了核心机密。其实不然，当你能大大方方的挂出自己的成果接受大众的审查、批判时，才是对自己成果的肯定，这才是一个研究人员应有的态度。

How to prove yourself. Show me your papers.

Theme 配置

我一直觉得 Academia 是一个很优美的词语，所以这个主题就使用了这个名字。我参考了很多学术展示页，最基本的特征就是简单，它不需要 blog 各种配置，最主要的作用就是展示你最 highlight 的成果。

Academia 的样式是我从 Jeykll 上的 academicpages 参考来的，因为它最符合我的审美（感谢原作者），然后我在 Hexo 上做了一些小的调整，只保留了 post 和 page 两个功能。

│ _config.yml
│
├─layout
│  │  index.pug
│  │  page.pug
│  └─includes
│          footer.pug
│          header.pug
│          layout.pug
│          mobile-nav.pug
│          side-card.pug
└─source
    ├─attaches
    │      CV.pdf
    ├─css
    │      index.styl
    │      user.styl
    ├─img
    │      favicon.png
    │      profile.png
    └─js
           main.js

准备工作及安装

对于不熟悉 Hexo 相关操作的朋友，下面这些基础知识还是需要掌握一下的：

发布 Hexo 博客: Easy-Hexo
Git
Markdown 语法: Learn more
配置服务器 (可选)
二次开发: Yaml, Jade/Pug, Stylus (可选)
Balabala…

安装

1	git clone https://github.com/PhosphorW/hexo-theme-academia.git themes/Academia

必要的 renderers:

1	npm install hexo-renderer-pug hexo-renderer-stylus

最后在 _config.yml 中设置 theme: Academia

使用方法

支持 post and page 两种页面

1 2	hexo n post "your title" hexo n page "your title"

只有 post 的 front-matter 中写有 academia: true 才会展示在首页，可以将要展示的信息写在一篇或多篇 post 中。这个标记对于 page 页是无效的。

布局说明

所有主题相关的样式配置都在 academia/__config.yml 中，主要有三部分内容：

Top Menu 区域：可以自行配置页内跳转、链接到其他 post 或 page、外部链接等
Sidebar 区域：个人头像、包括但不限于 Demo 中已经展示出的图标、外部链接展示、详细的 CV 链接
Content 区域：首页仅仅展示 front-matter 带 academia: true 标记的 post 内容，其余 post 或 page 页可通过顶部菜单的链接展示，page 页与主页的样式一致

(所有图标支持 font-awesome-5，~~font-awesome-4~~)

fontawesome-5 支持更多的图标类型和定义样式，即使是免费版相比 fa-4 图标数量也有较大提升，academia 从 1.2.1 起不再支持 fa-4。如从之前版本手动升级到 fa-5，需要替换样式表，同时修改旧版 icon 的类名 fa 至 fas 或 fab。

主题更新

从 1.2.0 版本起开始支持 data files 平滑更新，需要 hexo 3.+ 环境。

在第一次 clone 之后，将主题文件夹中的 _config.yml 复制到站点文件夹的 source/_data 目录下（该文件夹不存在的话则手动创建），重命名为 theme.yml，所有主题配置都可以直接在 theme.yml 中修改，调用时会默认替换主题目录中的配置文件，以后更新主题可直接 pull 最新的 branch 而不会影响到个人配置。

当使用 theme.yml 来配置主题时，每次修改后必须重启 hexo 服务，即重新执行 hexo server
有时候主题 _config.yml 会做一些功能增减，每次更新前务必参考 release page，以避免遗漏新功能或功能冲突。