jekyll using standards 使用规范


layout: default
title: jekyll using standards 使用规范
categories: [jekyll github markdown rouge]
date: 2016-9-3 15:47:05
excerpt: “本文摘要” # 覆盖清掉文章的摘要
pid: “1” # 新建一个pid的字符串变量
published: true #是否发布

permalink: jekyll-use.html #固定链接

jekyll using standards 使用规范

  1. file命名格式:文章就是普通的文本文件,文件名假定为2012-08-25-hello-world.html。
    (注意,文件名必须为”年-月-日-文章标题.后缀名”的格式。如果网页代码采用html格式,后缀名为html;如果采用markdown格式,后缀名为md。)

  2. demo示例:在该文件中,填入以下内容:(注意,行首不能有空格)

    ---
    layout: default
    title: 你好,世界
    ---
    <h2>{{ page.title }}</h2>
    <p>我的第一篇文章</p>
    <p>{{ page.date | date_to_string }}</p>
  
  1. 元数据:每篇文章的头部,必须有一个yaml文件头,用来设置一些元数据。
    它用三根短划线”—“,标记开始和结束,里面每一行设置一种元数据。”layout:default”,表示该文章的模板使用_layouts目录下的default.html文件;”title: 你好,世界”,表示该文章的标题是”你好,世界”,
    如果不设置这个值,默认使用嵌入文件名的标题,即”hello world”。

    每个页面都可以有自己的头信息,可以覆盖Jekyll和_config.yml里面的值

    “`

  2. </ol>

    <hr />

    <p>layout: post
    title: 一步一步创建Jekyll主题
    categories: [jekyll github markdown rouge]
    date: 2016-9-3 15:47:05
    excerpt: "" # 覆盖清掉文章的摘要
    pid: "" # 新建一个pid的字符串变量

    <hr />

    “`

    1. 使用模板变量
        在yaml文件头后面,就是文章的正式内容,里面可以使用模板变量。    
        {{ page.title }}就是文件头中设置的"你好,世界",
        {{ page.date }}则是嵌入文件名的日期(也可以在文件头重新定义date变量),"| date_to_string"表示将page.date变量转化成人类可读的格式。
    
    1. 发布
    前置条件:本地已经安装了jekyll程序。
    本地安装jekyll
    sudo gem install jekyll
    本地预览:jekyll serve
       gh-pages分支push jekyll源文件
    
       master分支push `jekyll build` 后_site文件夹中的文件
    
       GitHub pages服务器并不会自动帮你发布,也不会额外处理什么。
    
    1. 注意
      config中baseurl根目录不要添加/,post.url解析出来的格式为 /2016/07/25/VPS.html

    文章参考:

    阮一峰的网络日志

    一步一步创建Jekyll主题