From a065e04d529da1d847b5062a12c46d916408bf32 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 21:46:22 -0500 Subject: update based on https://github.com/mdn/yari/issues/2028 --- .../index.html" | 116 ------------ .../index.html" | 32 ---- files/ru/mdn/user_guide/writing/index.html | 49 ----- .../mdn/user_guide/zone_administration/index.html | 207 --------------------- 4 files changed, 404 deletions(-) delete mode 100644 "files/ru/mdn/contribute/howto/\320\277\321\200\320\270\320\262\321\217\320\267\320\272\320\260_github_\320\260\320\272\320\272\320\260\321\203\320\275\321\202\320\260/index.html" delete mode 100644 "files/ru/mdn/contribute/\320\262\321\205\320\276\320\264_\321\207\320\265\321\200\320\265\320\267_persona/index.html" delete mode 100644 files/ru/mdn/user_guide/writing/index.html delete mode 100644 files/ru/mdn/user_guide/zone_administration/index.html (limited to 'files/ru/mdn') diff --git "a/files/ru/mdn/contribute/howto/\320\277\321\200\320\270\320\262\321\217\320\267\320\272\320\260_github_\320\260\320\272\320\272\320\260\321\203\320\275\321\202\320\260/index.html" "b/files/ru/mdn/contribute/howto/\320\277\321\200\320\270\320\262\321\217\320\267\320\272\320\260_github_\320\260\320\272\320\272\320\260\321\203\320\275\321\202\320\260/index.html" deleted file mode 100644 index a627bdde50..0000000000 --- "a/files/ru/mdn/contribute/howto/\320\277\321\200\320\270\320\262\321\217\320\267\320\272\320\260_github_\320\260\320\272\320\272\320\260\321\203\320\275\321\202\320\260/index.html" +++ /dev/null @@ -1,116 +0,0 @@ ---- -title: Как привязать GitHub аккаунт к вашему MDN профилю -slug: MDN/Contribute/Howto/Привязка_GitHub_аккаунта -tags: - - Documentation - - MDN - - MDN Meta - - MDN Project -translation_of: Archive/MDN/Howto_Link_a_Github_account ---- -
{{MDNSidebar}}
- -
{{IncludeSubnav("/ru/docs/MDN")}}
- -
-

Note: Support for Persona logins on MDN was disabled on November 1, 2016. The method for adding a Github account to your profile therefore no longer works. If you didn't add a GitHub login to your MDN account before we disabled Persona logins, please file an "Account Help" bug on Bugzilla. For further reading about the end of life of Persona, see: Persona shutdown guidelines.

-
- -

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

- -
-

Вы должны сделать это до 1 ноября 2016, иначе вы больше не сможете входить на MDN!

-
- -

Обзор

- -

Добавление авторизации через GitHub к вашему аккаунту осуществить не трудно. Мы рассмотрим всё детально, но сначала, вот список шагов:

- -
    -
  1. Войдите в ваш MDN аккаунт.
    2. -
  2. Перейдите на страницу присоединённые аккаунты.
    3. -
  3. Добавьте авторизацию через GitHub.
    4. -
- -

Подробная инструкция

- -

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

- -

Войдите в свой MDN аккаунт

- -
    -
  1. В верхней части каждой страницы MDN расположен блок авторизации. Он отображает доступные методы авторизации: Persona и GitHub.
    - Sign in box on MDN, showing Persona and Github.
    2. -
  2. Выберите Persona, и войдите, используя свой логин и пароль. Если вы получаете ошибку о том, что система вас не узнаёт, убедитесь, что вы ввели адрес электронной почты, который вы использовали при входе на MDN через Persona. Если у вас по-прежнему есть проблемы, посмотрите раздел {{anch("Persona_не_помнит_меня", "Persona не помнит меня")}}.
    3. -
- -

Перейдите на страницу "присоединённые аккаунты"

- -

Просто щёлкните по кнопке ниже.

- -

Или выполните следующее:

- -
    -
  1. Щёлкните по вашему имени пользователя вверху любой страницы MDN. (Там же, где был блок Авторизации, когда вы входили). Откроется ваш профиль.
    2. -
  2. Откройте меню, щёлкнув по "шестерёнке", и выберите Присоединённые аккаунты.
    - Gear menu in profile, showing the "Account connections" option
    3. -
- -

Добавление авторизации через GitHub

- -

На странице "Присоединённые аккаунты", есть уже присоединённые к профилю MDN внешние аккаунты. Если GitHub в этом списке - поздравляем! Всё готово! Но проверьте, что помните ваш пароль, выйдя с MDN и войдя снова через GitHub.

