From c058fa0fb22dc40ef0225b21a97578cddd0aaffa Mon Sep 17 00:00:00 2001 From: Florian Merz Date: Thu, 11 Feb 2021 14:51:05 +0100 Subject: unslug ru: move --- .../index.html | 34 ++++ .../index.html | 184 +++++++++++++++++++++ .../howto/create_an_mdn_account/index.html | 42 ----- .../howto/create_and_edit_pages/index.html | 182 ++++++++++++++++++++ .../howto/do_a_technical_review/index.html | 57 ------- .../howto/do_an_editorial_review/index.html | 52 ------ .../index.html" | 34 ---- .../index.html" | 41 ----- .../index.html" | 74 --------- .../index.html" | 184 --------------------- 10 files changed, 400 insertions(+), 484 deletions(-) create mode 100644 files/ru/mdn/contribute/howto/add_or_update_browser_compatibility_data/index.html create mode 100644 files/ru/mdn/contribute/howto/create_an_interactive_exercise_to_help_learning_the_web/index.html delete mode 100644 files/ru/mdn/contribute/howto/create_an_mdn_account/index.html create mode 100644 files/ru/mdn/contribute/howto/create_and_edit_pages/index.html delete mode 100644 files/ru/mdn/contribute/howto/do_a_technical_review/index.html delete mode 100644 files/ru/mdn/contribute/howto/do_an_editorial_review/index.html delete mode 100644 "files/ru/mdn/contribute/howto/\320\264\320\276\320\261\320\260\320\262\320\270\321\202\321\214_\320\270\320\273\320\270_\320\276\320\261\320\275\320\276\320\262\320\270\321\202\321\214_\320\264\320\260\320\275\320\275\321\213\320\265_\320\276_\320\261\321\200\320\260\321\203\320\267\320\265\321\200\320\275\320\276\320\271_\321\201\320\276\320\262\320\274\320\265\321\201\321\202\320\270\320\274\320\276\321\201\321\202\320\270/index.html" delete mode 100644 "files/ru/mdn/contribute/howto/\320\272\320\260\320\272_\320\276\320\277\321\202\320\270\320\274\320\270\320\267\320\270\321\200\320\276\320\262\320\260\321\202\321\214_\321\201\321\202\321\200\320\260\320\275\320\270\321\206\321\213/index.html" delete mode 100644 "files/ru/mdn/contribute/howto/\320\274\320\265\321\202\320\272\320\270_javascript_\321\201\321\202\321\200\320\260\320\275\320\270\321\206/index.html" delete mode 100644 "files/ru/mdn/contribute/howto/\321\201\320\276\320\267\320\264\320\260\320\271_\320\270\320\275\321\202\320\265\321\200\320\260\320\272\321\202\320\270\320\262\320\275\320\276\320\265_\321\203\320\277\321\200\320\260\320\266\320\275\320\265\320\275\320\270\320\265_\320\264\320\273\321\217_\320\277\320\276\320\274\320\276\321\211\320\270_\320\262_\320\270\320\267\321\203\321\207\320\265\320\275\320\270\320\270_\320\262\320\265\320\261\320\260/index.html" (limited to 'files/ru/mdn/contribute/howto') diff --git a/files/ru/mdn/contribute/howto/add_or_update_browser_compatibility_data/index.html b/files/ru/mdn/contribute/howto/add_or_update_browser_compatibility_data/index.html new file mode 100644 index 0000000000..5b31ce215e --- /dev/null +++ b/files/ru/mdn/contribute/howto/add_or_update_browser_compatibility_data/index.html @@ -0,0 +1,34 @@ +--- +title: Как добавить или обновить данные о браузерной совместимости +slug: MDN/Contribute/Howto/Добавить_или_обновить_данные_о_браузерной_совместимости +tags: + - MDN Meta + - Руководство +translation_of: MDN/Contribute/Howto/Add_or_update_browser_compatibility_data +--- +
{{MDNSidebar}}{{IncludeSubnav("/ru/docs/MDN")}}
+ +

Если вы знаете информацию о браузерной совместимости с веб-функциями — или вы хотите помочь и можете провести некоторые исследования или эксперименты — вы можете помочь обновить MDN База данных о браузерной совместимости (BCD).

+ +
+
Где это нужно сделать?
+
+

Есть несколько способов как вы можете улучшить информацию о браузерной совместимости на MDN:

+ +
    +
  • Добавить данные о веб-функциях, ещё не включённых в BCD репозиторий
    • +
  • Обновить существующие данные новой информацией на основе либо изменениях в новых версиях браузеров, исправления ошибок в существующих данных, либо обновления о данных функциях
    • +
  • Отправить pull request по адресу BCD проблемы на Github.
    • +
+
+
Что вам нужно знать, чтобы выполнить задачу?
+
+
    +
  • Знакомство с Github
    • +
  • Знакомство с JSON
    • +
  • Информация о чём-либо или возможность проверить совместимость функций веб-стандартов в различных браузерах. Вы также можете конвертировать "старые" таблицы совместимости в формат JSON.
    • +
+
+
Какие шаги нужно сделать, чтобы выполнить задачу?
+
Подробнее о том как обновить JSON файлы в BCD репозитории на Github, смотри нашу статью таблицы совместимости. Для списка проблем по которым конкретно ищется помощь ищите  Github проблемы с тегом "Help Wanted".
+
diff --git a/files/ru/mdn/contribute/howto/create_an_interactive_exercise_to_help_learning_the_web/index.html b/files/ru/mdn/contribute/howto/create_an_interactive_exercise_to_help_learning_the_web/index.html new file mode 100644 index 0000000000..5488b77d10 --- /dev/null +++ b/files/ru/mdn/contribute/howto/create_an_interactive_exercise_to_help_learning_the_web/index.html @@ -0,0 +1,184 @@ +--- +title: Как создать интерактивное обучающее упражнение +slug: >- + MDN/Contribute/Howto/Создай_интерактивное_упражнение_для_помощи_в_изучении_веба +translation_of: MDN/Contribute/Howto/Create_an_interactive_exercise_to_help_learning_the_web +--- +
{{MDNSidebar}}
+ +
{{IncludeSubnav("/en-US/docs/MDN")}}
+ +

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

