aboutsummaryrefslogtreecommitdiff
path: root/files/uk/mdn/contribute/howto/create_and_edit_pages/index.html
blob: 900b4fa71fe34080caee72e396f46b524674e9c2 (plain)
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
---
title: Як створювати й редагувати сторінки
slug: MDN/Contribute/Howto/Create_and_edit_pages
tags:
  - Вступ
  - Початківець
  - Путівник
translation_of: MDN/Contribute/Howto/Create_and_edit_pages
original_slug: MDN/Contribute/Howto/Як_створювати_й_редагувати_сторінки
---
<div>{{MDNSidebar}}</div>

<p><span class="seoSummary">Ця стаття знайомить новачків із тим, як здійснюється редагування наявних сторінок та створення нових.</span></p>

<h2 id="Редагування_наявних_сторінок">Редагування наявних сторінок</h2>

<p>Редагування сторінки:</p>

<ul>
 <li>Клікніть на кнопку<strong> Редагувати</strong> в правому верхньому куті сторінки.</li>
 <li>Потім сторінка перезавантажиться з інтерфейсом редактора, в якому можна додавати або видаляти інформацію відразу на сторінці.</li>
 <li>Ви можете додавати параграфи, видаляти текст, вставляти заголовки і використовувати інші основні функції, які необхідні для написання та редагування. Дивіться керівництво <a href="/en-US/docs/MDN/Contribute/Editor/Basics">Editor UI elements</a> в <a href="/en-US/docs/MDN/Contribute/Editor">MDN Editor guide</a> щоб отримати більше інформації про використання вбудованого MDN редактора.</li>
</ul>

<h3 id="Попередній_перегляд_змін">Попередній перегляд змін</h3>

<p>Щоб продивитись, як ваші зміни будуть відображатись:</p>

<ul>
 <li>Клікніть на кнопку <strong>Попередній перегляд</strong> (в режимі редагування) над заголовком сторінки.</li>
 <li><span class="tlid-translation translation" lang="uk"><span title="">Це відкриває сторінку попереднього перегляду, яка показує ваші зміни в новому вікні або вкладці</span></span>.</li>
 <li><span class="tlid-translation translation" lang="uk"><span title="">Кожен раз, коли ви натискаєте цю кнопку, вона оновлює сторінку попереднього перегляду з останніми змінами</span></span>.</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="/en-US/docs/MDN/Contribute/Tagging"> Як правильно поставити теги сторінок</a> для отримання інформації про теги.</p>

<h3 id="Потрібна_перевірка">Потрібна перевірка?</h3>

<p><span class="tlid-translation translation" lang="uk"><span title="">Якщо експерт або досвідчений дописувач повинен переглянути ваші зміни, ви можете надіслати запит на технічний огляд (для коду, API чи технологій), редакційний огляд (прозу, граматику та вміст), переконавшись, що відповідний прапорець встановлено перед збереженням</span>.</span></p>

<h3 id="Вкладення_файлів">Вкладення файлів</h3>

<p>Якщо ви хочете <strong>долучити файл</strong><em> </em> <span class="tlid-translation translation" lang="uk"><span title="">до існуючої сторінки або додати ілюстрацію для подальшого роз'яснення, його можна ввести внизу сторінки.</span> <span title="">Завантажуючи зображення, будь ласка, використовуйте інструмент для оптимізації зображень, щоб зробити файл якомога меншим для завантаження.</span> <span title="">Це покращує час завантаження сторінки та сприяє загальній продуктивності MDN.</span> <span title="">Ви можете скористатись улюбленим інструментом, якщо він у вас є.</span></span> В іншому випадку ми пропонуємо <a href="https://tinypng.com/">TinyPNG</a>, зручний веб-інструмент.</p>

<h3 id="Оприлюднити_скасувати_чи_продовжити_редагування">Оприлюднити, скасувати чи продовжити редагування</h3>

