Skip to content

Commit 3070037

Browse files
committed
migrate to markdown-it
1 parent b50be79 commit 3070037

File tree

1,104 files changed

+14207
-17765
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

1,104 files changed

+14207
-17765
lines changed

1-js/1-getting-started/1-intro/article.md

Lines changed: 75 additions & 89 deletions
Large diffs are not rendered by default.
-31 Bytes
Loading
-13 Bytes
Loading

1-js/1-getting-started/2-pre-coding/article.md

Lines changed: 36 additions & 50 deletions
Large diffs are not rendered by default.

1-js/1-getting-started/3-editor/article.md

Lines changed: 21 additions & 28 deletions
Original file line numberDiff line numberDiff line change
@@ -1,31 +1,28 @@
11
# Редакторы для кода
22

3-
Для разработки обязательно нужен хороший редактор.
3+
Для разработки обязательно нужен хороший редактор.
44

55
Выбранный вами редактор должен иметь в своем арсенале:
66

7-
<ol>
8-
<li>Подсветку синтаксиса.</li>
9-
<li>Автодополнение.</li>
10-
<li>"Фолдинг" (от англ. folding) -- возможность скрыть-раскрыть блок кода.</li>
11-
</ol>
7+
1. Подсветку синтаксиса.
8+
2. Автодополнение.
9+
3. "Фолдинг" (от англ. folding) -- возможность скрыть-раскрыть блок кода.
1210

1311
[cut]
12+
1413
## IDE
1514

1615
Термин IDE (Integrated Development Environment) -- "интегрированная среда разработки", означает редактор, который расширен большим количеством "наворотов", умеет работать со вспомогательными системами, такими как багтрекер, контроль версий, и много чего ещё.
1716

1817
Как правило, IDE загружает весь проект целиком, поэтому может предоставлять автодополнение по функциям всего проекта, удобную навигацию по его файлам и т.п.
1918

20-
Если вы ещё не задумывались над выбором IDE, присмотритесь к следующим вариантам.
19+
Если вы ещё не задумывались над выбором IDE, присмотритесь к следующим вариантам.
2120

