From 634e45b21248fbb508edb7988483a4b9cf1fff7a Mon Sep 17 00:00:00 2001 From: Florian Merz Date: Thu, 25 Feb 2021 18:24:02 +0100 Subject: sync: move --- files/ru/mdn/tools/search/index.html | 105 -------------------------- files/ru/orphaned/mdn/tools/search/index.html | 105 ++++++++++++++++++++++++++ 2 files changed, 105 insertions(+), 105 deletions(-) delete mode 100644 files/ru/mdn/tools/search/index.html create mode 100644 files/ru/orphaned/mdn/tools/search/index.html (limited to 'files/ru') diff --git a/files/ru/mdn/tools/search/index.html b/files/ru/mdn/tools/search/index.html deleted file mode 100644 index 4f175b6ce8..0000000000 --- a/files/ru/mdn/tools/search/index.html +++ /dev/null @@ -1,105 +0,0 @@ ---- -title: Использование продвинутого поиска -slug: MDN/Tools/Search -tags: - - Guide - - MDN -translation_of: MDN/Tools/Search -original_slug: MDN/User_guide/Advanced_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/orphaned/mdn/tools/search/index.html b/files/ru/orphaned/mdn/tools/search/index.html new file mode 100644 index 0000000000..4f175b6ce8 --- /dev/null +++ b/files/ru/orphaned/mdn/tools/search/index.html @@ -0,0 +1,105 @@ +--- +title: Использование продвинутого поиска +slug: MDN/Tools/Search +tags: + - Guide + - MDN +translation_of: MDN/Tools/Search +original_slug: MDN/User_guide/Advanced_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
+
Различная информация от поискового движка о том, почему страница соответствует вашему запросу. Описание этого содержимого выходит за рамки данного документа.
+
-- cgit v1.2.3-54-g00ecf