47 lines
1.3 KiB
Markdown
47 lines
1.3 KiB
Markdown
A python webserver that automatically hooks into a mattermost instance, listens for any mentions of codiMD files, downloads them locally and then commits them to a git repo based on a specific metadata block in the codimd file.
|
|
|
|
**TODO**
|
|
- Hook into mattermost to automatically react to new files
|
|
- Change gitlab integration to gitea
|
|
|
|
**Done**
|
|
- Webserver that starts a sync when an endpoint is called
|
|
- Automatic detection of codimd file links in mattermost message
|
|
- Download of codimd files
|
|
- Creation of a gitlab pull request for any new files
|
|
- Creation of new commits for any new changes to the files. Hereby updating the existing pull request or creating a new one.
|
|
|
|
## How to run (currently)
|
|
|
|
# Start local webserver
|
|
make webserver
|
|
|
|
# Curl the webserver to trigger the sync
|
|
make sync
|
|
|
|
## CodiMD
|
|
|
|
You need to put the following block somewhere in you CodiMD file.
|
|
|
|
```markdown
|
|
:::spoiler Gitlab sync
|
|
- sync-to: path/in/the/drive
|
|
:::
|
|
```
|
|
|
|
|
|
## Setup
|
|
|
|
Copy the `config.example.toml` file to `config.toml` and complete the missing values.
|
|
|
|
## Used tech
|
|
|
|
- [GitLab CLI Tool](https://glab.readthedocs.io/en/latest/index.html)
|
|
- bash
|
|
- git
|
|
- curl
|
|
- python
|
|
|
|
### References
|
|
|
|
- [CodiMD source code](https://github.com/hackmdio/codimd/tree/develop/lib). Usefull to find the api endpoints.
|