Github上写Blog

更新日期: 2019-01-07阅读: 2.7k标签: github

预备知识:

必须:Git,GitHub,JekyllMarkdownYAML
可选:html,JavaScript,css,XML

工具

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

操作:

  1. 注册一个GitHub的账号,可以使用GitHub Desktop或者GitHub网站
  2. 创建一个空的项目
    • 在项目里面创建index.md,或者index.html,提交后,博客首页就建好了。
      • 注1: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,具体方法可以参考其他文章。


链接: https://www.fly63.com/article/detial/1781

远程协作尝试,Github远程协作

远程协作是一个听起来很酷的词,就像谈恋爱一样,听起来总是觉得它和浪漫一词相关。远程协作好处可以想象:节省办公室租金,工作环境自由/高效/免打扰,节省路途时间,更有可能招到更好的人才....

Gitment - 一款基于Github的Issues实现的评论插件

发现一个有意思的评论插件Gitment, 基本原理是利用Github项目上的Issues功能来实现内容的存储,使用github的账号登录体系。和自己的博客集成起来也比较简单,一个css文件,一个js文件,一段初始化代码就可以了。

GitHub 多账户设置

由于不同的 GitHub 不能使用同一个 SSH 公钥,所以要生成两个不同的 SSH 分别对应两个主账户和副账户。编辑 ~/.ssh/config SSH 配置文件,没有该文件则新建。然后,以后使用 main 账户添加远程仓库需要这样添加,部署相应的 SSH 公钥到 GitHub 后,尝试在相应的本地仓库 git push 几个文件测试。

官宣:Github 正式加入微软

GitHub是科技业界最流行的代码托管平台,微软于2018-6月宣布收购 GitHub,微软不会通过市场力量来破坏 GitHub 的开放性,在2018-10月Github 正式宣布加入了微软大家庭

GitHub发布史上最大更新,年度报告出炉!

在昨天的 GitHub Universe 开发者大会上,GitHub 发布了史上最大更新:可直接运行部分代码的 GitHub Actions,以及宣布了 2018 年的 GitHub 年度报告,包括最热门的开源项目和编程语言,让我们一起来先睹为快!

GitHub上传文件不能超过100M的解决办法

上传项目到GitHub上,当某个文件大小超过100M时,就会上传失败,因为默认的限制了上传文件大小不能超过100M。如果需要上传超过100M的文件,就需要我们自己去修改配置。

拒绝重复造轮子!GitHub推出新功能repository templates

GitHub 新功能 repository templates 帮助开发者在所有项目中重用代码。在不同代码库中共享样板代码(boilerplate code)是软件开发的惯例。使用喜欢的工具和目录结构开启新项目,能够帮助程序员更加高效地完成从想法到程序的转变

Github 上十个优秀的 Repo

以下是 Github 上十个优秀的 Repo ,可以用它们在短时间内增加个人的知识储备。毫无疑问,Awesome是最受欢迎的库,它涵盖了从软件开发到硬件再到业务的所有主题。 目前,它在Github上拿到超123,000星,且其内容庞大

GitHub:除非真正需要,否则我们不会删除您的任何内容

不仅仅是社交媒体巨头在努力的让用户相信平台的透明度,微软旗下的 GitHub,也在致力于此。作为一个代码共享平台兼作开发人员的社区

八个酷炫的GitHub技巧,让你看起来像大佬一样!

作为一名开发者,大部分都用过 GitHub。但你可能不知道,GitHub有很多隐藏的功能可以帮助我们更好地使用它。

点击更多...

内容以共享、参考、研究为目的,不存在任何商业目的。其版权属原作者所有,如有侵权或违规,请与小编联系!情况属实本人将予以删除!