Avicenna 项目使用与配置教程

1. 项目的目录结构及介绍

Avicenna 是一个基于 Hugo 的最小化学术页面主题。以下是项目的目录结构及其简要介绍：

avicenna/
├── archetypes/
├── assets/
├── content/
│   ├── about/
│   ├── projects/
│   └── publications/
├── data/
├── layouts/
├── static/
├── themes/
│   └── avicenna/
├── .gitignore
├── config.toml
├── hugo.exe (Windows 用户)
└── README.md

• archetypes/：包含 Hugo 使用的原型文件。
• assets/：存放静态资源，如图片、CSS 和 JavaScript 文件。
• content/：包含网站的内容文件，如个人简介、项目和出版物。
• data/：存放数据文件，如 JSON 或 YAML 文件。
• layouts/：包含网站的布局文件。
• static/：存放静态文件，如图片、CSS 和 JavaScript 文件。
• themes/：包含 Avicenna 主题文件。
• .gitignore：指定 Git 忽略的文件和目录。
• config.toml：项目的配置文件。
• hugo.exe：Hugo 可执行文件（仅限 Windows 用户）。
• README.md：项目说明文件。

2. 项目的启动文件介绍

启动 Avicenna 项目的方法有两种：自动化脚本和手动安装。

自动化脚本

使用自动化脚本，只需将 my_cool_page 替换为您希望的项目名称，然后执行以下命令：

wget https://raw.githubusercontent.com/hadisinaee/avicenna/master/setup_avicenna.sh && sh setup_avicenna.sh my_cool_page

执行脚本后，运行以下命令启动网站：

hugo serve

现在，您应该能够在 http://localhost:1313 上看到网站。

手动安装

1. 安装 Hugo。
2. 创建一个新站点并进入目录：

hugo new site my_cool_page
cd my_cool_page

3. 将 Avicenna 主题添加到主题目录：

git clone -b master https://github.com/hadisinaee/avicenna.git themes/avicenna

4. 将示例站点复制到您的项目：

cp -R themes/avicenna/exampleSite/* .

5. 运行网站：

hugo serve

现在，您应该能够在 http://localhost:1313 上看到网站。

3. 项目的配置文件介绍

Avicenna 的配置文件为 config.toml。此文件位于项目的根目录中，用于设置您的网站信息，如网站标题、URL、Google Analytics ID 等。

以下是一个基本的 config.toml 文件示例：

baseURL = "https://your-website-url.com"
languageCode = "zh-CN"
title = "我的学术主页"
theme = "avicenna"

[params]
  author = "您的名字"
  description = "您的简介"
  googleAnalytics = "您的 Google Analytics ID"

您可以根据需要自定义配置文件，添加更多设置和参数。