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