Repository files navigation

Этот репозитарий содержит учебник JavaScripthttps://learn.javascript.ru.

Движок, написанный на io.js, находится в отдельном репозитарииhttps://github.com/iliakan/javascript-nodejs, а здесь — текст.

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

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

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

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

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

Каждый из этих файлов начинается с# Заголовка материала.

Абсолютный URL для разделов и статей -- это URL-имя без номера и родителей, для задачи -- с префиксом/task/.

Например:

• директория2-ui/3-event-details с файломindex.md - это раздел сайта "События в деталях", он будет доступен по URL/event-details.
• директория2-ui/3-event-details/6-drag-and-drop с файломarticle.md содержит статью "Мышь: Drag'n'Drop, доступную по URL/drag-and-drop`.
• директория2-ui/3-event-details/6-drag-and-drop/slider с файломtask.md содержит задачу с названием "Слайдер", доступную по адресу/task/slider.

Заметим, что хотя структура директорий вложенная — все адреса "плоские". То есть, для URL берётся только последняя часть, собственно название материала: /event-details, /drag-and-drop и т.п. Это сделано специально, чтобы удобно было упорядочивать учебник, переносить статьи, и не менять адреса.

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

Все исправления и замечания, оформленные в виде Pull Request, будут учтены.