python translate script for converting site from sphinx-build to mkdocs-material #6092
Replies: 5 comments 7 replies
-
Here is an example: |
Beta Was this translation helpful? Give feedback.
-
Wanted to report back excellent progress: The script was used to translate geonetwork docs with the result here:
Starting on the second major project now: |
Beta Was this translation helpful? Give feedback.
-
Also a second contributor @krishnaglodha starting to help out, teaching me more python as we go.
|
Beta Was this translation helpful? Give feedback.
-
Documentation now available: https://jodygarnett.github.io/translate/ (based on migration of sphinx-build example) |
Beta Was this translation helpful? Give feedback.
-
Now available https://pypi.org/project/mkdocs-translate/ |
Beta Was this translation helpful? Give feedback.
-
To lower barrier of entry for documentation writing I have looked at converting documentation for an open source project from sphinx-build to mkdocs. And pandoc takes you about 90% of the way there.
I have now have a script for the other 10%: https://github.com/jodygarnett/translate
doc
andref
directivesguilabel
,menuselection
,file
,command
to simple markdownkdb
directive to appropriate mkdocs representation (++control-s++
)note
,warning
and friends\|
becomes|
(without destroying code-blocks)literalinclude
to use sample code in the docsbonus:
I am new to python so I am getting over some imposter syndrome to share here :)
Beta Was this translation helpful? Give feedback.
All reactions