Github 结合 Hexo 搭建轻量博客

htva0986 8年前
   <p>本次搭建,是在Windows系统上进行</p>    <h2>开始</h2>    <p>Hexo 是一个快速、简洁且高效的博客框架。Hexo 使用 Markdown(或其他渲染引擎)解析文章,在几秒内,即可利用靓丽的主题生成静态网页。</p>    <p>也有很多此类的文章了,不过还是要记录一下,分享给大家,我自己也做个复习。我也是不久前才弄好 <em>^_^</em></p>    <h3>工具准备</h3>    <ul>     <li>1.安装Node.js</li>    </ul>    <ul>     <li>2.安装Git</li>    </ul>    <p>安装过程就不说了,估计没有不会的。</p>    <ul>     <li>3.注册Github帐号</li>    </ul>    <p>点击进入 <a href="/misc/goto?guid=4958339615791362549" rel="nofollow,noindex">Github</a> ,注册帐号(用户名关系到博客以后的 域名前缀)。</p>    <h3>安装Hexo</h3>    <p>安装完上述程序,就可以进行Hexo的安装了。</p>    <p>打开命令行,输入安装命令:</p>    <pre>  npm install hexo-cli -g</pre>    <p>等待完成,安装 Hexo 后,依次执行下列命令,Hexo将会在指定文件夹中新建所需要的文件。</p>    <p>folder(不用打[])是你新建的文件夹名称,用于存放博客的所有文件。</p>    <p>默认安装在你打开的命令行默认所在的目录,可以切换至其他目录进行安装。</p>    <pre>  hexo init [folder]  cd [folder]  npm install</pre>    <p>比如我把目录切换到D盘进行安装。</p>    <p style="text-align: center;"><img src="https://simg.open-open.com/show/f8e468a951534105509196c944276667.png"></p>    <p>列出一个目录,看见下面这句话,就说明安装成功了。</p>    <p style="text-align: center;"><img src="https://simg.open-open.com/show/d89bb91f2bd848d949bb2cb23c0fe6e4.png"></p>    <p>可以打开电脑看一下目录结构。</p>    <p style="text-align: center;"><img src="https://simg.open-open.com/show/425483c6f34bbe9edab2707700adad26.png"></p>    <p>执行下面命令,生成网站(public文件夹):</p>    <pre>  hexo g</pre>    <p>结果如下:</p>    <p style="text-align: center;"><img src="https://simg.open-open.com/show/1ee93ce9d30fce28cbbdbb72dbc7430c.png"></p>    <p>执行下面命令,运行服务,就可以在浏览器中访问了,地址为: <a href="/misc/goto?guid=4959619570697390902" rel="nofollow,noindex">http://localhost:4000</a> :</p>    <pre>  hexo s</pre>    <p style="text-align: center;"><img src="https://simg.open-open.com/show/c831da84d371d499f1890767852cffb7.png"></p>    <p>如果遇到 hexo s 无效或者错误,可能是因为没有安装hexo server,执行下面命令,然后再试:</p>    <pre>  npm install hexo-server --save</pre>    <p>浏览器查看(这就是安装好的模样,这是默认主题,可以添加新的主题):</p>    <p style="text-align: center;"><img src="https://simg.open-open.com/show/cc0fdaa4ad75265f810f60805b3eb43f.png"></p>    <p>但是现在我们只能在我们本地的电脑上面浏览,别人无法看见,我们还需要将它部署到Github上面。这样就可以让别人访问了。</p>    <p>hexo 基本命令,先了解,后面会用到。</p>    <pre>  hexo g   #完整命令为hexo generate,用于生成静态文件  hexo s   #完整命令为hexo server,用于启动服务器,主要用来本地预览  hexo d   #完整命令为hexo deploy,用于将本地文件发布到github上  hexo n   #完整命令为hexo new,用于新建一篇文章  hexo clean   #清除生成的文件</pre>    <h2>部署</h2>    <h3>新建仓库(New repository)</h3>    <p>登录到你的Github帐号,在右上角+号点击新建。</p>    <p style="text-align: center;"><img src="https://simg.open-open.com/show/368897a8c3498c9b7fec2b72aaf871c6.png"></p>    <p>填写信息。格式为:你的用户名.github.io。然后创建。</p>    <p style="text-align: center;"><img src="https://simg.open-open.com/show/0c803adb0840238b72c0e4be511227d6.png"></p>    <h3>配置网站信息</h3>    <p>打开你的文件夹,找到 <strong>_config.yml</strong> 文件,打开它。最开始和最后。</p>    <p>默认可能会没有repo和branch选项,我们要手动写上。</p>    <p>repo: 地址为下图中的地址。替换成你的就可以。</p>    <p>Github 默认分支是 master。</p>    <p>暂时修改这些信息就可以。</p>    <pre>  # Site  title: Hexo #网站标题  subtitle: #副标题  description: #描述  author: zgm #作者,你的名字  language: zh-Hans #设置语言 zh-Hans为中文  timezone: #时区 默认使用电脑的时区    # Deployment  ## Docs: https://hexo.io/docs/deployment.html  deploy:    type: git    repo: https://github.com/你的用户名/你的用户名.github.io.git    branch: master</pre>    <p style="text-align: center;"><img src="https://simg.open-open.com/show/8a53786e91901960bcf56dfb96fa09cc.png"></p>    <h3>设置Git</h3>    <p>在Git Bash输入以下指令(任意位置点击鼠标右键),检查是否已经存在了SSH keys。</p>    <pre>  ls -al ~/.ssh</pre>    <p>如果不存在就没有关系,如果存在的话,可以直接删除.ssh文件夹里面所有文件。输入以下指令:</p>    <p>邮箱就是你注册Github时候的邮箱</p>    <p>执行命令,生成密钥。</p>    <pre>  ssh-keygen -t rsa -C "xxx@xxx.com"</pre>    <p>然后回车,出现提示就直接回车,第一次会问你是否继续,回车,第二次问你是否设置一个密码,写不写都可以,第三次是重复输入密码,没有的话就直接回车。</p>    <p>之后找到用户目录下.ssh文件夹,打开id_rsa.pub文件,复制里面的内容。</p>    <p style="text-align: center;"><img src="https://simg.open-open.com/show/2eeb79198e748df347cc533432723d54.png"></p>    <p>打开github网页找到右上角点击你的头像,找到Setting,进去点SSH keys,新建一个SSH。</p>    <p style="text-align: center;"><img src="https://simg.open-open.com/show/2eff997015324f15fa51e930a9f41c67.png"></p>    <p style="text-align: center;"><img src="https://simg.open-open.com/show/21a34d4bcf67a25d259a432ebe62c644.png"></p>    <p>在Git Bash输入下面的命令:</p>    <pre>  ssh -T git@github.com</pre>    <p>登陆成功。</p>    <p style="text-align: center;"><img src="https://simg.open-open.com/show/ff83f8f1984da53f9472732f04458f4c.png"></p>    <p>前面我们说过,hexo d 是部署到Github的命令,但是现在我们执行的话,会提示你</p>    <pre>  ERROR Deployer not found:git</pre>    <p>所以我们还要安装hexo-deployer-git:</p>    <pre>  npm install hexo-deployer-git --save</pre>    <p>安装完成后,在Git Bash配置一下用户名和密码(分别是你的邮箱和用户名):</p>    <pre>  git config --global user.email "xxx@xxx.com"  git config --global user.name "你的用户名"</pre>    <p>执行部署命令:</p>    <pre>  hexo d</pre>    <p>通常情况下是先生成网站,然后部署。可以将两个步骤放到一起:</p>    <pre>  hexo d -g</pre>    <p>现在你就可以打开网站看到效果了。</p>    <h2>发表</h2>    <h3>新建文章</h3>    <p>通过以下命令新建文章:</p>    <pre>  hexo new "文章名字"</pre>    <p>然后用编辑器打开你文件夹下面的 <strong>source\_posts</strong> 里面的 <strong>文章名字.md</strong> 文件。</p>    <pre>  title: 文章名字   #标题  date: 2016-12-09 12:04:29   #发表日期  categories: blog   #文章文类  tags: [文章,blog]   #文章标签  ---  #这里是正文,用markdown写,你可以选择写一段显示在首页的简介后  #加上<!--more-->,在<!--more-->之前的内容会显示在首页,  #之后的内容会被隐藏,点击Read more才能看到。</pre>    <h3>更新文章</h3>    <p>在命令行执行:</p>    <pre>  hexo d -g</pre>    <p>这样就可以把你的新文章传上去啦。</p>    <h2>参考</h2>    <p><a href="/misc/goto?guid=4959729169710168857" rel="nofollow,noindex">Hexo系列教程之一:hexo+github搭建独立博客</a></p>    <p><a href="/misc/goto?guid=4959729169814250240" rel="nofollow,noindex">Hexo官方文档</a></p>    <p> </p>    <p>来自:http://www.jianshu.com/p/840a353f8df5</p>    <p> </p>