+ +

Нет прямого способа для создания такого контента. Например существует много сторонних инструментов которые помогут в создании живых примеров (см: JSFiddle, CodePen, Dabblet, и т.д.) которые вы можете ссылаться из MDN статей. Если вы хотите создать более продвинутые упражнения, то можете воспользоваться Thimble из проекта WebMaker.

+ +

На данный момент MDN не имеет лёгкого инструмента для пометки автора такого контента. Однако, если вы являетесь программистом, то можете возпользоваться текущими MDN функциями для создания своего активного обучающего контента. Читайте далее для того чтобы узнать как это сделать.

+ +

MDN live samples

+ +

MDN has a very cool feature called live samples. It's a mechanism that turns any HTML, CSS, and JavaScript code inside an MDN page into its executed equivalent. Before using it, you should read over Using the live sample system, which is our complete documentation for building them. While they're easy to do, there are quirks and tricks you'll learn along the way.

+ +

What is interesting is that it's really easy to tweak that feature to use it in order to embed any kind of tool or utility you want into an MDN page.

+ +

Hidden code

+ +

The first way to use a code sample to create active learning content is to edit the page where you want to add your content. Use the Live Sample feature to create your content as you wish. Don't bother with the code complexity you could write; just create what you need. Once your content is ready, just switch to the editor code view and surround your code with a simple {{HTMLElement('div')}} element with the class hidden. By doing so, your code won't be displayed but your live sample remains accessible and displayable.

+ +

Let's see a simple example:

+ +
+

Click on the following square to randomly change its color or just type a hexadecimal code color

+ + +{{EmbedLiveSample('hidden_code_example', 120, 120)}}
+ +

If you take a look at that page HTML code with the MDN editor, you'll see the exact following HTML code:

+ +
<div class="moreinfo">
+<p>Click on the following square to randomly change its color or just type an hexadecimal code color</p>
+
+<div class="hidden">
+<h4 id="hidden_code_example">hidden code example</h4>
+
+<h5 id="HTML">HTML</h5>
+
+<pre class="brush: html">
+&lt;div class="square"&gt;
+  #&lt;input class="color"&gt;
+&lt;/div&gt;</pre>
+
+<h5 id="CSS">CSS</h5>
+
+<pre class="brush: css">
+body {
+  padding: 10px;
+  margin : 0;
+}
+
+.square {
+  width  : 80px;
+  height : 80px;
+  padding: 10px;
+  background-color: black;
+  color: white;
+  text-align: center;
+}
+
+.color {
+  width: 60px;
+  text-transform: uppercase;
+}
+</pre>
+
+<h5 id="JS">JS</h5>
+
+<pre class="brush: js">
+function setColor(color) {
+  document.querySelector('.square').style.backgroundColor = '#' + color;
+  document.querySelector('.color').value = color;
+}
+
+function getRandomColor() {
+  var color = Math.floor(Math.random() * 16777215);
+  return color.toString(16);
+}
+
+function getInputColor() {
+  var value = document.querySelector('.color').value;
+  var color = Number('0x' + color);
+  if (color === +color) {
+    return color.toString(16);
+  }
+  return value;
+}
+
+document.addEventListener('click', function () {
+  setColor(getRandomColor());
+});
+
+document.addEventListener('keyup', function () {
+  setColor(getInputColor());
+});
+</pre>
+</div>
+
+\{{EmbedLiveSample('hidden_code_example', 120, 120)}}
+</div>
+ +

You can see a more advance example of such a tweak on the Canvas API page.

+ +

Code from outside the page

+ +

The previous example is okay if you want to embed basic active learning content. However, if you want to deal with complex code, it can become a bit awkward to deal with that hidden class wrapper.

+ +

So another option is to write the code of your learning content on an MDN page and then embed it into another page. To do this we can use the {{TemplateLink("EmbedDistLiveSample")}} macro instead of the {{TemplateLink("EmbedLiveSample")}} macro.

+ +

Let's how that sample looks when configured as if it were being embedded from a remote origin:

+ +
+

Click on the following square to randomly change its color or just type a hexadecimal code color

+{{EmbedLiveSample('The_example', 120, 120, '', 'MDN/Contribute/Howto/Create_an_interactive_exercise_to_help_learning_the_web/distant_example')}}
+ +

This time, if you take a look at that page's HTML using the MDN editor, you'll see no hidden code. If you want to see the code, just go to the page that hosts it.

+ +

You can see a more advanced example of this usage in our HTML Form tutorial, which uses this technique to allow experimentation with forms.

diff --git a/files/ru/mdn/contribute/howto/create_an_mdn_account/index.html b/files/ru/mdn/contribute/howto/create_an_mdn_account/index.html deleted file mode 100644 index 99857a600a..0000000000 --- a/files/ru/mdn/contribute/howto/create_an_mdn_account/index.html +++ /dev/null @@ -1,42 +0,0 @@ ---- -title: Как создать MDN аккаунт -slug: MDN/Contribute/Howto/Create_an_MDN_account -tags: - - Документация - - Начинающий - - Руководство -translation_of: MDN/Contribute/Howto/Create_an_MDN_account ---- -
{{MDNSidebar}}
- -

