首页
/ Jekyll主题——Editorial的使用与配置

Jekyll主题——Editorial的使用与配置

2025-05-04 11:48:02作者:俞予舒Fleming

一、项目目录结构及介绍

在克隆或下载editorial-jekyll-theme项目后,你会看到以下目录结构:

.
├── _config.yml
├── _data
│   └── sponsors.yml
├── _includes
│   ├── footer.html
│   ├── head.html
│   ├── header.html
│   └── navigation.html
├── _layouts
│   ├── default.html
│   ├── page.html
│   └── post.html
├── _posts
│   └── 2022-01-01-welcome-to-jekyll.markdown
├── about.md
├── assets
│   ├── css
│   │   └── main.scss
│   ├── font
│   │   └── ...
│   ├── img
│   │   └── ...
│   └── js
│       └── ...
├── feed.xml
├── Gemfile
├── Gemfile.lock
├── index.md
└── README.md

以下是各部分的简要介绍:

  • _config.yml:Jekyll的配置文件,可以在这里设置网站的标题、描述、作者等信息。
  • _data:存放数据文件,例如赞助商列表等。
  • _includes:可重用的模板文件,例如页头、页脚、导航栏等。
  • _layouts:布局文件,定义了页面结构。
  • _posts:存放博客文章的Markdown文件。
  • about.md:关于页面的Markdown文件。
  • assets:存放静态资源,如CSS、字体、图片和JavaScript文件。
  • feed.xml:用于生成网站的RSS订阅。
  • GemfileGemfile.lock:Ruby的依赖文件,用于管理Jekyll的依赖。
  • index.md:网站的主页,通常包含欢迎信息。
  • README.md:项目的说明文件。

二、项目的启动文件介绍

为了启动此Jekyll项目,你需要确保你的系统中已经安装了Ruby和 Bundler。以下是启动项目的步骤:

  1. 打开命令行终端。
  2. 切换到项目目录。
  3. 运行bundle install来安装项目依赖。
  4. 运行bundle exec jekyll serve,Jekyll将会在本地启动一个服务器,默认端口为4000。
  5. 在浏览器中访问http://localhost:4000查看你的网站。

三、项目的配置文件介绍

项目的配置主要通过修改_config.yml文件进行。以下是一些常见的配置项:

  • title:网站的标题。
  • description:网站的描述。
  • author:网站作者的名称。
  • baseurl:网站的URL(如果是在根域名下则留空)。
  • url:网站完整的URL。
  • encoding:网站的字符编码。
  • includeexclude:用于指定在Jekyll构建过程中包含或排除的文件。

确保在修改配置文件后重新启动Jekyll服务器以应用更改。

登录后查看全文
热门项目推荐