|
1 |
| -# Современный учебник Javascript |
| 1 | +# The JavaScript Tutorial |
2 | 2 |
|
3 |
| -Всем привет! |
| 3 | +This repository hosts the content of the Modern JavaScript Tutorial, published at [https://javascript.info](https://javascript.info). |
4 | 4 |
|
5 |
| -Когда-то давно был только русский учебник https://learn.javascript.ru. Но несколько лет назад был полностью с нуля написан английский https://javascript.info. И с тех пор все существенные изменения вносились только в него. |
| 5 | +## Translations |
6 | 6 |
|
7 |
| -Сейчас учебники уже довольно сильно разошлись. Между статьями есть общие фрагменты, но и много различий. |
| 7 | +(In alphabetical order): |
8 | 8 |
|
9 |
| -Самое лучшее, что можно сделать – это перевести русский с английского. Для этого создан этот репозиторий. |
| 9 | +| Language | Github | Translation leads | Translated (%) | Last Commit | Published | |
| 10 | +|----------|--------|-------------------|----------------|-------------|-----------| |
| 11 | +| Azerbaijani | [orkhan-huseyn/javascript-tutorial-az](https://github.com/orkhan-huseyn/javascript-tutorial-az) | @orkhan-huseyn |  |  | | |
| 12 | +| Chinese | [xitu/javascript-tutorial-zh](https://github.com/xitu/javascript-tutorial-zh) | @leviding |  |  | [zh.javascript.info](https://zh.javascript.info) | |
| 13 | +| French | [HachemiH/javascript-tutorial-fr](https://github.com/HachemiH/javascript-tutorial-fr) | @HachemiH |  |  | | |
| 14 | +| Japanese | [KenjiI/javascript-tutorial-ja](https://github.com/KenjiI/javascript-tutorial-ja) | @KenjiI |  |  | [ja.javascript.info](https://ja.javascript.info) | |
| 15 | +| Korean | [Violet-Bora-Lee/javascript-tutorial-ko](https://github.com/Violet-Bora-Lee/javascript-tutorial-ko) | @Violet-Bora-Lee |  |  | | |
| 16 | +| Persian (Farsi) | [mehradsadeghi/javascript-tutorial-fa](https://github.com/mehradsadeghi/javascript-tutorial-fa) | @mehradsadeghi | started |  | | |
| 17 | +| Polish | [krzmaciek/javascript-tutorial-pl](https://github.com/krzmaciek/javascript-tutorial-pl) | @krzmaciek |  |  | | |
| 18 | +| Romanian | [lighthousand/javascript-tutorial-ro](https://github.com/lighthousand/javascript-tutorial-ro) | @lighthousand |  |  | | |
| 19 | +| Russian | [iliakan/javascript-tutorial-ru](https://github.com/iliakan/javascript-tutorial-ru) | @iliakan | * . |  | [learn.javascript.ru](https://learn.javascript.ru) | |
| 20 | +| Turkish | [sahinyanlik/javascript-tutorial-tr](https://github.com/sahinyanlik/javascript-tutorial-tr) | @sahinyanlik |  |  | | |
10 | 21 |
|
11 |
| -Пожалуйста, переводите статьи и делайте PR. |
| 22 | +`*` – the previous version is published in Russian, need to backport/translate the new one from English. |
12 | 23 |
|
13 |
| -Если взяли статью на перевод - имеет смысл сделать issue этоб этом, чтобы другие люди не переводили ее же. |
| 24 | +If you'd like to translate it into your language, please clone the repository, change its name to `javascript-tutorial-...` (by the language) and [create an issue](https://github.com/iliakan/javascript-tutorial-en/issues/new) for me to add you to the list. |
14 | 25 |
|
15 |
| -# Структура |
| 26 | +You can edit the text in any editor (markdown-like syntax). The server to run the tutorial locally and see how it looks is at <https://github.com/iliakan/javascript-tutorial-server>. |
16 | 27 |
|
17 |
| -Каждому разделу, статье или задаче соответствует директория. |
18 | 28 |
|
19 |
| -Эта директория имеет вид `N-url`, где `N` - это номер для сортировки статей и разделов (они упорядочены), а `url` – URL-имя, по которому материал будет доступен. |
20 | 29 |
|
21 |
| -В директории находится один из файлов: |
| 30 | +## Structure |
22 | 31 |
|
23 |
| - - `index.md` для раздела |
24 |
| - - `article.md` для статьи |
25 |
| - - `task.md` для условия задачи (+там же `solution.md` с решением) |
| 32 | +Every chapter, article or a task has its folder. |
26 | 33 |
|
27 |
| -Каждый из этих файлов начинается с `# Заголовка материала`, и дальше текст в формате а-ля Markdown. Его довольно просто понять. Для редактирования достаточно простого текстового редактора. |
| 34 | +The folder is named like `N-url`, where `N` is a number for the sorting purposes and `url` is the URL part with title of the material. |
28 | 35 |
|
29 |
| -Ресурсы и примеры, необходимые для статьи, раздела или задачи, находятся в её директории. На них можно ссылаться из материала. |
| 36 | +The type of the material is defined by the file inside the folder: |
30 | 37 |
|
31 |
| -# Запуск локально |
| 38 | + - `index.md` stands for a chapter |
| 39 | + - `article.md` stands for an article |
| 40 | + - `task.md` stands for a task (solution must be provided in `solution.md` file aswell) |
32 | 41 |
|
33 |
| -Для удобства редактирования учебник можно запустить локально. |
34 |
| - |
35 |
| -Сервер для этого находится здесь: <https://github.com/iliakan/javascript-tutorial-server>. |
| 42 | +Each of these files starts from the `# Main header`. |
0 commit comments