instructing my own blog

[alissli]

背景

• 借助github pages和jekyll搭建自己的博客

• 尝试1：根据github help创建github pages：alissli.github.io

  • 使用atom和github desktop建立index，显示

  • 删除index，仍然显示

• 尝试2：使用jekyll，参考http://www.pchou.info/ssgithubPage/2013-01-05-build-github-blog-page-02.html构建仓库文件夹

• 尝试2：使用github desktop建立jeklly 主题风格

  • 参考：Adding a Jekyll theme to your GitHub Pages site->choose the theme Tactile. -Blog地址：https://alissli.github.io/

[alissli]

ref：Think Like (a) Git

[alissli]

思考：假如不使用git，能否搭建一个博客

• 尝试1：
  • step 1：按github help的搭建github pages
  • step 2：参考一步步在 GitHub上创建博客主页 全系列 by by pchou配置【Jekyll基本结构】
  • Ref：Directory structure

[alissli]

• treak 稍稍调整（机器、系统）

[alissli]

此路不通的话，从头尝试。 受tianjie仓库启发，将原有仓库改名。

• 尝试1：通过网页使用github pages+jekyll搭建个人博客
  • step1: 了解到github pages有两种形式：User or organization site和Project site，区别见User, Organization, and Project Pages.搭建个人博客需要使用User or organization site
  • 参考Github Help-github pages搭建github pages， 建成的仓库如下图：
  • 点击上图中的readme文件，修改为index.html, 拷贝html代码,提交
  • 浏览器输入：alissli.github.io, 显示如下页面：
  • 参考Creating a GitHub Pages site with the Jekyll Theme Chooser在设置中选择minimal主题，回到code页面，增加一个_config.yml的文件。
  • 参考Creating pages继续搭建

[alissli]

https://help.github.com/articles/about-github-pages-and-jekyll/

• Configuring Jekyll

[alissli]

All posts must have YAML Front Matter 所有文章需要YAML表头

YEAR-MONTH-DAY-title.MARKUP 文件命名格式必须按照上面来，markup指文件扩展名（比如.html, .md) 范例：2011-12-31-new-years-eve-is-awesome.md

[alissli]

如果参考beiyuu的基本Jekyll结构, 自己去写诸如_config.yml，default.html等，需要看完jeklly的帮助，并且有？？？编程基础:

基本的Jekyll结构如下：

|-- _config.yml
|-- _includes
|-- _layouts
|   |-- default.html
|   `-- post.html
|-- _posts
|   |-- 2007-10-29-why-every-programmer-should-play-nethack.textile
|   `-- 2009-04-26-barcamp-boston-4-roundup.textile
|-- _site
`-- index.html

尝试2： 在尝试1的基础上，参考beiyuu修改. 但是我不知道哪些是必须的，哪些是不需要的。最简单的高效的方法还是直接去fork仓库，然后大概看下代码中哪些需要改成自己的。我不太想要他的风格，去找其他的仓库fork，更改尝试1中的仓库alissli.github.io为alissli01.github.io

主题参考：

• Github help提供的开源列表
• Jekyll
• Jekylltehmes

forkTrophy之后，更改仓库名称为alissli.github.io，失败

尝试3：将alissli01.github.io改回alissli.github.io，下载Trophy，解压文件，将所有文件上传至仓库alissli.github.io；通过网页上传，发现文件夹无法上传，改用github desktop上传。

无法更改gh-branch作为source，失败

尝试4：将尝试3的仓库alissli.github.io改为alissli01.github.io，然后fork夏雨莲的仓库。删除index.html和CNAME。 ref: 阮一峰

• 思考：是不是一定要用git才能解决？

[alissli]

搭建

尝试0：fork夏雨莲的仓库，将index.html删除。可以实现readme页面

推测下一步的尝试是按readme中的installation提示，删除gh-pages，再生成新的gh-pages branch

Installation: Fork the master branch and delete gh-pages branch in it. This is important because gh-pages branch is used here only to host the blog. You should be using the master branch as the source and create a fresh gh-pages branch.

• 思考：但是素封的文章里写建立个人博客应该使用User or organization site，而在User, Organization, and Project Pages中user or organization site的source file（源文件）应该是在master里的。

• 反馈：index.html删除后收到邮件提示，github pages build失败。恢复index.html文件，回复初始状态。失败。

尝试1：复制阮一峰博文中的index.html代码。失败。

尝试2：找到 Yulianxia 使用的jekylltheme的模板仓库，复制index.html源码,提交，成功！

[alissli]

GitHub Pages分两种，一种是你的GitHub用户名建立的username.github.io这样的用户&组织页（站），另一种是依附项目的pages。（via beiyuu）

ref：github帮助文档

[alissli]

Jekyll基本结构

Jekyll的核心其实就是一个文本的转换引擎，用你最喜欢的标记语言写文档，可以是Markdown、Textile或者HTML等等，再通过layout将文档拼装起来，根据你设置的URL规则来展现，这些都是通过严格的配置文件来定义，最终的产出就是web页面。(via beiyuu)

ref: beiyuu