- -

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

- -

- -

Чтобы добавить GitHub:

- -
    -
  1. Щёлкните Присоединить GitHub. MDN свяжется с GitHub и запросит разрешение на связывание аккаунтов. Если у вас еще нет аккаунта на GitHub, вам будет предложено создать его:
    - Screenshot of GitHub sign in window.
    2. -
  2. Если в вашем аккаунте GitHub включена двухфакторная авторизация, то вам будет предложено ввести код:
    - Screenshot of GitHub's Two-factor authentication window.
    3. -
  3. После входа в аккаунт GitHub, вам будет предложено разрешить связь между GitHub и MDN
    - (если у вас ещё нет разрешения по какой-либо причине). Эта страница показана ниже.
    - Screenshot of GitHub "Authorize application" window.
    - Щёлкните по зелёной кнопке Authorize application, чтобы предоставить разрешение доступа MDN к вашему аккаунту на GitHub. В случае успешной привязки - появится сообщение:
    - Account successfully created.
    4. -
- -

Теперь вы не только можете использовать GitHub для входа на MDN, а уже вошли, используя ваш аккаунт GitHub! Теперь вы готовы к отключению Persona. Убедитесь, что обновили пароль в ваших менеждерах для паролей, если необходимо.

- -

Устранение проблем

- -

Если сталкиваетесь с проблемами, когда пытаете добавить ваш GitHub аккаунт к вашему профилю, то надеемся, что советы по устранению проблем ниже помогут. Если они не помогают, пожалуйста, не стесняйтесь попросить у нас помощи на MDN Web Docs.

- -

Ошибка: Не удалось найти профиль соответствующий аккаунту

- -

Если вы пытаетесь присоединить GitHub аккаунт к вашему профилю и получаете ошибку "Could not find profile matching account", то может быть несколько возможных проблем. Если у вас есть несколько аккаунтов на GitHub, то может возникнуть некоторая путаница; GitHub может не сообщить ожидаемого адреса электронной почты MDN при попытке привязки аккаунта, что является причиной этой ошибки. Другие сбои в этом процессе также могут быть причиной этой ошибки.

- -

Один из способов обойти эту проблему: откройте новую приватную вкладку в вашем браузере; в Firefox, например, выберите "Новое приватное окно" в Меню->Файл (или нажмите Ctrl+Shift+P [Cmd-Shift-P на Mac]). Зайдите на MDN, войдите в свой MDN аккаунт, а затем попытайсь снова привязать ваш GitHub аккаунт к профилю, как описано выше.

- -

Также, убедитесь, что пытаетесь войти через Persona.

- -

Моя привязка GitHub не отображается на странице присоединённых аккаунтов.

- -

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

- -

Persona не помнит меня

- -

Если когда вы пытаетесь войти через Persona, чтобы добавить ваш GitHub аккаунт в ваш MDN профиль, вы получаете сообщение "Your email address is new to us", то это, вероятно, потому что прошло слишком много времени с того момента, когда вы последний раз входили через Persona, поэтому они удалили ваш адрес электронной почты из их системы. Это случается после некоторого периода времени; окно входа Persona выгдядит так:

- -

- -

Если это произошло, ваш нужно просто следовать инструкциям Persona, чтобы создать пароль для этого адреса электронной почты. MDN ничего не удаляет; главное, чтобы адрес совпал. Придёт письмо, чтобы подтвердить, что это ваш адрес электронной почты, скорее всего от no-reply@persona.org. Если у вас установлены фильтры спама, оно может попасть в папку "Спам".

- -

Как только вы установите пароль для адреса электронной почты, который вы использовали для входа на MDN, ваш доступ на MDN будет восстановлен. Теперь вы можете следовать шагам в разделе {{anch("Подробная_инструкция", "Подробная инструкция")}}, чтобы добавить ваш аккаунт GitHub в ваш профиль MDN.

- -

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

- - diff --git "a/files/ru/mdn/contribute/\320\262\321\205\320\276\320\264_\321\207\320\265\321\200\320\265\320\267_persona/index.html" "b/files/ru/mdn/contribute/\320\262\321\205\320\276\320\264_\321\207\320\265\321\200\320\265\320\267_persona/index.html" deleted file mode 100644 index 7a7c54e7cd..0000000000 --- "a/files/ru/mdn/contribute/\320\262\321\205\320\276\320\264_\321\207\320\265\321\200\320\265\320\267_persona/index.html" +++ /dev/null @@ -1,32 +0,0 @@ ---- -title: MDN и вход через Persona -slug: MDN/Contribute/Вход_через_Persona -tags: - - Documentation - - MDN - - MDN Meta - - Mozilla - - Persona -translation_of: Archive/MDN/Persona_sign-ins ---- -
{{MDNSidebar}}
-

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

