Apertium Html-tools is a web application providing a fully localised interface for text/document/website translation, analysis, and generation powered by Apertium. Designed with a dead simple build process, minimal dependencies and only static resources for quick and easy deployment with any web server, it is relatively lightweight and user-friendly. Html-tools relies on an Apertium HTTP API such as Apertium-apy or ScaleMT (to a lesser extent).
More information along with instructions for localization is available on the Apertium Wiki.
- Python 3
config.confand edit it.
- Then type
The static files within
/build (generated by
make) can be served by any
server. You can use whatever you like, including Apache or even just Python's
HTTP server. For example, to run on locally on
can do the following.
python3 -m http.server 8082
A completely local setup with language data and translation from Apertium,
an APy instance, and Nginx to serve Html-tools is provided via Docker.
After installing Docker, point your
http://localhost:2737, run the following, and check
Any changes to the local version of Html-tools will trigger a
For production usage, remember to
- Build with
pip install -r requirements-prod.txt.
- Enable gzip compression on your server.
pip install -r requirements-dev.txt to get development dependencies.
CircleCI runs tests and generates build artifacts including
a live copy of Html-tools using