Github pages + jekyll 博客快速搭建

Github Pages + Jekyll 方案的优点:

  · 免费

  · 有版本管理,修改方便

  · 支持markdown

缺点:

· 它生成的是静态网页,添加动态功能必须使用外部服务,比如评论功能要使用第三方服务(如disqus)。

· 它不适合大型网站,因为没有用到数据库,每运行一次都必须遍历全部的文本文件,网站越大,生成时间越长。

步骤:

1.注册Github

2.域名

  1)去买域名

  2)用Github pages提供的免费域名

http://{username}.github.io //用你的Github用户名替换网址中的{username}`

  后面有详细说明。

3.安装Git环境

  现讨论window环境的。这里可以下载:https://git-for-windows.github.io/

  工作需要,这个是旧版的:

  新版的图标比较好看。

  在打开的命令行窗口(Shell)内执行以下命令,设置你的git用户名和邮箱:

$ git config --global user.name "{username}"          // 用你的用户名替换{username}

$ git config --global user.email "{[email protected]}"    // 用你的邮箱替换{[email protected]}

4.SSH配置

  为了和Github的远程仓库进行传输,需要进行SSH加密设置。

  在刚才打开的Shell内执行:

$ ssh-keygen -t rsa -C"{[email protected]}"    // 用你的邮箱替换{[email protected]}

  可以不输入其他信息,一直敲回车直到命令完成。 这时你的用户目录(win7以上系统默认在C:\Users\你的计算机用户名)内会出现名为 .ssh 的文件夹,点进去能看到 id_rsa 和 id_rsa.pub两个文件,其中 id_rsa 是私钥,不能让怪人拿走, id_rsa.pub 是公钥,无需保密。

  接下来用你的浏览器登录Github,点击右上角的“Settings”:

  用文字处理软件打开刚才的 id_rsa.pub 文件,复制全部内容。
  点击“SSH and GPG Keys”,

  点击“New SSH Key”,将复制的内容粘贴在Key中,点“Add Key”确定。

5.创建项目

  1)Fork(Git系统的创建分支,简单来说是把当前仓库复制一份到你的仓库,你可以进行修改,因为你的仓库是原来仓库的新的分支)已有的开源博客仓库,在巨人的肩膀上进行符合自我的创作(找个大神的作品自己改改)。

  可以去这里挑:

  https://github.com/jekyll/jekyll/wiki/sites

  http://jekyllthemes.org/

  这个就挺好,知乎上看到的:https://github.com/Huxpro/huxpro.github.io

  然后点fork:

  去主页里找到刚才fork的分支:

  点击“Settings”,将“Repository name”改为 {你的Github用户名}.github.io,点击“Rename”。

  此时就可以通过 http://{你的Github用户名}.github.io 访问你fork下来的网站了。

  2)自建

  自建比较慢,以后讨论。

6.写东西

  1)克隆

  再次打开Git Bash,输入以下命令切换到你想放置本地代码仓库的位置:

$ cd {本地路径}     // 比如:cd d:/hahah

  或者随便找个地方右键Git Bash。

  clone(克隆)你自己的远程仓库:

$ git clone https://github.com/{username}/{username}.github.io.git     // 用你的Github用户名替换{username}

  失败的话可能是打错了或者网不好,网不好的话可以找工具tiao墙,网慢就等一会:

  2)写博客

  打开本地的 _posts 文件夹,你的所有博文都将放在这里,写新博文只需要新建一个标准文件名的文件,在文件中编写文章内容。 比如我们fork的模版中 _posts 文件夹里有一篇2014-01-29-hello-2015.markdown,你的文件命名也要严格遵循 年-月-日-文章标题.文档格式 这样的格式,注意月份和日期是两位数。

  推荐使用Markdown语言写文章,windows下推荐MarkdownPad这个软件编写Markdown文本。

  最开始写可以直接模仿别人的博文语法,更多Markdown语法可参考 认识与入门Markdown

  3)修改和提交

  当你使用Git Bash对你的本地仓库进行操作时,先用 cd 命令将你的工作目录设置到你要操作的本地仓库

$ cd {你刚才clone下来的项目文件夹路径}

  每当你对本地仓库里的文件进行了修改,只需在Bash中依次执行以下三个命令即可将修改同步到Github,刷新网站页面就能看到修改后的网页:

$ git add .

$ git commit -m "statement"   //此处statement填写此次提交修改的内容,作为日后查阅

$ git push origin master

  报错的情况会单独讨论。

7.搭建本地环境

  1).先安装Ruby:

  x64对应64位系统,挑一个顺眼的。

  记得勾选添加到环境变量PATH,忘了就卸载重安。

  2).安装 RubyGems

  windows下下载ZIP格式较为方便,下好后解压到本地任意路径,下面以 {unzip-path} 代替你解压的路径。 打开windows的cmd终端(按win+R快捷键打开“运行”,输入cmd,确定),输入命令:

$ cd {unzip-path}  //如果你没有解压在C盘,windows的终端切换到其他盘需要写为 cd /d {unzip-path}$ ruby setup.rb

  3).安装Jekyll

  在终端里输入

$ gem install jekyll

  4).安装jekyll-paginate

  在终端里输入

$ gem install jekyll-paginate

  如遇到以下错误,说明网络不通:

ERROR:  While executing gem ... (Gem::RemoteFetcher::FetchError)Errno::ECONNRESET: An existing connection was forcibly closed by the remote host.

  其他错误度娘或google,忘了当时报的什么错了。

