blog of eastlakeside maker
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
_drafts
_includes
_layouts
_posts
_wiki
assets
images
pages
.gitignore
CNAME
Gemfile
LICENSE
README.md
_config.yml
favicon.ico
index.html

README.md

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

  • 进入阅读 →
  • 也可以Fork这份代码用来作为你的github-pages模板

使用jekyll在本地测试

bundle install
bundle exec jekyll serve

概览

效果预览

screenshot home

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

经验与思考

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

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

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

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

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

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

致谢

本博客代码基于码志(马壮的个人博客):http://mazhuang.org, 感谢!