[Biopython-dev] Documentation Status

[Alexey Morozov]

Not really, if the main bulk of documentation is to be stored in docstrings
or made from them automatically for every future release. These things go
untranslated for years for less common languages, cause problems with
non-ASCII characters and so on.

But I think that there is not much need for translated docstrings. At least
in Russia, everyone in IT/CS and nearly everyone in life sciences knows at
least some English. What I was talking about is multilingual wiki or at
least a few manuals, cookbooks and "Getting started"s, or maybe Biopython
workshop, because it may help bioinformatics teachers.

2014-10-14 19:36 GMT+09:00 Peter Cock <p.j.a.cock at googlemail.com>:

> Hi Alexey,
>
> I am not aware of any Russian translation (another interesting language
> in terms of non-ASCII characters and the potential markup implications).
>
> Do you have any thoughts on if and how to track any future translation
> work in the main Biopython repository side by side with the English
> version to help keep things up to date?
>
> Peter
>
> On Tue, Oct 14, 2014 at 11:32 AM, Alexey Morozov
> <alexeymorozov1991 at gmail.com> wrote:
> > Speaking of translations, is Biopython documentation being translated
> into
> > Russian? I could contribute to such a work, but definitely won't make it
> all
> > alone.
> >
> > 2014-10-14 18:48 GMT+09:00 Peter Cock <p.j.a.cock at googlemail.com>:
> >>
> >> Hi Yanbo,
> >>
> >> Translations are an interesting case - some of the tutorial was also
> >> translated into Japanese once, but this work often goes out of date :(
> >> Using LaTeX it would be possible to embed alternative versions
> >> into the same file - even at a chapter or section level (you can have
> >> conditional blocks with if statements - so new sections could be in
> >> English only initially while waiting for translation). I don't think you
> >> can do this with Sphinx - or can you?
> >>
> >> Peter
> >>
> >> P.S. The source files for the Chinese translation is here, plus a port
> >> of the LaTeX tutorial into *.rst:
> >> https://github.com/bigwiv/Biopython-cn
> >>
> >>
> >> On Tue, Oct 14, 2014 at 10:00 AM, Yanbo Ye <yeyanbo289 at gmail.com>
> wrote:
> >> > For the Tutorial of Sphinx, here is a Chinese version that we
> translated
> >> > last year. All format seems ok, including  equations, chapter
> >> > hyperlinks,
> >> > references, etc. But it cannot pass the pdf compiling process on
> >> > readthedocs.  I'm not a expert on this. Maybe someone can give it a
> try.
> >> >
> >> > http://biopython-cn.readthedocs.org/zh_CN/latest/index.html
> >> _______________________________________________
> >> Biopython-dev mailing list
> >> Biopython-dev at mailman.open-bio.org
> >> http://mailman.open-bio.org/mailman/listinfo/biopython-dev
> >
> >
> >
> >
> > --
> > Alexey Morozov,
> > LIN SB RAS, bioinformatics group.
> > Irkutsk, Russia.
>



-- 
Alexey Morozov,
LIN SB RAS, bioinformatics group.
Irkutsk, Russia.
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mailman.open-bio.org/pipermail/biopython-dev/attachments/20141014/3c59291c/attachment.html>