关于在github上建立个人站点(wiki)的失败记录

本来以为可以在github上完全脱离本地genarator建设个人wiki的,折腾了两天,终于以失败告终。其实还是因为自己不学无术,图样图森破。基本的概念都没有搞清楚。但不管怎么样,我试过了。

以下是最终的结果。

JnamKuan on Github Page

这周花了完整的两天时间来研究怎么用Github Page. 以下是关于这个过程的一些记录和想法。

如果就是使用的话,真的是一点都不复杂。将它理解成一个静态的服务器就是了。(可能它本来就是这样)如果你的电脑上已经将网站的内容搭建好。那么将文件通过git或者github的桌面工具直接上传到自己的github page所在的repository上面就可以了。然后就可以通过在浏览器上输入已经设置好的域名进行访问即可。就这样。

但,我原来的想法和这个有点出入。但这个之后再细说。先来看看如何用Github做一个免费的网站服务器吧(静态)。

First thing first

既然是在github上搭建,那么产自肯定得有github的帐号对吧!注册什么的非常简单。比注册国内的网站简单多了。至少不会要求你的邮箱之后,又要求你的手机,又要求你的微信……诸如此类。这个肯定不用说了。

创建Github Page

在github上面host自己的网站,主要是用到github的page服务。github官方其实有直接的网面的,叫 github pages ,里面其实有非常详细的教程。

目前我了解到的创建方式有两种,我将它们分别称为官方的可能最多人用的;下来分别说一下;

注:
以下大部分内容都可以通过客户端或命令行操作。看个人喜欢!

官方的

创建一个新的repository, 并且将它命名为username.github.io其中username就是你注册的那个用户名,要求一模一样。这个也是创建后你或其他人访问用的地址。
page

其他的操作的创建别的repository是一样的。这个时候,访问unsername.github.io应该是看不到东西的。因为里面没有东西。如果你想先看一下效果的话,可以到设置里面去选择一个主题模板。
settings

选择一下主题 (Theme chooser == choose a theme)
theme

然后随便选一个,提交,重新打开地址,这时候,你应该能看到有内容了。
commit

放说回来,如果你本来已经将网站建好了,现在只要找个服务器来放的话。那么,只需要将page创建好就行。然后通过自己习惯的工具无论是git也行app也行,将网容内容提交到github page所在的repository上就行。

或者你也可以配合官方推荐的工具Jekyll使用,创建完全自定义的页面。(这其实也是我遇到坑的原因)

就是这么简单。

可能很多人用的

理论上这种方式可以创建无限个网站。因为这种方式是针对Project的。

操作同样很简单。

创建一个新的repository,这个时候名字是任意的,只要网站那里没有提示错误就行。

然后,最主要的差别,也是最重要的地方,创建一个创建一个名叫gh-pages的branch分支。

之后的设置什么的和前面的差不多。

最后,访问的地址是username.gihub.io/xxx,其中username就是你的用户名,xxx就是刚才创建的分支的名字。

其他内容如同上面。

 我遇到的坑是怎么回事

是啊。一切操作都这么简单,为什么我还会遇到坑的呢?

故事要从我的需求说起。

我本来是想将github page当作一个个人的知识管理系统Wiki, 然后内容由markdown来创建。我要做的就是将用markdown写好的内容保存在一个特定的文件夹里,然后git到github上面,我就可以直接在上面系统地查看,而不用在本地上将文件打开。要不然想找点什么还得打开电脑,这个很不方便的说。

然而,试用后发现,它虽然可以很方便地将文件储存上去。但是访问的时候,它并不会自动帮你生成一个文件的列表。也就是说,除非你记住你的分个文件的名字,然后在地址栏上将地址完整地填写访问。在这个百度的域名要Google找,Google的域名要百度查的年代,这个显然是很不现实的。

那么别人的文章链接是怎么来的?这个才是真的原因,它们都是通过类似于 jekyll 这样的工具将markdown文件本地转为静态网页文件后再提交上传的。呵……

我本来还想着尝试一下这个jekyll的,但是在我的可怜的windows上竟然没有官方的工具。也就是说,你想这样做还做不了。(虽然我不想)

后来,其实我也有找到在windows上的类似工具的。 jekyll-windows 非官方支持。但我已经没心情再试了。另外,我还找到了其他的类似jekyll并支持windows的工具,但是已经不想再试了。我现在已然忘了当初为什么出发了。

 另外的思路

后来我想,既然我是要用wiki的,那我是否可以直接去找个静态的wiki呢。

还真有不少。

比如现在用的这个 wiki-in-box
还有mdwiki, dokuwiki等等……但其实都一样,当新增加内容后,要手动地为内容在主页或导航上添加链接。这样也和我的想法相差太远了。

不过,话说回来,我为什么会有这样的想法的?因为我在用的 Farbox 服务就可以这样。只要写好内容,并将它们放到相应的文件夹里面。它就会自动同步到服务器并生成静态网页。你要做的只是写东西。(虽然这是个服务服务)

最近,farbox停止更新,并升级到了新的平台 bitcron 上。

好了,不广告。想到我的bitcron账号才以创建两上站点。所以其实也可以留一个用来当wiki,或者,退步一点。直接用本地的好了。

写在最后

想到已经花了那么多时间进去了。这个页面也创建了,就顺便留点内容吧。当作记录。

Comments
Write a Comment