diff options
Diffstat (limited to 'files/ru/mdn')
4 files changed, 0 insertions, 404 deletions
diff --git a/files/ru/mdn/contribute/howto/привязка_github_аккаунта/index.html b/files/ru/mdn/contribute/howto/привязка_github_аккаунта/index.html deleted file mode 100644 index a627bdde50..0000000000 --- a/files/ru/mdn/contribute/howto/привязка_github_аккаунта/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 ---- -<div>{{MDNSidebar}}</div> - -<div>{{IncludeSubnav("/ru/docs/MDN")}}</div> - -<div class="note"> -<p><strong>Note: </strong>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 <strong>file an <a class="external external-icon" href="https://mzl.la/accounthelp">"Account Help" bug</a> </strong>on Bugzilla. For further reading about the end of life of Persona, see: <a href="https://wiki.mozilla.org/Identity/Persona_Shutdown_Guidelines_for_Reliers">Persona shutdown guidelines</a>.</p> -</div> - -<p><span class="seoSummary">Поскольку 1 ноября 2016 г. система авторизации Mozilla <a href="https://login.persona.org/">Persona</a> будет отключена, всем пользователеям, которые хотят вносить вклад в MDN понадобится другой способ входа на MDN.<br> - В настоящее время, единственная альтернатива, которую мы поддерживаем - GitHub, так что вам понадобится <a href="https://github.com/">GitHub</a> аккаунт, чтобы входить и редактировать MDN после этой даты. Эта статья описывает, как добавить авторизацию через GitHub к вашему профилю MDN.</span></p> - -<div class="warning"> -<p>Вы должны сделать это до 1 ноября 2016, иначе вы больше не сможете входить на MDN!</p> -</div> - -<h2 id="Обзор">Обзор</h2> - -<p>Добавление авторизации через GitHub к вашему аккаунту осуществить не трудно. Мы рассмотрим всё детально, но сначала, вот список шагов:</p> - -<ol> - <li><a href="/ru/docs/MDN/Signing_in">Войдите в ваш MDN аккаунт.</a></li> - <li>Перейдите на страницу <a href="/ru/users/account/connections">присоединённые аккаунты</a>.</li> - <li>Добавьте авторизацию через GitHub.</li> -</ol> - -<h2 id="Подробная_инструкция">Подробная инструкция</h2> - -<p>Ниже представлено пошаговое руководство о том, как сделать все необходимое для того, чтобы авторизоваться через GitHub.</p> - -<h3 id="Войдите_в_свой_MDN_аккаунт">Войдите в свой MDN аккаунт</h3> - -<ol> - <li>В верхней части каждой страницы MDN расположен блок авторизации. Он отображает доступные методы авторизации: <strong>Persona </strong>и <strong>GitHub</strong>.<br> - <img alt="Sign in box on MDN, showing Persona and Github." src="https://mdn.mozillademos.org/files/13426/Mozilla_Developer_Network_-__Private_Browsing_.png" style="border-style: solid; border-width: 1px; height: 140px; width: 425px;"></li> - <li>Выберите <strong>Persona</strong>, и войдите, используя свой логин и пароль. Если вы получаете ошибку о том, что система вас не узнаёт, убедитесь, что вы ввели адрес электронной почты, который вы использовали при входе на MDN через Persona. Если у вас по-прежнему есть проблемы, посмотрите раздел {{anch("Persona_не_помнит_меня", "Persona не помнит меня")}}.</li> -</ol> - -<h3 id="Перейдите_на_страницу_присоединённые_аккаунты">Перейдите на страницу "присоединённые аккаунты"</h3> - -<p>Просто щёлкните по кнопке ниже.</p> - -<p>Или выполните следующее:</p> - -<ol> - <li>Щёлкните по вашему имени пользователя вверху любой страницы MDN. (Там же, где был блок <strong>Авторизации</strong>, когда вы входили). Откроется ваш профиль.</li> - <li>Откройте меню, щёлкнув по "шестерёнке", и выберите <strong>Присоединённые аккаунты</strong>.<br> - <img alt='Gear menu in profile, showing the "Account connections" option' src="https://mdn.mozillademos.org/files/13428/SheppyWork___MDN_-__Private_Browsing_.png" style="height: 217px; width: 219px;"></li> -</ol> - -<h3 id="Добавление_авторизации_через_GitHub">Добавление авторизации через GitHub</h3> - -<p>На странице "Присоединённые аккаунты", есть уже присоединённые к профилю MDN внешние аккаунты. Если GitHub в этом списке - поздравляем! Всё готово! Но проверьте, что помните ваш пароль, выйдя с MDN и войдя снова через GitHub.</p> - -<p>Если GitHub ещё нет в списке, то поищите список привязанных аккаунтов. Вы найдёте раздел под названием <strong>Подключить новый аккаунт</strong>, в котором будут перечислены возможные типы аккаунтов, которые можно привязать к вашему профилю MDN. Выглядит он примерно так:</p> - -<p><img alt="" src="https://mdn.mozillademos.org/files/13430/Account_Connections___MDN_-__Private_Browsing_.png" style="height: 79px; width: 476px;"></p> - -<p>Чтобы добавить GitHub:</p> - -<ol> - <li>Щёлкните <strong>Присоединить GitHub</strong>. MDN свяжется с GitHub и запросит разрешение на связывание аккаунтов. Если у вас еще нет аккаунта на GitHub, вам будет предложено создать его:<br> - <img alt="Screenshot of GitHub sign in window." src="https://mdn.mozillademos.org/files/13444/GitHub_Sign_In.png" style="height: 447px; width: 356px;"></li> - <li>Если в вашем аккаунте GitHub включена двухфакторная авторизация, то вам будет предложено ввести код:<br> - <img alt="Screenshot of GitHub's Two-factor authentication window." src="https://mdn.mozillademos.org/files/13460/GitHub_-_Where_software_is_built.png" style="height: 448px; width: 361px;"></li> - <li>После входа в аккаунт GitHub, вам будет предложено разрешить связь между GitHub и MDN<br> - (если у вас ещё нет разрешения по какой-либо причине). Эта страница показана ниже.<br> - <img alt='Screenshot of GitHub "Authorize application" window.' src="https://mdn.mozillademos.org/files/13456/Authorize_Mozilla_Developer_Network.png" style="height: 420px; width: 766px;"><br> - Щёлкните по зелёной кнопке <strong>Authorize application</strong>, чтобы предоставить разрешение доступа MDN к вашему аккаунту на GitHub. В случае успешной привязки - появится сообщение:<br> - <img alt="Account successfully created." src="https://mdn.mozillademos.org/files/13454/Edit_Your_Profile___MDN.png" style="height: 57px; width: 646px;"></li> -</ol> - -<p>Теперь вы не только можете использовать GitHub для входа на MDN, а уже вошли, используя ваш аккаунт GitHub! Теперь вы готовы к отключению Persona. Убедитесь, что обновили пароль в ваших менеждерах для паролей, если необходимо.</p> - -<h2 id="Устранение_проблем">Устранение проблем</h2> - -<p>Если сталкиваетесь с проблемами, когда пытаете добавить ваш GitHub аккаунт к вашему профилю, то надеемся, что советы по устранению проблем ниже помогут. Если они не помогают, пожалуйста, не стесняйтесь попросить у нас помощи на <a href="https://chat.mozilla.org/#/room/#mdn:mozilla.org">MDN Web Docs</a>.</p> - -<h3 id="Ошибка_Не_удалось_найти_профиль_соответствующий_аккаунту">Ошибка: Не удалось найти профиль соответствующий аккаунту</h3> - -<p>Если вы пытаетесь присоединить GitHub аккаунт к вашему профилю и получаете ошибку "Could not find profile matching account", то может быть несколько возможных проблем. Если у вас есть несколько аккаунтов на GitHub, то может возникнуть некоторая путаница; GitHub может не сообщить ожидаемого адреса электронной почты MDN при попытке привязки аккаунта, что является причиной этой ошибки. Другие сбои в этом процессе также могут быть причиной этой ошибки.</p> - -<p>Один из способов обойти эту проблему: откройте новую приватную вкладку в вашем браузере; в Firefox, например, выберите "Новое приватное окно" в Меню->Файл (или нажмите <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>P</kbd> [<kbd>Cmd</kbd>-<kbd>Shift</kbd>-<kbd>P</kbd> на Mac]). Зайдите на MDN, <a href="/ru/docs/MDN/Signing_in">войдите в свой MDN аккаунт</a>, а затем попытайсь снова привязать ваш GitHub аккаунт к профилю, как описано выше.</p> - -<p>Также, убедитесь, что пытаетесь войти через Persona.</p> - -<h3 id="Моя_привязка_GitHub_не_отображается_на_странице_присоединённых_аккаунтов.">Моя привязка GitHub не отображается на странице присоединённых аккаунтов.</h3> - -<p>Это может просходить из-за кеширования. Перезагрузите страницу или попробуйте выйти и войти снова, чтобы решить эту проблему.</p> - -<h3 id="Persona_не_помнит_меня">Persona не помнит меня</h3> - -<p>Если когда вы пытаетесь войти через Persona, чтобы добавить ваш GitHub аккаунт в ваш MDN профиль, вы получаете сообщение "Your email address is new to us", то это, вероятно, потому что прошло слишком много времени с того момента, когда вы последний раз входили через Persona, поэтому они удалили ваш адрес электронной почты из их системы. Это случается после некоторого периода времени; окно входа Persona выгдядит так:</p> - -<p><img alt="" src="https://mdn.mozillademos.org/files/13765/unknown-to-persona.png" style="height: 533px; width: 800px;"></p> - -<p>Если это произошло, ваш нужно просто следовать инструкциям Persona, чтобы создать пароль для этого адреса электронной почты. MDN ничего не удаляет; главное, чтобы адрес совпал. Придёт письмо, чтобы подтвердить, что это ваш адрес электронной почты, скорее всего от <code>no-reply@persona.org</code>. Если у вас установлены фильтры спама, оно может попасть в папку "Спам".</p> - -<p>Как только вы установите пароль для адреса электронной почты, который вы использовали для входа на MDN, ваш доступ на MDN будет восстановлен. Теперь вы можете следовать шагам в разделе {{anch("Подробная_инструкция", "Подробная инструкция")}}, чтобы добавить ваш аккаунт GitHub в ваш профиль MDN.</p> - -<h2 id="Смотрите_также">Смотрите также</h2> - -<ul> - <li><a href="/ru/docs/MDN/Contribute/Howto/Create_an_MDN_account">Как создать MDN аккаунт</a></li> - <li><a href="/ru/docs/MDN/Getting_started">MDN - быстрый старт!</a></li> - <li><a href="/ru/docs/MDN/Contribute/Howto">Руководства "Как сделать"</a></li> -</ul> diff --git a/files/ru/mdn/contribute/вход_через_persona/index.html b/files/ru/mdn/contribute/вход_через_persona/index.html deleted file mode 100644 index 7a7c54e7cd..0000000000 --- a/files/ru/mdn/contribute/вход_через_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 ---- -<div>{{MDNSidebar}}</div><div class="warning"> -<p>Пожалуйста, <a href="/ru/docs/MDN/Contribute/Howto/Привязка_GitHub_аккаунта">привяжите свой GitHub аккаунт к вашему MDN профилю сейчас</a>, чтобы вы смогли продолжить входить на MDN.</p> -</div> - -<p>В настоящее время, MDN позволяет помощникам входить через 2 различных провайдера: Mozilla Persona и GitHub. Начиная с 1 ноября 2016, мы удалим Persona из вариантов для входа. Поэтому, вы должны добавить аккаунт Github в вашем профиле, чтобы избежать потери доступа на MDN.</p> - -<p>Мы понимаем, что это неудобство, и приносим за него свои извинения. К сожалению, это не наше решение.</p> - -<h2 id="Почему_мы_удаляем_Persona">Почему мы удаляем Persona?</h2> - -<p>Mozilla закрыла проект Persona, и все его серверы будут отключены в ноябре 2016. Вы можете <a href="https://wiki.mozilla.org/Identity/Persona_Shutdown_Guidelines_for_Reliers#FAQs">узнать больше о решении Mozilla</a> выключить Persona на Mozilla wiki.</p> - -<h2 id="Когда_будет_удалена_Persona">Когда будет удалена Persona?</h2> - -<p>Мы отключим Persona как провайдера для входа 1 ноября 2016; другими словами, последний день, когда вы сможете войти на MDN, используя Persona, будет 31 октября 2016. Мы будем показывать всё более частые и более срочные уведомления <a href="/ru/docs/MDN/Contribute/Howto/Привязка_GitHub_аккаунта">добавить GitHub аккаунт к вашему MDN профилю</a>, начиная с этого момента. Пожалуйста, сделайте это как можно скорее, чтобы избежать любого риска потери доступа в MDN аккаунт.</p> - -<h2 id="Будет_ли_MDN_предоставлять_другого_провайдера_для_входа">Будет ли MDN предоставлять другого провайдера для входа?</h2> - -<p>Нам бы очень хотелось это сделать, но мы до сих пор не нашли другого провайдера, который отвечает нашим требованиям; кроме того, в настоящее время у нас нет ресурсов разработчиков для интеграции другого провайдера. В настоящее время, ваше <em>единственное</em> решение проблемы доступа на MDN - <a href="/ru/docs/MDN/Contribute/Howto/Привязка_GitHub_аккаунта">привязка вашего MDN профиля к вашему GitHub аккаунту</a>.</p> - -<p>Имейте в виду, конечно, вам не нужно входить на MDN, чтобы читать наш контент. Но если у вас есть аккаунт для помощи, и вы хотите иметь возможность внести свой вклад в любое время в будущем, то убедитесь, что <em><strong>привяжете GitHub аккаунт к вашему профилю как можно быстрее,</strong></em> до 31 октября 2016.</p> 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 ---- -<div>{{MDNSidebar}}</div><p>На MDN всегда существуют вещи, которые добавляются или обновляются. Будь то новая документация по новому сверкающему API или пересмотр старого, слегка изменившегося, API, вы всегда найдёте множество возможностей для помощи.</p> - -<h2 id="Editing_an_existing_page" name="Editing_an_existing_page">Редактирование существующей страницы</h2> -<p>Если вы нашли страницу, которую хотели бы пересмотреть, просто нажмите на кнопку «Редактировать» в её верхнем правом углу. Это действие откроет WYSIWYG-редактор для работы над содержимым страницы. Для подробностей о том, как работать с редактором, а также с системой макросов, которую мы используем для автоматизации некоторырых конструкций форматирования содержимого, смотрите <a href="/ru/docs/Project:MDN/Contributing/Editor_guide">руководство по редактору MDN</a>.</p> -<p>Существует множество причин, по которым вы можете захотеть отредактировать существующую страницу:</p> -<ul> - <li>Вы обнаружили ошибку или опечатку.</li> - <li>Вы хотите изменить формулировку для её лучшего понимания.</li> - <li>Компоновка или форматирование страницы ужасно.</li> - <li>Задокументированный API изменился и документация нуждается в обновлении, чтобы она соотвествовала этим изменениям.</li> - <li>Вы хотите добавить информацию о разнице в поведении API между браузерами.</li> - <li>Вы хотите добавить или улучшить примеры кода. Для подробностей смотрите раздел {{anch("Add_a_code_sample", "добавление примера кода")}} ниже.</li> - <li>Статья является заглушкой, либо просто упускает некоторые важные детали.</li> -</ul> - -<h2 id="Adding_a_new_page" name="Adding_a_new_page">Добавление новой страницы</h2> -<p>Это очень здорово! Добавление новой страницы на MDN делает веб чуточку лучше. Есть несколько очевидных причин для создания новой страницы, включая документирование API, который ещё не был задокументирован, либо добавление нового урока или руководства по теме.</p> -<p>Существует несколько способов создания новой страницы на MDN, но все они доступны только когда вы <a href="/ru/docs/Project:MDN/Contributing/Getting_started#Logging_into_MDN">вошли в систему</a>:</p> -<dl> - <dt>Нажатие на ссылку, ведущую на «несуществующую страницу»</dt> - <dd>При просмотре MDN, иногда вы будете находить ссылки на ещё несуществующие страницы. Довольно часто при создании статьи мы включаем в неё ссылки на страницы, которые нужно создать, но которые мы ещё не создали. Это помогает нам следить за теми вещами, что, в конечном итоге, должны быть сделаны, хотя иногда, чтобы вернуться к ним, требуется время. Вы можете не стесняться и сами сделать это! Просто нажмите на ссылку, и вы попадёте прямо в редактор для новой страницы.</dd> - <dt>Создание дочерней страницы</dt> - <dd>В верхнем правом углу каждой статьи находится выпадающее меню «Эта страница». В этом меню есть пункт <strong>«Новая подстраница»</strong>. Нажатие на этот пункт меню открывает редактор для новой страницы, чьим родителем в иерархии сайта будет страница, на которой вы нажали пункт меню <strong>«Новая подстраница»</strong>. Просто заполните название и короткую ссылку и начните создавать содержимое страницы.</dd> - <dt>Создание клона страницы</dt> - <dd>Вы также можете склонировать существующую страницу, используя пункт <strong>«Клонировать эту страницу»</strong> в выпадающем меню «Эта страница». Нажатие на этот пункт создаст копию текущей страницы, чьим родителем будет та же страница, что и у текущей страницы и откроет редактор, в котором вы сможете проставить название и короткую ссылку склонированной страницы, а также отредактировать её содержимое. Как правило, это хороший способ добавления новой страницы в уже существующую область сайта, например потому, что вы получаете образец компоновки для нового содержимого.</dd> - <dt>Создание ссылки на несуществующую страницу, затем нажатие на неё</dt> - <dd>Это в некотором роде гибридный метод. Поскольку каждая страница должна быть связана с какой-нибудь другой, вы можете начать с создания ссылки на новую статью на уже существующей странице, а затем, после сохранения той страницы, вы можете нажать на только что созданную ссылку и открыть редактор для новой статьи.</dd> -</dl> -<div class="note"> - <p><strong>Примечание:</strong> если вы не вошли в систему, вы получите ошибку 404 при попытке просмотреть несуществующую статью, вместо появления редактора для создания новой страницы.</p> -</div> - -<h2 id="Finding_information" name="Finding_information">Поиск информации</h2> -<p>На сайте содержится просто огромное количество информации и поэтому может быть сложно выцепить точную необходимую вам помощь. Вот несколько подсказок, с чего можно начать.</p> -<dl> - <dt><a href="https://wiki.mozilla.org/Modules">Списки владельцев модулей</a></dt> - <dd>Проекты Mozilla работают на базе так называемых «владельцев модулей»; каждый главный компонент имеет владельца или владельцев, которые отвечают за то, что с ним происходит. Владельцы часто являются лучшим источником информации — или, по крайней мере, они помогут найти нужного человека, с которым можно поговорить.</dd> - <dt><a href="http://mxr.mozilla.org/">Перекрёстные ссылки между исходниками Mozilla</a></dt> - <dd>MXR, перекрёстные ссылки проектов Mozilla, позволяет вам получить доступ к всем исходным кодам проекта Mozilla (за исключением некоторых вещей, главным образом связанных с ОС Firefox, которые находятся на GitHub). Код и комментарии в коде часто являются отличным информационным ресурсом.</dd> - <dt><a href="http://wiki.mozilla.org/">Вики Mozilla</a></dt> - <dd>Вики Mozilla — часто на неё ссылаются как на «wikimo» — это хранилище замечаний по процессу и дизайну, черновиков, планов и предварительных спецификаций. Несмотря на то, что часто там сам чёрт ногу сломит, она является кладезем бесценной информации.</dd> -</dl> 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 ---- -<div>{{MDNSidebar}}</div><p><span class="seoSummary"><strong>Зона</strong> — это специальная область MDN, чьё содержимое представлено с некоторыми дополнительными элементами управления, например, специальным блоком навигации по зоне и визуально улучшенной шапкой страницы. В этом руководстве рассматривается, как создавать и поддерживать зоны.</span></p> - -<p>К примеру, область MDN <a href="/ru/docs/MDN">Проект MDN</a> представлена зоной.</p> - -<div class="note"> -<p><strong>Примечание:</strong> реализация зон — а также определение того, как они должны использоваться — всё ещё в активной разработке и может значительно измениться. Пожалуйста, если у вас есть вопросы о том, что здесь написано, задавайте их на канале #mdn в IRC, особенно, если вы планируете создать зону или превратить в неё какой-нибудь существующий материал.</p> -</div> - -<h2 id="Zone_features" name="Zone_features">Возможности зон</h2> - -<p>После того, как вы создадите зону (её создание описывается ниже), вы получаете различные специальные возможности и преимущества, которые можно и нужно использовать:</p> - -<ul> - <li>Область заголовка, окрашиваемая в цвет, однозначно определяющий вашу зону.</li> - <li>Представляющий зону баннер в области заголовка.</li> - <li>Целевая страница зоны, построенная на основе навигационной иерархии зоны и представляющая большую, чем обычно, зону для большого баннера, а также место под краткое описание зоны.</li> - <li>Специальная боковая панель с навигацией; зоны могут включать в эту навигацию содержимое из любой части MDN, даже если оно не находится в иерархии зоны.</li> - <li>Дочерние страницы целевой страницы зоны — то есть, страницы, физически расположеные под целевой страницей — наследуют цвет зоны и её баннер, маленькую область сверху страницы.</li> -</ul> - -<p><strong>Добавить схему/диаграмму компоновки</strong></p> - -<p>Существует два основных типа зон: <strong>зоны внутри вики</strong> и <strong>зоны мини-сайта</strong>.</p> - -<h3 id="In-wiki_zones" name="In-wiki_zones">Зоны внутри вики</h3> - -<p><strong>Зона внутри вики</strong> — это зона, использующая преимущества функциональности зон, в тоже время оставаясь частью основного потока содержимого документации MDN. Например, эта зона, зона «<a href="/ru/docs/MDN">Проекта MDN</a>», является зоной внутри вики. Они являются своего рода полузонами в том смысле, что обычно они не включают содержимое извне своей собственной иерархи.</p> - -<p>Зоны внутри вики позволяют сегментировать MDN для добавления дополнительных визуальных украшательств и, что более важно, боковых панелей навигации без выдёргивания пользователя из основного потока содержимого MDN.</p> - -<div class="note"> -<p><strong>Примечание:</strong> зоны внутри вики обычно не появляются в списке «Зоны» на домашней странице MDN, поскольку они рассматриваются как часть основного тела содержимого документации MDN.</p> -</div> - -<h3 id="Mini-site_zones" name="Mini-site_zones">Зоны мини-сайта</h3> - -<p><strong>Зона мини-сайта</strong> — это зона, которая, хотя и редактируется и управляется при помощи того же самого интерфейса, что и любая другая вики-страница на MDN, представлена вне основного потока содержимого документации. Во всех функциональных отношениях она поддерживает всю стандартную функциональность вики, предоставляемую платформой <a href="/ru/docs/MDN/Kuma">Kuma</a>, на которой построен MDN. Хорошим примером зоны может служить <a href="/ru/Apps">Центр приложений</a>.</p> - -<p>При создании зоны мини-сайта она получает новый URL за пределами дерева "/docs/" на MDN, обычно он выглядит как <code>https://developer.mozilla.org/<em><локаль></em>/zone/<em><название_вашей_зоны></em></code>.</p> - -<div class="note"> -<p><strong>Примечание:</strong> в общем случае только очень значительное, специализированное содержимое должно быть перемещено за пределы иерархии вики; эти зоны предназначены в первую очередь для настройки специализарованных рекламных компаний и/или связанного с программой содержимого.</p> -</div> - -<h2 id="What_should_be_a_zone.3F" name="What_should_be_a_zone.3F">Что должно быть зоной?</h2> - -<p>Это интересный вопрос, и, честно говоря, ответ на него будет меняться с течением времени. Зоны являются новой концепцией для MDN и мы всё ещё изучаем, как именно мы будем их использовать.</p> - -<p>Существует две основные причины создания зон:</p> - -<ol> - <li>Вам нужно настроить <strong>мини-сайт</strong> для рекламной кампании или конкретного продукта.</li> - <li>Вы хотите создать, так сказать, единое окно доступа к теме, охватывающей несколько областей технологии.</li> -</ol> - -<h2 id="Creating_a_zone" name="Creating_a_zone">Создание зоны</h2> - -<p>Первым шагом является создание содержимого. Как минимум, вы должны создать начальную целевую страницу, которая станет корневой страницей вашей зоны. Если у вас есть хотя бы корневая страница и, возможно, даже несколько дочерних страниц, вы можете превратить их в зону.</p> - -<p>Для превращения раздела MDN в зону требуются привилегии администратора MDN, так что вам нужно попросить администратора MDN сделать это за вас. В запросе на превращение раздела в зону вы должны предоставить администратору несколько вещей:</p> - -<ul> - <li>Какая страница MDN должна быть превращена в корневую страницу новой зоны. Имейте ввиду, что все страницы, ниже её по иерархии, станут частью зоны.</li> - <li>Является ли ваша зона {{anch("In-wiki_zones", "зоной внутри вики")}} или {{anch("Mini-site_zones", "зоной мини-сайта")}}?</li> - <li>Так же вы должны предоставить информацию о стилях и картинки для настройки области шапки будущей зоны. Для подробностей смотрите раздел {{anch("Customizing_the_appearance", "Изменение внешнего вида")}}.</li> -</ul> - -<div class="note"> -<p><strong>Примечание:</strong> поскольку зоны являются конструкциями специального назначения, вам, вероятно, будет предложено обосновать, почему содержимое должно быть выделено в отдельную зону. Для понимания вопроса обратитесь к разделу {{anch("What_should_be_a_zone.3F", "Что должно быть зоной?")}}</p> -</div> - -<h2 id="Changing_the_zone_access_policy" name="Changing_the_zone_access_policy">Изменение политики доступа к зоне</h2> - -<p>В настоящий момент нет никакой поддержки разграничения прав доступа к зонам. Эту функциональность планируется добавить в будущем. Если вам нужно разграничение прав, пожалуйста, дайте нам знать, чтобы мы могли скорректировать приоритеты для этой работы.</p> - -<h2 id="Customizing_the_appearance" name="Customizing_the_appearance">Настройка внешнего вида</h2> - -<p>Частью того, что делает зону зоной, является возможность настройки её внешнего вида. Как минимум, она подразумевает настройку особого цвета и фонового изображения в шапке страниц зоны, помогающие пользователю понять, что он находится в определённой зоне. Также можно сделать и другие изменения внешнего вида страницы, однако они не должны выбиваться из общего стиля MDN.</p> - -<div class="note"> -<p><strong>Примечание:</strong> важно иметь в виду, что инструкции, изложенные ниже, являются всего лишь <strong>подсказками</strong>. Вы можете попытаться более тонко настроить CSS для своей зоны. Просто имейте в виду, что ваши изменения могут быть пересмотрены нашими командами по UX и/или дизайну и они должны вписываться в общий стиль MDN.</p> -</div> - -<h3 id="Basic_customization" name="Basic_customization">Базовая настройка</h3> - -<p>Базовая требуемая настройка для каждой зоны — это настройка цвета фона и изображения в шапке страниц зоны. Во время запроса создания зоны вас попросят предоставить эти данные. Далее изложены основные рекомендации по тому, что вы должны предоставить.</p> - -<ul> - <li>Фоновый цвет должен явно отличаться от фонового цвета остальных зон и в тоже время иметь отношение к освещаемой зоной теме. Вы должны определить его как {{cssxref("<color>")}}, чтобы администратор MDN мог настроить вашу зону.</li> - <li>По умолчанию, фоновое изображение появляется с правой стороны шапки (или с левой стороны в локалях с написанием текста справа-налево). Это изображение может быть в любом совместимом с веб формате, хотя обычно предпочтителен формат PNG. Оно должно либо смешиваться с вашим фоновым цветом, либо (что предпочтительнее) иметь прозрачный фон. Как правило, фоновое изображение должно быть около 468 пикселей в ширину и 400 пикселей в высоту, хотя в CSS на странице может быть проставлено значение {{cssxref("overflow")}} для его обрезки при необходимости. Тем не менее, создание слишком большого изображения увеличивает размер страницы, чего следует избегать.</li> - <li>Изображение может быть отправлено администратору MDN во время вашего запроса на создание зоны, или оно может быть одним из уже загруженных на MDN с соответствующей страницей вложений.</li> -</ul> - -<p>Имея эту информацию, команда администраторов MDN сможет установить для вас базовый CSS вашей зоны. Однако, если вы хотите, вы можете пойти дальше и предоставить свой собственный CSS. Следуя инструкциям в разделе {{anch("Additional_customizations", "Дополнительные изменения")}}, вы можете поэкспериментировать с другими изменениями визуального стиля вашей зоны.</p> - -<h3 id="Additional_customizations" name="Additional_customizations">Дополнительные изменения</h3> - -<p>Если вы хотите исследовать дополнительные возможности настройки, взгляните на шаблоны CSS/stylus, расположенные <a href="https://github.com/mozilla/kuma/blob/master/media/redesign/stylus/zones.styl">на github</a>. Это список всех CSS Stylus для стилей, которые вам позволено менять при помощи вашего CSS для зоны.</p> - -<p>Если вы хотите сделать дополнительные настройки, вы можете это сделать, но с одной важной оговоркой: ваши изменения не должны настолько значительными, что страницы зоны перестают выглядеть как часть MDN.</p> - -<p>При изменении таблицы стилей зоны вашими задачами становятся выделить те стили из шаблона, которые вы хотите изменить и поместить их в результирующий CSS. Как только вы сделаете это, предоставьте получившийся CSS команде администраторов MDN и они установят его для вас.</p> - -<p>Всё содержимое, относящееся к зонам, имеет класс <code>zone</code>.</p> - -<div class="note"> -<p><strong>Примечание:</strong> пожалуйста, обратите внимание, что поскольку сайт находится в стадии активной разработки, любые обсуждаемые здесь классы и стили могут быть изменены без предварительного уведомления.</p> -</div> - -<h4 id="Background_colors" name="Background_colors">Фоновые цвета</h4> - -<p>Как ранее упоминалось, первым делом вы, вероятно, захотите настроить фоновый цвет шапки вашей зоны. CSS может выглядеть подобным образом:</p> - -<pre class="brush: css">.zone #main-header, .zone .zone-article-header, .zone .zone-landing-header { - background-color: <strong><em>цвет-зоны</em></strong>; -} -</pre> - -<p>Идентификатор <code>main-header</code> ссылается на область навигации по сайту в самом верху страницу. Она включает вкладку «Mozilla» для междусайтовой навигации, поле поиска и другую глобальную функциональность по навигации.</p> - -<p>Класс <code>zone-article-header</code> представляет внешний вид шапки на страницах со статьями внутри зоны. То есть, все страницы, кроме целевой страницы зоны, будут в своей шапке иметь этот класс.</p> - -<p>Класс <code>zone-landing-header</code> используется в шапке целевой страницы зоны. Это более высокая шапка на целевой странице с большим изображением внутри неё.</p> - -<p>Как правило, вы захотите, чтобы эти области имели одинаковый цвет; и в самом деле, шапки статьи и целевой страницы должны быть одинаковыми. Единственной причиной, по которой вы могли бы настроить их по разному, является наличие градиентов и необходимость подогнать их цвет к некоторому «общему знаменателю», несмотря на различие по высоте.</p> - -<p><strong>Короче говоря:</strong> замените <strong><em>цвет-зоны</em></strong> в кусочке CSS, предоставленном выше, на {{cssxref("<color>")}}, который вы выбрали для вашей зоны.</p> - -<h4 id="Landing_page_header_image" name="Landing_page_header_image">Изображение в шапке целевой страницы</h4> - -<p>Также вы можете захотеть изменить изображение, представляющее вашу зону на целевой странице зоны. Эта страница имеет большую шапку для большого изображения, представляющего вашу зону. CSS выглядит так:</p> - -<pre class="brush: css">.zone .zone-landing-header .zone-image { - background-image: url(<strong><em>url-изображения-зоны</em></strong>); -} -</pre> - -<p>Класс <code>zone-image</code> используется для определения и стилизации изображения в шапке целевой страницы вашей зоны. Изображение должно быть не более 468 пикселей в ширину, хотя вы и можете изменить это здесь же с помощью дополнительного CSS. Просто замените <strong><em>url-изображения-зоны</em></strong> на URL используемого вами изображения.</p> - -<div class="note"> -<p><strong>Примечание:</strong> простейшим способом предоставить изображение является прикрепление его к соответствующей странице на MDN и использования получившегося URL.</p> -</div> - -<h4 id="Article_page_header_image" name="Article_page_header_image">Изображение в шапке страницы статьи</h4> - -<p>Кроме того, вы должны установить изображение, представляющее вашу зону на дочерних страницах. По умолчанию, это изображение ограничено 200 пикселями в ширину и 400 пикселям ив высоту, но, опять же, это может быть изменено.</p> - -<pre class="brush: css">.zone .zone-article-header .zone-image { - background-image: url(<strong><em>url-изображения-зоны</em></strong>); -} -</pre> - -<p>Просто замените <strong><em>url-изображения-зоны</em></strong> на URL используемого вами изображения.</p> - -<div class="note"> -<p><strong>Примечание:</strong> простейшим способом предоставить изображение является прикрепление его к соответствующей странице на MDN и использования получившегося URL. Вы можете использовать тоже самое изображение что и в шапке целевой страницы, просто отмасштабировав и обрезав его, либо использовать другое изображение.</p> -</div> - -<h4 id="Header_button_bottom_border" name="Header_button_bottom_border">Нижняя граница кнопки в шапке</h4> - -<p>Последнее, что мы рекомендуем вам поменять, — это внешний вид нижней границы кнопок в шапке зоны. Вот CSS:</p> - -<pre class="brush: css">.zone .zone-landing-header a.button { - box-shadow: inset 0 -1px <strong><em>цвет</em></strong>; -} -</pre> - -<p>Здесь замените <strong><em>цвет</em></strong> на {{cssxref("<color>")}} того же оттенка, что и фоновый, но чуточку темнее.</p> - -<h2 id="Zone_navigation" name="Zone_navigation">Навигация по зоне</h2> - -<h3 id="Zone_navigation_sidebar" name="Zone_navigation_sidebar">Боковая панель навигации по зоне</h3> - -<p>Боковая панель, появляющаяся на каждой странице зоны, определяется в содержимом целевой страницы зоны, в разделе с названием «Subnav» (виден только при редактировании страницы). Этот раздел может содержать вручную составленный куратором список страниц, либо использовать макрос, например {{TemplateLink("ListSubpages")}}. В последнем случае вам нужно будет <a href="/ru/docs/MDN/Kuma/Introduction_to_KumaScript#Caching">принудительно перезагрузить</a> (обновление с шифтом) целевую страницу зоны, чтобы увидеть изменения в боковой панели.</p> - -<div class="note"> -<p><strong>Примечание переводчика:</strong> Раздел «Subnav» не обязательно должен так называться, достаточно проставить атрибут <code>id="Subnav"</code> у заголовка. Однако, редактор MDN принудительно сбрасывает идентификатор в название раздела при сохранении страницы. Чтобы он этого не делал, достаточно добавить к заголовку атрибут <code>name="Subnav"</code>, в этом случае в качестве идентификатора будет использоваться значение этого атрибута.</p> -</div> - -<h3 id="Quicklinks" name="Quicklinks">Быстрые ссылки</h3> - -<p>Как и любая другая страница на MDN, страницы внутри зоны могут использовать возможность <a href="/ru/docs/MDN/Contribute/Content/Quicklinks">быстрых ссылок</a>. Быстрые ссылки — это навигационный блок, расположенный в левой боковой панели, предлагающий пользователю ссылки на сопутствующие материалы. Эти ссылки могут вести внутрь MDN или на внешние сайты и могут иметь до двух уровней вложенности.</p> - -<p>Чтобы облегчить создание наиболее распространённых типов быстрых ссылок для зон, мы написали несколько макросов, которые вы также можете использовать.</p> - -<h4 id="QuickLinksWithSubpages" name="QuickLinksWithSubpages">Макрос <code>QuickLinksWithSubpages</code></h4> - -<p>Макрос {{TemplateLink("QuickLinksWithSubpages")}} создаёт весь требуемый HTML для блока быстрых ссылок на странице со ссылками на страницы в указанной иерархии. Вы также можете использовать его без параметров для генерирования быстрых ссылок на дочерние страницы текущей страницы, хотя это не так полезно в зоне, поскольку навигация по зоне, как правило, уже предоставляет эти ссылки.</p> - -<h2 id="Zone_style_guide" name="Zone_style_guide">Руководство по оформлению зон</h2> - -<h2 id="Notes" name="Notes">Примечания</h2> - -<p>В этом разделе содержатся примечания, которые следует иметь в виду при создании зон и работе с ними.</p> - -<ul> - <li>Каждая страница в зоне автоматически наследует боковую панель навигации, предоставляемую корневой страницей зоны.</li> - <li>Если страница в зоне имеет раздел быстрых ссылок, быстрые ссылки отображаются под навигацией по зоне в боковой панели. Отключение быстрых ссылок отключает как быстрые ссылки, так и панель навигации, оставляя больше пространства под содержимое страницы.</li> -</ul> |