• Stars
    star
    9,329
  • Rank 3,643 (Top 0.08 %)
  • Language
    HTML
  • License
    Other
  • Created about 6 years ago
  • Updated 19 days ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

现代 JavaScript 教程(The Modern JavaScript Tutorial),以最新的 ECMAScript 规范为基准,通过简单但足够详细的内容,为你讲解从基础到高阶的 JavaScript 相关知识。

现代 JavaScript 教程中文版

Gitter Telegram

本教程为 React 官方文档MDN 共同推荐的前端教程,持续更新,永久免费,欢迎扫码关注微信公众号,加入读者群。群内自由交流技术,群友帮忙答疑,共同进步!

微信扫码关注官方订阅号,订阅更多精彩内容

加入读者交流群:

  • 微信群:加微信 imleviding扫二维码,验证信息填写 JS 教程
  • QQ 群:打开 QQ 搜索群号 955916282扫二维码,验证信息填写 JS 教程

教程配套每日一题:https://github.com/leviding/one-note-a-day

本项目托管了现代 JavaScript 教程中文版的内容,此内容发布在 https://zh.javascript.info

Mock 工具

分享一个好用的开源接口 Mock 工具:https://github.com/eolinker/eoapi

除了 Mock 功能,还集合了 API 管理和测试功能,还可以通过插件广场帮助你将 API 发布到各个应用平台,比如发布到网关上完成 API 上线,或者和低代码平台结合,将 API 快速变成低代码平台中可使用的组件等。

目录

翻译

我们希望本教程可以以更多语言呈现。如果你感兴趣,那就快来和我们一起翻译吧。

详见 翻译进度

贡献指南

我们希望与更多人一起维护本教程。

发现有错误?发现有些主题教程中没有?那就赶快提交 Pull Request 来想大家分享你的知识吧 👏

你可以在任何编辑器中编辑本项目中的文件。本教程使用增强的 "MarkDown" 格式,易于掌握。而且,如果你想在本地预览效果,我们也提供了一个可以在本地运行本教程的服务端 https://github.com/javascript-tutorial/server

详细贡献者列表请见 https://javascript.info/about#contributors

翻译流程

  • 检查 中文翻译进度 issue(Chinese Translate Progress issue)
  • 选择一篇还没有被选走(在 列表 中暂未被人勾选)的文章。
  • 该 issue 中添加以文章标题为内容的评论,如 An Introduction to JavaScript
    • 我们的 bot 会在 列表 中勾选上对应的文章,这样其他人就知道你正在翻译该文章了。
    • 不要在该评论中添加其他说明。
    • 如果你发现有些文章索然已经被勾选,但是勾选人在认领任务后 15 天内未提交译文,此时你仍可以发表以该文章标题为内容的评论(并 @leviding),如 An Introduction to JavaScript @leviding
  • Fork 此仓库并开始翻译。完成翻译后,请提交一个 PR(请在认领翻译后的 15 天内提交)。
    • PR 应以文章标题命名。Bot 会自动补充更多信息。

请给维护者时间来审核和 merge 你的翻译,或者提出对应的修改意见。

如果你想成为一个维护者,请在 给我们提新 issue

如果你愿意的话,请让其他人知道你在翻译这个教程,并尝试邀请他们参与翻译。你可以通过微博或群聊来号召。

🎉 非常感谢!

目前中文版已上线,我们会在“关于本项目”页面写上你的名字和贡献。

注:https://javascript.info/translate 列出了完整的语言列表。

文件结构

每一个章节或任务都有它自己的文件夹。

文件夹以 N-url 命名,N 为用于排序的数字,url 是该内容在网站上的链接中带有内容标题的部分。

文件的类型是依据文件夹中的文件定义的:

  • index.md 对应一个章节,
  • article.md 对应一篇文章,
  • task.md 对应一个任务(对应的答案必须在 solution.md 文件中提供)。

每一个文件都以 # 一级标题 开始。

添加新内容非常容易。

翻译提示

请不要添加换行,段落或移除已有的行和段落。这样可以减少 merge 英文版中的新变化时出现的问题。

如果你觉得英文版可以被改善 —— 欢迎,请给 英文版教程发 PR

专有词条

  • 一些具体的专有词不应被翻译。如 “Function Declaration”。
  • 对于其他专有词,如 resolved promiseslashregexp 等等,请先找找本项目 WIKI 中的「英文-中文」术语对照表 中是否已有对应的词条。
    • 若没有对应或近似的近似,则可以寻找其他教程(如:MDN)的翻译。

补充:

  • 专有词条翻译完,在其后方以括号加英文的方式补上原词条,例如:同源政策(Same Origin Policy)或转义(transpile),等等。
    • 若一篇文章出現两次以上相同专有词条,则在第一次之后补上原词条即可。
  • 若都无法找到对应的词条翻译,请直接留下原文词条。

