From 074785cea106179cb3305637055ab0a009ca74f2 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:42:52 -0500 Subject: initial commit --- files/ru/mdn/user_guide/advanced_search/index.html | 104 +++++++++++ files/ru/mdn/user_guide/deleting_pages/index.html | 16 ++ files/ru/mdn/user_guide/feeds/index.html | 73 ++++++++ files/ru/mdn/user_guide/index.html | 12 ++ files/ru/mdn/user_guide/linking_to_mdn/index.html | 63 +++++++ files/ru/mdn/user_guide/writing/index.html | 49 +++++ .../mdn/user_guide/zone_administration/index.html | 207 +++++++++++++++++++++ 7 files changed, 524 insertions(+) create mode 100644 files/ru/mdn/user_guide/advanced_search/index.html create mode 100644 files/ru/mdn/user_guide/deleting_pages/index.html create mode 100644 files/ru/mdn/user_guide/feeds/index.html create mode 100644 files/ru/mdn/user_guide/index.html create mode 100644 files/ru/mdn/user_guide/linking_to_mdn/index.html create mode 100644 files/ru/mdn/user_guide/writing/index.html create mode 100644 files/ru/mdn/user_guide/zone_administration/index.html (limited to 'files/ru/mdn/user_guide') diff --git a/files/ru/mdn/user_guide/advanced_search/index.html b/files/ru/mdn/user_guide/advanced_search/index.html new file mode 100644 index 0000000000..08ba78607f --- /dev/null +++ b/files/ru/mdn/user_guide/advanced_search/index.html @@ -0,0 +1,104 @@ +--- +title: Использование продвинутого поиска +slug: MDN/User_guide/Advanced_search +tags: + - Guide + - MDN +translation_of: MDN/Tools/Search +--- +
{{MDNSidebar}}

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

+

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

+
+

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

+
+ +

Формат поискового запроса

+

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

+
+
https://developer.mozilla.org/en-US/search
+
Используйте этот базовый URL для получения стандартной страницы с результатами поиска по MDN.
+
https://developer.mozilla.org/en-US/search.json
+
Используйте этот базовый URL для получения результатов в формате JSON. О формате результата смотрите раздел {{anch("JSON_result_format", "формат JSON для результата")}}.
+
+

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

+
+
locale=
+
Рассматриваемая локаль. По умолчанию рассматриваются все локали. Также вы можете явно указать «все локали» при помощи шаблона "*". Например, вы можете определить locale=en-US для ограничения поиска только по англоязычным страницам.
+
css_classnames=
+
Классы CSS для сопоставления. Этот параметр ограничивает результат поиска страницами, чей HTML-код включает в сеся как минимум одно использование указанных классов.
+
html_attributes=
+
Текст атрибутов HTML для сопоставления. Поиск ведётся по началу текста; то есть, если указаный текст появляется в начале строки атрибута HTML, он будет считаться совпавшим. Подробности смотрите ниже.
+
kumascript_macros=
+
Список искомых макросов KumaScript. Этот параметр позволяет вам находить статьи, использующие определённый макрос; это может быть полезно в тех случаях, если, к примеру, макрос устарел или его параметры поменялись и вам нужно обновить существующие варианты его использования.
+
+ +

Примеры

+

Здесь приведено несколько примеров поисковых запросов.

+ +

Поиск по локали

+
https://developer.mozilla.org/en-US/search?locale=en-US
+

В этом примере возвращается список всех англоязычных статей без каких-либо иных ограничений. На момент написания этой статьи их было 12865 (к тому времени, как вы прочитаете эту статью, их, конечно же, станет больше, поскольку мы постоянно растём)!

+ +

Поиск по имени CSS-класса

+
https://developer.mozilla.org/en-US/search?locale=en-US&css_classnames=smaller
+

В этом примере мы добавили к поисковому условию использование CSS-класса "smaller"; на момент написания этой статьи количество результатов снизилось всего до 6 страниц.

+ +

Поиск по строке атрибута HTML

+
https://developer.mozilla.org/en-US/search?locale=en-US&html_attributes=style
+

Здесь мы ищем использования атрибута "style" на элементах HTML. На момент написания этой статьи мы нашли 4935 таких страниц. Это плохо и это нужно искоренять; мы собираемся заменить все такие вхождения на наши стандартные классы.

+

Также вы можете включать в поисковый запрос значение атрибута, но помните, что если вы захотите включить символы вроде "=" или "/" в ваш поисковый запрос, вы должны их закодировать для использования в URL. Например, чтобы найти страницы, ссылающиеся на www.mozilla.org, вы можете сделать так:

+
https://developer.mozilla.org/en-US/search?locale=en-US&html_attributes=href%3D%22https%3A%2F%2Fwww.mozilla.org
+