<p>Коли ви закінчите редагування і будете задоволені своїм попереднім переглядом, ви <span class="tlid-translation translation" lang="uk"><span title="">ви можете опублікувати свою роботу та коментарі, натиснувши <em>зелену</em> кнопку</span></span>  <strong>Оприлюднити</strong> <span class="tlid-translation translation" lang="uk"><span title="">праворуч від заголовка сторінки або внизу сторінки.</span></span> <span class="tlid-translation translation" lang="uk"><span title="">Якщо ви хочете продовжувати працювати, натисніть кнопку</span></span> <strong>Оприлюднити та продовжити редагування</strong><span class="tlid-translation translation" lang="uk"><span title="">що публікує ваші зміни, зберігаючи інтерфейс редагування відкритим</span></span>.</p>

<p>Якщо ви передумали, ви можете скасувати свої зміни, натиснувши <em>червону</em> кнопку<strong> Відхилити</strong>. <span class="tlid-translation translation" lang="uk"><span title="">Зауважте, що відкидання змін <em>назавжди</em> відкидає їх.</span></span></p>

<p>Натискання <strong>Enter</strong> в полі редагування коментарів еквівалентне натисканню <strong>Оприлюднити та продовжити редагування</strong>.</p>

<div class="note">
<p>Якщо ви намагаєтесь зберегти свою сторінку і ваші зміни відхиляються як недійсні, коли ви намагаєтесь зберегти їх, але вміст насправді підходить для MDN, вам слід звернутися на <a href="mailto:mdn-admins@mozilla.com?subject=MDN%3A%20Content%20Rejection%20Appeal&amp;body=%3CDescribe%20the%20content%20you%20were%20trying%20to%20save%20and%20where%20you%20were%20trying%20to%20place%20it.%3E">email the MDN admin team</a>, щоб допомогли розмістити ваш контент.</p>
</div>

<h2 id="Отримання_дозволу_на_створення_сторінки">Отримання дозволу на створення сторінки</h2>

<p>For security reasons, newly-created accounts don't have the ability to create new pages. If you try to do so, you'll see a page instructing you how to go about getting the page created. There are two options:</p>

