Этот репозитарий содержит учебник JavaScript, включая все разделы, статьи, задачи.

Он предназначен для отображения движком сайта javascript.ru, репозитарий https://github.com/iliakan/javascript-nodejs.

При этом синтаксис намеренно сделан совместимым с GitHub, чтобы при желании можно было читать текст прямо из репозитария. Конечно, "живые" примеры и другие продвинутые возможности при этом будут не доступны, т.к. парсер GitHub их не умеет.

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

Эта директория имеет вид 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.

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