{"repo":"BukkitAPI-Translation-Group/Chinese_BukkitAPI","free":true,"listed":false,"github":"https://github.com/BukkitAPI-Translation-Group/Chinese_BukkitAPI","clone":"git clone https://github.com/BukkitAPI-Translation-Group/Chinese_BukkitAPI.git","description":"BukkitAPI 中文文档 (版本 Spigot-API 1.21)","language":"Java","stars":156,"topics":["javadoc","translation","minecraft","bukkit-api","bukkit"],"license":null,"category":"game-templates","readme_excerpt":"Bukkit 中文文档 提示： 该分支(master)用于进行 Bukkit 1.13 及以上版本的翻译工作。 限于作者精力，1.12.2版本已于2019.9.19正式停更，且不再提供1.12.2版本的在线文档。 您依然可以前往1.12.2分支查看相关代码，但不对历史文档中的错误负责。 文档地址： (可以应用于IDE，在IDE中实时预览) 离线版：1.12.2版本 1.13及以上版本 宣传：欢迎加入汉化组开发讨论QQ群：459574218。您可以与业内各界人士畅谈coding经验与想法. (加群注明来源: 来自github代码仓库 ) 遇到问题请发Issues或PR，以帮助我们解决相关问题。 项目说明 本项目的目标是翻译BukkitAPI的Javadoc，推进中国原创MC插件的发展，项目由andylizi发起。 Javadoc注释规范 Javadoc是JDK提供的一个工具，它可以从程序源代码中抽取类、方法、成员等注释形成一个和源代码配套的API帮助文档。 在开始翻译前, 请先掌握Javadoc文档注释样式. 参阅: 1.http://www.oracle.com/technetwork/java/javase/documentation/index-137868.html (英文) 2.http://www.cnblogs.com/xt0810/p/3630996.html 许可说明 本文档的翻译部分使用CC BY-NC 4.0许可协议发布，您不得将任何译文出于商业化的目的而使用。其它所有源代码属SpigotMC所有，以GPLv3许可协议发布. 翻译规范 原文保留 为了使文档更严谨、方便比对，必须保留原文。例如： 分为三部分, 第一部分为简述: 使用简短的语言描述的用途. 使用 . 号加一个空格给简述结尾. JavaDoc工具使用\". \"(英文句号后跟一个空格)来区分简单描述与详细描述, 但不会自动在这两种描述之间添加换行 请 统一使用英文标点符号 . 第二部分为详细描述, 用于详细说明方法用途, 或举一些简单的例子. 第三部分为JavaDoc标签, 其中有: 参数说明 @param, 返回值说明 @return, 抛出异常说明 @throws 等, 后面会详细说明. 请在需要换行的地方请使用 <p> 否则不会换行 原文与译文必须是连贯的，译文一句原文一句是错误的。 例外：类注释、枚举注释、标签一般不需要保留原文，若是比较难懂的、一大串的则需要保留。 类注释 类注释即为类的描述，介绍了类的作用等，比如： 枚举注释 即枚举类中对一些字段的注释，例如： 方法注释 一个例子： (1)处为方法的描述，是需要翻译的地方。 (2)处为javadoc的标签，javadoc的标签以\"@\"开头，对应的标签就有对应的说明。关于标签在下一部分详细说明。 如果注释中出现了你不能理解的内容，或翻译过来难以理解，请在原文之前加上译注，用自己的理解继续说明，比如： ----- 标签 你之前已经了解了一些javadoc的标签，比如@param、@return、@see、@deprecated等等，这里详细解释下一些特别的标签该如何翻译： @param 参数名 参数说明 @param loc 一个位置({@link Location}) 注意: 参数名不用翻译, 对应的是方法中的参数. @return 返回值说明 @return 此方块的位置 @throws 异常类型 在什么情况下会抛出这个异常 @throws IllegalArgumentException 如果P","default_branch":null,"files":null,"tree":[],"storefront":"/r/BukkitAPI-Translation-Group","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/BukkitAPI-Translation-Group/Chinese_BukkitAPI/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}