1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
|
---
title: Как создавать и редактировать страницы
slug: MDN/Contribute/Howto/Create_and_edit_pages
tags:
- MDN основы
- Гайд
- Как
- Новичок
- Стартовая
translation_of: MDN/Contribute/Howto/Create_and_edit_pages
original_slug: MDN/Contribute/Creating_and_editing_pages
---
<div>{{MDNSidebar}}</div>
<p><span class="seoSummary">Данная статья предоставляет новым контрибьюторам основную информацию о процессе создания и редактирования страниц.</span></p>
<h2 id="Редактирование_уже_существующей_страницы">Редактирование уже существующей страницы</h2>
<p>Чтобы редактировать страницу:</p>
<ol>
<li>Кликните на кнопку <strong>Редактировать</strong> в правом верхнем углу страницы.</li>
<li>Затем страница перезагрузится, и вы увидите редактор, в котором можно добавлять или удалять информацию напрямую.</li>
<li>Добавляйте параграфы, удаляйте текст, вставляйте заголовки и используйте другие основные фунцкии, которые нужны для написания и редактирования.</li>
</ol>
<p>Смотрите руководства <a href="/ru/docs/MDN/Contribute/Editor/Basics">Редактор UI элементов</a> в <a href="/ru/docs/MDN/Contribute/Editor">Руководстве по MDN редактору</a>, чтобы получить больше информации об использовании встроенных <strong>MDN </strong>редакторах.</p>
<h3 id="Предварительный_просмотр_изменений">Предварительный просмотр изменений</h3>
<p>Чтобы посмотреть, как ваши изменения будут выглядеть:</p>
<ul>
<li>Кликните на кнопку <strong>Предварительный просмотр </strong>в режиме редактирования, в в самом верху или низу страницы.</li>
<li>Это откроет страницу предварительного просмотра, показывающую ваши изменения (ревизии) в новом окне или вкладке.</li>
<li>Каждый раз, когда вы нажимаете на кнопку <strong>Предварительный просмотр</strong>, ваша страница предварительного просмотра обновляется до последних изменений.</li>
</ul>
<p><strong>Будьте аккуратны! </strong>Предварительный просмотр не сохраняет ваши изменения. Не закрывайте вкладку с редактором, пока не сохраните свою работу.</p>
<h3 id="Комментарий_к_ревизии">Комментарий к ревизии</h3>
<p>После предварительного просмотра своих изменений вы захотите <em>сохранить свою ревизию</em>. Перед тем, как <strong>сохранить</strong>, посмотрите на текстовый блок с комментарием к ревизии, находящийся внизу страницы и оставляющий комментарий для того, чтобы объяснить другим контрибьторам, зачем вы сделали изменения. Например, вы могли добавить новую секцию, изменить текст, чтобы сделать терминологию более упорядоченной, переписать параграф для лучшего объяснения или удалить определённую информацию, так как она просто лишняя.</p>
<h3 id="Содержание">Содержание</h3>
<p>В секции "В этой статье" находится список ссылок к заголовкам на странице. Вы можете изменить содержание, изменив заголовки. Также вы можете просто убрать данную секцию или увеличить количество ссылок, поменяв в секции "Редактировать описание" значение пункта "Оглавление".</p>
<h3 id="Метки_статьи_теги">Метки статьи (теги)</h3>
<p>Вы можете добавлять или удалять теги, описывающие содержание и назначение страницы, в самом низу страницы редактирования. Смотрите <a href="/ru/docs/Project:MDN/Contributing/Tagging_standards">Стандартные метки статей в MDN</a>, чтобы получить больше информации о тегах.</p>
<h3 id="Требуется_проверка">Требуется проверка?</h3>
<p>Если ваши изменения нуждаются в проверке экспертом или просто опытным контрибьютором, то, пожалуйста, оставьте заявку на техническую (для кода, API или технологий) и/или на редакционную (качества написания, грамматики или содержимого) проверку, убедитесь, что поставили галочки в нужных вам полях перед тем, как сохранить.</p>
<h3 id="Прикрепить_файлы">Прикрепить файлы</h3>
<p>Если вы хотите <strong>прикрепить файлы </strong>к существующей странице или добавить иллюстрацию для объяснения, это может быть сделано внизу страницы. При загрузке изображения, пожалуйста, убедитесь, что используете инструменты оптимизации, чтобы сделать файл маленьким, а загрузку возможной. Это улучшает время загрузки страницы и помогает производительности MDN в целом. Вы можете использовать свой любимый инструмент, если он у вас есть. Иначе, мы предлагаем <a href="https://tinypng.com/">TinyPNG</a> - удобный Веб инструмент.</p>
<h3 id="Публикация_отмена_или_дальнейшие_изменения"> Публикация, отмена или дальнейшие изменения</h3>
<p>Когда вы закончили редактирование и довольны изменениями, опубликуйте свою работу и комментарии, кликнув на <em>зелёную </em>кнопку <strong>Опубликовать</strong> в правом верхнем или нижнем углу страницы. Если же вы хотите продолжить вносить изменения, нажмите <strong>Сохранить и продолжить редактирование</strong>, это опубликует ваши изменения, однако оставит вас во вкладке с редактором.</p>
<p>Если вы изменили своё мнение, вы можете отменить изменения, нажав на <em>красную </em>кнопку <strong>Отменить</strong>. Изменения, которые вы хотите отменить, будут <em>навсегда </em>отменены.</p>
<p>Нажатие клавиши <strong>Enter </strong>в поле ввода комментария к ревизии то же самое, что нажатие кнопку <strong>Сохранить и продолжить редактирование</strong>.</p>
<div class="note">
<p>Если при попытке сохранить изменения, они были не приняты как некорректные, но вы считаете, что правки полностью приемлемы для MDN, <a href="mailto:mdn-admins@mozzila.com?subject=MDN%20Content%20Rejection%20Appeal&body=Describe%20the%20content%20you%20were%20trying%20to%20save%20and%20where%20you%20were%20trying%20to%20place%20it.">обратитесь к администрации MDN</a> за помощью.</p>
</div>
<h2 id="Получение_прав_на_создание_страниц">Получение прав на создание страниц</h2>
<p>По причинам безопасности недавно созданные аккаунты не имеют права добавлять новые страницы. Если вы попытаетесь сделать это, то увидите страницу с инструкцией, как создать страницу. Есть два варианта:</p>
<ul>
<li><strong>Попросить, чтобы страница была создана для вас. </strong>Чтобы сделать это, <a href="https://bugzilla.mozilla.org/enter_bug.cgi?bug_file_loc=http%3A%2F%2F&bug_ignored=0&bug_severity=normal&bug_status=NEW&cf_fx_iteration=---&cf_fx_points=---&contenttypemethod=autodetect&contenttypeselection=text%2Fplain&flag_type-4=X&flag_type-607=X&flag_type-800=X&flag_type-803=X&form_name=enter_bug&maketemplate=Remember%20values%20as%20bookmarkable%20template&op_sys=Unspecified&priority=--&product=Developer%20Documentation&rep_platform=Unspecified&short_desc=Create%20page%3A%20&status_whiteboard=create-page&target_milestone=---&version=unspecified">отправьте запрос</a> с темой "Create page: <название страницы>". Заполните адресную строку URL, указывающим, где именно на MDN вы хотите видеть страницу. В поле ввода комментария укажите, почему вы хотите создать эту страницу.</li>
<li><strong>Запросить права на создание страниц</strong>. Если вы оставите заявку на получение прав и получите их, то вы сможете добавлять новые страницы в соответствии с инструкциями, приведёнными здесь. Чтобы оставить заявку, <a href="mailto:mdn-admins@mozilla.org">свяжитесь с администрацией MDN</a>. Напишите своё имя пользователя (username) и почему вы хотите создавать страницы. Например, вы делаете документацию для нового API, которая требует добавления новых страниц, или вы хотите добавить новые термины в словарь. Также вы должны сделать полезные изменения содержимого для этой страницы и быть контрибьютором ещё некоторое время. Время и другие вещи рассматриваются вместе.</li>
</ul>
<h2 id="Создание_новой_страницы">Создание новой страницы</h2>
<p>Сразу же, как только вы получили право создавать страницы, вы может начать добавлять их.</p>
<p>Если вы не знаете, где разместить новую статью, <strong>не беспокойтесь</strong>. Вставьте её, куда угодно: мы найдём её и переместим туда, где ей лучше всего быть, или используем её в уже существующем контенте. Также не волнуйтесь о том, чтобы статья выглядела идеально. У нас есть гномы-помощники, которые помогают сделать вашу статью понятнее и привлекательнее.</p>
<p>Есть несколько способов создать страницу:</p>
<ul>
<li><a href="#Ссылка_на_отсутствующую_страницу">Ссылка на отсутствующую страницу.</a></li>
<li><a href="#Новая_страница_без_ссылки">Новая страница без ссылки.</a></li>
<li><a href="#Подстраница_уже_имеющейся_страницы">Подстраница уже имеющейся страницы.</a></li>
<li><a href="#Клонирование_уже_имеющейся_страницы">Клонирование уже имеющейся страницы.</a></li>
<li><a href="#Ссылка_из_уже_имеющейся_страницы">Ссылка из уже имеющейся страницы.</a></li>
</ul>
<h3 id="Ссылка_на_отсутствующую_страницу">Ссылка на отсутствующую страницу</h3>
<p>Как и в большинстве вики, возможно такое, что есть ссылка, ведущая на страницу, которой ещё нет. Например, автор мог написать список участников API перед тем, как создать страницы для этих участников. На MDN ссылки на несуществующие страницы обычно отображаются красным цветом.</p>
<p>Чтобы создать отсутствующую страницу:</p>
<ol>
<li>Войдите в MDN аккаунт с правами на создание страниц. Если вы не зайдёте, тогда при переходе на ссылку на отсутсвующую страницу будет выводиться ошибка 404 (страница не найдена).</li>
<li>Кликните на ссылку на отсутсвующую страницу. Если у вас есть соответсвующие права, тогда перед вами откроется <a href="/ru/docs/MDN/Contribute/Editor">MDN Редактор (Editor) UI</a> для создания страницы.</li>
<li>Напишите содержание страницы и сохраните её.</li>
</ol>
<h3 id="Новая_страница_без_ссылки">Новая страница без ссылки</h3>
<p>Чтобы создать <em>новую страницу без ссылки с другой страницы</em>, введите имя несуществующей страницы в адресной строке вашего браузера. Например, если вы введёте:</p>
<pre><code>https://developer.mozilla.org/ru/docs/FooBar</code>
</pre>
<p>MDN создаст новую страницу с заголовком "FooBar" и открытым редактором для добавления контента. Вернитесь к разделу <a href="#Editing_an_existing_page">Редактирование уже существующей страницы</a> в этой статье, чтобы узнать, как работать в редакторе.</p>
<p><em>Чтобы создать новую страницу без ссылки с другой страницы:</em></p>
<ol>
<li>Войдите в аккаунт с правами на создание страниц.</li>
<li>Введите следующий текст в адресную строку своего браузера:</li>
</ol>
<pre class="syntaxbox"><code>https://developer.mozilla.org/ru/docs/new</code>
</pre>
<p>MDN создаст страницу с местом для заголовка и откроет редактор, чтобы добавить содержимое. Вернитесь к разделу <a href="#Editing_an_existing_page">Редактирование уже существующей страницы</a> в этой статье, чтобы узнать больше о редакторе.</p>
<h3 id="Подстраница_уже_имеющейся_страницы">Подстраница уже имеющейся страницы</h3>
<p>Чтобы создать подстраницу:</p>
<ol>
<li>На "родительской" странице (parent page) нажмите кнопку <strong>Дополнительно </strong>(значок шестерёнки в правом верхнем углу страницы) и выберите <strong>Новая подстатья</strong>.</li>
<li>Откроется редактор для создания документа.</li>
<li>Добавьте заголовок в поле <strong>Заголовок</strong>.</li>
<li>Если нужно, измените <strong>Slug </strong>поле. Например, если заголовок длинный и короткий URL смотрится лучше. Это поле по умолчанию заполняет редактор, заменяя в заголовке пробелы нижними подчёркиваниями и изменяя только последнюю часть URL.</li>
<li>В поле <strong>Оглавление</strong> выберите уровни заголовков, которые нужно отобразить. Если же оглавление не нужно, можно выбрать "Нет содержимого".</li>
<li>Напишите статью в редакторе и сохраните изменения. Вернитесь к разделу <a href="#Editing_an_existing_page">Редактирование уже существующей страницы</a> в этой статье, чтобы узнать больше о редакторе.</li>
</ol>
<h3 id="Клонирование_уже_имеющейся_страницы">Клонирование уже имеющейся страницы</h3>
<p>Если уже есть страница, формат и структуру которой вы хотите использовать для создание собственной, то вы можете просто склонировать эту страницу, а затем изменить её содержимое.</p>
<ol>
<li>На оригинальной странице нажмите на кнопку<strong> Дополнительно</strong> и выберите <strong>Клонировать эту статью</strong>. Откроется редактор для создания нового документа. </li>
<li>Измените Заголовок страницы в соответствии с контентом. Поле Slug обновится автоматически, как только вы измените Заголовок.</li>
<li>Измените путь в поле <strong>Slug</strong>, если нужно вставить документ в другое место в иерархии документа. В большинстве случаев это не нужно. Клонированная страница чаще всего схожа по контенту с оригиналом, поэтому желательно, чтобы она была в том же месте.</li>
<li>В поле <strong>Оглавление</strong> выберите уровни заголовков для содержания. Или выберите "Нет содержимого", если это не нужно.</li>
<li>Напишите статью и сохраните изменения. Вернитесь к разделу <a href="#Editing_an_existing_page">Редактирование уже существующей страницы</a> в этой статье, чтобы узнать больше о редакторе.</li>
</ol>
<h3 id="Ссылка_из_уже_имеющейся_страницы">Ссылка из уже имеющейся страницы</h3>
<p>Это в какой-то степени гибрид. Вы можете создать ссылку на другую страницу, затем нажать на ссылку, которую вы только что создали, чтобы добавить новую страницу:</p>
<ol>
<li>Введите имя новой страницы, где угодно, чтобы это был текст на существующей странице. </li>
<li>Выделите это новое имя и нажмите на <strong>значок ссылки</strong> <strong>(<img alt="" src="https://developer.mozilla.org/files/3810/link-icon.png">) </strong>в панеле инструментов редактора. Окно "<strong>Обновить ссылку</strong>" откроется с выделенным текстом в поле "<strong>Ссылка на</strong>".</li>
<li>"/ru/docs/" вставлена по умолчанию в начале URL. <em>Введите имя страницы </em>после "/ru/docs/". Название страницы необязательно должно совпадать с текстом ссылки. </li>
<li>Нажмите OK, чтобы создать и вставить ссылку.</li>
</ol>
<p>Если страницы ещё не существует, то ссылка будет красного цвета. Если же страница <em>уже</em> есть, то ссылка будет синего цвета. Если вы хотите создать новую страницу, но заголовок уже занят, проверьте, возможно вы можете помочь редактировать и улучшить эту страницу. С другой стороны придумайте уникальное имя для своей страницы и сделайте ссылку для неё. Посмотрите также <a href="/ru/docs/Project:Writer's_guide">Руководство по оформлению материалов MDN</a>.</p>
<h2 id="Обновление_содержимого_страницы">Обновление содержимого страницы</h2>
<p>MDN поддерживает KumaScript макросы и интеграцию контента с других страниц, иногда кэширования страниц может быть затруднено по соображениям производительности. Страницы строятся из своих исходных мест, и их сборка может кэшироваться для дальнейших запросов. С этого момента макросы (шаблоны) или интеграции (используют макрос <code>Page</code>) не будут реагировать на дальнейшие изменения самих макросов, их выходных данных или контента интегрированных материалов.</p>
<ul>
<li>Чтобы вручную обновить страницу перезагрузите свой браузер. MDN заметит эту перестройку страницы и обновит выходные данные макроса и интегрированный контент на странице.</li>
<li>Вы также можете настроить страницы на автоматическое переодическое обновление. Это не стоит делать, если вы собираетесь обновлять страницу часто. Смотрите <a href="en-US/docs/MDN/Contribute/Tools/Page_regeneration">Регенерация страниц</a> для более детальной информации.</li>
</ul>
<h2 id="См._также">См. также</h2>
<ul>
<li><a href="/ru/docs/MDN/Contribute/Editor">Руководство по MDN редактору</a></li>
<li><a href="/ru/docs/Project:Writer's_guide">Руководство по оформлению материалов MDN</a></li>
</ul>
|