8.开启本地预览

  上一小节的安装都完成以后,在终端中输入命令

$ cd {local repository} // {local repository}替换成你的本地仓库的目录

$ jekyll serve

  如果没有报错,在浏览器地址栏输入 http://localhost:4000/ 回车就可以预览了。不过 jekyll serve 服务需要一直开着。

摘取自:http://playingfingers.com/2016/03/26/build-a-blog/

扩展阅读:

Github Pages
Git教程 - 廖雪峰
Jekyll中文文档
认识与入门Markdown
Ruby和Gem
使用Github Pages建独立博客
搭建一个免费的,无限流量的Blog—-github Pages和Jekyll入门

时间: 2024-11-05 21:52:49

Github pages + jekyll 博客快速搭建的相关文章

关于hexo+github pages建立博客

1.在使用git对源代码进行push到github时,出现了好几次这种情况: 1 $ git push -u origin master 2 To github.com:wangmengjun142857/wangmengjun142857.github.io.git 3 ! [rejected] master -> master (fetch first) 4 error: failed to push some refs to '[email protected]:wangmengjun14

利用hexo和github建立个人博客 适合小白的~

因为我自己用的是window 7系统,所以下面的教程是针对window系统的 首先需要准备的有 Git v1.9.5 下载地址:百度云 Node.js v0.12.5 x64 下载地址: 百度云 安装Git 作用:把本地的hexo提交到github上面去: 一路点击“Next”就好了 在这里选择对应的window选项 安装Node.js Node也是一样简单,也是一路“Next”就好,然后就等待安装完成 接下来就要验证软件是否正确的安装了 在运行里面输入“cmd” 然后输入如图所示的命令,如果结

github创建个人博客手记

第一步:先总体看下要在本地创建的文件目录 /jun_demo |-- _config.yml |-- _layouts | |-- default.html |-- _posts | |-- 2014-06-26-hello-world.html |-- index.html config.yml:Configuration设置 _layouts:模板存放文件夹 default.html:文件模板 _posts:blog文章存放目录 2014-06-26-hello-world-html:blo

使用Github pages+jekyll搭建自己的博客(windows版)

最近突发奇想,想试试GitHub pages来搭建博客.网上一搜一大堆,嗯...看来还是挺简单的...于是自己撸起袖子干...... 结果对于我这种GitHub注册过,git 没用过,ruby.jekyll 是么都不知道的小白来说,一路踩坑的感觉,真的不要太酸爽...... 下面记录我从零开始搭建博客的过程: 说一句,大神请绕道,不喜勿喷啊,内容有点多... 复杂方法: 第一大步:注册github并创建一个仓库 1.用自己的邮箱注册 注:用户名建议用小写,后面会提到原因. 2.新建一个仓库 登录

github博客的搭建

原文引用https://www.dazhuanlan.com/2019/08/25/5d62297e88c17/ 第一步: 注册github账号,创建新的仓库,注意命名为name.github.io,可以先不设置主题. 第二步: 下载安装git.nodejs等,之类的安装教程很多,hexo也是由此安装的,但是教程中很多的命令没有用上. 第三步: 在安装完成之后,主要使用git的bash接口进行操作,使用hexo命令进行仓库的初始化: $ hexo init博客文章建立: $ hexo new "

github pages & Jekyll

首先,一本好书:http://git-scm.com/book/zh/v1,据说看了前4章这本书就会用github大部分功能了 然后进入主题 原文地址:http://www.ruanyifeng.com/blog/2012/08/blogging_with_jekyll.html 搭建一个免费的,无限流量的Blog----github Pages和Jekyll入门 作者: 阮一峰 日期: 2012年8月25日 喜欢写Blog的人,会经历三个阶段. 第一阶段,刚接触Blog,觉得很新鲜,试着选择一

在github上写博客

在github上混了几个月,收获颇多.作为一个开源的坚定信仰者,深深觉得每一个码农都应该参与到开源社区中,github提供了一个平台,让你为开源项目提交代码变得异常简单和直接.以前由于工作异常繁忙和繁杂,虽然看了很多开源的代码,从中受益颇多,却为之贡献很少,现在醒悟,几分后悔,但愿以后这种情况能够反转.说实话,我从心里异常反感和厌恶那种拿开源代码修改修改,然后换个名称,然后到处吹牛逼的做法... 说得有点偏了,回到github.github还为码农提供了一个博客系统,叫做github pages

使用GitHub做个人博客

前言 用过市面上主流的blog程序,也用Django自己写过开源的博客程序July(170+Star),慢慢的发现没太多精力去打理维护,干脆直接放GitHub当静态页面算了,之前也用过Hexo.jekyll等静态程序,但使用起来还是繁琐,体验不到写作的乐趣. 所以,干脆直接放GitHub把,简单粗暴,你可能只需要做一件事情,就是准备好一个GitHub账号,再准备一个域名,不论备案与否. 创建GitHub仓库 假设你已经有GitHub账号,如果还没有点我注册,登录你的账号,创建一个仓库 仓库名.描

利用hexo+github创建个人博客

因为想拥有一个独属于自己的个人博客啊. 安装部署hexo 进入一个安全的目录,cd ~/Desktop 在 GitHub 上新建一个空 repo,repo 名称是「你的GitHub用户名.github.io」 安装 Hexo $ npm install -g hexo-cli $ hexo init myBlog $ cd myBlog $ npm I $ hexo new这时会看到一个 md 文件的路径 $ vi _config.yml编辑网站配置 把第 6 行的 title 改成你想要的名字