Чтобы вносить любые изменения в контент на MDN, вам будет нужен MDN профиль (для чтения и поиска сайту он не нужен). Данное руководство поможет вам создать ваш MDN профиль.

- -
-
Дл чего MDN нужен адрес моей электронной почты?
-
-Адрес вашей электронной почты используется для восстановления аккаунта. Иногда адрес может понадобиться администраторам MDN, чтобы написать вам по вопросам, связанным с вашим аккаунтом либо с вашей активностью на данном сайте.
-
-Кроме того, вы можете дополнительно подписаться на уведомления (например, when specific pages are changed) и сообщения (например, если вы решите присоединиться к нашей команде бета-тестирования, то сможете получать по электронной почте сведения о новых возможностях сайта, которые нужно протестировать).
-
-Адрес вашей электронной почты никогда не будет показан на MDN и будет использоваться только согласно нашей политике конфиденциальности.
- -
Если вы вошли в MDN через аккаунт GitHub, и вы используете режим "noreply" в настройках почтового адреса на GitHub, вы не получите сообщений (включая оповещения от страниц, на которые вы подписаны) от MDN.
-
-
- -
    -
  1. В верхней части каждой страницы MDN есть кнопка с надписью Войти. Наведите курсор мыши на неё (или нажмите на неё, если вы на мобильном устройстве), чтобы отобразить список сервисов, которые мы поддерживаем для регистрации в MDN.
    2. -
  2. Выберите аккаунт для того, чтобы Войти в систему. Сейчас доступны GitHub и Google. Обратите внимание, что если вы выберете GitHub, то ссылка на ваш GitHub-профиль будет отображаться на публичной странице вашего профиля MDN.
    3. -
  3. Следуйте инструкциям, чтобы подключить выбранную учетную запись к MDN (например, форма для входа через GitHub будет выглядеть как на картинке ниже).
    4. -
  4. После того, как служба аутентификации вернет вас на сайт MDN, вам будет предложено ввести имя пользователя MDN и адрес электронной почты. Ваше имя пользователя будет отображаться публично, чтобы при вкладе в развитие сообщества было видно ваше авторство. Не используйте свой адрес электронной почты в качестве имени пользователя.
    5. -
  5. Нажмите Создать мой профиль MDN.
    6. -
  6. Если адрес электронной почты, указанный в шаге 4, не то же самый, который вы используете на выбранном для аутентификации сервисе, то проверьте свою электронную почту и нажмите на ссылку в письме с подтверждением, которое мы выслали вам.
    7. -
- -

Это всё! Теперь у вас есть аккаунт MDN, и вы можете сразу начать  редактировать контент сообщества!

- -

Нажмите на своё имя в верхней части любой страницы MDN, чтобы увидеть свой профиль. В профиле нажмите Редактировать, если хотите внести изменения или дополнения.

- -
-

Новые имена пользователей не могут содержать пробелы или символ"@". Выбирая имя, помните, что оно будет отображаться публично, чтобы было видно, что именно вы проделали ту или иную работу.

-
diff --git a/files/ru/mdn/contribute/howto/create_and_edit_pages/index.html b/files/ru/mdn/contribute/howto/create_and_edit_pages/index.html new file mode 100644 index 0000000000..9b6d34eff9 --- /dev/null +++ b/files/ru/mdn/contribute/howto/create_and_edit_pages/index.html @@ -0,0 +1,182 @@ +--- +title: Как создавать и редактировать страницы +slug: MDN/Contribute/Creating_and_editing_pages +tags: + - MDN основы + - Гайд + - Как + - Новичок + - Стартовая +translation_of: MDN/Contribute/Howto/Create_and_edit_pages +--- +
{{MDNSidebar}}
+ +

Данная статья предоставляет новым контрибьюторам основную информацию о процессе создания и редактирования страниц.

+ +

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

+ +

Чтобы редактировать страницу:

+ +
    +
  1. Кликните на кнопку Редактировать в правом верхнем углу страницы.
    2. +
  2. Затем страница перезагрузится, и вы увидите редактор, в котором можно добавлять или удалять информацию напрямую.
    3. +
  3. Добавляйте параграфы, удаляйте текст, вставляйте заголовки и используйте другие основные фунцкии, которые нужны для написания и редактирования.
    4. +
+ +

Смотрите руководства Редактор UI элементов в Руководстве по MDN редактору, чтобы получить больше информации об использовании встроенных MDN редакторах.

+ +

Предварительный просмотр изменений

+ +

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

+ + + +

Будьте аккуратны! Предварительный просмотр не сохраняет ваши изменения. Не закрывайте вкладку с редактором, пока не сохраните свою работу.

+ +

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

+ +

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

+ +

Содержание

+ +

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

+ +

Метки статьи (теги)

+ +

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

+ +

Требуется проверка?

+ +

Если ваши изменения нуждаются в проверке экспертом или просто опытным контрибьютором, то, пожалуйста, оставьте заявку на техническую (для кода, API или технологий) и/или на редакционную (качества написания, грамматики или содержимого) проверку, убедитесь, что поставили галочки в нужных вам полях перед тем, как сохранить.

+ +

Прикрепить файлы

+ +

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

+ +

 Публикация, отмена или дальнейшие изменения

+ +

Когда вы закончили редактирование и довольны изменениями, опубликуйте свою работу и комментарии, кликнув на зелёную кнопку Опубликовать в правом верхнем или нижнем углу страницы. Если же вы хотите продолжить вносить изменения, нажмите Сохранить и продолжить редактирование, это опубликует ваши изменения, однако оставит вас во вкладке с редактором.

+ +

