fix
This commit is contained in:
parent
222c52fcd8
commit
726d7d5c10
1 changed files with 27 additions and 20 deletions
47
README.md
47
README.md
|
@ -1,35 +1,42 @@
|
||||||
# Современный учебник Javascript
|
# The JavaScript Tutorial
|
||||||
|
|
||||||
Всем привет!
|
This repository hosts the content of the Modern JavaScript Tutorial, published at [https://javascript.info](https://javascript.info).
|
||||||
|
|
||||||
Когда-то давно был только русский учебник https://learn.javascript.ru. Но несколько лет назад был полностью с нуля написан английский https://javascript.info. И с тех пор все существенные изменения вносились только в него.
|
## Translations
|
||||||
|
|
||||||
Сейчас учебники уже довольно сильно разошлись. Между статьями есть общие фрагменты, но и много различий.
|
(In alphabetical order):
|
||||||
|
|
||||||
Самое лучшее, что можно сделать – это перевести русский с английского. Для этого создан этот репозиторий.
|
| Language | Github | Translation leads | Translated (%) | Last Commit | Published |
|
||||||
|
|----------|--------|-------------------|----------------|-------------|-----------|
|
||||||
|
| Azerbaijani | [orkhan-huseyn/javascript-tutorial-az](https://github.com/orkhan-huseyn/javascript-tutorial-az) | @orkhan-huseyn |  |  | |
|
||||||
|
| Chinese | [xitu/javascript-tutorial-zh](https://github.com/xitu/javascript-tutorial-zh) | @leviding |  |  | [zh.javascript.info](https://zh.javascript.info) |
|
||||||
|
| French | [HachemiH/javascript-tutorial-fr](https://github.com/HachemiH/javascript-tutorial-fr) | @HachemiH |  |  | |
|
||||||
|
| Japanese | [KenjiI/javascript-tutorial-ja](https://github.com/KenjiI/javascript-tutorial-ja) | @KenjiI |  |  | [ja.javascript.info](https://ja.javascript.info) |
|
||||||
|
| Korean | [Violet-Bora-Lee/javascript-tutorial-ko](https://github.com/Violet-Bora-Lee/javascript-tutorial-ko) | @Violet-Bora-Lee |  |  | |
|
||||||
|
| Persian (Farsi) | [mehradsadeghi/javascript-tutorial-fa](https://github.com/mehradsadeghi/javascript-tutorial-fa) | @mehradsadeghi | started |  | |
|
||||||
|
| Polish | [krzmaciek/javascript-tutorial-pl](https://github.com/krzmaciek/javascript-tutorial-pl) | @krzmaciek |  |  | |
|
||||||
|
| Romanian | [lighthousand/javascript-tutorial-ro](https://github.com/lighthousand/javascript-tutorial-ro) | @lighthousand |  |  | |
|
||||||
|
| Russian | [iliakan/javascript-tutorial-ru](https://github.com/iliakan/javascript-tutorial-ru) | @iliakan | * . |  | [learn.javascript.ru](https://learn.javascript.ru) |
|
||||||
|
| Turkish | [sahinyanlik/javascript-tutorial-tr](https://github.com/sahinyanlik/javascript-tutorial-tr) | @sahinyanlik |  |  | |
|
||||||
|
|
||||||
Пожалуйста, переводите статьи и делайте PR.
|
`*` – the previous version is published in Russian, need to backport/translate the new one from English.
|
||||||
|
|
||||||
Если взяли статью на перевод - имеет смысл сделать issue этоб этом, чтобы другие люди не переводили ее же.
|
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.
|
||||||
|
|
||||||
# Структура
|
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>.
|
||||||
|
|
||||||
Каждому разделу, статье или задаче соответствует директория.
|
|
||||||
|
|
||||||
Эта директория имеет вид `N-url`, где `N` - это номер для сортировки статей и разделов (они упорядочены), а `url` – URL-имя, по которому материал будет доступен.
|
|
||||||
|
|
||||||
В директории находится один из файлов:
|
## Structure
|
||||||
|
|
||||||
- `index.md` для раздела
|
Every chapter, article or a task has its folder.
|
||||||
- `article.md` для статьи
|
|
||||||
- `task.md` для условия задачи (+там же `solution.md` с решением)
|
|
||||||
|
|
||||||
Каждый из этих файлов начинается с `# Заголовка материала`, и дальше текст в формате а-ля Markdown. Его довольно просто понять. Для редактирования достаточно простого текстового редактора.
|
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.
|
||||||
|
|
||||||
Ресурсы и примеры, необходимые для статьи, раздела или задачи, находятся в её директории. На них можно ссылаться из материала.
|
The type of the material is defined by the file inside the folder:
|
||||||
|
|
||||||
# Запуск локально
|
- `index.md` stands for a chapter
|
||||||
|
- `article.md` stands for an article
|
||||||
|
- `task.md` stands for a task (solution must be provided in `solution.md` file aswell)
|
||||||
|
|
||||||
Для удобства редактирования учебник можно запустить локально.
|
Each of these files starts from the `# Main header`.
|
||||||
|
|
||||||
Сервер для этого находится здесь: <https://github.com/iliakan/javascript-tutorial-server>.
|
|
||||||
|
|
Loading…
Add table
Add a link
Reference in a new issue