- Github Pages base on Jekyll
- Init
gem install jekyll bundlejekyll new wkevin.github.iocd wkevin.github.iobundle exec jekyll serve
_config.yml_config.yml是给jekyll serve或jekyll build使用的- jekyll official
- 修改后需要重启 jekyll serve
Gemfile- Github Pages 有默认的 Gemfile，用户不需要上传：
git rm Gemfile - 本地浏览如果需要模拟 Github Pages，修改:
- 注释
gem "jekyll" - 打开
gem "github-pages", group: :jekyll_plugins
- 注释
- Github Pages 有默认的 Gemfile，用户不需要上传：
- Config theme
- 一些theme是gem打包发布的，用户的文档中不会出现
_layout、_css等内容，本地和远程只需指定theme:xxx或remote_theme:xxx- 本地 bundle 安装了 theme 后，可以使用
bundle show xxx查看其具体内容，学习或修改
- 本地 bundle 安装了 theme 后，可以使用
- 一些theme而是以源码发布的，需要用户
fork或git clone其_layout、_css等内容到自己的文件夹中。 - 不同的theme会有不同的配置项，如：layout：xxx，需要读其说明，仔细配置
- Github Pages 把 theme 分 2 类：
- officially supported themes:
theme: xxx，都已gem化。- Blog使用： 自动搜索
_posts目录并生成瀑布流文章列表theme: minima——jekyll new时默认
- 网站使用： 自己组织链接，不支持page、post
theme: jekyll-theme-cayman- 其他的都是，所以要想写blog，还得用下面的
remote_theme
- Blog使用： 自动搜索
- open source Jekyll theme hosted on GitHub
remote_theme: xxx—— 需要该theme已经gem化，Github Pages能够在云端找到并安装- https://github.com/mmistakes/minimal-mistakes
- https://github.com/mmistakes/so-simple-theme —— 简洁、大方，本Blog使用
- 简要说明
data/navigation.yml定义导航栏- 10种layout：home, posts, post, collection(等同pages), page, categories, category, tags, tag, search.
- 2种 entries_layout ： list, grid
- 个性化配置方法
_config.yml中可以在[head|footer]_scripts中添加 js 的路径，注意是下滑线bundle show jekyll-theme-so-simple查看本插件源文件的位置- 从源文件中拷贝
_includes/[head|footer]-custom.html到blog目录下，根据情况修改 - 从源文件中拷贝
assets/css/main.scss到blog目录下，酌情修改 - 从源文件中拷贝
assets/js/main.js到blog目录下，酌情修改
- 我的配置：
- 根目录下的 .md 文件对应每个子目录：posts、categories、tags、ai、auto、search —— 其中 posts、ai、auto 包含md文件，其他是视图
_config.yml中定义了默认值：随笔是post，其他是page —— 不需要每篇文章中再定义
- posts、ai、auto 分别对应
_post、_ai、_auto文件夹 ——_config.yml中定义的path - 根目录下的
ai/auto/it.md中定义了 entries_layout 使用 grid
- 根目录下的 .md 文件对应每个子目录：posts、categories、tags、ai、auto、search —— 其中 posts、ai、auto 包含md文件，其他是视图
- 简要说明
- fork -- modify
- officially supported themes:
- 一些theme是gem打包发布的，用户的文档中不会出现
- Others
- 其他说明
- 新建post可以用
./newpost.sh，同时创建一个post 及其images下的同名文件夹放图片
- 新建post可以用
forked from wkevin/wkevin.github.io
-
Notifications
You must be signed in to change notification settings - Fork 0
wuaizxd/wkevin.github.io
Folders and files
| Name | Name | Last commit message | Last commit date | |
|---|---|---|---|---|
Repository files navigation
About
wkevin's blog
Resources
Stars
Watchers
Forks
Releases
No releases published
Packages 0
No packages published
Languages
- JavaScript 96.2%
- CSS 2.0%
- Shell 1.1%
- Other 0.7%