Hello everyone! I'm just at some steps from actually starting the julia documentation translation into spanish, I have been studying the tools I'm going to need and use (sphinx, lokalize, pology, dictionaries, spell-checkers, glossaries, git, github, etc.) and I would like to have some advice into how to proceed.
I had been adviced before that instead of making pull requests to the juila repo, I should had a separate repo (julia-es) for this purpose, and then it could be linked to the julia repo as juliadoc is. The current rapo layout I'm experimenting with looks like this: Devel (regular dir) | |---- julia (my own fork of julia that I cloned and which I keep up to date) | |-----julia-es (where I'm meant for the translations to reside a clone of: of https://github.com/Ismael-VC/julia-es ) This is the current setup I have for sphinx: https://gist.github.com/Ismael-VC/9349109 Notice I can't use: /home/ismaelvc/Devel/julia/doc/ as the root path: Enter the root path for documentation. > Root path for the documentation [.]: /home/ismaelvc/Devel/julia/doc/ Error: an existing conf.py has been found in the selected root path. sphinx-quickstart will not overwrite existing Sphinx projects. > Please enter a new root path (or just Enter to exit): . I have accepted all options, because I cannot forsee what I'm going to end up needing in the long run. Also I want to use julia's files as templates into my own repo, like the conf.py inside julia/doc, etc. and just change what I need , but also I want to follow any modification done in the originals, how could I do this? currently I can only think on diffing them manually. I'd love to see not only the manual, but all of julia's documentation translated into spanish, including the stirngs from "help()", warnings, errors, info, etc. So I'm commiting in long term and I would like to take into account all of this before proceeding any further into the actual translations of the strings. ismaelvc@toybox ~/D/julia-es (setup)> ln -s ~/Devel/julia/doc/manual/* ~/Devel/julia-es/source/ ismaelvc@toybox ~/D/julia-es (setup)> sphinx-build -b gettext source/ manual-es/ Running Sphinx v1.2.1 loading pickled environment... done building [gettext]: targets for 0 template files building [gettext]: targets for 30 source files that are out of date updating environment: 0 added, 0 changed, 0 removed looking for now-outdated files... none found preparing documents... done writing output... [100%] variables-and-scoping /home/ismaelvc/Devel/julia-es/source/arrays.rst:618: WARNING: undefined label: stdlib-sparse (if the link has no caption the label must precede a section header) /home/ismaelvc/Devel/julia-es/source/linear-algebra.rst:12: WARNING: undefined label: stdlib-linalg (if the link has no caption the label must precede a section header) /home/ismaelvc/Devel/julia-es/source/packages.rst:13: WARNING: undefined label: available-packages (if the link has no caption the label must precede a section header) /home/ismaelvc/Devel/julia-es/source/performance-tips.rst:457: WARNING: undefined label: stdlib-profiling (if the link has no caption the label must precede a section header) writing message catalogs... [100%] metaprogramming build succeeded, 4 warnings. ismaelvc@toybox ~/D/julia-es (setup)> But my current layout doesn't take into account, anything more than the manual, I'm having troubles thinking how to order all the files I need, so I don't have to cahnge the layout in the future, and I can just start focusing in the actual translation. This is the current repo layout, in my setup branch: https://github.com/Ismael-VC/julia-es/tree/setup Am I ready to start, what do you think? I don't think so! :) http://postimg.org/image/p1mqgjl83/ Thanks in advance! Ismael Venegas Castelló
