美文网首页数字游民部落学习android菜鸟低调修行纪念册
手把手教你用github pages搭建博客 最新版

手把手教你用github pages搭建博客 最新版

作者: _qisen | 来源:发表于2016-06-10 12:04 被阅读3540次

    如果给你40分钟,可以搭建一个如下图所示的网站,你愿意吗?如果你愿意,那我们就开始干!

    干杯

    Cheers!来,朋友干一杯!


    第一篇博文

    在看到界面之后,现在该看看怎么写第一篇博客了。博客的正常工作,需要相关的博客引擎来支持,这就是前文中提及的 jekyll , 在 Github Pages 已经安装完成了,因而 前面所使用的 http://USERNAME.github.com 才能看到正常的画面。

    那么如果想在本地也看到效果后,再上传 Github 的话,可以在本地安装 Jekyll。Jekyll 的安装依赖于 Ruby,因而安装前需要下载 Ruby,具体的步骤如下。

    1. 安装Ruby : 对于 Windows 用户而言,非常简单,从 rubyinstaller.org 下载即可。而 Mac 用户,最新版的系统已经自带,无需处理。

    2. 安装 Gem : 安装 Ruby 过后,就可以安装可以在 Ruby 运行的软件,有一个工具可以帮我们管理 Ruby 软件,这就是 Gem,类似于 Mac 上的 Homebrew,Ubuntu 上的 apt-get,或者手机上的 豌豆荚 23333。安装方式也很简单,rubygems.org 从这个网站上进行下载即可。

    3. 安装 Jekyll : 有了软件管理器后,现在要做的事情就是安装今天的主角 Jekyll ,非常简单,一行话的事情。

    gem install jekyll
    
    1. 验证安装 : 执行 jekyll serve 命令,然后在浏览器访问 localhost:4000 如果一切正常,你就能看到与 Github Pages 上相同的画面了。

    2. 享受书写 :首先创建一篇文章,通过 rake 命令即可。rake post title="Hello World" 这样就创建了一篇 YYYY-MM-DD-title-Hello-world.md 的文章。文章采用的是 markdown 语法进行编写,关于 markdown 语法,这里有一篇不错的文章进行介绍,点击查看

    3. 本地查看与上传 : 同样通过jekyll serve,在浏览器中进行查看,如果没什么问题的话,现在就可以上传到服务端。

    # 将新添加的文件加入索引中
    git add .
    # 将这次的修改作为一个打包
    git commit -am "first blood"
    # 拉取远程仓库的代码
    git fetch
    # 与远程仓库的代码进行比对和合并
    git rb
    # 提交到远程仓库
    git push origin master
    

    再耐心地等待一小会,访问这个链接 http://USERNAME.github.com 即可查看你提交的内容。


    Markdown 语法简介

    markdown 语法十分简单,非常有利于写作,这里做一个简单介绍,熟悉的读者可以跳过这一章节。

    # 表示标题,## 表示2级标题,同理####表示4级标题

    空行表示新的段落,如果不空行的话,markdown 认为是同一段落

    [A](B) 这样样式表示为链接,A为你想要显示的文字,B为实际的链接

    ![A](B) 这种样式表示图片,A为图片的描述文字,B为图片链接

    * 表示无序列表,1,2,3 表示有序列表

    以上就是 Markdown 的基本语法。


    配置域名

    一个小插曲
    据说百度爬虫爬得太猛烈,已经对很多Github 用户造成了可用性的问题了,而禁用百度爬虫这一举措可能会一直持续下去。换而言之,Github Pages 无法被百度索引。这也是我放弃使用 woaitqs.github.io 作为我域名的缘故。

    当然你特有的域名,也是对你自己的一种投资,非常值得。

    解决上诉的问题,首先需要买一个域名,因为万网自带云解析,因为就直接在万网买了 woatiqs.cc 的域名。当然也可以使用其他域名服务提供商,建议使用 GoDaddy

    接下来需要告知github,现在你有域名了。在根目录下创建 CNAME 的文件,一定要大写,在文件中输入你的域名即可。在 Github 上直接操作,或者在本地操作,与提交博客的方式一样上传到 Github 都可以。等上几分钟,就可以通过你的域名进行访问了,点击 woatiqs.cc 就和 woaitqs.github.io 同样效果了。

    端午愉快

    相关文章

      网友评论

      • bd7ad728a45a:你好,我想问下。如果想搭建一个团队的博客类似百度的FEX这种的要怎么操作?
      • fb57d8a1862f:博主你好,我照着步骤弄,前面一切正常,但在执行 'jekyll serve' 命令的时候就报错了,错误是一大串的红字,最后一行提示说 ‘jekyll 3.1.6 | Error: jekyll-paginate’。请问这该怎么解决呢?博客主页一切正常,只是因为这个步骤没有成功,所以无法实现本地预览
        fb57d8a1862f:@_qisen 噢!我想我找到错误的地方了!之所以在执行“jekyll serve”的时候报那个错,确实是因为在jekyll 3.0以后,配置文件必须加上“gems: [jekyll-paginate]”这一句,本地预览才完整,不然就会出现我那这种情况。然而加上那句之后本地却没有安装“jekyll-paginate”,才导致了运行的时候报错,服务启动失败。解决这个问题只需执行“gem install jekyll-paginate”即可。一切都是因为对Ruby的不熟悉,但整个过程下来也学到了很多,感谢博主:)
        fb57d8a1862f:@_qisen 是的。在_config.yml文件中,有这么一段 “gems: [jekyll-paginate]” 原模板作者说Jekyll 3.0后需要加上这一句才能预览,但是我现在将其注释之后却反而能正常启动服务而不会报错了,但这时候这个预览却有点问题了,这是我博客的地址:evilsir.com.cn,在这个页面上可以看到主题模板中原有的一些示例文章,但在本地预览的时候首页却没有任何文章,除此之外一切正常
        _qisen:@LOSERXIE 是在yml的配置文件中进行的吗?如果没有加上这个
      • RadioWaves:LZ在吗,可以问个问题吗 我执行gem install jekyll的时候 提示我没有权限,我又用sudo gem install jekyll去安装 提示我Operation not permitted - /usr/bin/rougify 请问这个是什么情况,可以加个qq了解下吗
        _qisen:@Cstye 没有遇到过这个问题,是Ruby环境的问题吗?
      • c2d4631a3227:下的不错啊,我也搭建成功 :smile: dahei.me
        _qisen:@大黑黑 哈哈,恭喜恭喜

      本文标题:手把手教你用github pages搭建博客 最新版

      本文链接:https://www.haomeiwen.com/subject/sgjjdttx.html