Як створювати й редагувати сторінки

Ця стаття знайомить новачків із тим, як здійснюється редагування наявних сторінок та створення нових.

Редагування наявних сторінок

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

  • Клікніть на кнопку Редагувати в правому верхньому куті сторінки.
  • Потім сторінка перезавантажиться з інтерфейсом редактора, в якому можна додавати або видаляти інформацію відразу на сторінці.
  • Ви можете додавати параграфи, видаляти текст, вставляти заголовки і використовувати інші основні функції, які необхідні для написання та редагування. Дивіться керівництво Editor UI elements в MDN Editor guide щоб отримати більше інформації про використання вбудованого MDN редактора.

Попередній перегляд змін

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

  • Клікніть на кнопку Попередній перегляд (в режимі редагування) над заголовком сторінки.
  • Це відкриває сторінку попереднього перегляду, яка показує ваші зміни в новому вікні або вкладці.
  • Кожен раз, коли ви натискаєте цю кнопку, вона оновлює сторінку попереднього перегляду з останніми змінами.

Будьте уважні! Попередній перегляд сторінки не зберігає ваші зміни, тому не закривайте вкладку з редактором, поки не збережете свою роботу.

Коментар до ревізії

Після попереднього перегляду змін ви захочете зберегти вашу ревізію (версію). Перед тим, як зберегти, подивіться на текстовий блок з коментарями до ревізії, що знаходиться внизу сторінки і залиште коментар, щоб пояснити іншим учасникам, чому ви зробили будь-які зміни. Наприклад, ви можливо, додали новий розділ, змінили деякі слова, щоб зробити термінологію більш послідовною, переписали абзац для уточнення мови або видалили інформацію, оскільки вона була зайвою.

Зміст

В розділі "У цій статті" знаходиться автоматично створений список посилань до заголовків на сторінці. Формулювання цих посилань можна змінювати, редагуючи заголовки. Також можна видалити вміст секції або зменшити кількість посилань в ній, вибравши "Редагувати назву сторінки та властивості" і змінити значення спадного списку пункту "зміст".

Мітки

Ви можете додавати або видаляти теги, які описують вміст сторінки і функцію під розділом редагування сторінки. Дивіться розділ Як правильно поставити теги сторінок для отримання інформації про теги.

Потрібна перевірка?

Якщо експерт або досвідчений дописувач повинен переглянути ваші зміни, ви можете надіслати запит на технічний огляд (для коду, API чи технологій), редакційний огляд (прозу, граматику та вміст), переконавшись, що відповідний прапорець встановлено перед збереженням.

Вкладення файлів

Якщо ви хочете долучити файл до існуючої сторінки або додати ілюстрацію для подальшого роз'яснення, його можна ввести внизу сторінки. Завантажуючи зображення, будь ласка, використовуйте інструмент для оптимізації зображень, щоб зробити файл якомога меншим для завантаження. Це покращує час завантаження сторінки та сприяє загальній продуктивності MDN. Ви можете скористатись улюбленим інструментом, якщо він у вас є. В іншому випадку ми пропонуємо TinyPNG, зручний веб-інструмент.

Оприлюднити, скасувати чи продовжити редагування

Коли ви закінчите редагування і будете задоволені своїм попереднім переглядом, ви ви можете опублікувати свою роботу та коментарі, натиснувши зелену кнопку Оприлюднити праворуч від заголовка сторінки або внизу сторінки. Якщо ви хочете продовжувати працювати, натисніть кнопку Оприлюднити та продовжити редагуваннящо публікує ваші зміни, зберігаючи інтерфейс редагування відкритим.

Якщо ви передумали, ви можете скасувати свої зміни, натиснувши червону кнопку Відхилити. Зауважте, що відкидання змін назавжди відкидає їх.

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

Якщо ви намагаєтесь зберегти свою сторінку і ваші зміни відхиляються як недійсні, коли ви намагаєтесь зберегти їх, але вміст насправді підходить для MDN, вам слід звернутися на email the MDN admin team, щоб допомогли розмістити ваш контент.

Отримання дозволу на створення сторінки

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:

  • Ask for the page to be created for you. To do this, file a documentation request bug with the subject "Create page: <page title>". 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.
  • Request page creation privileges. 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, email the MDN admin 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).

Створення нової сторінки

Once you have page-creation permission, you can start creating new pages.

If you do not know where to put a new article, do not worry about it! 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.

There are a few ways to create a new page:

Посилання на відсутню сторінку

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.

To create a page from a "missing page" link:

  1. 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.)
  2. Click the "missing page" link. If you have page creation permission, the MDN Editor UI opens, ready for you to create the missing page.
  3. Write the content of the page, and save it.

Нова сторінка без посилань

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

https://developer.mozilla.org/uk/docs/FooBar

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 Editing an existing page section of this article for how to use the editor mode.

To create a new page without linking from another page:

  1. Make sure that you are logged in, and have page-creation permission.
  2. Enter the following in the URL field of your browser.
https://developer.mozilla.org/uk/docs/new

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 Editing an existing page section of this article for how to use the editor mode.

Підстаття наявної статті

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

  1. On the "parent" page, click the Advanced menu (the gear icon in the toolbar), and click New sub-page. An editor view opens for creating a new document.
  2. Type a title for the document in the Title field.
  3. Change the Slug 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.
  4. In the TOC 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.
  5. Write content of the page in the editor pane, and save your changes. Refer to the Editing an existing page section of this article for how to use the editor mode.

Створення клона наявної сторінки

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.

  1. On the original page, click the Advanced menu (the gear icon in the toolbar), and click Clone this page. An editor view opens for creating a new document.
  2. Change the Title of the page as appropriate for the new content. The Slug field is updated automatically as you change the Title field.
  3. If needed, change the path portion of the Slug 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.)
  4. In the TOC 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.
  5. Write content of the page in the editor pane, and save your changes. Refer to the Editing an existing page section of this article for how to use the editor mode.

Посилання з наявної сторінки

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.

  1. Enter the name of the new page anywhere (that makes sense) in the text of an existing page.
  2. Highlight the name and click the Link icon () in the editor's toolbar. The "Update Link" dialog opens, with the highlighted text in the "Link To" field.
  3. "/en-US/docs/" is inserted by default at the beginning of the URL field. Enter the name of the page after "/en-US/docs/". (The page name doesn't have to be the same as the link text.)
  4. Click OK to create and insert the link.

If the page does not already exist, the link is displayed in red. If the page does 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 page naming guide for guidelines.

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 Editing an existing page section of this article for how to use the editor mode.

Оновлення вмісту сторінки

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 macroPage on that page will not reflect changes made to the macro, the macro's output, or the contents of the transcluded material.

  • 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.
  • 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 Page regeneration for detailed information.

Див. також