开源项目 `ser-mk.github.io` 使用教程

开源项目 ser-mk.github.io 使用教程

ser-mk.github.ioMy tech blog项目地址:https://gitcode.com/gh_mirrors/se/ser-mk.github.io

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

ser-mk.github.io/
├── _config.yml
├── _data/
├── _includes/
├── _layouts/
├── _posts/
├── _sass/
├── assets/
├── css/
├── images/
├── js/
├── pages/
├── 404.html
├── about.md
├── index.html
└── README.md

目录结构介绍

• _config.yml: 项目的配置文件，包含网站的基本设置和配置。
• _data/: 存放项目的数据文件，通常用于存储一些静态数据。
• _includes/: 存放可重用的HTML片段，可以在多个页面中引用。
• _layouts/: 存放页面的布局模板。
• _posts/: 存放博客文章的Markdown文件。
• _sass/: 存放SASS样式文件。
• assets/: 存放静态资源文件，如CSS、JavaScript、图片等。
• css/: 存放CSS样式文件。
• images/: 存放图片文件。
• js/: 存放JavaScript文件。
• pages/: 存放其他页面的Markdown文件。
• 404.html: 自定义的404错误页面。
• about.md: 关于页面的Markdown文件。
• index.html: 项目的主页文件。
• README.md: 项目的说明文件。

2. 项目的启动文件介绍

项目的启动文件是 index.html，它是网站的主页文件。该文件通常包含网站的基本结构和内容，是用户访问网站时首先看到的页面。

3. 项目的配置文件介绍

项目的配置文件是 _config.yml，它包含了网站的基本设置和配置。以下是一些常见的配置项：

title: "My Tech Blog"
description: "This is my tech blog."
url: "https://ser-mk.github.io"
baseurl: ""

# 作者信息
author:
  name: "Evgeny Chormonov"
  email: "example@example.com"

# 导航栏
navigation:
  - title: "Home"
    url: "/"
  - title: "About"
    url: "/about.html"
  - title: "Blog"
    url: "/blog.html"

# 其他配置
markdown: kramdown
theme: jekyll-theme-minimal

配置文件介绍

• title: 网站的标题。
• description: 网站的描述。
• url: 网站的URL。
• baseurl: 网站的基本URL路径。
• author: 作者信息，包括姓名和邮箱。
• navigation: 导航栏的配置，定义了导航栏中的链接和标题。
• markdown: 使用的Markdown解析器。
• theme: 使用的Jekyll主题。

以上是 ser-mk.github.io 项目的基本使用教程，涵盖了项目的目录结构、启动文件和配置文件的介绍。希望这些信息能帮助你更好地理解和使用该项目。

ser-mk.github.ioMy tech blog项目地址:https://gitcode.com/gh_mirrors/se/ser-mk.github.io