e45327df5d
OAuth2 allows the user to only consent to a subset of the scopes requested. Previously, the Generic Oauth2 implementation assumes that the `username`, `email` and `displayName` attributes are supplied, and may crash if they are not defined. This commit allows for `email` and `displayName` to not be defined, either through the user refusing consent or the OAuth2 configuration not asking for them in the first place (by not setting `userProfile*Attr`). If `email` is not provided, the `emails` property is simply left empty. If `displayName` is not provided, it is left undefined, and CodiMD uses the `username` whenever the `displayName` is expected. This does not deal with the case where `username` is not provided. Since usernames are not unique in CodiMD, it is possible to deal with this by setting a dummy username. This can be added in a future commit if desired. Fixes #406 Signed-off-by: Dexter Chua <dalcde@yahoo.com.hk> |
||
|---|---|---|
| bin | ||
| docs | ||
| locales | ||
| public | ||
| src | ||
| .babelrc | ||
| .editorconfig | ||
| .eslintignore | ||
| .eslintrc.js | ||
| .gitignore | ||
| .mailmap | ||
| .sequelizerc.example | ||
| .travis.yml | ||
| app.json | ||
| AUTHORS | ||
| CHANGELOG.md | ||
| CODE_OF_CONDUCT.md | ||
| config.json.example | ||
| CONTRIBUTING.md | ||
| LICENSE | ||
| package.json | ||
| README.md | ||
| SECURITY.md | ||
| tsconfig.json | ||
| webpack.common.js | ||
| webpack.dev.js | ||
| webpack.htmlexport.js | ||
| webpack.prod.js | ||
| yarn.lock | ||
CodiMD
CodiMD lets you create real-time collaborative markdown notes. You can test-drive it by visiting our CodiMD demo server.
It is inspired by Hackpad, Etherpad and similar collaborative editors. This project originated with the team at HackMD and now forked into its own organisation. A longer writeup can be read in the history doc.
Community and Contributions
We welcome contributions! There's a lot to do: If you would like to report bugs, the issue tracker is the right place. If you can help translating, find us on POEditor. To get started developing, take a look at the docs/dev directory. In any case: come talk to us, we'll be delighted to help you with the first steps.
To stay up to date with our work or get support it's recommended to join our Matrix channel, stop by our community forums or subscribe to the release feed. We also engage in regular community calls (RSS) which you are very welcome to join.
Installation / Upgrading
You can run CodiMD in a number of ways, and we created setup instructions for all of these:
If you do not wish to run your own setup, you can find a commercial offering at https://hackmd.io. This is not the same codebase as this one, but it is a very similar project.
Configuration
Theres two main ways to configure your CodiMD instance: Config file or environment variables. You can choose what works best for you.
CodiMD can integrate with
- facebook, twitter, github, gitlab, dropbox, google, ldap, saml and oauth2 for login
- imgur, s3, minio, azure for image/attachment storage (files can also be local!)
- dropbox for export and import
More info about that can be found in the configuration docs above.
Browser support
To use CodiMD, your browser should match or exceed these versions:
Chrome >= 47, Chrome for Android >= 47
Safari >= 9, 
iOS Safari >= 8.4
Firefox >= 44
IE >= 9, 
Edge >= 12
Opera >= 34, 
Opera Mini not supported
Android Browser >= 4.4
Related Tools
Our community has created related tools, we'd like to highlight codimd-cli which lets you use CodiMD from the comfort of your command line.
License
Licensed under AGPLv3. For our list of contributors, see AUTHORS.