Если вы изменили своё мнение, вы можете отменить изменения, нажав на красную кнопку Отменить. Изменения, которые вы хотите отменить, будут навсегда отменены.

+ +

Нажатие клавиши Enter в поле ввода комментария к ревизии то же самое, что нажатие кнопку Сохранить и продолжить редактирование.

+ +
+

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

+
+ +

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

+ +

По причинам безопасности недавно созданные аккаунты не имеют права добавлять новые страницы. Если вы попытаетесь сделать это, то увидите страницу с инструкцией, как создать страницу. Есть два варианта:

+ + + +

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

+ +

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

+ +

Если вы не знаете, где разместить новую статью, не беспокойтесь. Вставьте её, куда угодно: мы найдём её и переместим туда, где ей лучше всего быть, или используем её в уже существующем контенте. Также не волнуйтесь о том, чтобы статья выглядела идеально. У нас есть гномы-помощники, которые помогают сделать вашу статью понятнее и привлекательнее.

+ +

Есть несколько способов создать страницу:

+ + + +

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

+ +

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

+ +

Чтобы создать отсутствующую страницу:

+ +
    +
  1. Войдите в MDN аккаунт с правами на создание страниц. Если вы не зайдёте, тогда при переходе на ссылку на отсутсвующую страницу будет выводиться ошибка 404 (страница не найдена).
    2. +
  2. Кликните на ссылку на отсутсвующую страницу. Если у вас есть соответсвующие права, тогда перед вами откроется MDN Редактор (Editor) UI для создания страницы.
    3. +
  3. Напишите содержание страницы и сохраните её.
    4. +
+ +

Новая страница без ссылки

+ +

Чтобы создать новую страницу без ссылки с другой страницы, введите имя несуществующей страницы в адресной строке вашего браузера. Например, если вы введёте:

+ +
https://developer.mozilla.org/ru/docs/FooBar
+
+ +

MDN создаст новую страницу с заголовком "FooBar" и открытым редактором для добавления контента. Вернитесь к разделу Редактирование уже существующей страницы в этой статье, чтобы узнать, как работать в редакторе.

+ +

Чтобы создать новую страницу без ссылки с другой страницы:

+ +
    +
  1. Войдите в аккаунт с правами на создание страниц.
    2. +
  2. Введите следующий текст в адресную строку своего браузера:
    3. +
+ +
https://developer.mozilla.org/ru/docs/new
+
+ +

MDN создаст страницу с местом для заголовка и откроет редактор, чтобы добавить содержимое. Вернитесь к разделу Редактирование уже существующей страницы в этой статье, чтобы узнать больше о редакторе.

+ +

Подстраница уже имеющейся страницы

+ +

Чтобы создать подстраницу:

+ +
    +
  1. На "родительской" странице (parent page) нажмите кнопку Дополнительно (значок шестерёнки в правом верхнем углу страницы) и выберите Новая подстатья.
    2. +
  2. Откроется редактор для создания документа.
    3. +
  3. Добавьте заголовок в поле Заголовок.
    4. +
  4. Если нужно, измените Slug поле. Например, если заголовок длинный и короткий URL смотрится лучше. Это поле по умолчанию заполняет редактор, заменяя в заголовке пробелы нижними подчёркиваниями и изменяя только последнюю часть URL.
    5. +
  5. В поле Оглавление выберите уровни заголовков, которые нужно отобразить. Если же оглавление не нужно, можно выбрать "Нет содержимого".
    6. +
  6. Напишите статью в редакторе и сохраните изменения. Вернитесь к разделу Редактирование уже существующей страницы в этой статье, чтобы узнать больше о редакторе.
    7. +
+ +

Клонирование уже имеющейся страницы

+ +

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

+ +
    +
  1. На оригинальной странице нажмите на кнопку Дополнительно и выберите Клонировать эту статью. Откроется редактор для создания нового документа. 
    2. +
  2. Измените Заголовок страницы в соответствии с контентом. Поле Slug обновится автоматически, как только вы измените Заголовок.
    3. +
  3. Измените путь в поле Slug, если нужно вставить документ в другое место в иерархии документа. В большинстве случаев это не нужно. Клонированная страница чаще всего схожа по контенту с оригиналом, поэтому желательно, чтобы она была в том же месте.
    4. +
  4. В поле Оглавление выберите уровни заголовков для содержания. Или выберите "Нет содержимого", если это не нужно.
    5. +
  5. Напишите статью и сохраните изменения. Вернитесь к разделу Редактирование уже существующей страницы в этой статье, чтобы узнать больше о редакторе.
    6. +
+ +

Ссылка из уже имеющейся страницы

+ +

Это в какой-то степени гибрид. Вы можете создать ссылку на другую страницу, затем нажать на ссылку, которую вы только что создали, чтобы добавить новую страницу:

+ +
    +
  1. Введите имя новой страницы, где угодно, чтобы это был текст на существующей странице. 
    2. +
  2. Выделите это новое имя и нажмите на значок ссылки ()  в панеле инструментов редактора. Окно "Обновить ссылку" откроется с выделенным текстом в поле "Ссылка на".
    3. +
  3. "/ru/docs/" вставлена по умолчанию в начале URL. Введите имя страницы после "/ru/docs/". Название страницы необязательно должно совпадать с текстом ссылки. 
    4. +
  4. Нажмите OK, чтобы создать и вставить ссылку.
    5. +
+ +

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

+ +

Обновление содержимого страницы

+ +

MDN поддерживает KumaScript макросы и интеграцию контента с других страниц, иногда кэширования страниц может быть затруднено по соображениям производительности. Страницы строятся из своих исходных мест, и их сборка может кэшироваться для дальнейших запросов. С этого момента макросы (шаблоны) или интеграции (используют макрос Page) не будут реагировать на дальнейшие изменения самих макросов, их выходных данных или контента интегрированных материалов.

