[mapserver-dev] Re: Error while make html, from Elvis Wang

[Jeff McKenna]

Hello Elvis,

Thanks for diving into this.

You are correct that the directory should be named 'zh_cn'.  Also, it 
seems that 'documentation.txt' is the master document in each 
translations folder, so it must exist for Sphinx to process the folder. 
  I have added documentation.txt, index.txt, and your about.txt to the 
zh_cn folder in SVN.  Please execute 'svn up' inside the docs root 
folder, and then 'make clean' followed by 'make html'.

I've tested on the server, and you can see some Chinese characters now 
in the Sphinx navigation (e.g. the search tool in the left panel):

http://www.mapserver.org/trunk/zh_cn/index.html

your 'about' page: http://www.mapserver.org/trunk/zh_cn/about.html

Hope that helps.

-jeff



On 11-05-14 2:36 AM, Elvis Wang wrote:
>
> Hello Jeff,
>
> This morning I tried to make some changes (i.e. translation) to test the
> sphinx and mapserver docs.
>
> First I copied "about.txt" from en dir to cn dir. Then I opened the text
> file in cn dir and added some Chinese characters in this document.
>
> Then I saved and closed the file.
>
> Next I opened the console and cd to the docs dir, run "make html
> TRANSLATIONS=cn". There came an error.
>
>
> IOError: [Errno 2] No such file or directory:
> '/home/wbprime/Projects/mapserver_docs/build/doctrees/cn/documentation.doctree'
>
> The full traceback has been saved in /tmp/sphinx-err-lg8Wmd.log, if you
> want to report the issue to the developers.
> Please also report this if it was a user error, so that a better error
> message can be provided next time.
> Either send bugs to the mailing list at
> <http://groups.google.com/group/sphinx-dev/>,
> or report them in the tracker at
> <http://bitbucket.org/birkenfeld/sphinx/issues/>. Thanks!
> make: *** [html] Error 1
>
>
> Then make clean.
>
> Then make again by "make html". Error is :
>
>
> Exception occurred:
> File "/usr/lib/python2.7/site-packages/sphinx/environment.py", line
> 1101, in get_doctree
> f = open(doctree_filename, 'rb')
> IOError: [Errno 2] No such file or directory:
> '/home/wbprime/Projects/mapserver_docs/build/doctrees/cn/documentation.doctree'
>
> The full traceback has been saved in /tmp/sphinx-err-0dL47B.log, if you
> want to report the issue to the developers.
> Please also report this if it was a user error, so that a better error
> message can be provided next time.
> Either send bugs to the mailing list at
> <http://groups.google.com/group/sphinx-dev/>,
> or report them in the tracker at
> <http://bitbucket.org/birkenfeld/sphinx/issues/>. Thanks!
> make: *** [html] Error 1
>
> The possible reason is, as far as I kown, that the code of Chinese
> language is zh not cn. Or maybe zh_cn. You can decide if it is possible
> to change the docs branch directory name. I am not sure after reading
> the page : http://docutils.sourceforge.net/docs/howto/i18n.html . I
> don't know how the make file works. It is quite complicated for me now.
>
> As an attchment, I will send you the "about.txt" file changed.
>
> wait for your response.
>
> Best
>
> Elvis Wang
>
>