Этот поиск вернул 29 результатов. Это удивительно малое количество ссылок на сайт www.mozilla.org!

+ +

Поиск по используемому макросу KumaScript

+
https://developer.mozilla.org/en-US/search?locale=en-US&kumascript_macros=unimplemented_header
+

Этот поисковый запрос ищет использования макроса {{TemplateLink("unimplemented_header")}}. На момент написания этой статьи было найдено шесть страниц. Он позволяет нам искать макросы, чьи параметры были изменены, либо те, которые мы хотим прекратить использовать (последний случай как раз относится к рассматриваемому макросу).

+ +

Формат JSON для результата

+

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

+

В результирующем объекте содержатся следующие данные:

+
+
count
+
Общее количество найденных результатов.
+
next
+
URL, по которому можно перейти на следующую страницу с результатами (либо {{jsxref("Global_Objects/null", "null")}} для последней страницы).
+
previous
+
URL, по которому можно перейти на предыдущую страницу с результатами (либо {{jsxref("Global_Objects/null", "null")}} для первой страницы).
+
query
+
???
+
page
+
Номер страницы с результатами, описываемой этим объектом.
+
pages
+
Общее количество страниц с результатами.
+
start
+
Номер первого элемента на этой странице с результатами.
+
end
+
Номер последнего элемента на этой странице с результатами.
+
filters
+
Массив конфигураций расличных поисковых фильтров. Эти фильтры доступны в стандартном поиске.
+
documents
+
Массив {{anch("Page_objects", "объектов страницы")}}, описывающих каждую совпавшую страницу.
+
+ +

Объекты страницы

+

Каждый объект страницы содержит следующие поля:

+
+
title
+
Заголовок статьи.
+
slug
+
Идентификатор статьи. Это вся часть URL страницы, следующая за локалью и последующим символом слеша.
+
locale
+
Локаль страницы.
+
excerpt
+
Фрагмент содержания страницы; это либо первый блок обычного текста статьи, либо содержимое, отмеченное классом "SEO Summary".
+
url
+
Полный URL страницы.
+
edit_url
+
Полный URL страницы в режиме редактирования.
+
tags
+
Массив меток страницы.
+
score
+
Значение очков, присвоенное странице поисковым движком.
+
explanation
+
Различная информация от поискового движка о том, почему страница соответствует вашему запросу. Описание этого содержимого выходит за рамки данного документа.
+
diff --git a/files/ru/mdn/user_guide/deleting_pages/index.html b/files/ru/mdn/user_guide/deleting_pages/index.html new file mode 100644 index 0000000000..ffd7d04664 --- /dev/null +++ b/files/ru/mdn/user_guide/deleting_pages/index.html @@ -0,0 +1,16 @@ +--- +title: Удаление страниц +slug: MDN/User_guide/Deleting_pages +tags: + - Guide + - MDN +translation_of: MDN/Tools/Page_deletion +--- +
{{MDNSidebar}}

Только администраторы MDN имеют право и могут удалять страницы. Эта статья описывает, как отправить запрос на удаление страницы с MDN.

+

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

+
    +
  1. Не очищайте и не изменяйте содержимое страницы. Мы хотим видеть эту страницу во время удаления.
    2. +
  2. Добавьте метку «junk» к странице. Не удаляйте другие метки.
    3. +
  3. Если страница особенно срочно нуждается в удалении (например, её содержимое неуместно, оскорбительно или технически опасно), уведомите администратора MDN.
    4. +
+

Администратор удалит страницу, когда это будет возможно, после того как убедится, что это удаление целесообразно.

diff --git a/files/ru/mdn/user_guide/feeds/index.html b/files/ru/mdn/user_guide/feeds/index.html new file mode 100644 index 0000000000..ba43bf1809 --- /dev/null +++ b/files/ru/mdn/user_guide/feeds/index.html @@ -0,0 +1,73 @@ +--- +title: Ленты новостей MDN +slug: MDN/User_guide/Feeds +tags: + - Kuma +translation_of: MDN/Tools/Feeds +--- +
{{MDNSidebar}}

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

+ +

Получение доступа к лентам новостей

+

Все ленты новостей начинаются со следующего базового URL:

+
https://developer.mozilla.org/<локаль>/docs/feeds/<формат>/
+

Заполнители в базовом URL могут быть заменены следующими значениями:

+ +

Если вы используете формат json, вы также можете определить дополнительный параметр запроса ?callback=<имя функции обратного вызова>, который следует соглашению JSONP для загрузки данных как JavaScript.

+ +

Доступные ленты

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
ЛентаОписание
all +

Все недавно изменённые статьи, упорядоченные по дате изменения. Также она включает в себя новые статьи. Все изменения объединяются в одну запись в ленте новостей для каждой статьи. Например:

+

https://developer.mozilla.org/ru/docs/feeds/rss/all