+ + + +

См. также

+ + diff --git a/files/ru/mdn/contribute/howto/do_a_technical_review/index.html b/files/ru/mdn/contribute/howto/do_a_technical_review/index.html deleted file mode 100644 index ba395e2669..0000000000 --- a/files/ru/mdn/contribute/howto/do_a_technical_review/index.html +++ /dev/null @@ -1,57 +0,0 @@ ---- -title: Как сделать технический обзор -slug: MDN/Contribute/Howto/Do_a_technical_review -tags: - - Guide - - Howto - - MDN Meta - - Как сделать - - Руководство -translation_of: MDN/Contribute/Howto/Do_a_technical_review ---- -
{{MDNSidebar}}
- -

Технический обзор заключается в рассмотрении технической точности и полноты статьи и её корректировки, если это необходимо. Если автор статьи хочет, чтобы кто-нибудь ещё проверил техническое содержание статьи, то он ставит пометку "Технический обзор" при редактировании. Часто автор связывается с определённым инженером для выполнения технического обзора, но кто-либо с техническими знаниями и опытом в теме также может сделать это.

- -

Эта статья описывает, как выполнить технический обзор, тем самым гарантируя точность содержания MDN.

- -
-
В чём задача?
-
Обзор и исправление статей на техническую точность и полноту.
-
Где это необходимо сделать?
-
В конкретных статьях, которые отмечены как требующие технического обзора.
-
Что Вы должны знать, чтобы выполнить задачу?
-
-
    -
  • Экспертные знания в теме, которую Вы обозреваете.
    • -
  • Возможность редактирования статьи на MDN.
    • -
-
-
Какие действия нужно выполнить, чтобы сделать это?
-
-
    -
  1. Выберите статью для обзора: -
      -
    1. Перейдите к списку страниц, которые нуждаются в техническом обзоре. В этом списке перечислены все страницы, для которых был запрошен технический обзор.
      2. -
    2. Выберите страницу, с темой которой Вы очень хорошо знакомы.
      3. -
    3. Нажмите на ссылку статьи, чтобы загрузить страницу.
      4. -
    -
    2. -
  2. Прочитайте статью, обращая пристально внимание на технические детали: Верна ли статья? Чего-то не хватает? Не стесняйтесь переключаться на другую статью, если выбранная не устраивает Вас.
    3. -
  3. Если ошибок нет, то Вам не нужно редактировать статью, чтобы отметить её как просмотренную. Посмотрите на окно "быстрого обзора" в левой боковой панели страницы:
    -
    - Выберите флажок Технический и нажмите Обзор завершен.
    4. -
  4. Если Вы нашли ошибки, которые нужно исправить: -
      -
    1. Нажмите кнопку Редактировать в верхней части страницы; она переместит Вас в редактор MDN.
      2. -
    2. Исправьте неверную техническую информацию и добавьте важную информацию, которая отсутствует.
      3. -
    3. Введите Комментарий к ревизии в нижней части статьи, который описывает, что Вы сделали, например, "Технический обзор закончен". Если Вы исправляли информацию, добавьте это в Ваш комментарий, например, "Технический обзор: исправлено описание параметров".
      4. -
    4. Отмените флажок Технический под Требуется проверка?.
      5. -
    5. Нажмите кнопку Сохранить изменения.
      6. -
    -
    5. -
-
-
- -

Поздравляем! Вы только что завершили свой первый технический обзор! Спасибо вам за вашу помощь! 

diff --git a/files/ru/mdn/contribute/howto/do_an_editorial_review/index.html b/files/ru/mdn/contribute/howto/do_an_editorial_review/index.html deleted file mode 100644 index eab3b47fde..0000000000 --- a/files/ru/mdn/contribute/howto/do_an_editorial_review/index.html +++ /dev/null @@ -1,52 +0,0 @@ ---- -title: Как сделать редакционный обзор -slug: MDN/Contribute/Howto/Do_an_editorial_review -tags: - - Guide - - Howto - - MDN Meta - - Как сделать - - Руководство -translation_of: MDN/Contribute/Howto/Do_an_editorial_review ---- -
{{MDNSidebar}}

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

- -

Эта статья описывает выполнение редакционного обзора для поддержания точности содержания MDN.

- -
-
В чём задача?
-
Техническое редактирование и исправление статей, которые отмечены как требующие редакционного обзора.
-
Где это необходимо сделать?
-
В конкретных статьях, которые отмечены как требующие редакционного обзора.
-
Что Вы должны знать, чтобы выполнить задачу?
-
Вы должны иметь хорошие грамматические и орфографические навыки в русском языке.
-
Какие действия нужно выполнить, чтобы сделать это?
-
-
    -
  1. Выберите статью для обзора: -
      -
    1. Перейдите к списку страниц, которые нуждаются в редакционном обзоре.  В этом списке перечислены все страницы, для которых был запрошен редакционный обзор.
      2. -
    2. Выберите страницу.
      3. -
    3. Нажмите на ссылку статьи, чтобы загрузить страницу.
      4. -
    -
    2. -
  2. Прочитайте статью, обращая пристальное внимание на опечатки и орфографические, грамматические или оборотные ошибки. Не стесняйтесь переключаться на другую статью, если выбранная не устраивает Вас.
    3. -
  3. Если ошибок нет, то Вам не нужно редактировать статью, чтобы отметить её как прошедшую корректуру. Посмотрите на окно "быстрого обзора" в левой боковой панели страницы:
    -
    - Выберите флажок Редакционный и нажмите Обзор завершен.
    4. -
  4. Если Вы нашли ошибки, которые нужно исправить: -
      -
    1. Нажмите кнопку Редактировать в верхней части страницы; она переместит Вас в редактор MDN.
      2. -
    2. Исправьте все опечатки и орфографические, грамматические или оборотные ошибки, которые Вы видите.
      3. -
    3. Введите Комментарий ревизии в нижней части статьи; что-то вроде 'Редакционный обзор: исправлены опечатки, грамматика и орфография'.
      4. -
    4. Снимите флажок Редакционный под Требуется проверка?.
      5. -
    5. Нажмите кнопку Сохранить изменения.
      6. -
    -
    5. -
