利用Hexo搭建Github的个人主页

背景:

近期在跟圈内朋友谈一件事情:

搭建一个关于DICOM协议的中文社区,以开源书籍的模式,自发翻译DICOM官方最新标准。以DICOM协议为切入点,通过阅读、研究、到最后翻译,更加全面掌握标准,尤其是加深对医疗行业的了解。 随着国内新医改的逐步深入,各行各业的创业者开始涉足医疗行业,无论出于颠覆旧有体制和现行标准,还是出于对DICOM标准了解不足的角度,未来新的医疗大环境下必然需要标准的更新,或新的标准。称之为DICOMX.X也好,称之为XXX也罢。充分研读现有标准,实时关注当下新需求,为改善或制定适应未来医疗环境的新标做准备……

虽然目前看起来这件事情的意义不是很大,且以我个人的能力来推动还有很艰难的一段路要走。但是只要有恒心和毅力,哪怕是靠一己之力,每天一点点变化终究会有收获,正如我博文的格言“只要踏出一步,路就在前方”。因此近期在构思以如何的一种方式才能更有效、更优质的来实施该项目。 以类似于MongoDB中文社区、Scala中文,还是以hadoop中文,还是以W3CSchool,甚至干脆就在Github上发布一个开源书籍项目,诸如7天学会Node.js、Docker中文。 Σ( ° △ °|||)︴。

Hexo发布GitHub个人主页:

看了一下目前手中的资源和环境,决定先用Github上提供的免费空间来尝试一下。谷歌或百度一下,该类教程很多。还是按照老方法,先搜索资料,尝试在Win7 64位的本机搭建环境,然后待搭建成功后将搭建经验整理成博文。本篇博文后文主要介绍如何利用Hexo来发布Github个人主页。详细内容如下:

1、环境配置:

博文Hexo搭建Github静态博客中比较详细的介绍了如何配置Hexo整体环境,但是在具体实施过程中遇到了问题。比如在我的Git Bash下,无法识别npm。如下图所示:

(1)Node.js Install:

因此需要安装Node.js,从官网下载下载的x64位的Windows Installer安装失败,具体而且安装过程中也未给出具体提示,如下所示:

最终在圆点网博文中找到了解决方案:第一步,从Node.js官网下载Node.js引擎,也就是一个叫做node.exe的二进制包 。

第二步,从Node.js上下载最新的npm,我选择的是npm-1.4.9.zip第三步,配置环境变量。新建NODE_PATH环境变量,指向node_modules,如我本地 F:\ZSGitHub\nodejs\node_modules。 向Path系统变量中添加Node.exe的路径,例如我本地为 F:\ZSGitHub\nodejs,以及刚才创建的NODE_PATH变量,即向Path路径中添加%NODE_PATH%第四步,进入NODE_PATH目录,运行npm install express。安装完成后输入node -v看到如下内容,说明安装Node.js成功。

(2)Hexo Install:

安装完Node.js后,接下来直接安装Hexo,输入npm install -g hexo指令即可。

(3)Git Install:

参照博文Windows下Git安装指南即可顺利完成Git的安装,安装完成后,开始菜单中如下图所示:

安装完成后,需要配置Git的用户名和邮件地址。启动Git Bash,输入git config -l可先查看当前环境Git的配置情况,例如我本地:

然后按照Hexo搭建Github静态博客中配置自己Git的信息,即username和email,分别输入git config –global user.name “zssure-thu”和git config –global user.email zssure@163.com。

2、具体部署:

环境搭建完成后,接下来让我们动手利用Hexo在本地发布一个网页。

(1)生成博文:

网页发布需要有内容,也就是我们常说的博文。进入到Hexo目录,我本地F:\ZSGitHub\Hexo,输入hexo new “Hello World zssure”,随后会看到在F:\ZSGitHub\Hexo\source_posts目录下生成一个名为Hello-World-zssure.md的MarkDown文件。双击利用MarkDownPad打开,内容如下:

title: Hello World zssure date: 2015-05-22 —

这就是一个简单的空的博文文件,利用MarkDownPad编辑器将自己需要发布的内容粘贴进去。关于MarkDown的语法我就不介绍了,可参照之前CSDN官方对MarkDown编辑器的介绍。我今年的博文也都是用MarkDown来编辑的,因此这里为了省事,就直接将最近期的一篇专栏文章DICOM:DICOM Print服务中PresentationContext协商之 MetaSOPClass与SOPClass对比分析直接贴过来了。大致效果如下:

保存后,我们的博文就算写完了。在当前目录,输入hexo server,可启动本地web服务,打开chrome浏览器,输入:4000/可以看到如下内容,这说明我们的博文已经顺利发布了。

(2)生成网站文件:

众所周知,网站发布需要html、css、js等多种语言和结构配合,虽然MarkDown内嵌了诸多html的语法,但是离真正发布的网站文件还有一些差别。这就是我们之所以使用Hexo的原因。有了Hexo工具,不需要我们自己编写html、css和js文件,Hexo可一键生成。同样命令行进入目录F:\ZSGitHub\Hexo,输入hexo generate,过一段时间后,可以看到当前目录多了public文件夹,打开可以看到该文件夹内已经由hexo自动生成了网站发布所需的各种文件,诸如css、js、index.html、archives等等。

(3)发布到Github:

一切准备就绪,接下来就是将我们利用Hexo搭建的本地网站发布到Github主页中去了。为什么要发布到Github主页呢?其实很简单,在这之前我们利用Hexo构建的只能在本机和局域网内部访问,我们搭建网站自然是希望放到外网上供大家浏览啦。而Github就提供了这样一种服务,简而言之就是提供拥有外网IP的一个约300M的免费空间给你。在该空间内按照Github的说明,将自己构建的网站内容上传到Github指定目录下,就可以完成我们网站在外网的发布啦。参照Hexo搭建Github静态博客博文,我们修改F:\ZSGitHub\Hexo目录下的_config.yml配置文件,主要修改内容有两部分:

志在山顶的人,不会贪念山腰的风景。

利用Hexo搭建Github的个人主页

相关文章:

你感兴趣的文章:

标签云: