Github上写Blog

2019-01-08 08:22:31来源:博客园 阅读 ()

新老客户大回馈,云服务器低至5折

预备知识:

必须:Git,GitHub,Jekyll,Markdown,YAML

可选:HTML,JavaScript,CSS,XML

工具:

可选:VSCode+Markdown Preview Github Styling,GitHub Desktop

操作:

  1. 注册一个GitHub的账号,可以使用GitHub Desktop或者GitHub网站;
  2. 创建一个空的项目
    • 在项目里面创建index.md,或者index.html,提交后,博客首页就建好了。
      • 注:index.html的优先级比index.md的高,系统会默认使用index.html显示。(系统需要编译,编译的进度请参考注1)
    • 进入项目的Settings,找到Github Pages,修改Source的选项,默认是None(也就是不开启主页显示模式),改为master branch,点save。页面重新刷新,再找到Source就会出现系统提示的显示地址。(编译没有通过的项目是无法正常显示的)
    • 如果还想换个漂亮的皮肤,就点theme就可以了。
  3. 如果不甘心使用这样简单的主页,你就需要fork一个别人的项目barryclark/jekyll-now;
    • 修改_config.yml文件
      • name:博客的名字
      • description:显示在浏览器上的标题栏的名字
      • avatar:博主的照片(可以从Git的Profile里面取照片的地址)
      • # Flags below are optional:表示以下的内容可以选择性的修改
        • email,github是我有的,其他的就看个人喜欢,不填内容就不会在网页上显示,也不会出错
        • sina,douban等国内的需要修改代码才能实现(人懒就先放一下了)
      • permalink : 在前面加个#把它屏蔽掉,因为默认的方式似乎无法正常显示。
    • Settings设置参考前面的说明。
    • 按照“_post”目录下的“2014-3-3-Hello-World.md”的模式,依据“YYYY-MM-DD-文件名称.md”的标准创建一个新文件,就是你发表的新文章了。
      • 打开主页,就会看到文章的主题出现在主页,点进去就可以看到文章的内容。(系统需要编译,编译的进度请参考注1)
  4. 如果还想更漂亮的的页面,更完整功能可以fork这个项目minimal-mistakes
    • 具体修改可以fork我的项目zhuyuanxiang.github.io,改了中文的地方就是我修改的,并且将需要的一些文件从docs目录下移到了根目录下。

注1:了解编译的进度,可以点Code的commits,进去后会看到自己本次提交的记录,如果后面有个绿色的就是编译成功了,如果是个红色的×就是编译失败了,失败了主页就无法显示你想要展示的内容。

注2:如果不喜欢远程编译结果出来后才知道有没有问题,可以自己在本机安装Jekyll,具体方法可以参考其他文章。

标签:

版权申明:本站文章部分自网络,如有侵权,请联系:west999com@outlook.com
特别注意:本站所有转载文章言论不代表本站观点,本站所提供的摄影照片,插画,设计作品,如需使用,请与原作者联系,版权归原作者所有

上一篇:曲折的建站之旅

下一篇:IE CSS Hack【记录】