词条含义

在英文中很多词条有明确的含义在內,但对于一个不了解英文的人来说,会忽略该含义。

请谨记有必要时可以多加解释或增加额外的翻译,例如:

`ReadableStream` objects allows to read data chunk-by-chunk.
`ReadableStream` objects 允許一个个资料块(chunk)地读取资料。

标点符号

  • 本教程标点符号格式采用 此份指南

  • 资料链接、增強,都须 留下空白

  • 中文无斜体形式,英文的斜体翻译至中文改为 加粗

  • 斜线号 / 较为特殊,若用于分隔两同类型词条时,请维持半形斜线且两侧不加空白,但在词汇们整体的前后要留一空白做分隔:

    • Increment/decrement can only be applied to variables.递增/递减 只能被套用在变量上。
    • If the result of increment/decrement is not used, ...如果 递增/递减 的結果没被使用,...
  • 语一句话只能有一个逗号,但中文无此限制,可依据语气通顺程度将一些英文句点转为逗号。

  • 列举项目后的文字需加句号。<- 像这样

代码块中的文本

  • 翻译注释。
  • 翻译展示给用户的信息和用来举例的字符串。
  • 不要翻译变量(variables)、类(classes)和标识符(identifiers)。
  • 确保翻译后的代码可以正常运行。 :)

例:

// Example
const text = "Hello, world";
document.querySelector('.hello').innerHTML = text;

✅ 请这样翻译(翻译注解):

// 范例
const text = 'Hello, world';
document.querySelector('.hello').innerHTML = text;

❌ 別翻译成(不要翻译类):

// 范例
const text = 'Hello, world';
// ".hello" 是一个类
// 不要翻译
document.querySelector('.你好').innerHTML = text;

外部链接

本翻译教程以维持原本外部链接为原则。

但如果这个外部链接是指向 Wikipedia 的,如 https://en.wikipedia.org/wiki/JavaScript,并且其有质量优良的目标语言的译文,请将链接指向该译文。

例如:

