维基是Web协同著作平台,可以让任何浏览网页的人都能够方便地参与网页的编辑和创建。这源自于维基如下魔力:
- 快速更改。修改网页无需复杂的后台修改和网页部署流程,浏览的网页直接提供编辑按钮,任何查看网页的用户均可在线编辑网页。
- 简洁语法。编写网页不需要学习复杂的HTML,取而代之的是易学易用的格式化文本(维基语法),有的维基还提供图形化编辑界面。
- 版本控制。熟悉Git的人,可以把维基看作是Web的版本控制。历次修改都记录在案,历史修订可进行比较,可恢复到历史版本等。
- 维基链接。页面链接使用[[页面名称]]语法,可以非常方便地创建新页面,并实现页面间的互联。
GitHub提供了维基模块,方便项目团队创建社区驱动和维护的项目文档。
GitHub的维基模块可以通过项目管理页面控制开启或关闭,默认开启。因为GitHub提供了项目展示的多种途径,一些小项目如果觉得用README文件构建项目说明,或者用gh-pages分支维护项目主页就足够了,大可关闭维基模块。
维基页面并没有自动创建,还需要进行初始化。自动创建的维基首页只有非常简单的信息,点击编辑按钮,修改维基首页。首页的页面名称为“Home”,不能随意更改,否则无法找到首页,或者页面之间的跳转会失效。无论怎样更改维基页面都不怕内容丢失,因为维基记录了每一次修订历史,并可以回退任意一次修改。
在维基中创建新页面有多种方法,可以点击页面中的“New Page”按钮,也可以先在页面中用[[页面名称]]格式嵌入维基链接,然后在生成的页面中可以看到指向新页面的链接,当然这些链接所指向的页面并不存在。
对于项目gotgithub/helloworld来说,用Git克隆其维基,用如下命令:
$ git clone git@github.com:gotgithub/helloworld.wiki.git
GitHub维基背后的引擎名为Gollum,GitHub已将其开源,项目网址:https://github.com/github/gollum 。安装Gollum,在克隆的维基版本库中运行gollum就可以在本地启动维基服务。