<ul>
 <li><strong>Ask for the page to be created for you.</strong> To do this, <a href="https://bugzilla.mozilla.org/enter_bug.cgi?bug_file_loc=http%3A%2F%2F&amp;bug_ignored=0&amp;bug_severity=normal&amp;bug_status=NEW&amp;cf_fx_iteration=---&amp;cf_fx_points=---&amp;contenttypemethod=autodetect&amp;contenttypeselection=text%2Fplain&amp;flag_type-4=X&amp;flag_type-607=X&amp;flag_type-800=X&amp;flag_type-803=X&amp;form_name=enter_bug&amp;maketemplate=Remember%20values%20as%20bookmarkable%20template&amp;op_sys=Unspecified&amp;priority=--&amp;product=Developer%20Documentation&amp;rep_platform=Unspecified&amp;short_desc=Create%20page%3A%20&amp;status_whiteboard=create-page&amp;target_milestone=---&amp;version=unspecified">file a documentation request bug</a> with the subject "Create page: &lt;page title&gt;". Be sure to fill out the URL field with the location on MDN where you'd like the page to go if you know where to put it. You should include in the comment text some information about why you need the page created.</li>
 <li><strong>Request page creation privileges.</strong> If you request page creation privileges and they're granted to you, you'll be able to add new pages yourself by following the instructions here. To request these privileges, <a href="mailto:mdn-admins@mozilla.org">email the MDN admin</a> team with your request. Be sure to include your username, why you would like to have the ability to create new pages (for instance, you're documenting a new API which involves many new pages, or you'd like to add new terms to the glossary). You should also have already made some useful contributions to the site content, and should have been a contributor for some length of time (the length of time and the other factors are all considered together, so there isn't a fixed time period here).</li>
</ul>

<h2 id="Створення_нової_сторінки">Створення нової сторінки</h2>

<p>Once you have page-creation permission, you can start creating new pages.</p>

<p>If you do not know where to put a new article, <strong>do not worry about it!</strong> Put it anywhere and we will find it and move it to where it belongs or merge it into existing content if that makes the most sense. You also do not need to worry about making it perfect. We have happy helper gnomes that will help make your content clean and luscious.</p>

<p>There are a few ways to create a new page:</p>

<ul>
 <li><a href="#Missing_page_link">"Missing page" link</a></li>
 <li><a href="#New_page_without_link">New page without link</a></li>
 <li><a href="#Subpage_of_an_existing_page">Subpage of an existing page</a></li>
 <li><a href="#Clone_of_an_existing_page">Clone of an existing page</a></li>
 <li><a href="#Link_from_an_existing_page">Link from an existing page</a></li>
</ul>

<dl>
</dl>

<h3 id="Посилання_на_відсутню_сторінку">Посилання на відсутню сторінку</h3>

<p>As with most wikis, on MDN it is possible to create a link to a page that doesn't yet exist. For example, an author might create a list of all the members of an API, before creating the pages for those members. On MDN, links to non-existent pages are typically displayed in red.</p>

<p>To create a page from a "missing page" link:</p>

<ol>
 <li>Make sure that you are logged into MDN, and have page-creation permission. (If you aren't logged in, clicking a "missing page" link gives a 404 (page not found) error.)</li>
 <li>Click the "missing page" link. If you have page creation permission, the <a href="/en-US/docs/MDN/Contribute/Editor">MDN Editor UI</a> opens, ready for you to create the missing page.</li>
 <li>Write the content of the page, and save it.</li>
</ol>

<h3 id="Нова_сторінка_без_посилань">Нова сторінка без посилань</h3>

<p><em>To create a new page without linking from another page</em>, enter a unique page name in the URL field of your browser. For example, if you enter:</p>

<pre class="language-html">https://developer.mozilla.org/uk/docs/FooBar</pre>

<p>MDN creates a new page with the title "FooBar" and opens the editor so you can add content to the new page. Refer to the <a href="#Editing_an_existing_page">Editing an existing page</a> section of this article for how to use the editor mode.</p>

<p><em>To create a new page without linking from another page</em>:</p>

<ol>
 <li>Make sure that you are logged in, and have page-creation permission.</li>
 <li>Enter the following in the URL field of your browser.</li>
</ol>

<pre class="language-html">https://developer.mozilla.org/uk/docs/new</pre>

<p>MDN creates a new page with a place for a title and opens the editor so you can add content to the new page. Refer to the <a href="#Editing_an_existing_page">Editing an existing page</a> section of this article for how to use the editor mode.</p>

<h3 id="Підстаття_наявної_статті">Підстаття наявної статті</h3>

<p>To create a page that you want to be below an existing page in the page hierarchy:</p>

<ol>
 <li>On the "parent" page, click the <strong>Advanced</strong> menu (the gear icon in the toolbar), and click <strong>New sub-page</strong>. An editor view opens for creating a new document.</li>
 <li>Type a title for the document in the <strong>Title</strong> field.</li>
 <li>Change the <strong>Slug</strong> field if needed (for example, if the title is very long and you want a shorter URL). This field is automatically filled by the editor, by substituting underscores for spaces in the title. In this case, you can change only the last part of the URL of the document.</li>
 <li>In the <strong>TOC</strong> field, select the heading levels you want to be automatically displayed in the table of contents for the page, or "No table of contents" if the page doesn't need one.</li>
 <li>Write content of the page in the editor pane, and save your changes. Refer to the <a href="#Editing_an_existing_page">Editing an existing page</a> section of this article for how to use the editor mode.</li>
</ol>

<h3 id="Створення_клона_наявної_сторінки">Створення клона наявної сторінки</h3>

<p>If there is an existing page whose format you want to use for your new page, you can "clone" that page and then change the content.</p>

<ol>
 <li>On the original page, click the <strong>Advanced</strong> menu (the gear icon in the toolbar), and click <strong>Clone this page</strong>. An editor view opens for creating a new document.</li>
 <li>Change the <strong>Title</strong> of the page as appropriate for the new content. The <strong>Slug</strong> field is updated automatically as you change the <strong>Title</strong> field.</li>
 <li>If needed, change the path portion of the <strong>Slug</strong> field, to put the new document in a different part of the document hierarchy. (In most cases, this is not needed, because the cloned page has similar content to the original, and therefore should be located in a similar place.)</li>
 <li>In the <strong>TOC</strong> field, select the heading levels you want to be automatically displayed in the table of contents for the page, or "No table of contents" if the page doesn't need one.</li>
 <li>Write content of the page in the editor pane, and save your changes. Refer to the <a href="#Editing_an_existing_page">Editing an existing page</a> section of this article for how to use the editor mode.</li>
</ol>

<h3 id="Посилання_з_наявної_сторінки">Посилання з наявної сторінки</h3>

<p>This method is a bit of a hybrid. You can create a link on another page, and then click the link you just inserted, to create the new page.</p>

<ol>
 <li>Enter the name of the new page anywhere (that makes sense) in the text of an existing page.</li>
 <li>Highlight the name and <strong>click the Link icon (<img alt="" src="https://developer.mozilla.org/files/3810/link-icon.png" style="height: 28px; width: 29px;">) </strong>in the editor's toolbar. The <strong>"Update Link"</strong> dialog opens, with the highlighted text in the<strong> "Link To"</strong> field.</li>
 <li>"/en-US/docs/" is inserted by default at the beginning of the URL field.<em> Enter the name </em>of the page after "/en-US/docs/". (The page name doesn't have to be the same as the link text.)</li>
 <li>Click OK to create and insert the link.</li>
</ol>

<p>If the page does not already exist, the link is displayed in red. If the page <em>does</em> already exist, the link is displayed in blue. If you want to create a new page but the page title you want is already taken, check first if it makes more sense to help edit and improve the page that is already there. Otherwise, think of a different title for your new page and create a link for it. Refer to the <a href="https://developer.mozilla.org/Project:en/Page_Naming_Guide" title="Project:en/Page_Naming_Guide">page naming guide</a> for guidelines.</p>

<p>To add content to your new page, click on the red link you just created (after saving and closing the editor). The new page opens in editor mode, so you can start writing. Refer to the <a href="#Editing_an_existing_page">Editing an existing page</a> section of this article for how to use the editor mode.</p>

<h2 id="Оновлення_вмісту_сторінки">Оновлення вмісту сторінки</h2>

<p>MDN's support for KumaScript macros and transclusion of content from one page into another can sometimes be hampered slightly by the need for caching of generated pages for performance reasons. Pages are built from their source, and that output is cached for future requests. From then on, any macros (templates) or transclusions (using the macro<span class="templateLink"><code><a href="https://developer.mozilla.org/en-US/docs/Template:Page">Page</a></code></span> on that page will not reflect changes made to the macro, the macro's output, or the contents of the transcluded material.</p>

<ul>
 <li>To update a page manually, you can do a force-refresh in your browser. MDN detects this and triggers a page rebuild, pulling in updated macro output and transcluded page content.</li>
 <li>You can also configure pages to periodically be rebuilt automatically. This should not be done unless you expect the page to need updating frequently. See <a href="/en-US/docs/MDN/Contribute/Tools/Page_regeneration">Page regeneration</a> for detailed information.</li>
</ul>

<h2 id="Див._також">Див. також</h2>

<ul>
 <li><a href="/en-US/docs/MDN/Contribute/Editor">MDN editor guide</a></li>
 <li><a href="/en-US/docs/MDN/Contribute/Content/Style_guide">MDN style guide</a></li>
</ul>