Math rendering as a Slack integration via Wikimedia Mathoid.
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
slack_mathoid
.gitignore
LICENSE
README.md
setup.py

README.md

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.

slack-mathoid in action

Installation

slack-mathoid setup is easy.

$ 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:

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.