Gitit Bigger使用

创建和修改页面

根据提示，注册并登录

编辑页面

编辑一个页面,点击“edit”按钮在页面的右下角。
可以点击“Preview”在任何时候看到你会变化。没有保存,直到您按下“Save”。
注意,必须提供自己的更改的描述。这是为了方便别人了解wiki页面已经被改变了。

页面元数据

页面可以选择从一个元数据块开始。例如:

---
format: latex+lhs
categories: haskell math
toc: no
title: Haskell and
Category Theory
...

\section{Why Category Theory?}

元数据块包含一个键值对列表。如果需要,可以继续添加在一个或多个的行。(这是上面的“title”示例所示。)元数据块必须始于—,最后一行…
可以有一个或多个空行紧随其后。

目前支持以下键:
format
覆盖默认的页面类型需要在配置文件中指定。可能的值是markdown,rst、latex、html、markdown+lhs,rst+lhs,latex+lhs。(忽略大小写,所以你也可以用 LaTeX, HTML,等等)。
categories
一个空格或逗号分隔列表页面所属的类别。
toc
覆盖默认设置目录的配置文件。Values可以是 yes, no, true, or false (忽略大小写)。
title
默认情况下页面名称作为页面标题。此元数据元素覆盖默认值。

创建新页面

创建一个新页面,就是创建一个wiki链接,点击链接。如果该页面不存在,可以立即编辑它。

恢复到之前的版本

如果你点击“history”,会得到一个以前版本的页面的记录。你可以看到两个版本之间的差异通过拖拽到另一个,添加的东西将会以黄色突出显示和删除的东西将用横线划掉了。点击“revert”,然后“Save”。

删除页面

点击页面底部的“delete”按钮将会删除页面。注意,可以恢复删除的页面,因为他们的记录仍将通过“activity”按钮在页面的顶部。

上传文件

可以上传一个文件——图片、PDF、或其他一些resource。

点击“upload”按钮在导航栏中。系统将提示你选择要上传的文件。
需要对上传的文件或资源有一个简单的description。
通常你可以离开“Name on wiki”空白,因为现有的文件将使用默认的名称。如果不想要这个,可以自己提供一个名字。注意,上传的文件必须包括一个文件扩展名(例如pdf格式)。
如果你提供一个新版本的文件已经存在于wiki,选择复选框“覆盖现有的文件”。
链接到一个上传文件,就是用它的名字在一个常规wiki链接。例如,如果你上传一张fido.jpg,可以插入图片(markdown-formatted)页面如下: 。如果你上传一个PDFprojection.pdf,你可以插入的链接使用:[projection](projection.pdf)。

Markdown

这个wiki页面都是以markdown的扩展形式书写。如果不熟悉markdown,应该开始通过查看markdown“basics”页面和markdown的语法描述。查阅pandoc用户指南信息等。

Wiki links

链接页面方式：[something](Page Name)

注意页面名称可以包含空格和特殊字符。不需要CamelCase(骆驼命名)。CamelCase单词不会自动转化为wiki链接。
Wiki页面可以组织成目录。例如:
Wine/Pinot Noir
Wine/Burgundy
Wine/Cabernet Sauvignon

wikidata仓库

请注意检查你的 wikidata/ 目录的 git 配置。请注意：
wikidata 文件夹是一个本地仓库，所有的 wiki 页面都将保存到此处；
Gitit 启动时，会检查这个文件夹是否存在，如果不存在，Gitit 将会创建它，并初始化它为一个本地仓库
只有提交到仓库里的文件，才会被 Gitit 添加到 wiki 中。
如果你想要将此仓库与你的远程仓库绑定、同步：你需要：
clone 你的 wiki 仓库到 wikidata 文件夹：git clone your-wikidata.git ./wikidata，或者：
运行 git remote 相关命令，使 wikidata 文件夹和你的远程仓库连接起来；

1） 如果 wikidata 文件夹尚不存在

cd ~/workspace/gitit
git clone your-wikidata.git ./wikidata
git branch --set-upstream-to=origin/master master
# 启动 gitit 服务:
./run/run.sh start

2） 如果 wikidata 已经存在，但并没有和你的远程仓库绑定

cd wikidata
git remote add origin path/to/your-wikidata.git
git branch --set-upstream-to=origin/master master
# 启动 gitit 服务: 
./run/run.sh start

通过Shell编辑wiki

不通过 web界面，也可以操作我们的 Gitit Wiki。

背景： 1. wikidata: wiki pages 的仓库 2. 只有提交到仓库里的文件，才会被 Gitit 添加到 wiki 中。

# 进入 wikidata 目录
cd /path/to/your/wikidata

# 新增文件并输入一些字符串
touch new_page.md
echo "hello shajiquan" >> new_page.md

# 添加新文件到仓库
git add new_pge.md
git commit -m "add new_page.md file"

# 更新文件并提交到仓库
echo "new line" >> old_page.md
git add old_page.md
git commit -m "update old_page.md "

# 推送到远程仓库
git push origin master