Gitit Bigger: Git and Markdown based wiki, Bootstrap, ace Editor, syntax highlight and docker deploy support.
基于 Git 和 Markdown 的超棒的 Wiki 系统,Bootstrap、Ace 编辑器等增强,支持 Docker 部署。
假定你已安装 Git 和 Gitit
git clone https://github.com/menduo/gitit-bigger ~/workspace/gitit;
cd ~/workspace/gitit;
cp sample.gitit.conf my-gitit.conf;
./run/run.sh start;
docker run -d --name gitit -p 7500:7500 menduo/gitit-bigger;
无数据库
Git 版本控制
Markdown 格式
Wiki 化:
代码高亮
支持公式等(我基本不用)
导出 epub 等(基于 pandoc)
更多关于 Gitit 的安装、部署、优化的中文介绍和说明,请见:
Bootstrap 模板
Ace Editor
Ace Editor 的编辑模式已设为 markdown
。
采用配置文件方式启动,多个实例轻松共享资源
支持自定义 Ace 编辑器启用/禁用、模式、样式等配置
支持 Markdown 模式下快捷键
数学公式:支持 MathJax 启用/禁用,自定义 MathJax 源
代码高亮:支持使用 highlight.js 高亮代码 - Gitit 的高亮需要服务端支持
增加启动、部分、自动备份脚本或帮助
请注意检查你的 wikidata/
目录的 git 配置。请注意:
wikidata
文件夹是一个本地仓库,所有的 wiki 页面都将保存到此处;Gitit
启动时,会检查这个文件夹是否存在,如果不存在,Gitit 将会创建它,并初始化它为一个本地仓库wikidata
文件夹:git clone your-wikidata.git ./wikidata
,或者:git remote
相关命令,使 wikidata
文件夹和你的远程仓库连接起来;# 如果 wikidata 文件夹尚不存在
cd ~/workspace/gitit
git clone your-wikidata.git ./wikidata
git branch --set-upstream-to=origin/master master
# 启动 gitit 服务: ./run/run.sh start
# 如果 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
Gitit Bigger 提供一定程度的配置。
你可以通过在 templates/page_more_scripts.st
里定义 BIGGER_SETTINGS_APPEND
对象来覆盖默认配置。
包括:
详情见:- gitit_bigger_utils.md
不通过 web界面,也可以操作我们的 Gitit Wiki。背景:
wikidata
: wiki pages 的仓库
# 进入 wikidata 目录
cd /path/to/your/wikidata
# 新增文件并输入一些字符串
touch new_page.md
echo "hello menduo" >> 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
通过配置文件的方式,可以轻松运行多个 Gitit 实例。除 wiki.menduo.net 外,我也运行了另外的实例来做私人笔记。
cp sample.gitit.conf my-gitit-private.conf;
my-gitit-private.conf
里的相关配置,尤其是:端口、wikidata 目录(详见gitit_config.md 配置)gitit -f my-gitit-private.conf
注意
my-gitit.conf
和 my-gitit-private.conf
这两个实例使用不同的用户,可能会造成 cookies 的混乱。nginx
做反向代理,为每个实例绑定一个二级域名。localhost
和 127.0.0.1
一类的来处理 cookie 域问题。此处可能存在不合适展示的内容,页面不予展示。您可通过相关编辑功能自查并修改。
如您确认内容无涉及 不当用语 / 纯广告导流 / 暴力 / 低俗色情 / 侵权 / 盗版 / 虚假 / 无价值内容或违法国家有关法律法规的内容,可点击提交进行申诉,我们将尽快为您处理。
1. 开源生态
2. 协作、人、软件
3. 评估模型