部分示例代码未显示

[seisman]

比如变量这一节，源代码为

A variable, in Julia, is a name associated (or bound) to a value. It's useful when you 
want to store a value (that you obtained after some math, for example) for later use. 
For example:

.. doctest::

    # Assign the value 10 to the variable x
    julia> x = 10 
    10

    # Doing math with x's value
    julia> x + 1
    11

    # Reassign x's value
    julia> x = 1 + 1 
    2

    # You can assign values of other types, like strings of text
    julia> x = "Hello World!"
    "Hello World!"

Julia 提供了极其灵活的变量命名系统。变量名区分大小写。

GitHub的渲染效果为：

中文文档的渲染类似，也是没有代码部分：

似乎是RTFD在解释doctest时出问题了。

而官方英文文档里近似同样的代码却可以正确渲染：

[cuiweiqiang]

@seisman 有个临时解决的方案，把julia的项目源代码clone下来，然后将本项目的manual下的文件替换julia项目下的doc/manual中的文件，然后在julia下编译就行。

[GaZ3ll3]

这是两个问题, 一个是 conf.py 里面应该改为, 这样sphinx可以看见这个doctest builder.

extensions = ['sphinx.ext.mathjax',
              'juliadoc.julia',
              'juliadoc.jldoctest',
              'juliadoc.jlhelp']

另一个是我们的juliadoc 很久没更新, 我尝试了下用我们自己的repo(pip install), 发现import都会失败. 我改为

-e git+https://github.com/JuliaLang/JuliaDoc.git@85c83a5c4ecd1716e0aa858d73322cc2058bc7b1#egg=JuliaDoc

之后就可以import,虽然会报一些错, 但是最后编译都没有问题. 所以我觉得minimal的方案是

1. 改conf.py
2. 改requirements.txt

我打算再调试下各种组合, 再提交一个方案.

[GaZ3ll3]

http://test-julia-3.readthedocs.org/zh_CN/latest/manual/variables/

这里是我这样修改的结果. 已提交PR, 本地和rtfd已经测试, HTML已通过.

pdf 生成有错.

pdf 生成正常, 是readthedocs的cdn的问题. 虽然声称解决了, 但是还是不能及时更新. 这里是 最新生成的 pdf

https://cdnmedia.readthedocs.org/pdf/test-julia-3/latest/test-julia-3.pdf

[cuiweiqiang]

@GaZ3ll3 这个版本好像有个问题，左侧导航栏不能随页面滚动。具体原因还在看。

[GaZ3ll3]

@cuiweiqiang 摊手, 我尝试过把conf改过, 也尝试把template文件夹去掉, 都没有用.

[GaZ3ll3]

文档已经更新, sidebar的问题还是无法解决. 决定重新开一个issue讨论.

julia_zh_cn文档里 已修复 http://julia-cn.readthedocs.org/zh_CN/latest/ @cuiweiqiang