Github 结合 Hexo 搭建轻量博客
<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>
本文由用户 htva0986 自行上传分享,仅供网友学习交流。所有权归原作者,若您的权利被侵害,请联系管理员。
转载本站原创文章,请注明出处,并保留原始链接、图片水印。
本站是一个以用户分享为主的开源技术平台,欢迎各类分享!