Switch to sphinx to be able to translate documentation #98
Conversation
|
FYI, french translation has started on https://github.com/biblibre/omeka-s-enduser-fr (on |
|
To be complete, we did a communication we did to the French community (in French too). Regards. |
jajm
force-pushed
the
sphinx
branch
2 times, most recently
from
799e6a4
to
425127d
Compare
jajm
force-pushed
the
sphinx
branch
3 times, most recently
from
aabd312
to
d15c25e
Compare
|
Hi, We would like to have some feedbacks. Please have a look, it would be a real gain for Omeka community who are not English talking people ;). Thanks. |
|
Hi, This one is complicated for us, since we'd have to change the server-side systems used to build and deploy the docs, as well as the local setups for people working on them. We've also got several other mkdocs projects so it's convenient for us to have the same setup for multiple things. What in particular does Sphinx provide here that mkdocs doesn't? A system that generates gettext files from the source docs? I'm not really familiar with how localization/translation works in Sphinx. |
|
Hi, I understand that changing tools is complicated, but I believe having documentation translated in other languages would really benefit Omeka and its users.
Yes. And a system that generates translated documentation using these gettext files. You can see the basic steps in the The last time I checked, MkDocs supported translations only for the theme, not for the documentation itself |
We needed to translate in french the Omeka S's documentation, and mkdocs does not fit our needs. Sphinx provides by default all the tools needed to translate with PO files and generate translated documentation. The generated documentation is the same as if it was generated by mkdocs. Ideally, we think that all the PO files should be in the official documentation repository, and they could be modified on Transifex, so that anyone can participate to translation. Instructions for translating are written inside translation.md
It is a syntax extension that is not supported by MyST Instead, add a line of javascript to add this attribute to all <a> elements that have the `external` class. This class is added by sphinx automatically
We needed to translate in french the Omeka S's documentation, and mkdocs
does not fit our needs. Sphinx provides by default all the tools needed
to translate with PO files and generate translated documentation. The
generated documentation is the same as if it was generated by mkdocs.
Ideally, we think that all the PO files should be in the official
documentation repository, and they could be modified on Transifex, so
that anyone can participate to translation.
Instructions for translating are written inside translation.md