https://github.com/xyene/slack-mathoid
Math rendering as a Slack integration via Wikimedia Mathoid.
https://github.com/xyene/slack-mathoid
bot math math-rendering slack typeset
Last synced: about 2 months ago
JSON representation
Math rendering as a Slack integration via Wikimedia Mathoid.
- Host: GitHub
- URL: https://github.com/xyene/slack-mathoid
- Owner: Xyene
- License: agpl-3.0
- Created: 2016-10-03T02:15:52.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2016-12-08T01:13:26.000Z (over 9 years ago)
- Last Synced: 2025-12-30T11:21:31.374Z (6 months ago)
- Topics: bot, math, math-rendering, slack, typeset
- Language: Python
- Size: 19.5 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# slack-mathoid
Math rendering as a Slack integration via Wikimedia Mathoid.
## Try it out!
Simply add `https://puck.dmoj.ca/typeset` as an outgoing webhook in your Slack channel.
You can trigger slack-mathoid by prefixing LaTeX commands with `!math`.

## Installation
slack-mathoid setup is easy.
```shell
$ git clone https://github.com/Xyene/slack-mathoid.git
$ cd slack-mathoid
$ python setup.py develop
```
## Running slack-mathoid
To start slack-mathoid, simply run:
```shell
export MATHOID_URL="http://localhost:10044"
export MATHOID_CACHE="/web/static"
export MATHOID_SERVE_URL="https://math.example.org"
slack-mathoid --port=8888
```
This will start a Slack webhook on `localhost:8888/typset`, which should be forwarded and added as an outgoing webhook on Slack.
Cached math will be stored in `MATHOID_CACHE`, and served off `MATHOID_SERVE_URL`. slack-mathoid assumes a Mathoid server is running
on `MATHOID_URL`.
You may optionally provide a `SLACK_AUTH_TOKEN` environment variable to restrict access to the server.