-
- -

В настоящее время, MDN позволяет помощникам входить через 2 различных провайдера: Mozilla Persona и GitHub. Начиная с 1 ноября 2016, мы удалим Persona из вариантов для входа. Поэтому, вы должны добавить аккаунт Github в вашем профиле, чтобы избежать потери доступа на MDN.

- -

Мы понимаем, что это неудобство, и приносим за него свои извинения. К сожалению, это не наше решение.

- -

Почему мы удаляем Persona?

- -

Mozilla закрыла проект Persona, и все его серверы будут отключены в ноябре 2016. Вы можете узнать больше о решении Mozilla выключить Persona на Mozilla wiki.

- -

Когда будет удалена Persona?

- -

Мы отключим Persona как провайдера для входа 1 ноября 2016; другими словами, последний день, когда вы сможете войти на MDN, используя Persona, будет 31 октября 2016. Мы будем показывать всё более частые и более срочные уведомления добавить GitHub аккаунт к вашему MDN профилю, начиная с этого момента. Пожалуйста, сделайте это как можно скорее, чтобы избежать любого риска потери доступа в MDN аккаунт.

- -

Будет ли MDN предоставлять другого провайдера для входа?

- -

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

- -

Имейте в виду, конечно, вам не нужно входить на MDN, чтобы читать наш контент. Но если у вас есть аккаунт для помощи, и вы хотите иметь возможность внести свой вклад в любое время в будущем, то убедитесь, что привяжете GitHub аккаунт к вашему профилю как можно быстрее, до 31 октября 2016.

diff --git a/files/ru/mdn/user_guide/writing/index.html b/files/ru/mdn/user_guide/writing/index.html deleted file mode 100644 index b83e7bcfc8..0000000000 --- a/files/ru/mdn/user_guide/writing/index.html +++ /dev/null @@ -1,49 +0,0 @@ ---- -title: Написание статей -slug: MDN/User_guide/Writing -tags: - - MDN -translation_of: Archive/Meta_docs/Writing_content ---- -
{{MDNSidebar}}

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

- -

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

-

Если вы нашли страницу, которую хотели бы пересмотреть, просто нажмите на кнопку «Редактировать» в её верхнем правом углу. Это действие откроет WYSIWYG-редактор для работы над содержимым страницы. Для подробностей о том, как работать с редактором, а также с системой макросов, которую мы используем для автоматизации некоторырых конструкций форматирования содержимого, смотрите руководство по редактору MDN.

-

Существует множество причин, по которым вы можете захотеть отредактировать существующую страницу:

- - -

Добавление новой страницы

-

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

-

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

-
-
Нажатие на ссылку, ведущую на «несуществующую страницу»
-
При просмотре MDN, иногда вы будете находить ссылки на ещё несуществующие страницы. Довольно часто при создании статьи мы включаем в неё ссылки на страницы, которые нужно создать, но которые мы ещё не создали. Это помогает нам следить за теми вещами, что, в конечном итоге, должны быть сделаны, хотя иногда, чтобы вернуться к ним, требуется время. Вы можете не стесняться и сами сделать это! Просто нажмите на ссылку, и вы попадёте прямо в редактор для новой страницы.
-
Создание дочерней страницы
-
В верхнем правом углу каждой статьи находится выпадающее меню «Эта страница». В этом меню есть пункт «Новая подстраница». Нажатие на этот пункт меню открывает редактор для новой страницы, чьим родителем в иерархии сайта будет страница, на которой вы нажали пункт меню «Новая подстраница». Просто заполните название и короткую ссылку и начните создавать содержимое страницы.
-
Создание клона страницы
-
Вы также можете склонировать существующую страницу, используя пункт «Клонировать эту страницу» в выпадающем меню «Эта страница». Нажатие на этот пункт создаст копию текущей страницы, чьим родителем будет та же страница, что и у текущей страницы и откроет редактор, в котором вы сможете проставить название и короткую ссылку склонированной страницы, а также отредактировать её содержимое. Как правило, это хороший способ добавления новой страницы в уже существующую область сайта, например потому, что вы получаете образец компоновки для нового содержимого.
-
Создание ссылки на несуществующую страницу, затем нажатие на неё
-
Это в некотором роде гибридный метод. Поскольку каждая страница должна быть связана с какой-нибудь другой, вы можете начать с создания ссылки на новую статью на уже существующей странице, а затем, после сохранения той страницы, вы можете нажать на только что созданную ссылку и открыть редактор для новой статьи.
-
-
-

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