- -
-

Из-за соображений производительности Ваши правки могут не сразу появиться на странице.

-
-
-
diff --git "a/files/ru/mdn/contribute/howto/\320\264\320\276\320\261\320\260\320\262\320\270\321\202\321\214_\320\270\320\273\320\270_\320\276\320\261\320\275\320\276\320\262\320\270\321\202\321\214_\320\264\320\260\320\275\320\275\321\213\320\265_\320\276_\320\261\321\200\320\260\321\203\320\267\320\265\321\200\320\275\320\276\320\271_\321\201\320\276\320\262\320\274\320\265\321\201\321\202\320\270\320\274\320\276\321\201\321\202\320\270/index.html" "b/files/ru/mdn/contribute/howto/\320\264\320\276\320\261\320\260\320\262\320\270\321\202\321\214_\320\270\320\273\320\270_\320\276\320\261\320\275\320\276\320\262\320\270\321\202\321\214_\320\264\320\260\320\275\320\275\321\213\320\265_\320\276_\320\261\321\200\320\260\321\203\320\267\320\265\321\200\320\275\320\276\320\271_\321\201\320\276\320\262\320\274\320\265\321\201\321\202\320\270\320\274\320\276\321\201\321\202\320\270/index.html" deleted file mode 100644 index 5b31ce215e..0000000000 --- "a/files/ru/mdn/contribute/howto/\320\264\320\276\320\261\320\260\320\262\320\270\321\202\321\214_\320\270\320\273\320\270_\320\276\320\261\320\275\320\276\320\262\320\270\321\202\321\214_\320\264\320\260\320\275\320\275\321\213\320\265_\320\276_\320\261\321\200\320\260\321\203\320\267\320\265\321\200\320\275\320\276\320\271_\321\201\320\276\320\262\320\274\320\265\321\201\321\202\320\270\320\274\320\276\321\201\321\202\320\270/index.html" +++ /dev/null @@ -1,34 +0,0 @@ ---- -title: Как добавить или обновить данные о браузерной совместимости -slug: MDN/Contribute/Howto/Добавить_или_обновить_данные_о_браузерной_совместимости -tags: - - MDN Meta - - Руководство -translation_of: MDN/Contribute/Howto/Add_or_update_browser_compatibility_data ---- -
{{MDNSidebar}}{{IncludeSubnav("/ru/docs/MDN")}}
- -

Если вы знаете информацию о браузерной совместимости с веб-функциями — или вы хотите помочь и можете провести некоторые исследования или эксперименты — вы можете помочь обновить MDN База данных о браузерной совместимости (BCD).

- -
-
Где это нужно сделать?
-
-

Есть несколько способов как вы можете улучшить информацию о браузерной совместимости на MDN:

- -
    -
  • Добавить данные о веб-функциях, ещё не включённых в BCD репозиторий
    • -
  • Обновить существующие данные новой информацией на основе либо изменениях в новых версиях браузеров, исправления ошибок в существующих данных, либо обновления о данных функциях
    • -
  • Отправить pull request по адресу BCD проблемы на Github.
    • -
-
-
Что вам нужно знать, чтобы выполнить задачу?
-
-
    -
  • Знакомство с Github
    • -
  • Знакомство с JSON
    • -
  • Информация о чём-либо или возможность проверить совместимость функций веб-стандартов в различных браузерах. Вы также можете конвертировать "старые" таблицы совместимости в формат JSON.
    • -
-
-
Какие шаги нужно сделать, чтобы выполнить задачу?
-
Подробнее о том как обновить JSON файлы в BCD репозитории на Github, смотри нашу статью таблицы совместимости. Для списка проблем по которым конкретно ищется помощь ищите  Github проблемы с тегом "Help Wanted".
-
diff --git "a/files/ru/mdn/contribute/howto/\320\272\320\260\320\272_\320\276\320\277\321\202\320\270\320\274\320\270\320\267\320\270\321\200\320\276\320\262\320\260\321\202\321\214_\321\201\321\202\321\200\320\260\320\275\320\270\321\206\321\213/index.html" "b/files/ru/mdn/contribute/howto/\320\272\320\260\320\272_\320\276\320\277\321\202\320\270\320\274\320\270\320\267\320\270\321\200\320\276\320\262\320\260\321\202\321\214_\321\201\321\202\321\200\320\260\320\275\320\270\321\206\321\213/index.html" deleted file mode 100644 index 26d5101d9d..0000000000 --- "a/files/ru/mdn/contribute/howto/\320\272\320\260\320\272_\320\276\320\277\321\202\320\270\320\274\320\270\320\267\320\270\321\200\320\276\320\262\320\260\321\202\321\214_\321\201\321\202\321\200\320\260\320\275\320\270\321\206\321\213/index.html" +++ /dev/null @@ -1,41 +0,0 @@ ---- -title: Как оптимизировать страницы -slug: MDN/Contribute/Howto/Как_оптимизировать_страницы -translation_of: MDN/Contribute/Howto/Set_the_summary_for_a_page ---- -
{{MDNSidebar}}

