Giter Club home page Giter Club logo

clojure_api_cn's Introduction

关于

这是 Clojure 官方 API 文档 clojure.github.com/clojure 的中文翻译版本。

在线阅读地址: clojure-api-cn.readthedocs.org

翻译进度

模块 进 度 译者

clojure.core clojure.data clojure.inspector

进行中 `h 无 无

uangz`_ , Lin Xiangyu

clojure.java.browse

已完成 `L

in Xiangyu`_
clojure.java.io

已完成 `Q

iu Xiafei`_
clojure.java.javadoc

已完成 `L

in Xiangyu`_

clojure.java.shell clojure.main clojure.pprint clojure.reflect clojure.repl

已完成 `L 无 无 无 无

in Xiangyu`_

clojure.set clojure.stacktrace

已完成 `Q 无

iu Xiafei`_

clojure.string clojure.template clojure.test clojure.walk

已完成 `h 无 无 无

uangz`_

clojure.xml clojure.zip

已完成 `L 无

in Xiangyu`_

如何加入翻译?

  1. 选定你要翻译的函数/宏/模块,到项目 github 的 issue 页面开一个 issue ,将你要翻译的内容写下来(为避免出现多人翻译同一项内容的情况,请确保你要翻译的内容没有其他人在翻译)。
  2. 如果你要翻译的是一整个模块的内容,请在“翻译进度”表中将相应模块的进度从“无”更改为“进行中”,并在“译者”一栏加上你的名字和链接。
  3. 开始翻译!
  4. 完成,提交翻译到 repo ,并在“翻译进度”表中将相应模块的状态改为“已完成”。
  5. (recur step-1)

以下是一些翻译时需要注意的地方:

  • 庞大的 clojure.core 模块需要多人来共同翻译,只要里面的某个函数/宏没有别人在翻译,你就可以翻译它。
  • 最好以单个函数/宏为单位,小段小段地 push 自己的翻译,不要将大一块翻译凑到一起来 push ,小段的内容更容易被检查
  • 碰到不好翻译的地方,或者需要任何帮助,开 issue 讨论
  • 对于一些没有标准翻译的词语,请使用“翻译(原文)”的格式做标记,比如: 柯里化(currying) 。这种标记同一个页面里做一次就可以了。
  • 如果模块文档没有提供相应的测试代码,可以参考 ClojureDocs 上面的测试代码,也可以自己添加测试代码。

对以上规则有任何疑问或建议,请开 issue 或者联系 huangz

参考资料

Clojure 官方文档: clojure.org/documentation

Clojure API 手册: clojure.github.com/clojure

Clojure Cheat Sheet: clojure.org/cheatsheet

ClojureDocs ,由社区驱动的,带代码示例的 API 手册: clojuredocs.org

clojure_api_cn's People

Contributors

huangzworks avatar khotyn avatar oa414 avatar qiuxiafei avatar

Watchers

 avatar  avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.