+
revisions +

Все ревизии статей, упорядоченные по дате изменения, включая новые статьи. Каждая ревизия занимает отдельную запись в ленте. Например:

+

https://developer.mozilla.org/ru/docs/feeds/atom/revisions

+
tag/<имя-метки> +

Недавно изменённые статьи, упорядоченные по дате изменения. В ленту включаются только статьи с определённой меткой. Например:

+

https://developer.mozilla.org/ru/docs/feeds/json/tag/CSS?callback=loadFeed

+
files +

Недавно изменённые или загруженные файлы. Например:

+

https://developer.mozilla.org/ru/docs/feeds/atom/files

+
l10n-updates +

Переводные статьи, чей оригинал был изменён с последнего редактирования этой статьи. Например:

+

https://developer.mozilla.org/ru/docs/feeds/atom/l10n-updates

+
needs-review[/<тип-проверки>] +

Список статей, требующих определённой проверки, либо статьи, требующие любой проверки, если тип проверки не указан. Тип проверки может быть одним из technical, editorial или kumascript.

+

https://developer.mozilla.org/ru/docs/feeds/json/needs-review

+

https://developer.mozilla.org/ru/docs/feeds/rss/needs-review/technical

+

https://developer.mozilla.org/ru/docs/feeds/atom/needs-review/editorial

+

https://developer.mozilla.org/ru/docs/feeds/atom/needs-review/kumascript

+
diff --git a/files/ru/mdn/user_guide/index.html b/files/ru/mdn/user_guide/index.html new file mode 100644 index 0000000000..c8999eeb85 --- /dev/null +++ b/files/ru/mdn/user_guide/index.html @@ -0,0 +1,12 @@ +--- +title: Руководство пользователя MDN +slug: MDN/User_guide +tags: + - Documentation + - Landing + - MDN +translation_of: MDN/Tools +--- +
{{MDNSidebar}}

Сайт сети разработчиков Mozilla является продвинутой системой для поиска, чтения и внесения документации и примеров исходного кода для веб-разработчиков (а также для разработчиков под браузер Firefox и ОС Firefox). Руководство пользователя MDN предоставляет статьи, в подробностях описывающие, как использовать MDN для поиска нужной вам документации и, если вы желаете, как помочь сделать материалы лучше: более полными и обширными.

+
+ {{LandingPageListSubpages}}
diff --git a/files/ru/mdn/user_guide/linking_to_mdn/index.html b/files/ru/mdn/user_guide/linking_to_mdn/index.html new file mode 100644 index 0000000000..093ce13265 --- /dev/null +++ b/files/ru/mdn/user_guide/linking_to_mdn/index.html @@ -0,0 +1,63 @@ +--- +title: Проставление ссылок на MDN +slug: MDN/User_guide/Linking_to_MDN +tags: + - Documentation + - Guide + - MDN +translation_of: MDN/About/Linking_to_MDN +--- +
{{MDNSidebar}}

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

+ + +

Да! Разумеется! Дело не только в том, что гипертекст — это сущность веба, это так же способ указать вашим пользователям на ценные ресурсы и показать своё доверие к работе нашего сообщества.

+

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

+ +

На какую страницу мне надо ссылаться?

+

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

+ +

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

+ +

Как создать хорошую ссылку?

+

Создание ссылок — дело тривиальное, но создание хороших ссылок — это нечто более сложное. Существует несколько способов создать ссылки:

+ +

Ссылки в тексте

+

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

+
+

… с помощью API IndexedDB данные можно хранить в локальной базе данных…

+
+

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

+ +

Что не надо делать при проставлении ссылок в тексте

+

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

+ + +

Добавление баннера или изображения на ваш сайт

+

Другим способом сослаться на MDN является добавление изображения со ссылкой вне основного текста страницы, например, в боковую панель. Он имеет другое значение: тогда как проставление ссылок в тексте является способом предоставления дополнительной информации вашим пользователям, добавление изображения со ссылкой в боковую панель — это способ показать вашу поддержку проекту MDN или способ продвинуть MDN. Также это способ предложения MDN в качестве единого ресурса со всей информацией.

+

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

+ +

Автоматическое проставление ссылок на MDN из WordPress

+

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

+

Большое спасибо вам за вашу поддержку!

diff --git a/files/ru/mdn/user_guide/writing/index.html b/files/ru/mdn/user_guide/writing/index.html new file mode 100644 index 0000000000..b83e7bcfc8 --- /dev/null +++ b/files/ru/mdn/user_guide/writing/index.html @@ -0,0 +1,49 @@ +--- +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 new file mode 100644 index 0000000000..95704a390d --- /dev/null +++ b/files/ru/mdn/user_guide/zone_administration/index.html @@ -0,0 +1,207 @@ +--- +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