Вы можете заняться оптимизацией любой страницы на MDN, для поисковой оптимизации страницы, вы можете выбрать любую страницу: пусть то будет Лендинговая страница или подсказки. Это должен быть текст, который связан по смыслу с контентом страницы. Все слова должны быть уникальными и не должны встречаться в тексте.

- -

 

- -
-
Что необходимо сделать?
-
Выделить ключевые слова и написать оптимизированную (SEO) статью .
-
Где это нужно сделать?
-
На любых страницах, которые еще не оптимизированы, либо на страницах, которые не достаточно хорошо оптимизированы.
-
Необходимые знания и навыки для выполнения этого задания?
-
Навыки использования MDN редактора; владение Английским языком на уровне - native; умение писать SEO-статьи.
-
Что необходимо для этого сделать?
-
-
    -
  1. Выбрать страницу, на которой необходимо провести оптимизацию: -
      -
    1. На этой странице MDN выберите раздел, в котором вы сильны (например, HTML):
      -
      2. -
    2. На этой странице, нажмите СТРАНИЦЫ (Pages) в разделе Резюме (Summary). В этом разделе вы увидите индекс всех страниц. Так же вы увидите ссылки на страницы (слева), а тэги и SEO - статьи справа:
      -
      3. -
    3. Выберите страницу, которую необходимо оптимизировать:
      -
      4. -
    4. Кликните на ссылку, чтобы перейти на эту страницу.
      5. -
    -
    2. -
  2. Нажмите кнопку Правка (Edit), чтобы открыть MDN редактор.
    3. -
  3. Составьте одно - два предложения в качестве SEO-статьи. При необходимости отредактируйте уже существующую статью.
    4. -
  4. Выберите текст, который будет использован в качестве SEO.
    5. -
  5. На панели инструментов выберите виджет Styles. Выберите SEO Summary. (В исходном коде страницы будет создано {{HTMLElement("span")}} элемент с class="seoSummary" вокруг выделенного текста.)
    -
    6. -
  6. Сохраните свои изменения, желательно с комментариями. Для облегчения понимания ваших трудов другим участникам.
    7. -
-
-
- -

 

diff --git "a/files/ru/mdn/contribute/howto/\320\274\320\265\321\202\320\272\320\270_javascript_\321\201\321\202\321\200\320\260\320\275\320\270\321\206/index.html" "b/files/ru/mdn/contribute/howto/\320\274\320\265\321\202\320\272\320\270_javascript_\321\201\321\202\321\200\320\260\320\275\320\270\321\206/index.html" deleted file mode 100644 index 0c0ed4eca9..0000000000 --- "a/files/ru/mdn/contribute/howto/\320\274\320\265\321\202\320\272\320\270_javascript_\321\201\321\202\321\200\320\260\320\275\320\270\321\206/index.html" +++ /dev/null @@ -1,74 +0,0 @@ ---- -title: Как пометить страницы JavaScript -slug: MDN/Contribute/Howto/Метки_JavaScript_страниц -tags: - - Guide - - Howto - - JavaScript - - MDN Meta -translation_of: MDN/Contribute/Howto/Tag_JavaScript_pages ---- -
{{MDNSidebar}}

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

- -
-
Где это нужно сделать?
-
Внутри определенных JavaScript-страниц без тегов
-
Что вам нужно знать, чтобы выполнить эту задачу?
-
Базовые знания JavaScript, например, знание метода или свойства.
-
Каковы шаги для этого?
-
-
    -
  1. Выберите одну из страниц в списке, указанном выше.
    2. -
  2. Нажмите ссылку на статью, чтобы загрузить страницу.
    3. -
  3. После загрузки страницы, нажмите кнопку EDIT рядом с нее названием; это перенесет вас в редактор MDN.
    4. -
  4. Как минимум тег JavaScript нужно добавить. Так же здесь список возможных тегов для добавления: - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    ТегКакие страницы использовать
    Methodметоды
    Propertyсвойства
    prototypeпрототипы
    Object type nameметоды объекта; например String.fromCharCode должен иметь тег String
    ECMAScript6 и Experimentalвозможности (фичи) которые были добавлены в новой версии ECMAScript
    Deprecatedустаревшие функции (использование которых не рекомендуется, но поддерживается)
    Obsoleteустаревшие функции (которые больше не поддерживаются в современных браузерах)
    othersСм. Стандарты тегов MDN для других возможных меток
    -
    5. -
  5. Сохранить с комментарием.
    6. -
  6. Готово!
    7. -
-
-
- -

 

