JuliaZH.jl icon indicating copy to clipboard operation
JuliaZH.jl copied to clipboard

支持 docstrings ?

Open Gnimuc opened this issue 4 years ago • 1 comments

在 #88 中已经描述的挺清楚了,可以把这个 PR 作为一个 demo,这里为了简化,采用了更直白的 JSON 文件作为文档翻译的载体。

本地化流程与 markdown 文档基本一致,唯一不同之处是,markdown 是利用 Transifex 的自动同步源功能,自动与 Julia repo 进行同步,而 docstrings 是本地提取的,需要手动用 tx push -s 同步。

julia> using JuliaZH
[ Info: Precompiling JuliaZH [652e05fd-ed22-5b6c-bf99-44e63a676e5f]

julia> zh_CN()

help?> sinc
search: sinc sincos sincosd significand isinteractive MissingException CartesianIndices

  sinc(x)

  当 x \neq 0 时,计算 \sin(\pi x) / (\pi x) ,当 x = 0 时,返回 1 。

Gnimuc avatar Jun 26 '20 09:06 Gnimuc

我们可以先merge了试试?反正不影响其它部分的功能。

还有一些事情需要确认:

  • [ ] 现在dump的是1.4-release的docstrings,merge的话,要对1.5-release重新dump.
  • [ ] 同一个session,docstrings替换只能生效一次,这个问题之前好像讨论过,替换的实现需要调整。
  • [ ] Transifex 上可能出现的潜在的docstrings解析问题。
  • [ ] dump stdlibs的docstrings。

Gnimuc avatar Jun 27 '20 00:06 Gnimuc