Skip to content

Commit 06f61d8

Browse files
committed
first commit
0 parents  commit 06f61d8

1 file changed

Lines changed: 40 additions & 0 deletions

File tree

README.md

Lines changed: 40 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,40 @@
1+
2+
# Учебник JavaScript
3+
4+
Этот репозитарий содержит учебник JavaScript, включая все разделы, статьи, задачи.
5+
6+
**Сейчас полностью экспортирован раздел https://github.com/iliakan/javascript-tutorial/tree/master/02-ui/03-event-details, позже будет всё содержимое.**
7+
8+
Он предназначен для отображения движком сайта javascript.ru, при помощи парсера https://github.com/iliakan/simpledownParser.
9+
10+
При этом синтаксис намеренно сделан совместимым с GitHub, чтобы при желании можно было читать текст прямо из репозитария. Конечно, "живые" примеры и другие продвинутые возможности при этом будут не доступны, т.к. парсер GitHub их не умеет.
11+
12+
**Каждому разделу, статье или задаче соответствует директория.**
13+
14+
Эта директория имеет вид NN-url, где NN - это номер для сортировки статей и разделов (они упорядочены), а url - URL-имя, по которому материал будет доступен.
15+
16+
В директории находится один из файлов:
17+
18+
- `index.md` для раздела
19+
- `article.md` для статьи
20+
- `task.md` для условия задачи (+там же `solution.md` с решением)
21+
22+
Каждый из этих файлов начинается с `# Заголовка материала`.
23+
24+
Абсолютный URL для разделов и статей -- это URL-имя без номера и родителей, для задачи -- с префиксом `/task/`.
25+
26+
Например:
27+
28+
- директория `02-ui/03-event-details` с файлом `index.md` - это раздел сайта "События в деталях", он будет доступен по URL `/event-details`.
29+
- директория `02-ui/03-event-details/06-drag-and-drop` с файлом `article.md` содержит статью "Мышь: Drag'n'Drop`, доступную по URL `/drag-and-drop`.
30+
- директория `02-ui/03-event-details/06-drag-and-drop/slider` с файлом `task.md` содержит задачу с названием "Слайдер", доступную по адресу `/task/slider`.
31+
32+
Ресурсы и примеры, необходимые для статьи, раздела или задачи, находятся в её директории. На них можно ссылаться из материала.
33+
34+
**Этот репозитарий пока не публичный, он станет публичным после релиза сайта.**
35+
36+
Это сделано для того, чтобы поисковики (Google, Yandex etc) не проиндексировали его содержимое до того, как оно появится на сайте. А то они подумают, что на сайте копия, а не оригинал материалов и понизят его в ранжировании.
37+
38+
39+
40+

0 commit comments

Comments
 (0)