Как создавать и редактировать страницы

Есть две самые основные задачи на MDN, которые выполняет практически любой помощник MDN. Первое - редактирование существующей страницы и второе - создание новой. В данной статье рассматриваются самые основы того, как сделать каждую из них.

Редактирование существующей страницы

Редактировать очень просто:

• Просто нажмите на кнопку "Редактировать" в верхнем левом углу страницы.
• Страница загружается с параметрами форматирования, так что вы можете приступать к оформлению прямо в окне редактора.
• Вы можете добавлять пункты, удалять текст, вставлять заголовки и испытать ещё множество различные функции создания и редактирования.

Предпросмотр изменений

Чтобы посмотреть, как выглядят ваши изменения:

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

Будьте осторожны! Предпросмотр страницы НЕ СОХРАНЯЕТ ваш прогресс, так что лучше не закрывайте эту страницу при открытии окна предпросмотра.

Комментарий к ревизии

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

Метки

You can add or remove tags that describe the page content and function below the editing section of the page. See How to properly tag pages for information on what tags to apply.

Нужна ли проверка?

If an expert or experienced contributor should review your edits, you can request a technical review (for code, API's, or technologies), an editorial review (for prose, grammar, and content), or a template review (for KumaScript code) by making sure the box is checked before you save.

Прикрепление файлов

Если вы хотите прикрепить к редактируемой странице файл с изображением или дополнительными пояснениями, воспользуйтесь формой добавления файлов, расположенной в низу страницы.

Сохранение, отмена или продолжение редактирования

When you are finished editing, and happy with your preview, you can save your work and comments by clicking the green "Save changes" to the right of the page title. If you change your mind, you can discard your edits by clicking the red "Discard changes" button to the right of the page title.

Pressing Enter in the Revision Comment field is equivalent to clicking "Save and Keep Editing".

Создание новой страницы

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:

• "Missing page" link
• New page without link
• Subpage of an existing page
• Clone of an existing page
• Link from an existing page

Получение прав на создание страницы

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: ". Be sure to fill out the URL field with the location on MDN you'd like the page to go at, 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).

Ссылка на "Отсутвующую страницу"

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 in to MDN. (If you aren't logged in, clicking a "missing page" link gives a 404 (page not found) error.)
2. Click the "missing page" link. 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/en-US/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 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 Page macro 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 details.

Смотрите также

• Руководство редактора MDN
• Руководство по оформлению материалов MDN