-
- -

Поиск информации

-

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

-
-
Списки владельцев модулей
-
Проекты Mozilla работают на базе так называемых «владельцев модулей»; каждый главный компонент имеет владельца или владельцев, которые отвечают за то, что с ним происходит. Владельцы часто являются лучшим источником информации — или, по крайней мере, они помогут найти нужного человека, с которым можно поговорить.
-
Перекрёстные ссылки между исходниками Mozilla
-
MXR, перекрёстные ссылки проектов Mozilla, позволяет вам получить доступ к всем исходным кодам проекта Mozilla (за исключением некоторых вещей, главным образом связанных с ОС Firefox, которые находятся на GitHub). Код и комментарии в коде часто являются отличным информационным ресурсом.
-
Вики Mozilla
-
Вики Mozilla — часто на неё ссылаются как на «wikimo» — это хранилище замечаний по процессу и дизайну, черновиков, планов и предварительных спецификаций. Несмотря на то, что часто там сам чёрт ногу сломит, она является кладезем бесценной информации.
-
diff --git a/files/ru/mdn/user_guide/zone_administration/index.html b/files/ru/mdn/user_guide/zone_administration/index.html deleted file mode 100644 index 95704a390d..0000000000 --- a/files/ru/mdn/user_guide/zone_administration/index.html +++ /dev/null @@ -1,207 +0,0 @@ ---- -title: Управление зонами -slug: MDN/User_guide/Zone_administration -tags: - - Documentation - - MDN -translation_of: Archive/MDN/Zones ---- -
{{MDNSidebar}}

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

- -

К примеру, область MDN Проект MDN представлена зоной.

- -
-

Примечание: реализация зон — а также определение того, как они должны использоваться — всё ещё в активной разработке и может значительно измениться. Пожалуйста, если у вас есть вопросы о том, что здесь написано, задавайте их на канале #mdn в IRC, особенно, если вы планируете создать зону или превратить в неё какой-нибудь существующий материал.

-
- -

Возможности зон

- -

После того, как вы создадите зону (её создание описывается ниже), вы получаете различные специальные возможности и преимущества, которые можно и нужно использовать:

- - - -

Добавить схему/диаграмму компоновки

- -

Существует два основных типа зон: зоны внутри вики и зоны мини-сайта.

- -

Зоны внутри вики

- -

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

- -

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

- -
-

Примечание: зоны внутри вики обычно не появляются в списке «Зоны» на домашней странице MDN, поскольку они рассматриваются как часть основного тела содержимого документации MDN.

-
- -

Зоны мини-сайта

- -

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

- -

При создании зоны мини-сайта она получает новый URL за пределами дерева "/docs/" на MDN, обычно он выглядит как https://developer.mozilla.org/<локаль>/zone/<название_вашей_зоны>.

- -
-

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

-
- -

Что должно быть зоной?

- -

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

- -

Существует две основные причины создания зон:

- -
    -
  1. Вам нужно настроить мини-сайт для рекламной кампании или конкретного продукта.
    2. -
  2. Вы хотите создать, так сказать, единое окно доступа к теме, охватывающей несколько областей технологии.
    3. -
- -

Создание зоны

- -

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

- -

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

- - - -
-

Примечание: поскольку зоны являются конструкциями специального назначения, вам, вероятно, будет предложено обосновать, почему содержимое должно быть выделено в отдельную зону. Для понимания вопроса обратитесь к разделу {{anch("What_should_be_a_zone.3F", "Что должно быть зоной?")}}

-
- -

Изменение политики доступа к зоне

- -

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

- -

Настройка внешнего вида

- -

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

- -
-

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

-
- -

Базовая настройка

- -

Базовая требуемая настройка для каждой зоны — это настройка цвета фона и изображения в шапке страниц зоны. Во время запроса создания зоны вас попросят предоставить эти данные. Далее изложены основные рекомендации по тому, что вы должны предоставить.

- - - -

Имея эту информацию, команда администраторов MDN сможет установить для вас базовый CSS вашей зоны. Однако, если вы хотите, вы можете пойти дальше и предоставить свой собственный CSS. Следуя инструкциям в разделе {{anch("Additional_customizations", "Дополнительные изменения")}}, вы можете поэкспериментировать с другими изменениями визуального стиля вашей зоны.

