You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
[![Help Contribute to Open Source][codetriage-image]][codetriage-url]
11
11
[![POEditor][poeditor-image]][poeditor-url]
12
12
13
-
HackMD lets you create realtime collaborative markdown notes on all platforms.
14
-
Inspired by Hackpad, with more focus on speed and flexibility.
15
-
Still in the early stage, feel free to fork or contribute to HackMD.
13
+
CodiMD lets you create real-time collaborative markdown notes on all platforms.
14
+
Inspired by Hackpad, with more focus on speed and flexibility, and build from [HackMD](https://hackmd.io) source code.
15
+
Feel free to contribute.
16
16
17
17
Thanks for using! :smile:
18
18
@@ -27,7 +27,7 @@ Thanks for using! :smile:
27
27
-[Instructions](#instructions)
28
28
-[Heroku Deployment](#heroku-deployment)
29
29
-[Kubernetes](#kubernetes)
30
-
-[HackMD by docker container](#hackmd-by-docker-container)
30
+
-[CodiMD by docker container](#codimd-by-docker-container)
31
31
-[Upgrade](#upgrade)
32
32
-[Native setup](#native-setup)
33
33
-[Configuration](#configuration)
@@ -60,7 +60,7 @@ Thanks for using! :smile:
60
60
- Node.js 6.x or up (test up to 7.5.0)
61
61
- Database (PostgreSQL, MySQL, MariaDB, SQLite, MSSQL) use charset `utf8`
62
62
- npm (and its dependencies, especially [uWebSockets](https://github.com/uWebSockets/uWebSockets#nodejs-developers), [node-gyp](https://github.com/nodejs/node-gyp#installation))
63
-
- For **building**HackMD we recommend to use a machine with at least **2GB** RAM
63
+
- For **building**CodiMD we recommend to use a machine with at least **2GB** RAM
64
64
65
65
### Instructions
66
66
@@ -73,20 +73,20 @@ Thanks for using! :smile:
73
73
74
74
## Heroku Deployment
75
75
76
-
You can quickly setup a sample Heroku HackMD application by clicking the button below.
76
+
You can quickly setup a sample Heroku CodiMD application by clicking the button below.
77
77
78
-
[](https://heroku.com/deploy?template=https://github.com/hackmdio/hackmd/tree/master)
78
+
[](https://heroku.com/deploy?template=https://github.com/hackmdio/codimd/tree/master)
79
79
80
80
If you deploy it without the button, keep in mind to use the right buildpacks. For details check `app.json`.
81
81
82
82
## Kubernetes
83
83
84
84
To install use `helm install stable/hackmd`.
85
85
86
-
For all further details, please check out the offical HackMD[K8s helm chart](https://github.com/kubernetes/charts/tree/master/stable/hackmd).
86
+
For all further details, please check out the offical CodiMD[K8s helm chart](https://github.com/kubernetes/charts/tree/master/stable/hackmd).
87
87
88
-
## HackMD by docker container
89
-
[](http://play-with-docker.com?stack=https://github.com/hackmdio/docker-hackmd/raw/master/docker-compose.yml&stack_name=hackmd)
88
+
## CodiMD by docker container
89
+
[](http://play-with-docker.com?stack=https://github.com/hackmdio/docker-hackmd/raw/master/docker-compose.yml&stack_name=codimd)
90
90
91
91
92
92
**Debian-based version:**
@@ -98,11 +98,11 @@ For all further details, please check out the offical HackMD [K8s helm chart](h
98
98
99
99
[](https://microbadger.com/images/hackmdio/hackmd:alpine"Get your own version badge on microbadger.com")[](https://microbadger.com/images/hackmdio/hackmd:alpine"Get your own image badge on microbadger.com")
100
100
101
-
The easiest way to setup HackMD using docker are using the following three commands:
101
+
The easiest way to setup CodiMD using docker are using the following three commands:
Read more about it in the [docker repository…](https://github.com/hackmdio/docker-hackmd)
@@ -111,14 +111,14 @@ Read more about it in the [docker repository…](https://github.com/hackmdio/doc
111
111
112
112
## Native setup
113
113
114
-
If you are upgrading HackMD from an older version, follow these steps:
114
+
If you are upgrading CodiMD from an older version, follow these steps:
115
115
116
116
1. Fully stop your old server first (important)
117
117
2.`git pull` or do whatever that updates the files
118
118
3.`npm install` to update dependencies
119
119
4. Build front-end bundle by `npm run build` (use `npm run dev` if you are in development)
120
120
5. Modify the file named `.sequelizerc`, change the value of the variable `url` with your db connection string
121
-
For example: `postgres://username:password@localhost:5432/hackmd`
121
+
For example: `postgres://username:password@localhost:5432/codimd`
122
122
6. Run `node_modules/.bin/sequelize db:migrate`, this step will migrate your db to the latest schema
123
123
7. Start your whole new server!
124
124
@@ -154,10 +154,10 @@ There are some config settings you need to change in the files below.
154
154
| --------- | ------ | ----------- |
155
155
|`NODE_ENV`|`production` or `development`| set current environment (will apply corresponding settings in the `config.json`) |
156
156
|`DEBUG`|`true` or `false`| set debug mode; show more logs |
157
-
|`HMD_DOMAIN`|`hackmd.io`| domain name |
158
-
|`HMD_URL_PATH`|`hackmd`| sub URL path, like `www.example.com/<URL_PATH>`|
157
+
|`HMD_DOMAIN`|`codimd.org`| domain name |
158
+
|`HMD_URL_PATH`|`codimd`| sub URL path, like `www.example.com/<URL_PATH>`|
159
159
|`HMD_PORT`|`80`| web app port |
160
-
|`HMD_ALLOW_ORIGIN`|`localhost, hackmd.io`| domain name whitelist (use comma to separate) |
160
+
|`HMD_ALLOW_ORIGIN`|`localhost, codimd.org`| domain name whitelist (use comma to separate) |
161
161
|`HMD_PROTOCOL_USESSL`|`true` or `false`| set to use SSL protocol for resources path (only applied when domain is set) |
162
162
|`HMD_URL_ADDPORT`|`true` or `false`| set to add port on callback URL (ports `80` or `443` won't be applied) (only applied when domain is set) |
163
163
|`HMD_USECDN`|`true` or `false`| set to use CDN resources or not (default is `true`) |
@@ -191,8 +191,8 @@ There are some config settings you need to change in the files below.
191
191
|`HMD_LDAP_SEARCHBASE`|`o=users,dc=example,dc=com`| LDAP directory to begin search from |
192
192
|`HMD_LDAP_SEARCHFILTER`|`(uid={{username}})`| LDAP filter to search with |
193
193
|`HMD_LDAP_SEARCHATTRIBUTES`|`displayName, mail`| LDAP attributes to search with (use comma to separate) |
194
-
|`HMD_LDAP_USERIDFIELD`|`uidNumber` or `uid` or `sAMAccountName`| The LDAP field which is used uniquely identify a user on HackMD|
195
-
|`HMD_LDAP_USERNAMEFIELD`| Fallback to userid | The LDAP field which is used as the username on HackMD|
194
+
|`HMD_LDAP_USERIDFIELD`|`uidNumber` or `uid` or `sAMAccountName`| The LDAP field which is used uniquely identify a user on CodiMD|
195
+
|`HMD_LDAP_USERNAMEFIELD`| Fallback to userid | The LDAP field which is used as the username on CodiMD|
196
196
|`HMD_LDAP_TLS_CA`|`server-cert.pem, root.pem`| Root CA for LDAP TLS in PEM format (use comma to separate) |
197
197
|`HMD_LDAP_PROVIDERNAME`|`My institution`| Optional name to be displayed at login form indicating the LDAP provider |
198
198
|`HMD_SAML_IDPSSOURL`|`https://idp.example.com/sso`| authentication endpoint of IdP. for details, see [guide](docs/guides/auth.md#saml-onelogin). |
@@ -235,7 +235,7 @@ There are some config settings you need to change in the files below.
235
235
| --------- | ------ | ----------- |
236
236
|`debug`|`true` or `false`| set debug mode, show more logs |
237
237
|`domain`|`localhost`| domain name |
238
-
|`urlPath`|`hackmd`| sub URL path, like `www.example.com/<urlpath>`|
238
+
|`urlPath`|`codimd`| sub URL path, like `www.example.com/<urlpath>`|
239
239
|`port`|`80`| web app port |
240
240
|`allowOrigin`|`['localhost']`| domain name whitelist |
241
241
|`useSSL`|`true` or `false`| set to use SSL server (if `true`, will auto turn on `protocolUseSSL`) |
@@ -249,9 +249,9 @@ There are some config settings you need to change in the files below.
249
249
|`allowFreeURL`|`true` or `false`| set to allow new note creation by accessing a nonexistent note URL |
250
250
|`defaultPermission`|`freely`, `editable`, `limited`, `locked`, `protected` or `private`| set notes default permission (only applied on signed users) |
251
251
|`dbURL`|`mysql://localhost:3306/database`| set the db URL; if set, then db config (below) won't be applied |
252
-
|`db`|`{ "dialect": "sqlite", "storage": "./db.hackmd.sqlite" }`| set the db configs, [see more here](http://sequelize.readthedocs.org/en/latest/api/sequelize/)|
252
+
|`db`|`{ "dialect": "sqlite", "storage": "./db.codimd.sqlite" }`| set the db configs, [see more here](http://sequelize.readthedocs.org/en/latest/api/sequelize/)|
253
253
|`sslKeyPath`|`./cert/client.key`| SSL key path (only need when you set `useSSL`) |
254
-
|`sslCertPath`|`./cert/hackmd_io.crt`| SSL cert path (only need when you set `useSSL`) |
254
+
|`sslCertPath`|`./cert/codimd_io.crt`| SSL cert path (only need when you set `useSSL`) |
255
255
|`sslCAPath`|`['./cert/COMODORSAAddTrustCA.crt']`| SSL ca chain (only need when you set `useSSL`) |
256
256
|`dhParamPath`|`./cert/dhparam.pem`| SSL dhparam path (only need when you set `useSSL`) |
257
257
|`tmpPath`|`./tmp/`| temp directory path |
@@ -304,7 +304,7 @@ There are some config settings you need to change in the files below.
304
304
## Structure
305
305
306
306
```text
307
-
hackmd/
307
+
codimd/
308
308
├── tmp/ --- temporary files
309
309
├── docs/ --- document files
310
310
├── lib/ --- server libraries
@@ -330,15 +330,15 @@ See more at [http://operational-transformation.github.io/](http://operational-tr
0 commit comments