FAQ
What is Monsu?
Monsu is a fictional language created for this project. The built-in dictionary
maps English words to placeholder Monsu tokens (monsu_1, monsu_2, ...).
Replace them with your own Monsu vocabulary using emtrans add or a custom
dictionary file.
Why does emtrans translate with monsu_1, monsu_2, ...?
The default dictionary assigns sequential placeholders as a demonstration. Real
words can be provided through the user dictionary or a custom
--dictionary file.
Why do some words stay unchanged?
Words not present in the active dictionary (built-in + user + custom) pass
through untouched. emtrans --json reports them in the missing array, and
Translator.missing_words() returns them from Python.
How do I translate from Monsu back to English?
emtrans -r "monsu_1 monsu_2"
or
from emtranslator import Translator
Translator(reverse=True).translate("monsu_1")
Where is my user dictionary stored?
~/.config/neostore/emtranslator/config.toml (see
Configuration).
Is my dictionary shared with other projects?
No. The path is project-specific (neostore/emtranslator/). Each project using
this layout keeps its own config directory.
How can I use a project-specific dictionary?
emtrans add hola monsu_92 -d ./project.toml
emtrans -d ./project.toml "hola"
Does the translator handle grammar?
No. Translation is strictly word-by-word dictionary lookup. There is no grammar, sentence-structure, or context handling.
Does it preserve punctuation and spacing?
Yes. Input is tokenized into words, punctuation, and whitespace; only words are translated. Punctuation and spacing are re-attached to the output.
Does it make network requests?
No. Everything runs locally.
What Python versions are supported?
Python 3.8 or newer (requires-python = ">=3.8" in pyproject.toml).