- -

Дополнительные изменения

- -

Если вы хотите исследовать дополнительные возможности настройки, взгляните на шаблоны CSS/stylus, расположенные на github. Это список всех CSS Stylus для стилей, которые вам позволено менять при помощи вашего CSS для зоны.

- -

Если вы хотите сделать дополнительные настройки, вы можете это сделать, но с одной важной оговоркой: ваши изменения не должны настолько значительными, что страницы зоны перестают выглядеть как часть MDN.

- -

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

- -

Всё содержимое, относящееся к зонам, имеет класс zone.

- -
-

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

-
- -

Фоновые цвета

- -

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

- -
.zone #main-header, .zone .zone-article-header, .zone .zone-landing-header {
-    background-color: цвет-зоны;
-}
-
- -

Идентификатор main-header ссылается на область навигации по сайту в самом верху страницу. Она включает вкладку «Mozilla» для междусайтовой навигации, поле поиска и другую глобальную функциональность по навигации.

- -

Класс zone-article-header представляет внешний вид шапки на страницах со статьями внутри зоны. То есть, все страницы, кроме целевой страницы зоны, будут в своей шапке иметь этот класс.

- -

Класс zone-landing-header используется в шапке целевой страницы зоны. Это более высокая шапка на целевой странице с большим изображением внутри неё.

- -

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

- -

Короче говоря: замените цвет-зоны в кусочке CSS, предоставленном выше, на {{cssxref("<color>")}}, который вы выбрали для вашей зоны.

- -

Изображение в шапке целевой страницы

- -

Также вы можете захотеть изменить изображение, представляющее вашу зону на целевой странице зоны. Эта страница имеет большую шапку для большого изображения, представляющего вашу зону. CSS выглядит так:

- -
.zone .zone-landing-header .zone-image {
-    background-image: url(url-изображения-зоны);
-}
-
- -

Класс zone-image используется для определения и стилизации изображения в шапке целевой страницы вашей зоны. Изображение должно быть не более 468 пикселей в ширину, хотя вы и можете изменить это здесь же с помощью дополнительного CSS. Просто замените url-изображения-зоны на URL используемого вами изображения.

- -
-

Примечание: простейшим способом предоставить изображение является прикрепление его к соответствующей странице на MDN и использования получившегося URL.

-
- -

Изображение в шапке страницы статьи

- -

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

- -
.zone .zone-article-header .zone-image {
-    background-image: url(url-изображения-зоны);
-}
-
- -

Просто замените url-изображения-зоны на URL используемого вами изображения.

- -
-

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

-
- -

Нижняя граница кнопки в шапке

- -

Последнее, что мы рекомендуем вам поменять, — это внешний вид нижней границы кнопок в шапке зоны. Вот CSS:

- -
.zone .zone-landing-header a.button {
-    box-shadow: inset 0 -1px цвет;
-}
-
- -

Здесь замените цвет на {{cssxref("<color>")}} того же оттенка, что и фоновый, но чуточку темнее.

- -

Навигация по зоне

- -

Боковая панель навигации по зоне

- -

Боковая панель, появляющаяся на каждой странице зоны, определяется в содержимом целевой страницы зоны, в разделе с названием «Subnav» (виден только при редактировании страницы). Этот раздел может содержать вручную составленный куратором список страниц, либо использовать макрос, например {{TemplateLink("ListSubpages")}}. В последнем случае вам нужно будет принудительно перезагрузить (обновление с шифтом) целевую страницу зоны, чтобы увидеть изменения в боковой панели.

- -
-

Примечание переводчика: Раздел «Subnav» не обязательно должен так называться, достаточно проставить атрибут id="Subnav" у заголовка. Однако, редактор MDN принудительно сбрасывает идентификатор в название раздела при сохранении страницы. Чтобы он этого не делал, достаточно добавить к заголовку атрибут name="Subnav", в этом случае в качестве идентификатора будет использоваться значение этого атрибута.

-
- - - -

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

- -

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

- -

Макрос QuickLinksWithSubpages

- -

Макрос {{TemplateLink("QuickLinksWithSubpages")}} создаёт весь требуемый HTML для блока быстрых ссылок на странице со ссылками на страницы в указанной иерархии. Вы также можете использовать его без параметров для генерирования быстрых ссылок на дочерние страницы текущей страницы, хотя это не так полезно в зоне, поскольку навигация по зоне, как правило, уже предоставляет эти ссылки.

- -

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

- -

Примечания

- -

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

- - -- cgit v1.2.3-54-g00ecf