22-
<ul>
23-
<li>Продукты IntelliJ: [WebStorm](http://www.jetbrains.com/webstorm/), а также в зависимости от дополнительного языка программирования [PHPStorm (PHP)](http://www.jetbrains.com/phpstorm/), [IDEA (Java)](http://www.jetbrains.com/idea/), [RubyMine (Ruby)](http://www.jetbrains.com/ruby/) и другие.</li>
24-
<li>Visual Studio, в сочетании с разработкой под .NET (Win)</li>
25-
<li>Продукты на основе Eclipse, в частности [Aptana](http://www.aptana.com/) и Zend Studio</li>
26-
<li>[Komodo IDE](http://www.activestate.com/komodo-ide) и его облегчённая версия [Komodo Edit](http://www.activestate.com/komodo-edit).</li>
27-
<li>[Netbeans](http://netbeans.org/)</li>
28-
</ul>
21+
- Продукты IntelliJ: [WebStorm](http://www.jetbrains.com/webstorm/), а также в зависимости от дополнительного языка программирования [PHPStorm (PHP)](http://www.jetbrains.com/phpstorm/), [IDEA (Java)](http://www.jetbrains.com/idea/), [RubyMine (Ruby)](http://www.jetbrains.com/ruby/) и другие.
22+
- Visual Studio, в сочетании с разработкой под .NET (Win)
23+
- Продукты на основе Eclipse, в частности [Aptana](http://www.aptana.com/) и Zend Studio
24+
- [Komodo IDE](http://www.activestate.com/komodo-ide) и его облегчённая версия [Komodo Edit](http://www.activestate.com/komodo-edit).
25+
- [Netbeans](http://netbeans.org/)
2926

3027
Почти все они, за исключением Visual Studio, кросс-платформенные.
3128

@@ -35,31 +32,27 @@
3532

3633
## Лёгкие редакторы
3734

38-
Лёгкие редакторы -- не такие мощные, как IDE, но они быстрые и простые, мгновенно стартуют.
35+
Лёгкие редакторы -- не такие мощные, как IDE, но они быстрые и простые, мгновенно стартуют.
3936

4037
Основная сфера применения лёгкого редактора -- мгновенно открыть нужный файл, чтобы что-то в нём поправить.
4138

42-
На практике "лёгкие" редакторы могут обладать большим количеством плагинов, так что граница между IDE и "лёгким" редактором размыта, спорить что именно редактор, а что IDE -- не имеет смысла.
39+
На практике "лёгкие" редакторы могут обладать большим количеством плагинов, так что граница между IDE и "лёгким" редактором размыта, спорить что именно редактор, а что IDE -- не имеет смысла.
4340

4441
Достойны внимания:
4542

46-
<ul>
47-
<li><a href="http://www.sublimetext.com/">Sublime Text</a> (кросс-платформенный, shareware).</li>
48-
<li><a href="https://atom.io/">Atom</a> (кросс-платформенный, free).</li>
49-
<li><a href="http://www.scintilla.org/">SciTe</a> простой, легкий и очень быстрый (Windows, бесплатный).</li>
50-
<li><a href="http://sourceforge.net/projects/notepad-plus/">Notepad++</a> (Windows, бесплатный).</li>
51-
<li>Vim, Emacs. Если умеете их готовить.</li>
52-
</ul>
43+
- <a href="http://www.sublimetext.com/">Sublime Text</a> (кросс-платформенный, shareware).
44+
- <a href="https://atom.io/">Atom</a> (кросс-платформенный, free).
45+
- <a href="http://www.scintilla.org/">SciTe</a> простой, легкий и очень быстрый (Windows, бесплатный).
46+
- <a href="http://sourceforge.net/projects/notepad-plus/">Notepad++</a> (Windows, бесплатный).
47+
- Vim, Emacs. Если умеете их готовить.
5348

5449
## Мои редакторы
5550

5651
Лично мои любимые редакторы:
5752

58-
<ul>
59-
<li>Как IDE -- редакторы от Jetbrains: для чистого JavaScript [WebStorm](http://www.jetbrains.com/webstorm/), если ещё какой-то язык, то в зависимости от языка: [PHPStorm (PHP)](http://www.jetbrains.com/phpstorm/), [IDEA (Java)](http://www.jetbrains.com/idea/), [RubyMine (Ruby)](http://www.jetbrains.com/ruby/). У них есть и другие редакторы под разные языки, но я ими не пользовался.</li>
60-
<li>Как быстрый редактор -- <a href="http://www.sublimetext.com">Sublime Text</a>.</li>
61-
<li>Иногда Visual Studio, если разработка идёт под платформу .NET (Win).</li>
62-
</ul>
53+
- Как IDE -- редакторы от Jetbrains: для чистого JavaScript [WebStorm](http://www.jetbrains.com/webstorm/), если ещё какой-то язык, то в зависимости от языка: [PHPStorm (PHP)](http://www.jetbrains.com/phpstorm/), [IDEA (Java)](http://www.jetbrains.com/idea/), [RubyMine (Ruby)](http://www.jetbrains.com/ruby/). У них есть и другие редакторы под разные языки, но я ими не пользовался.
54+
- Как быстрый редактор -- <a href="http://www.sublimetext.com">Sublime Text</a>.
55+
- Иногда Visual Studio, если разработка идёт под платформу .NET (Win).
6356

6457
Если не знаете, что выбрать -- можно посмотреть на них ;)
6558

1-js/1-getting-started/4-devtools/article.md

Lines changed: 39 additions & 52 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22

33
При разработке скриптов всегда возможны ошибки... Впрочем, что я говорю? У вас абсолютно точно будут ошибки, если конечно вы -- человек, а не <a href="http://ru.wikipedia.org/wiki/%D0%91%D0%B5%D0%BD%D0%B4%D0%B5%D1%80_(%D0%A4%D1%83%D1%82%D1%83%D1%80%D0%B0%D0%BC%D0%B0)">робот</a>.
44

5-
Чтобы читать их в удобном виде, а также получать массу полезной информации о выполнении скриптов, в браузерах есть *инструменты разработки*.
5+
Чтобы читать их в удобном виде, а также получать массу полезной информации о выполнении скриптов, в браузерах есть *инструменты разработки*.
66

77
**Для разработки рекомендуется использовать Chrome или Firefox.**
88

@@ -12,100 +12,87 @@
1212

1313
[cut]
1414

15-
## Google Chrome
15+
## Google Chrome
1616

17-
Откройте страницу [bug.html](bug.html).
17+
Откройте страницу [bug.html](bug.html).
1818

1919
В её JavaScript-коде есть ошибка. Конечно, обычному посетителю она не видна, нужно открыть инструменты разработчика.
2020

21-
Для этого используйте клавишу [key F12] под Windows, а если у вас Mac, то [key Cmd+Opt+J].
21+
Для этого используйте клавишу `key:F12` под Windows, а если у вас Mac, то `key:Cmd+Opt+J`.
2222

2323
При этом откроются инструменты разработчика и вкладка Console, в которой будет ошибка.
2424

2525
Выглядеть будет примерно так:
2626

27-
<img src="chrome.png">
27+
![](chrome.png)
2828

29+
- При клике на `bug.html` вы перейдёте во вкладку с кодом к месту ошибки, там будет и краткое описание ошибки.
30+
В данном случае ошибка вызвана строкой `lalala`, которая интерпретатору непонятна.
31+
- В этом же окошке вы можете набирать команды на JavaScript. Например, наберите `alert("Hello")` -- команду вывода сообщения и запустите её нажатием `key:Enter`. Мы познакомимся с этой и другими командами далее.
32+
- Для перевода курсора на следующую строку (если команда состоит из нескольких строк) -- используется сочетание `key:Shift+Enter`.
2933

30-
<ul>
31-
<li>При клике на `bug.html` вы перейдёте во вкладку с кодом к месту ошибки, там будет и краткое описание ошибки.
32-
В данном случае ошибка вызвана строкой `lalala`, которая интерпретатору непонятна. </li>
33-
<li>В этом же окошке вы можете набирать команды на JavaScript. Например, наберите `alert("Hello")` -- команду вывода сообщения и запустите её нажатием [key Enter]. Мы познакомимся с этой и другими командами далее.</li>
34-
<li>Для перевода курсора на следующую строку (если команда состоит из нескольких строк) -- используется сочетание [key Shift+Enter].</li>
35-
</ul>
34+
Далее в учебнике мы подробнее рассмотрим отладку в Chrome в главе <info:debugging-chrome>.
3635

37-
Далее в учебнике мы подробнее рассмотрим отладку в Chrome в главе [](/debugging-chrome).
36+
## Firefox
3837

39-
## Firefox
38+
Для разработки в Firefox используется расширение Firebug.
4039

41-
Для разработки в Firefox используется расширение Firebug.
40+
1. Первым делом его надо установить.
4241

43-
<ol>
44-
<li>Первым делом его надо установить.
42+
Это можно сделать со страницы <a href="https://addons.mozilla.org/ru/firefox/addon/firebug/">https://addons.mozilla.org/ru/firefox/addon/firebug/</a>.
4543

46-
Это можно сделать со страницы <a href="https://addons.mozilla.org/ru/firefox/addon/firebug/">https://addons.mozilla.org/ru/firefox/addon/firebug/</a>.
44+
Перезапустите браузер. Firebug появится в правом-нижнем углу окна:
4745

48-
Перезапустите браузер. Firebug появится в правом-нижнем углу окна:
46+
![](firebug-gray.png)
4947

50-
<img src="firebug-gray.png">
48+
Если иконки не видно -- возможно, у вас выключена панель расширений. Нажмите `key:Ctrl+\` для её отображения.
5149

52-
Если иконки не видно -- возможно, у вас выключена панель расширений. Нажмите [key Ctrl+\] для её отображения.
50+
Ну а если её нет и там, то нажмите `key:F12` -- это горячая клавиша для запуска Firebug, расширение появится, если установлено.
51+
2. Далее, для того чтобы консоль заработала, её надо включить.
5352

54-
Ну а если её нет и там, то нажмите [key F12] -- это горячая клавиша для запуска Firebug, расширение появится, если установлено.
55-
</li>
56-
<li>Далее, для того чтобы консоль заработала, её надо включить.
53+
Если консоль уже была включена ранее, то этот шаг не нужен, но если она серая -- выберите в меню `Консоль` и включите её:
5754

58-
Если консоль уже была включена ранее, то этот шаг не нужен, но если она серая -- выберите в меню `Консоль` и включите её:
55+
![](firefox_console_enable.png)
56+
3. Для того, чтобы Firebug работал без глюков, желательно сначала открыть Firebug, а уже потом -- зайти на страницу.
5957

60-
<img src="firefox_console_enable.png">
58+
С открытым Firebug зайдите на страницу с ошибкой: [bug.html](/devtools/bug.html).
6159

62-
</li>
63-
<li>Для того, чтобы Firebug работал без глюков, желательно сначала открыть Firebug, а уже потом -- зайти на страницу.
60+
Консоль покажет ошибку:
6461

65-
С открытым Firebug зайдите на страницу с ошибкой: [bug.html](/devtools/bug.html).
62+
![](firefox.png)
6663

67-
Консоль покажет ошибку:
64+
Кликните на строчке с ошибкой и браузер покажет исходный код. При необходимости включайте дополнительные панели.
6865

69-
<img src="firefox.png">
66+
Как и в Chrome, можно набирать и запускать команды. Область для команд на рисунке находится справа, запуск команд осуществляется нажатием `key:Ctrl+Enter` (для Mac -- `key:Cmd+Enter`).
7067

71-
Кликните на строчке с ошибкой и браузер покажет исходный код. При необходимости включайте дополнительные панели.
72-
</li>
73-
</ol>
74-
75-
Как и в Chrome, можно набирать и запускать команды. Область для команд на рисунке находится справа, запуск команд осуществляется нажатием [key Ctrl+Enter] (для Mac -- [key Cmd+Enter]).
76-
77-
Можно перенести её вниз, нажав на кнопочку <img src="firefox_console_down.png"> (на рисунке её не видно, но она присутствует в правом нижнем углу панели разработки).
68+
Можно перенести её вниз, нажав на кнопочку ![](firefox_console_down.png) (на рисунке её не видно, но она присутствует в правом нижнем углу панели разработки).
7869

7970
Об основных возможностях можно прочитать на сайте <a href="http://firebug.ru">firebug.ru</a>.
8071

81-
## Internet Explorer
72+
## Internet Explorer
8273

83-
Панель разработчика запускается нажатием [key F12].
74+
Панель разработчика запускается нажатием `key:F12`.
8475

8576
Откройте её и зайдите на страницу с ошибкой: [bug.html](/devtools/bug.html). Если вы разобрались с Chrome/Firefox, то дальнейшее будет вам более-менее понятно, так как инструменты IE построены позже и по аналогии с Chrome/Firefox.
8677

87-
## Safari
78+
## Safari
8879

89-
Горячие клавиши: [key Ctrl+Shift+I], [key Ctrl+Alt+C] для Mac -- [key Cmd] вместо [key Ctrl].
80+
Горячие клавиши: `key:Ctrl+Shift+I`, `key:Ctrl+Alt+C` для Mac -- `key:Cmd` вместо `key:Ctrl`.
9081

9182
Для доступа к функционалу разработки через меню:
9283

93-
<ol>
94-
<li>
95-
В Safari первым делом нужно активировать меню разработки.
84+
1. В Safari первым делом нужно активировать меню разработки.
9685

97-
Откройте меню, нажав на колесико справа-сверху и выберите `Настройки`.
86+
Откройте меню, нажав на колесико справа-сверху и выберите `Настройки`.
9887

99-
Затем вкладка `Дополнительно`:
88+
Затем вкладка `Дополнительно`:
10089

101-
<img src="safari.png">
90+
![](safari.png)
10291

103-
Отметьте `Показывать меню "Разработка" в строке меню`. Закройте настройки.
104-
</li>
105-
<li>Нажмите на колесико и выберите `Показать строку меню`.
92+
Отметьте `Показывать меню "Разработка" в строке меню`. Закройте настройки.
93+
2. Нажмите на колесико и выберите `Показать строку меню`.
10694

107-
Инструменты будут доступны в появившейся строке меню, в пункте `Разработка`.</li>
108-
</ol>
95+
Инструменты будут доступны в появившейся строке меню, в пункте `Разработка`.
10996

11097
## Итого
11198

0 commit comments

Comments
 (0)