开源项目 `pages-themes/architect` 使用教程

开源项目 pages-themes/architect 使用教程

architectArchitect is a Jekyll theme for GitHub Pages项目地址:https://gitcode.com/gh_mirrors/archit/architect

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

pages-themes/architect/
├── _includes/
│   ├── footer.html
│   ├── head.html
│   ├── header.html
│   └── scripts.html
├── _layouts/
│   ├── default.html
│   ├── home.html
│   └── page.html
├── assets/
│   ├── css/
│   │   └── main.scss
│   └── js/
│       └── main.js
├── _sass/
│   ├── architect/
│   │   ├── _base.scss
│   │   ├── _layout.scss
│   │   └── _syntax-highlighting.scss
│   └── minima/
│       ├── _base.scss
│       ├── _layout.scss
│       └── _syntax-highlighting.scss
├── .gitignore
├── .travis.yml
├── 404.html
├── about.md
├── Gemfile
├── Gemfile.lock
├── index.md
└── README.md

目录结构介绍

• _includes/: 包含页面的各个部分，如页眉、页脚和脚本。
• _layouts/: 包含页面的布局模板。
• assets/: 包含CSS和JavaScript文件。
• _sass/: 包含SCSS样式文件。
• .gitignore: Git忽略文件。
• .travis.yml: Travis CI配置文件。
• 404.html: 404错误页面。
• about.md: 关于页面。
• Gemfile: Ruby依赖管理文件。
• Gemfile.lock: 锁定Gemfile中的依赖版本。
• index.md: 主页内容。
• README.md: 项目说明文档。

2. 项目的启动文件介绍

项目的启动文件是 index.md，它定义了主页的内容和布局。通过编辑这个文件，可以修改主页的显示内容。

3. 项目的配置文件介绍

项目的配置文件主要包括以下几个部分：

• _config.yml: Jekyll配置文件，用于设置网站的基本信息、插件和变量等。
• Gemfile 和 Gemfile.lock: 用于管理项目的Ruby依赖。
• .travis.yml: 用于配置Travis CI的持续集成设置。

_config.yml 示例

title: 我的博客
email: example@example.com
description: >- # 这个会显示在首页的描述中
  这是一个使用 Architect 主题的 Jekyll 博客。
baseurl: "" # 网站的子路径，如 "/blog"
url: "http://example.com" # 网站的域名
twitter_username: jekyllrb
github_username:  jekyllrb

# 构建设置
markdown: kramdown
theme: minima
plugins:
  - jekyll-feed

通过编辑 _config.yml 文件，可以自定义网站的标题、描述、URL等基本信息，以及配置使用的插件和主题。

architectArchitect is a Jekyll theme for GitHub Pages项目地址:https://gitcode.com/gh_mirrors/archit/architect