[JavaScript](https://en.wikipedia.org/wiki/JavaScript) is a programming language.

✅ OK (en -> zh):

[JavaScript](https://zh.wikipedia.org/wiki/JavaScript) 是一种编程语言。

对于指向 MDN 的外部链接,可以使用部分翻译的版本。

如果外部链接没有翻译的版本,请不要修改该链接。

诠释资料

一些文件,通常是练习题,顶部会有 YAML 的诠释资料(Metadata)并以 --- 分隔:

importance: 5

---
...

请不要翻译 “importance”(和其他放置在顶端的诠释资料)。

Anchors

某些标题以 [#anchor] 结尾,如:

## 扩散运算符 [#spread-operator]

请不要翻译或者去掉 [#...] 部分,它是 URL 锚点元素的依赖。

与英文版同步更新

详见 WIKI 中的「如何进行此教程的后续更新」。

管理员注意事项

详见 WIKI 中的「管理员注意事项」。

更多

更多说明请见 WIKI

在本地运行

你可以在本地运行本教程的服务端来预览你的翻译。

运行服务端的教程请见 https://github.com/javascript-tutorial/server


本中文版教程的核心维护者 🚀

我们希望与大家合作维护本教程。本教程的详细贡献者列表请见:https://zh.javascript.info/about

More Repositories

1

en.javascript.info

Modern JavaScript Tutorial
HTML
22,614
star
2

ru.javascript.info

Современный учебник JavaScript
HTML
3,728
star
3

ko.javascript.info

모던 JavaScript 튜토리얼(The Modern JavaScript Tutorial in Korean )
HTML
1,795
star
4

es.javascript.info

Spanish translation of javascript.info site.
HTML
518
star
5

server

Server for the Modern Javascript Tutorial
JavaScript
440
star
6

ja.javascript.info

現代の JavaScript チュートリアル
HTML
393
star
7

tr.javascript.info

Modern JavaScript Tutorial in Turkish
HTML
337
star
8

uk.javascript.info

Modern JavaScript Tutorial in Ukrainian (JavaScript українською 🇺🇦)
HTML
307
star
9

pt.javascript.info

Tutorial de JavaScript Moderno em Português
HTML
218
star
10

fr.javascript.info

Modern JavaScript Tutorial
HTML
198
star
11

fa.javascript.info

Modern JavaScript Tutorial in Persian (Farsi)
HTML
181
star
12

id.javascript.info

Tutorial JavaScript Modern dalam Bahasa Indonesia
HTML
132
star
13

bn.javascript.info

Modern JavaScript Tutorial in Bengali
HTML
116
star
14

it.javascript.info

Modern JavaScript Tutorial in Italian
HTML
79
star
15

ar.javascript.info

Modern JavaScript Tutorial in Arabic
HTML
60
star
16

pl.javascript.info

Modern JavaScript Tutorial in Polish
HTML
38
star
17

zh-hant.javascript.info

Modern JavaScript Tutorial in Chinese Traditional
HTML
36
star
18

de.javascript.info

Modern JavaScript Tutorial in German
HTML
34
star
19

vi.javascript.info

Modern JavaScript Tutorial in Vietnamese
HTML
34
star
20

hi.javascript.info

Modern JavaScript Tutorial in Hindi
HTML
28
star
21

ro.javascript.info

Modern JavaScript Tutorial in Romanian
HTML
27
star
22

uz.javascript.info

Modern JavaScript Tutorial in Uzbek
HTML
26
star
23

az.javascript.info

Modern JavaScript Tutorial in Azerbaijani
HTML
21
star
24

translate

Modern JavaScript Tutorial Translation
JavaScript
21
star
25

engine

JavaScript
20
star
26

th.javascript.info

Modern JavaScript Thai Version
HTML
17
star
27

ka.javascript.info

Modern JavaScript Tutorial in Georgian
HTML
14
star
28

el.javascript.info

Modern JavaScript Tutorial in Greek (Μοντέρνο JavaScript Tutorial στα Ελληνικά)
HTML
9
star
29

ug.javascript.info

Modern JavaScript Tutorial in Uyghur
HTML
8
star
30

hy.javascript.info

Modern JavaScript Tutorial in Armenian
HTML
8
star
31

bg.javascript.info

Modern JavaScript Tutorial in Bulgarian
HTML
8
star
32

test.javascript.info

Modern JavaScript Tutorial in Test
HTML
7
star
33

te.javascript.info

Modern JavaScript Tutorial in Telugu
HTML
6
star
34

ta.javascript.info

Modern JavaScript Tutorial in Tamil
HTML
6
star
35

kk.javascript.info

Modern JavaScript Tutorial in Kazakh
HTML
5
star
36

ky.javascript.info

Modern JavaScript Tutorial in Kyrgyz
HTML
5
star
37

he.javascript.info

Modern JavaScript Tutorial in Hebrew
HTML
4
star
38

lt.javascript.info

Modern JavaScript Tutorial in Lithuanian
HTML
4
star
39

nl.javascript.info

Modern JavaScript Tutorial in Dutch
HTML
4
star
40

pa.javascript.info

Modern JavaScript Tutorial in Punjabi
HTML
3
star
41

ca.javascript.info

Modern JavaScript Tutorial in Catalan
HTML
3
star
42

my.javascript.info

Modern JavaScript Tutorial in Burmese
HTML
3
star
43

hu.javascript.info

Modern JavaScript Tutorial in Hungarian
HTML
3
star
44

cs.javascript.info

Modern JavaScript Tutorial in Czech
HTML
3
star
45

sr.javascript.info

Modern JavaScript Tutorial in Serbian
HTML
3
star
46

sq.javascript.info

Modern JavaScript Tutorial in Albanian
HTML
2
star
47

ms.javascript.info

Modern JavaScript Tutorial in Malay
HTML
2
star
48

tk.javascript.info

Modern JavaScript Tutorial in Turkmen
HTML
2
star
49

v2.javascript.info

Modern JavaScript Tutorial in v2
HTML
2
star
50

ml.javascript.info

Modern JavaScript Tutorial in Malayalam
HTML
2
star
51

hr.javascript.info

Modern JavaScript Tutorial in Croatian
HTML
2
star
52

km.javascript.info

Modern JavaScript Tutorial in Central Khmer
HTML
2
star
53

ku.javascript.info

Modern JavaScript Tutorial in Kurdish | فێرکاری مۆدێرن جاڤاسکڕێپت بە زمانی کوردی
HTML
2
star
54

fi.javascript.info

Modern JavaScript Tutorial in Finnish
HTML
1
star
55

bs.javascript.info

Modern JavaScript Tutorial in Bosnian
HTML
1
star
56

da.javascript.info

Modern JavaScript Tutorial in Danish
HTML
1
star
57

me.javascript.info

Savremen JavaScript tutorijal na crnogorskom jeziku !
HTML
1
star
58

project

Git Crash Course demo repository
HTML
1
star
59

ur.javascript.info

Modern JavaScript Tutorial in Urdu
HTML
1
star
60

sk.javascript.info

Modern JavaScript Tutorial in Slovak
HTML
1
star
61

si.javascript.info

Modern JavaScript Tutorial in Sinhala
HTML
1
star
62

pt-PT-old.javascript.info

Modern JavaScript Tutorial in Portuguese
HTML
1
star
63

ro-old.javascript.info

The translated version of https://github.com/iliakan/javascript-tutorial-en in Romanian.
HTML
1
star