diff --git "a/files/ru/mdn/contribute/howto/\321\201\320\276\320\267\320\264\320\260\320\271_\320\270\320\275\321\202\320\265\321\200\320\260\320\272\321\202\320\270\320\262\320\275\320\276\320\265_\321\203\320\277\321\200\320\260\320\266\320\275\320\265\320\275\320\270\320\265_\320\264\320\273\321\217_\320\277\320\276\320\274\320\276\321\211\320\270_\320\262_\320\270\320\267\321\203\321\207\320\265\320\275\320\270\320\270_\320\262\320\265\320\261\320\260/index.html" "b/files/ru/mdn/contribute/howto/\321\201\320\276\320\267\320\264\320\260\320\271_\320\270\320\275\321\202\320\265\321\200\320\260\320\272\321\202\320\270\320\262\320\275\320\276\320\265_\321\203\320\277\321\200\320\260\320\266\320\275\320\265\320\275\320\270\320\265_\320\264\320\273\321\217_\320\277\320\276\320\274\320\276\321\211\320\270_\320\262_\320\270\320\267\321\203\321\207\320\265\320\275\320\270\320\270_\320\262\320\265\320\261\320\260/index.html" deleted file mode 100644 index 5488b77d10..0000000000 --- "a/files/ru/mdn/contribute/howto/\321\201\320\276\320\267\320\264\320\260\320\271_\320\270\320\275\321\202\320\265\321\200\320\260\320\272\321\202\320\270\320\262\320\275\320\276\320\265_\321\203\320\277\321\200\320\260\320\266\320\275\320\265\320\275\320\270\320\265_\320\264\320\273\321\217_\320\277\320\276\320\274\320\276\321\211\320\270_\320\262_\320\270\320\267\321\203\321\207\320\265\320\275\320\270\320\270_\320\262\320\265\320\261\320\260/index.html" +++ /dev/null @@ -1,184 +0,0 @@ ---- -title: Как создать интерактивное обучающее упражнение -slug: >- - MDN/Contribute/Howto/Создай_интерактивное_упражнение_для_помощи_в_изучении_веба -translation_of: MDN/Contribute/Howto/Create_an_interactive_exercise_to_help_learning_the_web ---- -
{{MDNSidebar}}
- -
{{IncludeSubnav("/en-US/docs/MDN")}}
- -

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

- -

Нет прямого способа для создания такого контента. Например существует много сторонних инструментов которые помогут в создании живых примеров (см: JSFiddle, CodePen, Dabblet, и т.д.) которые вы можете ссылаться из MDN статей. Если вы хотите создать более продвинутые упражнения, то можете воспользоваться Thimble из проекта WebMaker.

- -

На данный момент MDN не имеет лёгкого инструмента для пометки автора такого контента. Однако, если вы являетесь программистом, то можете возпользоваться текущими MDN функциями для создания своего активного обучающего контента. Читайте далее для того чтобы узнать как это сделать.

- -

MDN live samples

- -

MDN has a very cool feature called live samples. It's a mechanism that turns any HTML, CSS, and JavaScript code inside an MDN page into its executed equivalent. Before using it, you should read over Using the live sample system, which is our complete documentation for building them. While they're easy to do, there are quirks and tricks you'll learn along the way.

- -

What is interesting is that it's really easy to tweak that feature to use it in order to embed any kind of tool or utility you want into an MDN page.

- -

Hidden code

- -

The first way to use a code sample to create active learning content is to edit the page where you want to add your content. Use the Live Sample feature to create your content as you wish. Don't bother with the code complexity you could write; just create what you need. Once your content is ready, just switch to the editor code view and surround your code with a simple {{HTMLElement('div')}} element with the class hidden. By doing so, your code won't be displayed but your live sample remains accessible and displayable.

- -

Let's see a simple example:

- -
-

Click on the following square to randomly change its color or just type a hexadecimal code color

- - -{{EmbedLiveSample('hidden_code_example', 120, 120)}}
- -

If you take a look at that page HTML code with the MDN editor, you'll see the exact following HTML code:

- -
<div class="moreinfo">
-<p>Click on the following square to randomly change its color or just type an hexadecimal code color</p>
-
-<div class="hidden">
-<h4 id="hidden_code_example">hidden code example</h4>
-
-<h5 id="HTML">HTML</h5>
-
-<pre class="brush: html">
-&lt;div class="square"&gt;
-  #&lt;input class="color"&gt;
-&lt;/div&gt;</pre>
-
-<h5 id="CSS">CSS</h5>
-
-<pre class="brush: css">
-body {
-  padding: 10px;
-  margin : 0;
-}
-
-.square {
-  width  : 80px;
-  height : 80px;
-  padding: 10px;
-  background-color: black;
-  color: white;
-  text-align: center;
-}
-
-.color {
-  width: 60px;
-  text-transform: uppercase;
-}
-</pre>
-
-<h5 id="JS">JS</h5>
-
-<pre class="brush: js">
-function setColor(color) {
-  document.querySelector('.square').style.backgroundColor = '#' + color;
-  document.querySelector('.color').value = color;
-}
-
-function getRandomColor() {
-  var color = Math.floor(Math.random() * 16777215);
-  return color.toString(16);
-}
-
-function getInputColor() {
-  var value = document.querySelector('.color').value;
-  var color = Number('0x' + color);
-  if (color === +color) {
-    return color.toString(16);
-  }
-  return value;
-}
-
-document.addEventListener('click', function () {
-  setColor(getRandomColor());
-});
-
-document.addEventListener('keyup', function () {
-  setColor(getInputColor());
-});
-</pre>
-</div>
-
-\{{EmbedLiveSample('hidden_code_example', 120, 120)}}
-</div>
- -

You can see a more advance example of such a tweak on the Canvas API page.

- -

Code from outside the page

- -

The previous example is okay if you want to embed basic active learning content. However, if you want to deal with complex code, it can become a bit awkward to deal with that hidden class wrapper.

- -

So another option is to write the code of your learning content on an MDN page and then embed it into another page. To do this we can use the {{TemplateLink("EmbedDistLiveSample")}} macro instead of the {{TemplateLink("EmbedLiveSample")}} macro.

- -

Let's how that sample looks when configured as if it were being embedded from a remote origin:

- -
-

Click on the following square to randomly change its color or just type a hexadecimal code color

-{{EmbedLiveSample('The_example', 120, 120, '', 'MDN/Contribute/Howto/Create_an_interactive_exercise_to_help_learning_the_web/distant_example')}}
- -

This time, if you take a look at that page's HTML using the MDN editor, you'll see no hidden code. If you want to see the code, just go to the page that hosts it.

- -

You can see a more advanced example of this usage in our HTML Form tutorial, which uses this technique to allow experimentation with forms.

-- cgit v1.2.3-54-g00ecf