这是一个基于OSX+jekyll+markdown+github的个人博客
--致我亲爱的宝贝
Install Command Line ToolsPermalink
` xcode-select –install `
Install homebrew
/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
Install ruby
先检查版本号 ` ruby -v ` 我们使用2.6.3 如果低于这个,那就请跟着我下面的步骤进行升级吧. 网上有很多很多ruby的管理工具 这里我使用rvm 所以下文使用rvm 来进行.
// 安装rvm
curl -sSL https://get.rvm.io | bash -s stable
// 进行确认版本
rvm -v
// 安装ruby的 2.6.3版本
rvm install 2.6.3
// 把2.6.3这个版本设置成默认
rvm use 2.6.3 --default
安装及使用github desktop
传送门 ==> https://desktop.github.com/
导入项目
接下来,就可以把我的项目下载下来,也可以fork我的项目把名称改成 “用户名.github.io”这样.
如何写页面
文件目录的说明
文件/目录 | 描述 |
---|---|
_config.yml | 保存配置数据。很多配置选项都可以直接在命令行中进行设置,但是如果你把那些配置写在这儿,你就不用非要去记住那些命令了。 |
_drafts | drafts(草稿)是未发布的文章。这些文件的格式中都没有 title.MARKUP 数据。学习如何 使用草稿. |
_includes | 你可以加载这些包含部分到你的布局或者文章中以方便重用。可以用这个标签 “ include file.ext” 来把文件 _includes/file.ext 包含进来。 |
_layouts | layouts(布局)是包裹在文章外部的模板。布局可以在 YAML 头信息中根据不同文章进行选择。 这将在下一个部分进行介绍。标签 “content” 可以将content插入页面中。 |
_posts | 这里放的就是你的文章了。文件格式很重要,必须要符合: “YEAR-MONTH-DAY-title.md”。 永久链接 可以在文章中自己定制,但是数据和标记语言都是根据文件名来确定的。 |
_data | 格式化好的网站数据应放在这里。jekyll 的引擎会自动加载在该目录下所有的 yaml 文件(后缀是 .yml, .yaml, .json 或者 .csv )。这些文件可以经由 `site.data` 访问。如果有一个 “members.yml” 文件在该目录下,你就可以通过 “site.data.members” 获取该文件的内容。 |
_site | 一旦 Jekyll 完成转换,就会将生成的页面放在这里(默认)。最好将这个目录放进你的 “.gitignore” 文件中。 |
.jekyll-metadata | 该文件帮助 Jekyll 跟踪哪些文件从上次建立站点开始到现在没有被修改,哪些文件需要在下一次站点建立时重新生成。该文件不会被包含在生成的站点中。将它加入到你的 “.gitignore” 文件可能是一个好注意。 |
HTML, Markdown, Textile files | 如果这些文件中包含 YAML 头信息 部分,Jekyll 就会自动将它们进行转换。当然,其他的如 .html, .markdown, .md, 或者 .textile 等在你的站点根目录下或者不是以上提到的目录中的文件也会被转换。 |
如何写一个markdown文件
如何使用模板的排版
感激jekyll-TeXt-theme这个项目 给我们创建博客带来了极大的方便. 接下来 我会用当前这个页面来做一个简单介绍 在页面的头部加入
---
layout: article
title: 这是一个基于OSX+jekyll+markdown+github的个人博客
aside:
toc: true
tags: hello
---
一般情况下只需要配置 这些字段就行了
layout: article
sharing: true
license: true
aside:
toc: true
show_edit_on_github: true
show_subscribe: true
pageview: true
关于模板的详细配置信息
在本地查看效果
将这个写完的文章保存为 “年-月-日-标题.md”的名字形式,上传至Github中的_posts文件中,Jekyll会自动解析生成该文章的html页面。
bundle exec jekyll build
jekyll gem install jekyll bundler