rescript-idea / rescript-lang.org-chinese-translation Goto Github PK

Ever wanted a language like JavaScript, but without the warts, with a great type system, and with a lean build toolchain that doesn't waste your time?

想要一个Javascript一样的编程语言, 但是没有先天缺陷, 而是有一个更好的类型系统, 和一整套不会浪费你时间的简洁易用的构建工具链吗?

校对后请修改为:

<!-- 
Ever wanted a language like JavaScript, but without the warts, with a great type system, and with a lean build toolchain that doesn't waste your time? 
-->

想要一个Javascript一样的编程语言, 但是没有先天缺陷, 而是有一个更好的类型系统, 和一整套不会浪费你时间的简洁易用的构建工具链吗?

对于标题校对完毕后, 删除英文原文后, 新加一条包含原文的注释, 如:

## Introduction | 引言

校对后请修改为:

<!--
## Introduction 
-->
## 引言

或

注意::  分别出现在三行

如果你愿意接手一个章节的校对工作, 请在这个issue下留言, 或者直接发起一个新的issue, 我会更新这个表格和project的进度.

校对工作进度:

剩余章节	校对
Introduction	butterunderflow
Installation	include-yy
Editor Plugins	include-yy
Migrate to ReScript Syntax	include-yy
Try	include-yy
Overview	include-yy
Let Binding	include-yy
Type	include-yy
Primitive Types	butterunderflow, include-yy
Tuple	butterunderflow
Record	butterunderflow
Object	butterunderflow
Variant	butterunderflow
Polymorphic Variant	include-yy
Null, Undefined and Option	include-yy
Array & List	include-yy
Function	include-yy
If-Else & Loops	butterunderflow
Pipe	butterunderflow
Pattern Matching / Destructuring	butterunderflow
Mutation	oakland
JSX	butterunderflow
Exception	butterunderflow
Lazy Value	butterunderflow
Async & Promise	include-yy
Module	butterunderflow
Import & Export	include-yy
Attribute (Decorator)	include-yy
Unboxed	include-yy
Reserved Keyword	kirisky
Extensible Variant	include-yy
Interop Cheatsheet	include-yy
Embed Raw JavaScript	include-yy
Shared Data Types	include-yy
External (Bind to Any JS Library)	include-yy
Bind to JS Object	include-yy
Bind to JS Function	include-yy
Import from / Export to JS	include-yy
Bind to Global JS Values	include-yy
JSON	include-yy
Inlining Constants	include-yy
Use Illegal Identifier Names	include-yy
Generate Converters & Helpers	include-yy
Browser Support & Polyfills	include-yy
Libraries & Publishing	include-yy
Overview(Build System)	butterunderflow
Configuration	butterunderflow
Configuration Schema	butterunderflow
External Stdlib	butterunderflow
Pinned Dependencies	butterunderflow
Interop with JS Build Systems	butterunderflow
Performance	oakland
Warning Numbers	butterunderflow

翻译(ReScript & React): Beyond JSX

翻译

翻译(ReScript & React): Elements & JSX

翻译

翻译(ReScript & React): useState Hook

翻译

翻译(GenType): Introduction

翻译

术语表和部分不确定的翻译 (Glossary and some uncertain translations)

名词	中文含义	翻译
Exhaustive check	检查模式匹配是否覆盖了所有可能的模式	穷举性检查
Mutate	-	修改, 变动
Unboxed	-	拆箱
Module	ReScript程序的组成单位	模块
Spread	取决于上下文可能有不同的含义:既可以值ReScript中对列表或记录值的一种操作, 将一个列表/记录 "展开" 到另一个列表/记录; 也可能只是指值的传播	展开/传播
Shape	文档中指的是不同的不同的变体有着不同的shape	形状
Extensible Variant	ReScript中的一种变体类型, 可以被扩展创建新的变体	可扩展变体
External	指ReScript中的一类绑定, 但是其绑定值在JavaScript中实现	external
Functor	ReScript中模块级别的函数	仿函数
heterogeneous	指一个容器可以包含多种类型的元素	异构性
prepend	指向一个列表头部插入元素	头插操作

I'm not sure of the translation of some jargon, so I'll list them here for now.
关于文档翻译的不确定的部分, 在这里列出.

翻译(ReScript & React): GUIDES

翻译

翻译: Introduction

翻译

翻译工作流程

翻译的进度放在这个issue中同步:
目前的中文文档在这里.
可以在中文文档页面查看翻译后的中文文档

翻译规范

为了便于校对, 目前是在翻译后的文档中保留了官方文档原文的.

和之前略有不同的是, 这一次请在翻译的时候就直接注释掉英文原文

<!-- 
Ever wanted a language like JavaScript, but without the warts, with a great type system, and with a lean build toolchain that doesn't waste your time?
-->

想要一个Javascript一样的编程语言, 但是没有先天缺陷, 而是有一个更好的类型系统, 和一整套不会浪费你时间的简洁易用的构建工具链吗?

对于列表, 请将原来的英文列表和翻译的列表分开, 如:

<!-- 
Unreadable JavaScript code generated from other compiled-to-js languages makes it so that it could be, practically speaking:

- Hard to debug (cryptic stack trace, mangled variable names)
- Hard to learn from (non-straightforward mapping of concepts from one language to another)
- Hard to profile for performance (unclear what runtime performance cost there is)
- Hard to integrate with existing hand-written JS code
-->

<!--
其他编译到JS的语言生成的不可读的JavaScript代码使得它们:
- 难以调试(模糊的堆跟踪, 混乱的变量名)
- 难以学习(不存在一种语言到另一种语言的概念上的映射)
- 难以分析其性能(对于代码的运行时性能消耗是不清晰的)
- 难以集成到现有手写的JS代码项目
-->

如果你在使用VSCode, 可以通过 Ctrl + Shift + P -> change language mode -> markdown 修改当前的语言模式为 markdown, 这样就可以通过 Shift + Ctrl + A 注释了.
也可以使用 OlingCat 写的翻译插件, 安装插件后, 按 alt + D 可以注释掉当前段落并在下方复制原文.