Skip to content

Latest commit

 

History

History
executable file
·
47 lines (26 loc) · 3.61 KB

README.md

File metadata and controls

executable file
·
47 lines (26 loc) · 3.61 KB

При переносе репозитория потерялись звёзды GitHub. Давайте их вернём =) Пожалуйста, поставьте ★ сверху.

Современный учебник JavaScript

Всем привет!

Когда-то давно был только русский учебник https://learn.javascript.ru. Но несколько лет назад был полностью с нуля написан английский — https://javascript.info. И с тех пор все существенные изменения вносились только в него.

Сейчас учебники уже довольно сильно разошлись. Между статьями есть общие фрагменты, но и много различий.

Самое лучшее, что можно сделать – это перевести русский с английского. Для этого создан этот репозиторий.

Пожалуйста, помогите нам с переводом!

  • Перейдите в ишью с текущим состоянием перевода.
  • Выберите понравившуюся статью для перевода, у которой не отмечена галочка.
  • Напишите комментарий, указав название выбранной статьи, чтобы мейнтейнер узнал об этом и отметил вас в чеклисте.
  • Сделайте форк этого репозитория, начните переводить и когда закончите, откройте пулреквест.

Если вы хорошо знаете JavaScript и можете делать ревью статей - напишите нам: ревью очень важны для качества переводов.

🎉 Спасибо!

Обязательно ознакомьтесь с рекомендациями по переводу!

Структура

Каждому разделу, статье или задаче соответствует директория.

Эта директория имеет вид N-url, где N - это номер для сортировки статей и разделов (они упорядочены), а url – URL-имя, по которому материал будет доступен.

В директории находится один из файлов:

  • index.md для раздела
  • article.md для статьи
  • task.md для условия задачи (+там же solution.md с решением)

Каждый из этих файлов начинается с # Заголовка материала, и дальше текст в формате а-ля Markdown. Его довольно просто понять. Для редактирования достаточно простого текстового редактора.

Ресурсы и примеры, необходимые для статьи, раздела или задачи, находятся в её директории. На них можно ссылаться из материала.

Запуск локально

Для удобства редактирования учебник можно запустить локально.

Сервер для этого находится здесь: https://github.com/javascript-tutorial/server.