野路子搭建自己的科研主页 hugo+academic，github.io

admin管理员组

文章数量:1546840

hugo 0.68.3
academic 4.8
ubuntu 20.04

或许这篇文章写的有些迟，但是没有看到更好的，因此还是很有必要写。
前情回顾： 起因， 某日发现github可以提供github pages，让个人可以搭建一个（个人名字.github.io) 的个人主页。之前虽然也搭建过个人主页，但是由于缺乏维护经费和时间，不了了之了。之前看到某大牛学者用了academic模板做自己的网站，心生羡慕。最近，终于有时间可以搞一下啦。

简介

网站分为动态网站和静态网站，不细说。像个人主页这种一般静态网站就可以了，不需要搞成复杂的动态网站。hugo 就是这么一种可以直接通过简单设置，就能得到比较好的静态网页的工具，简称静态网站生成工具。模板是网站的展示样式，academic 最开始就是hugo的一个模板，但是后续增加了很多神奇的东西，时间原因懒得研究了，为此起见，采用了academic 4.8这个版本。

环境准备

安装hugo

ubuntu 20.04上直接安装hugo版本有些低，建议改成清华源之后安装.

sudo apt install hugo

设置新站点

hugo new site 文件夹名字(例如，my_site)

这个时候就有了my_site文件夹，自动生成一些文件夹如下

archetypes
config.toml
content
data
layouts
static
themes

下载并测试 academic

下载academic 4.8并解压到themes文件夹下命名为academic
不同release 版本academic

将其中的exampleSite文件夹下的所有文件夹放到my_site文件夹下。exampleSite文件夹是一个简单的样例，其实可以有其他的方法生成，这种最简单。

测试运行

在my_site文件夹下使用命令

hugo server

把http://localhost:1313/ 粘贴到浏览器里，就可以查看网页了。
如果已经有一个了，这里会变成其他的（例如http://localhost:34581），复制粘贴就行。

设置自己的github.io

搭建自己的github.io主页

参见https://blog.csdn/qq_34106574/article/details/82704883

生成静态网站

在my_site文件夹下使用命令

hugo -D

这时候会多出来一个public文件夹，这个文件夹里的内容就是生成好的网站。

上传到你的github.io

方法一，直接拖动到github上你的github.io仓库下，然后访问 你的名字.github.io 就可以了。
方法二，采用git上传,

• 先把public 下的文件全删了
• 拉取github.io的main分支
• 运行 hugo -D 生成，
• 上传到github 例如： git add . && git comment -m “xiediansha” && git push origin main

注意，由于github把所有的主分支改成了main，如需修改，参照https://zhuanlan.zhihu/p/339370999

academic的使用方法

两个重要的文件夹

config/_default/ 这个文件夹下是设置
content 这个文件夹下是主要内容

config的各种设置

config/_default/文件夹下的设置

config.toml 这个文件是设置
languages.toml 这个文件是双语设置
menus.toml 设置标题
params.toml 其他设置

具体的设置里边都有说明，或者参考https://www.bilibili/video/BV1iA411v7Gi?from=search&seid=12419074823331143082

content 的主要使用方法

home 文件夹是主页元素的设置
authors 文件夹下是作者信息的设置
project 文件夹下是项目
publication 文件夹下是publication

home文件夹下内容

每个md文件都类似于

+++
widget = “blank” # See https://sourcethemes/academic/docs/page-builder/ 这个是文件类型，详细参见这个连接
headless = true # This file represents a page section.
active = true # Activate this widget? true/false 这个是是否显示，可以选择false不显示，或者直接删掉文件从而不显示。这个要重启hugo server。
weight = 15 # Order that this section will appear. 权重，权重越小，优先级越高，即在最上边显示
+++
上边加号内的是设置，这个后边这里可以写东西，原样显示的。

其他文件夹下的md文件类似原理。

project的和publication的联动

在publication的index.md中设置

projects:
- internal-project 这个是 project的目录，而不是名称

这样在相应的project详情页中就可以看到文章了。

添加publication，或其他的任何东西

找到相应的文件夹，复制一个原来的，粘贴，然后改成自己的名字并修改index.md就行了。
index.md 里边有注释，大概翻一下能看懂。

双语言设置languages.toml

这里可以设置默认语言，不同语言的文件夹等内容。
但是，貌似不可以共用信息，就像两个独立的网站一样。

注意，以上都是野路子，其实hugo有自己的命令添加publication等部件。

本文标签： 自己的路子科研主页GitHub