diff options
Diffstat (limited to 'files/ru/orphaned')
3 files changed, 356 insertions, 0 deletions
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..ab4eb3b792 --- /dev/null +++ b/files/ru/orphaned/mdn/tools/search/index.html @@ -0,0 +1,105 @@ +--- +title: Использование продвинутого поиска +slug: orphaned/MDN/Tools/Search +tags: + - Guide + - MDN +translation_of: MDN/Tools/Search +original_slug: MDN/Tools/Search +--- +<div>{{MDNSidebar}}</div><p><span class="seoSummary">В качестве дополнительной возможности внесения для вкладчиков в MDN у нас есть продвинутый механизм поиска, который позволяется вам искать по исходному коду страницы — то есть, по сырому HTML сайта, с макросами вместо их вывода — что позволяет искать использования определённых макросов, атрибутов HTML и тому подобное.</span></p> +<p>На текущий момент для использования продвинутого механизма поиска нет пользовательского интерфейса, но вы можете получить к нему доступ посредством специально сформированных URL. Вы можете получить вывод либо на стандартную страницу с результатами поиска по MDN, либо в формате JSON (последнее означает, что вы можете использовать этот механизм, например, из кода на KumaScript). <span class="seoSummary">Эта статья описывает, как всем этим пользоваться.</span></p> +<div class="note"> + <p><strong>Примечание:</strong> эти поисковые запросы не предназначены для конструирования распространяемых URL; а предназначены для использования во вспомогательных инструментах и утилитах. В будущем они могут измениться, также не обязательно, что эти запросы самые эффективные.</p> +</div> + +<h2 id="Search_query_format" name="Search_query_format">Формат поискового запроса</h2> +<p>Продвинутые поисковые запросы позволяются конструировать URL с соответствующими параметрами. Базовый URL может быть одним из следующих:</p> +<dl> + <dt><code>https://developer.mozilla.org/en-US/search</code></dt> + <dd>Используйте этот базовый URL для получения стандартной страницы с результатами поиска по MDN.</dd> + <dt><code>https://developer.mozilla.org/en-US/search.json</code></dt> + <dd>Используйте этот базовый URL для получения результатов в формате JSON. О формате результата смотрите раздел {{anch("JSON_result_format", "формат JSON для результата")}}.</dd> +</dl> +<p>Кроме того, вам нужно добавить соответствующие параметры для получения желаемого результата. Вы можете использовать любую комбинацию следующих параметров:</p> +<dl> + <dt><code>locale=</code></dt> + <dd>Рассматриваемая локаль. По умолчанию рассматриваются все локали. Также вы можете явно указать «все локали» при помощи шаблона <code>"*"</code>. Например, вы можете определить <code>locale=en-US</code> для ограничения поиска только по англоязычным страницам.</dd> + <dt><code>css_classnames=</code></dt> + <dd>Классы CSS для сопоставления. Этот параметр ограничивает результат поиска страницами, чей HTML-код включает в сеся как минимум одно использование указанных классов.</dd> + <dt><code>html_attributes=</code></dt> + <dd>Текст атрибутов HTML для сопоставления. Поиск ведётся по началу текста; то есть, если указаный текст появляется в начале строки атрибута HTML, он будет считаться совпавшим. Подробности смотрите ниже.</dd> + <dt><code>kumascript_macros=</code></dt> + <dd>Список искомых макросов KumaScript. Этот параметр позволяет вам находить статьи, использующие определённый макрос; это может быть полезно в тех случаях, если, к примеру, макрос устарел или его параметры поменялись и вам нужно обновить существующие варианты его использования.</dd> +</dl> + +<h2 id="Examples" name="Examples">Примеры</h2> +<p>Здесь приведено несколько примеров поисковых запросов.</p> + +<h3 id="Searching_by_locale" name="Searching_by_locale">Поиск по локали</h3> +<pre>https://developer.mozilla.org/en-US/search?locale=en-US</pre> +<p>В этом примере возвращается список всех англоязычных статей без каких-либо иных ограничений. На момент написания этой статьи их было 12865 (к тому времени, как вы прочитаете эту статью, их, конечно же, станет больше, поскольку мы постоянно растём)!</p> + +<h3 id="Searching_by_CSS_class_name" name="Searching_by_CSS_class_name">Поиск по имени CSS-класса</h3> +<pre>https://developer.mozilla.org/en-US/search?locale=en-US&css_classnames=smaller</pre> +<p>В этом примере мы добавили к поисковому условию использование CSS-класса <code>"smaller"</code>; на момент написания этой статьи количество результатов снизилось всего до 6 страниц.</p> + +<h3 id="Searching_by_HTML_attribute_string" name="Searching_by_HTML_attribute_string">Поиск по строке атрибута HTML</h3> +<pre>https://developer.mozilla.org/en-US/search?locale=en-US&html_attributes=style</pre> +<p>Здесь мы ищем использования атрибута <code>"style"</code> на элементах HTML. На момент написания этой статьи мы нашли 4935 таких страниц. Это плохо и это нужно искоренять; мы собираемся заменить все такие вхождения на наши стандартные классы.</p> +<p>Также вы можете включать в поисковый запрос значение атрибута, но помните, что если вы захотите включить символы вроде <code>"="</code> или <code>"/"</code> в ваш поисковый запрос, вы должны их закодировать для использования в URL. Например, чтобы найти страницы, ссылающиеся на www.mozilla.org, вы можете сделать так:</p> +<pre>https://developer.mozilla.org/en-US/search?locale=en-US&html_attributes=href%3D%22https%3A%2F%2Fwww.mozilla.org</pre> +<p>Этот поиск вернул 29 результатов. Это удивительно малое количество ссылок на сайт www.mozilla.org!</p> + +<h3 id="Searching_for_KumaScript_macro_usage" name="Searching_for_KumaScript_macro_usage">Поиск по используемому макросу KumaScript</h3> +<pre>https://developer.mozilla.org/en-US/search?locale=en-US&kumascript_macros=unimplemented_header</pre> +<p>Этот поисковый запрос ищет использования макроса {{TemplateLink("unimplemented_header")}}. На момент написания этой статьи было найдено шесть страниц. Он позволяет нам искать макросы, чьи параметры были изменены, либо те, которые мы хотим прекратить использовать (последний случай как раз относится к рассматриваемому макросу).</p> + +<h2 id="JSON_result_format" name="JSON_result_format">Формат JSON для результата</h2> +<p>Когда вы запрашиваете результат в формате JSON, вы по прежнему получаете результаты по одной странице за раз. Каждая страница является объектом KumaScript, который состоит из нескольких частей с метаданными о результатах, плюс массив стандартных объектов страницы с одним дополнительным полем: URL-адресом для начала редактирования страницы.</p> +<p>В результирующем объекте содержатся следующие данные:</p> +<dl> + <dt><code>count</code></dt> + <dd>Общее количество найденных результатов.</dd> + <dt><code>next</code></dt> + <dd>URL, по которому можно перейти на следующую страницу с результатами (либо {{jsxref("Global_Objects/null", "null")}} для последней страницы).</dd> + <dt><code>previous</code></dt> + <dd>URL, по которому можно перейти на предыдущую страницу с результатами (либо {{jsxref("Global_Objects/null", "null")}} для первой страницы).</dd> + <dt><code>query</code></dt> + <dd>???</dd> + <dt><code>page</code></dt> + <dd>Номер страницы с результатами, описываемой этим объектом.</dd> + <dt><code>pages</code></dt> + <dd>Общее количество страниц с результатами.</dd> + <dt><code>start</code></dt> + <dd>Номер первого элемента на этой странице с результатами.</dd> + <dt><code>end</code></dt> + <dd>Номер последнего элемента на этой странице с результатами.</dd> + <dt><code>filters</code></dt> + <dd>Массив конфигураций расличных поисковых фильтров. Эти фильтры доступны в стандартном поиске.</dd> + <dt><code>documents</code></dt> + <dd>Массив {{anch("Page_objects", "объектов страницы")}}, описывающих каждую совпавшую страницу.</dd> +</dl> + +<h3 id="Page_objects" name="Page_objects">Объекты страницы</h3> +<p>Каждый объект страницы содержит следующие поля:</p> +<dl> + <dt><code>title</code></dt> + <dd>Заголовок статьи.</dd> + <dt><code>slug</code></dt> + <dd>Идентификатор статьи. Это вся часть URL страницы, следующая за локалью и последующим символом слеша.</dd> + <dt><code>locale</code></dt> + <dd>Локаль страницы.</dd> + <dt><code>excerpt</code></dt> + <dd>Фрагмент содержания страницы; это либо первый блок обычного текста статьи, либо содержимое, отмеченное классом "SEO Summary".</dd> + <dt><code>url</code></dt> + <dd>Полный URL страницы.</dd> + <dt><code>edit_url</code></dt> + <dd>Полный URL страницы в режиме редактирования.</dd> + <dt><code>tags</code></dt> + <dd>Массив меток страницы.</dd> + <dt><code>score</code></dt> + <dd>Значение очков, присвоенное странице поисковым движком.</dd> + <dt><code>explanation</code></dt> + <dd>Различная информация от поискового движка о том, почему страница соответствует вашему запросу. Описание этого содержимого выходит за рамки данного документа.</dd> +</dl> diff --git a/files/ru/orphaned/web/api/htmlhyperlinkelementutils/index.html b/files/ru/orphaned/web/api/htmlhyperlinkelementutils/index.html new file mode 100644 index 0000000000..2ee02cdbfd --- /dev/null +++ b/files/ru/orphaned/web/api/htmlhyperlinkelementutils/index.html @@ -0,0 +1,179 @@ +--- +title: HTMLHyperlinkElementUtils +slug: orphaned/Web/API/HTMLHyperlinkElementUtils +tags: + - API + - Experimental + - Mixin + - NeedsTranslation + - TopicStub + - URL API +translation_of: Web/API/HTMLHyperlinkElementUtils +original_slug: Web/API/HTMLHyperlinkElementUtils +--- +<p>{{ApiRef("URL API")}}{{SeeCompatTable}}</p> + +<p>The <strong><code>HTMLHyperlinkElementUtils</code></strong> mixin defines utility methods and properties to work with {{domxref("HTMLAnchorElement")}} and {{domxref("HTMLAreaElement")}}. These utilities allow to deal with common features like URLs.</p> + +<p>There are no objects of this type, but several objects {{domxref("HTMLAnchorElement")}} and {{domxref("HTMLAreaElement")}} implement it.</p> + +<h2 id="Properties">Properties</h2> + +<p><em>This interface doesn't inherit any property.</em></p> + +<dl> + <dt>{{domxref("HTMLHyperlinkElementUtils.href")}}</dt> + <dd>Is a {{domxref("USVString")}} containing the whole URL.</dd> + <dt>{{domxref("HTMLHyperlinkElementUtils.protocol")}}</dt> + <dd>Is a {{domxref("USVString")}} containing the protocol scheme of the URL, including the final <code>':'</code>.</dd> + <dt>{{domxref("HTMLHyperlinkElementUtils.host")}}</dt> + <dd>Is a {{domxref("USVString")}} containing the host, that is the <em>hostname</em>, and then, if the <em>port</em> of the URL is not empty (which can happen because it was not specified or because it was specified to be the default port of the URL's scheme), a <code>':'</code>, and the <em>port</em> of the URL.</dd> + <dt>{{domxref("HTMLHyperlinkElementUtils.hostname")}}</dt> + <dd>Is a {{domxref("USVString")}} containing the domain of the URL.</dd> + <dt>{{domxref("HTMLHyperlinkElementUtils.port")}}</dt> + <dd>Is a {{domxref("USVString")}} containing the port number of the URL.</dd> + <dt>{{domxref("HTMLHyperlinkElementUtils.pathname")}}</dt> + <dd>Is a {{domxref("USVString")}} containing an initial <code>'/'</code> followed by the path of the URL.</dd> + <dt>{{domxref("HTMLHyperlinkElementUtils.search")}}</dt> + <dd>Is a {{domxref("USVString")}} containing a <code>'?'</code> followed by the parameters of the URL.</dd> + <dt>{{domxref("HTMLHyperlinkElementUtils.hash")}}</dt> + <dd>Is a {{domxref("USVString")}} containing a <code>'#'</code> followed by the fragment identifier of the URL.</dd> + <dt>{{domxref("HTMLHyperlinkElementUtils.username")}}</dt> + <dd>Is a {{domxref("USVString")}} containing the username specified before the domain name.</dd> + <dt>{{domxref("HTMLHyperlinkElementUtils.password")}}</dt> + <dd>Is a {{domxref("USVString")}} containing the password specified before the domain name.</dd> + <dt>{{domxref("HTMLHyperlinkElementUtils.origin")}} {{readonlyInline}}</dt> + <dd>Returns a {{domxref("USVString")}} containing the origin of the URL, that is its scheme, its domain and its port.</dd> +</dl> + +<h2 id="Methods">Methods</h2> + +<p><em>This interface doesn't inherit any method.</em></p> + +<dl> + <dt>{{domxref("HTMLHyperlinkElementUtils.toString()")}}</dt> + <dd>Returns a {{domxref("DOMString")}} containing the whole URL. It is a synonym for {{domxref("HTMLHyperlinkElementUtils.href")}}, though it can't be used to modify the value.</dd> +</dl> + +<h2 id="Specifications">Specifications</h2> + +<table class="standard-table"> + <thead> + <tr> + <th scope="col">Specification</th> + <th scope="col">Status</th> + <th scope="col">Comment</th> + </tr> + </thead> + <tbody> + <tr> + <td>{{SpecName('HTML WHATWG', '#htmlhyperlinkelementutils', 'HTMLHyperlinkElementUtils')}}</td> + <td>{{Spec2('HTML WHATWG')}}</td> + <td>Initial definition</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility">Browser compatibility</h2> + +<p>{{ CompatibilityTable() }}</p> + +<div id="compat-desktop"> +<table class="compat-table"> + <tbody> + <tr> + <th>Feature</th> + <th>Chrome</th> + <th>Firefox (Gecko)</th> + <th>Internet Explorer</th> + <th>Opera</th> + <th>Safari</th> + </tr> + <tr> + <td>Basic support</td> + <td>{{CompatNo}} [1]</td> + <td>{{CompatGeckoDesktop("22")}} [2]</td> + <td>{{CompatNo}} [1]</td> + <td>{{CompatNo}} [1]</td> + <td>{{CompatNo}} [1]</td> + </tr> + <tr> + <td><code>username</code> and <code>password</code></td> + <td>{{CompatUnknown}}</td> + <td>{{CompatGeckoDesktop("26")}} [2]</td> + <td>{{CompatNo}}</td> + <td>{{CompatUnknown}}</td> + <td>{{CompatUnknown}}</td> + </tr> + <tr> + <td><code>origin </code></td> + <td>{{CompatVersionUnknown()}}</td> + <td>{{CompatGeckoDesktop("26")}} [2]</td> + <td>{{CompatUnknown}}</td> + <td>{{CompatUnknown}}</td> + <td>{{CompatUnknown}}</td> + </tr> + </tbody> +</table> +</div> + +<div id="compat-mobile"> +<table class="compat-table"> + <tbody> + <tr> + <th>Feature</th> + <th>Android</th> + <th>Chrome for Android</th> + <th>Firefox Mobile (Gecko)</th> + <th>IE Mobile</th> + <th>Opera Mobile</th> + <th>Safari Mobile</th> + </tr> + <tr> + <td>Basic support</td> + <td>{{CompatNo}} [1]</td> + <td>{{CompatNo}} [1]</td> + <td>{{CompatGeckoMobile("22")}} [2]</td> + <td>{{CompatNo}} [1]</td> + <td>{{CompatNo}} [1]</td> + <td>{{CompatNo}} [1]</td> + </tr> + <tr> + <td><code>username</code> and <code>password</code></td> + <td>{{CompatUnknown}}</td> + <td>{{CompatUnknown}}</td> + <td>{{CompatGeckoMobile("26")}} [2]</td> + <td>{{CompatNo}}</td> + <td>{{CompatUnknown}}</td> + <td>{{CompatUnknown}}</td> + </tr> + <tr> + <td><code>origin </code></td> + <td>{{CompatUnknown}}</td> + <td>{{CompatUnknown}}</td> + <td>{{CompatGeckoMobile("26")}} [2]</td> + <td>{{CompatUnknown}}</td> + <td>{{CompatUnknown}}</td> + <td>{{CompatUnknown}}</td> + </tr> + </tbody> +</table> +</div> + +<p>[1] Though not grouped in a single abstract interface, these methods are directly available on the interfaces that implement it, if this interface is supported.</p> + +<p>[2] This mixin was called <code>URLUtils</code> before Firefox 45, and was also implemented to other by other interfaces, like {{domxref("Location")}}. From Firefox 45, the other interfaces implements their own version of the properties and methods they need.</p> + +<h2 id="See_also">See also</h2> + +<ul> + <li>Interfaces implementing this one: {{domxref("HTMLAnchorElement")}}, {{domxref("HTMLAreaElement")}} + <dl><br> + <dd> </dd> + </dl> + </li> +</ul> + +<dl> + <dd> </dd> +</dl> diff --git a/files/ru/orphaned/web/mathml/element/mglyph/index.html b/files/ru/orphaned/web/mathml/element/mglyph/index.html new file mode 100644 index 0000000000..37bc0ad8b7 --- /dev/null +++ b/files/ru/orphaned/web/mathml/element/mglyph/index.html @@ -0,0 +1,72 @@ +--- +title: <mglyph> +slug: orphaned/Web/MathML/Element/mglyph +tags: + - MathML + - MathML:Element + - Глиф + - Символ +translation_of: Web/MathML/Element/mglyph +original_slug: Web/MathML/Element/mglyph +--- +<div>{{MathMLRef}}</div> + +<p class="summary">Элемент <code><mglyph></code> разметки MathML используется для отображения нестандартных символов там, где существующиt символы Unicode недоступны. Его можно использовать в <a href="/en-US/docs/tag/MathML:Token%20Elements">элементах-токенах</a>.</p> + +<h2 id="Атрибуты">Атрибуты</h2> + +<dl> + <dt id="attr-alt">alt</dt> + <dd>Этот атрибут определяет альернативный текст, описывающий изображение. Пользователи увидят этот текст, если URL адрес изображения неправильный, изображение не в одном из <a href="/ru/docs/Web/HTML/Element/img#Поддерживаемые_форматы_изображений">поддерживаемых форматов</a> или пока изображение не будет загружено.</dd> + <dt id="attr-class-id-style">class, id, style</dt> + <dd>Предусмотрено для использования с <a href="/ru/docs/Web/CSS">таблицами стилей</a>.</dd> + <dt id="attr-height">height</dt> + <dd>Высота изображения.</dd> + <dt id="attr-href">href</dt> + <dd>Используется для установки гиперссылки на указанный URI.</dd> + <dt id="attr-mathbackground">mathbackground</dt> + <dd>Цвет фона (если изображение имеет прозрачность). Вы можете использовать <code>#rgb</code>, <code>#rrggbb</code> и <a href="/ru/docs/Web/CSS/color_value">имена цветов HTML</a>.</dd> + <dt id="attr-src">src</dt> + <dd>URL изображения.</dd> + <dt id="attr-valign">valign</dt> + <dd>Задаёт вертикальное выравнивание относительно текущей базовой линии.</dd> + <dt id="attr-width">width</dt> + <dd>Ширина изображения.</dd> +</dl> + +<h2 id="Пример">Пример</h2> + +<pre class="brush: html notranslate"><math> + <mi><mglyph src="my-glyph.png" alt="my glyph"/></mi> +</math> +</pre> + +<h2 id="Спецификации">Спецификации</h2> + +<table class="standard-table"> + <thead> + <tr> + <th scope="col">Спецификация</th> + <th scope="col">Статус</th> + <th scope="col">Комментарий</th> + </tr> + </thead> + <tbody> + <tr> + <td>{{ SpecName('MathML3', 'chapter3.html#presm.mglyph', 'mglyph') }}</td> + <td>{{ Spec2('MathML3') }}</td> + <td>Текущая спецификация</td> + </tr> + <tr> + <td>{{ SpecName('MathML2', 'chapter3.html#presm.mglyph', 'mglyph') }}</td> + <td>{{ Spec2('MathML2') }}</td> + <td>Начальная спецификация</td> + </tr> + </tbody> +</table> + +<h2 id="Совместимость_с_браузерами">Совместимость с браузерами</h2> + + + +<p>{{Compat("mathml.elements.mglyph")}}</p> |