如何建立wiki

github

Posted by 追智者 on July 4, 2018

学习了如何在github里建立一个wiki。

首页

一个github的仓库只能有一个wiki,一个wiki只能有一个home。home页是最前面的首页,页面命名最好还是为home。

如何编辑首页

1.写明你的wiki是干什么的。

2.可以加上自己的联系方式,头像之类的。

3.建立子页面的目录。可以把子页面的链接放到首页里,方便随时获取。

侧边栏

侧边栏命名是_sidebar,只有一个,不需要新命名。

注意

如果你要在原来的_sidebar上,在建一个带_sidebar结尾的页面名,那么新的_sidebar会覆盖原来的_sidebar

如何编辑侧边栏

侧边栏相当于目录的目录,home里可以放最详细的目录和链接,比如会放一级,二级和三级目录。而侧边栏你可以只放一级和二级目录,直接和home的行内文字进行链接。

如何连接wiki里home页面的文字

比如home里有html5-and-css,是一级标题,那么你就可以在侧边栏页面里的,home页面链接+#html5-and-css

形式如: ` hhml5-and-css`

页脚

页脚是_Footer,只有一个,不需要新命名。

你可以用加上首页的返回链接。

其他

可以使用Typora编辑好页面,在复制到wiki里。毕竟Typora的编辑更人性化。

记住,有链接,才不会遗忘,才不会变成遗忘的孤岛。

文件名最好要用英文命名,参考GitHub 协作五大业余姿势

我的第一个wiki

参考资料

wiki使用

markdown语法

wiki模板参考Rafael Rodriguez大神的FCC学习记录

CHANGELOG

20180413初稿

20180704修改