BUILD.md

欢迎大牙码特(Matt Su)的博客源码

• **进入博客首页 → ** suqi.github.io
• 也可以Fork这份代码用来作为你的github-pages模板

以下是如何使用本博客源码作为模板来构建你自己的博客

使用jekyll在本地测试

bundle install
bundle exec jekyll serve

概览

• 效果预览
• Fork 指南
• 贴心提示
• 经验与思考
• 致谢

效果预览

Fork 指南

Fork 本项目之后，还需要做一些事情才能让你的页面「正确」跑起来。

1. 正确设置项目名称与分支。

   按照 GitHub Pages 的规定，名称为 username.github.io 的项目的 master 分支，或者其它名称的项目的 gh-pages 分支可以自动生成 GitHub Pages 页面。

2. 修改域名。

   如果你需要绑定自己的域名，那么修改 CNAME 文件的内容；如果不需要绑定自己的域名，那么删掉 CNAME 文件。

3. 修改配置。

   网站的配置基本都集中在 _config.yml 文件中，将其中与个人信息相关的部分替换成你自己的，比如网站的 title、subtitle、duoshuo 和 Disqus 的用户名等。

   注意： 因为 Disqus 处理用户名与域名白名单的策略存在缺陷，请一定将 disqus_username 修改成你自己的。我对该缺陷的记录见 Issues#2。

4. 删除我的文章与图片。

   如下文件夹中除了 template.md 文件外，都可以全部删除，然后添加你自己的内容。

   • _posts 文件夹中是我已发布的博客文章。
   • _drafts 文件夹中是我尚未发布的博客文章。
   • _wiki 文件夹中是我已发布的 wiki 页面。
   • images 文件夹中是我的文章和页面里使用的图片。

5. 修改「关于」页面。

   pages/about.md 文件内容对应网站的「关于」页面，里面的内容多为个人相关，将它们替换成你自己的信息。

贴心提示

1. 排版建议遵照一定的规范，推荐 中文文案排版指北（简体中文版）。

2. 在本地预览博客效果可以参考 Setting up your Pages site locally with Jekyll。

经验与思考

• 简约，尽量每个页面都不展示多余的内容。

• 有时一图抵千言，有时可能只会拖慢网页加载速度。

• 言之有物，不做无痛之呻吟。

• 如果写技术文章，那先将技术原理完全理清了再开始写，一边摸索技术一边组织文章效率较低。

• 杜绝难断句、难理解的长句子，如果不能将其拆分成几个简洁的短句，说明脑中的理解并不清晰。

• 可以学习一下那些高质量的博主，他们的行文，内容组织方式，有什么值得借鉴的地方。

致谢

本博客代码基于马壮的博客进行修改, 感谢!

• 修改方向主要是让站点更扁平化, 专注于内容, 而不是绚烂的eyecandy