hackmd的安装与维护

介绍

hackmd是支持协作的超级好用在线Markdown编辑器

更名

HackMD CE成为了CodiMD
CodiMD最近更名为其原名HackMD。CodiMD是HackMD的免费软件版本。HackMD EE，这是一个SaaS（软件即服务）提供的产品hackmd.io。

我们决定更改名称以打破HackMD和CodiMD之间的混淆，正式称为HackMD CE，因为它从来都不是一个开放的核心项目。

浏览器要求

浏览器要求
Chrome> = 47，Chrome for Android> = 47
苹果浏览器 Safari> = 9，iOS Safari> = 8.4
火狐 Firefox> = 44
IE IE> = 9，Edge> = 12
Opera> = 34，不支持Opera Mini
Android浏览器> = 4.4

安装

系统准备：
ubuntu 16.40
git (https://git-scm.com/)
docker (https://www.docker.com/community-edition)
docker-compose (https://docs.docker.com/compose/install/)

docker安装

curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh

使用docker-compose 安装

sudo curl -L "https://github.com/docker/compose/releases/download/1.24.0/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
sudo chmod +x /usr/local/bin/docker-compose
sudo ln -s /usr/local/bin/docker-compose /usr/bin/docker-compose
docker-compose --version

hackmd安装与运行

下载hackmd的docker容器并运行

git clone https://github.com/hackmdio/docker-hackmd.git
cd docker-hackmd/
docker-compose up

Wait until see the log HTTP Server listening at port 3000

用浏览器打开 http://127.0.0.1:3000

运维

备份

docker-compose exec database pg_dump hackmd -U hackmd  > backup.sql

恢复

cat backup.sql | docker exec -i $(docker-compose ps -q database) psql -U hackmd

升级软件

cd docker-hackmd ## enter the directory
git pull ## pull new commits
docker-compose pull ## pull new containers
docker-compose up ## turn on

试用小记

安装运行后，显示了一些小的错误：https://github.com/hackmdio/docker-hackmd/issues/68
还有上传图片时显示错误，有可能需要自己设置图床，与官方的demo还是有区别。看来开源的版本还是需要有人持续地投入。

如果能访问到官方版本： https://demo.codimd.org/ 而且速度也可以，建议使用官方版本，有diy兴趣的目前可以暂时跑一跑，等以后文档补充齐全了，以及bug修复了再安装和运行自己的版本。

参考资料

docker

Install Docker Compose
https://docs.docker.com/compose/install/

Get Docker CE for Ubuntu
https://docs.docker.com/install/linux/docker-ce/ubuntu/#install-using-the-convenience-script

这可能是最为详细的Docker入门总结
https://blog.csdn.net/M2l0ZgSsVc7r69eFdTj/article/details/84056743

hackmd

Rename the project
https://github.com/hackmdio/codimd/issues/720

https://github.com/hackmdio/codimd

https://github.com/hackmdio/docker-hackmd

Enabling auth via Google, Twitter, GH, etc...
https://github.com/hackmdio/docker-hackmd/issues/66

Authentication guide - GitHub
https://github.com/hackmdio/codimd/blob/master/docs/guides/auth/github.md