Skip to content

Commit

Permalink
convert content to md
Browse files Browse the repository at this point in the history
  • Loading branch information
@SphinxKnight
SphinxKnight committed Sep 19, 2022
1 parent 1d59c15 commit cd964ef
Show file tree
Hide file tree
Showing 2 changed files with 87 additions and 121 deletions.
6 changes: 3 additions & 3 deletions files/ru/web/xml/index.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -10,8 +10,8 @@ tags:
- XML
translation_of: Web/XML
---
<p>{{QuickLinksWithSubpages("/en-US/docs/Web/XML")}}</p>
{{QuickLinksWithSubpages("/en-US/docs/Web/XML")}}

<p class="summary">The <strong>Extensible Markup Language</strong> is a strict serialisation of the <a href="/en-US/docs/Web/API/Document_Object_Model">Document Object Model</a>.</p>
The **Extensible Markup Language** is a strict serialisation of the [Document Object Model](/ru/docs/Web/API/Document_Object_Model).

<p>{{LandingPageListSubpages}}</p>
{{LandingPageListSubpages}}
202 changes: 84 additions & 118 deletions files/ru/web/xml/xml_introduction/index.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -7,133 +7,99 @@ tags:
- XML
translation_of: Web/XML/XML_introduction
---
<p><span class="seoSummary">XML - это язык разметки подобный HTML. Расшифровывается как (англ. Extensible Markup Language - Расширяемый Язык Разметки) и является рекомендацией сообщества <a class="external" href="https://www.w3.org">W3C</a> в качестве языка разметки общего назначения (</span><a href="https://www.w3.org/TR/xml/">W3C recommended</a><span class="seoSummary">). В отличии от остальных языков разметки, XML сам по себе не определён (это означает, что вы должны сами определять используемые теги). Основной целью XML является передача данных между разными системами (даже концептуально разными), такими как интернет.</span></p>
XML - это язык разметки подобный HTML. Расшифровывается как (англ. Extensible Markup Language - Расширяемый Язык Разметки) и является рекомендацией сообщества [W3C](https://www.w3.org) в качестве языка разметки общего назначения ([W3C recommended](https://www.w3.org/TR/xml/)). В отличии от остальных языков разметки, XML сам по себе не определён (это означает, что вы должны сами определять используемые теги). Основной целью XML является передача данных между разными системами (даже концептуально разными), такими как интернет.

<p>Много языков базируются на XML; Некоторые примеры: <a href="/ru/docs/Glossary/XHTML" title="ru/XHTML">XHTML</a>, <a href="/ru/docs/Web/MathML" title="ru/MathML">MathML</a>, <a href="/ru/docs/Web/SVG" title="ru/SVG">SVG</a>, <a href="/ru/docs/Mozilla/Tech/XUL" title="ru/XUL">XUL</a>, <a href="/en-US/docs/Mozilla/Tech/XBL" title="en/XBL">XBL</a>, <a href="/en-US/docs/Web/RSS" title="en/RSS">RSS</a>, и <a href="/ru/docs/RDF" title="ru/RDF">RDF</a>. Вы можете создать свой.</p>
Много языков базируются на XML; Некоторые примеры: [XHTML](/ru/docs/Glossary/XHTML "ru/XHTML"), [MathML](/ru/docs/Web/MathML "ru/MathML"), [SVG](/ru/docs/Web/SVG "ru/SVG"), [XUL](/ru/docs/Mozilla/Tech/XUL "ru/XUL"), [XBL](/ru/docs/Mozilla/Tech/XBL "en/XBL"), [RSS](/ru/docs/Web/RSS "en/RSS"), и [RDF](/ru/docs/RDF "ru/RDF"). Вы можете создать свой.

<h2 id="Корректный_XML_(правильно_сформированный)">"Корректный" XML (правильно сформированный)</h2>
## "Корректный" XML (правильно сформированный)

<h3 id="Правила_оформления">Правила оформления</h3>
### Правила оформления

<p>Для корректного XML документа должны исполняться следующие условия: </p>
Для корректного XML документа должны исполняться следующие условия:

<ul>
<li>
<p>Правильное оформление документа.</p>
</li>
<li>
<p>Соблюдаться все синтаксические правила XML.</p>
</li>
<li>
<p>Документ должен соответствовать семантическим правилам языка (которые обычно заданны в схеме XML или DTD (англ. <strong><a href="/en-US/docs/Glossary/DTD" title="en/DTD">Document Type Definition</a></strong>)). </p>
</li>
</ul>
- Правильное оформление документа.
- Соблюдаться все синтаксические правила XML.
- Документ должен соответствовать семантическим правилам языка (которые обычно заданны в схеме XML или DTD (англ. **[Document Type Definition](/ru/docs/Glossary/DTD "en/DTD")**)).

<h3 id="Пример">Пример</h3>
### Пример

<p>Пример ниже показывает документ с тегом, который не закрывает сам себя и не имеет закрывающего тега (это неправильно оформленный XML документ).</p>
Пример ниже показывает документ с тегом, который не закрывает сам себя и не имеет закрывающего тега (это неправильно оформленный XML документ).

<pre class="brush: xml">&lt;message&gt;
&lt;warning&gt;
```xml
<message>
<warning>
Hello World
&lt;!--missing &lt;/warning&gt; --&gt;
&lt;/message&gt;
</pre>
<!--missing </warning> -->
</message>
```

<p>Давайте посмотрим на корректную версию этого документа:</p>
Давайте посмотрим на корректную версию этого документа:

<pre class="brush: xml">&lt;message&gt;
&lt;warning&gt;
```xml
<message>
<warning>
Hello World
&lt;/warning&gt;
&lt;/message&gt;
</pre>

<p> Документ содержащий неопределённый тег является не корректным. Например, если мы не определили тег <code>&lt;warning&gt;</code>, документ не корректен.</p>

<div class="note">
<p>В большинство браузеров встроен дебаггер, который может идентифицировать плохо написанный XML документ.</p>
</div>

<h2 id="Entities">Сущности</h2>

<p>HTML и XML предлагают методы (которые называют сущности) для обращения к специальным зарезервированным символам (например угловые скобки, обозначающие начало и конец тега). Существует пять сущностей, которые вы обязательно должны знать:</p>

<table class="standard-table">
<thead>
<tr>
<th scope="col">Сущность</th>
<th scope="col">Символ</th>
<th scope="col">Описание</th>
</tr>
</thead>
<tbody>
<tr>
<td>&amp;lt;</td>
<td>&lt;</td>
<td>Знак меньше (одна из угловых скобок)</td>
</tr>
<tr>
<td>&amp;gt;</td>
<td>&gt;</td>
<td>Знак больше (одна из угловых скобок)</td>
</tr>
<tr>
<td>&amp;amp;</td>
<td>&amp;</td>
<td>Амперсанд</td>
</tr>
<tr>
<td>&amp;quot;</td>
<td>"</td>
<td>Двойная кавычка</td>
</tr>
<tr>
<td>&amp;apos;</td>
<td>'</td>
<td>Одинарная кавычка (апостроф)</td>
</tr>
</tbody>
</table>

<p>Не смотря на то, что по умолчанию создано всего пять сущностей, вы можете добавить в документ свои сущности используя <a href="/en-US/docs/Glossary/DTD" title="en/DTD">Document Type Definition</a>. Например, создать новую <code>&amp;warning;</code> сущность, можно так:</p>

<pre>&lt;?xml version="1.0" encoding="UTF-8"?&gt;
&lt;!DOCTYPE body [
&lt;!ENTITY warning "Предупреждение: произошла ошибка, обновите и попробуте ещё раз."&gt;
]&gt;
&lt;body&gt;
&lt;message&gt; &amp;warning; &lt;/message&gt;
&lt;/body&gt;
</pre>

<p>Также вы можете использовать нумерические ссылки для специфический специальных символов. Например, &amp;#xA9; - это символ "©".</p>

<h2 id="Отображение_XML">Отображение XML</h2>

<p>XML обычно используют для описания чего-то. Существуют методы отображения XML данных, но если вы не определили способ визуализации XML документа, то в браузере он отобразится построчно, как обычный текстовый файл .</p>

<p>Один из методов отображения XML - указать <a href="/ru/docs/Web/CSS" title="ru/CSS">CSS</a> (чтобы использовать в документе нужно прописать инструкцию <code>xml-stylesheet</code>, как показано в примере ниже).</p>

<pre>&lt;?xml-stylesheet type="text/css" href="stylesheet.css"?&gt;</pre>

<p>Есть также много других мощных методов отображения XML, например, <a href="/en-US/docs/Web/XSLT" title="en/XSLT">XSLT</a>(англ. <strong>Extensible Stylesheet Language Transformations</strong>), который может использоваться для преобразование XML в другие языки такие, как HTML. Это делает XML очень универсальным.</p>

<pre>&lt;?xml-stylesheet type="text/xsl" href="transform.xsl"?&gt;</pre>

<h2 id="Recommendations">Рекомендации</h2>

<p>Эта статья является очень маленьким введением в XML, с очень маленьким количеством примеров и ссылок для того, чтобы вы могли начать работать с этим языком. Чтобы больше узнать про XML, вам придётся искать информацию и более информативные статьи в интернете.</p>

<p>Изучайте <a href="/ru/docs/Web/HTML" title="ru/HTML">HTML</a> (англ. HyperText Markup Language), знание HTML поможет вам лучше понять XML.</p>

<h2 id="Смотрите_также">Смотрите также</h2>

<ul>
<li><a class="external" href="http://www.xml.com/">XML.com</a></li>
<li><a class="external" href="https://www.w3.org/XML/">Extensible Markup Language (XML) @ W3.org</a></li>
<li><a class="external" href="http://www.alistapart.com/d/usingxml/xml_uses_a.html">XML Example: A List Apart</a></li>
<li><a class="external" href="http://www.alistapart.com/articles/usingxml/">Using XML: A List Apart</a></li>
</ul>

<p>Статья <a href="http://www.alistapart.com/articles/usingxml/">Using XML</a> - отличный ресурс с большим количеством информации о создании своего языка на основе XML.</p>
</warning>
</message>
```

Документ содержащий неопределённый тег является не корректным. Например, если мы не определили тег `<warning>`, документ не корректен.

> **Примечание:** В большинство браузеров встроен дебаггер, который может идентифицировать плохо написанный XML документ.
## Сущности

HTML и XML предлагают методы (которые называют сущности) для обращения к специальным зарезервированным символам (например угловые скобки, обозначающие начало и конец тега). Существует пять сущностей, которые вы обязательно должны знать:

| Сущность | Символ | Описание |
| -------- | ------ | ------------------------------------ |
| \&lt; | < | Знак меньше (одна из угловых скобок) |
| \&gt; | > | Знак больше (одна из угловых скобок) |
| \&amp; | & | Амперсанд |
| \&quot; | " | Двойная кавычка |
| \&apos; | ' | Одинарная кавычка (апостроф) |

Не смотря на то, что по умолчанию создано всего пять сущностей, вы можете добавить в документ свои сущности используя [Document Type Definition](/ru/docs/Glossary/DTD "en/DTD"). Например, создать новую `&warning;` сущность, можно так:

```
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE body [
<!ENTITY warning "Предупреждение: произошла ошибка, обновите и попробуте ещё раз.">
]>
<body>
<message> &warning; </message>
</body>
```

Также вы можете использовать нумерические ссылки для специфический специальных символов. Например, \&#xA9; - это символ "©".

## Отображение XML

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

Один из методов отображения XML - указать [CSS](/ru/docs/Web/CSS "ru/CSS") (чтобы использовать в документе нужно прописать инструкцию `xml-stylesheet`, как показано в примере ниже).

```
<?xml-stylesheet type="text/css" href="stylesheet.css"?>
```

Есть также много других мощных методов отображения XML, например, [XSLT](/ru/docs/Web/XSLT "en/XSLT")(англ. **Extensible Stylesheet Language Transformations**), который может использоваться для преобразование XML в другие языки такие, как HTML. Это делает XML очень универсальным.

```
<?xml-stylesheet type="text/xsl" href="transform.xsl"?>
```

## Рекомендации

Эта статья является очень маленьким введением в XML, с очень маленьким количеством примеров и ссылок для того, чтобы вы могли начать работать с этим языком. Чтобы больше узнать про XML, вам придётся искать информацию и более информативные статьи в интернете.

Изучайте [HTML](/ru/docs/Web/HTML "ru/HTML") (англ. HyperText Markup Language), знание HTML поможет вам лучше понять XML.

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

- [XML.com](http://www.xml.com/)
- [Extensible Markup Language (XML) @ W3.org](https://www.w3.org/XML/)
- [XML Example: A List Apart](http://www.alistapart.com/d/usingxml/xml_uses_a.html)
- [Using XML: A List Apart](http://www.alistapart.com/articles/usingxml/)

Статья [Using XML](http://www.alistapart.com/articles/usingxml/) - отличный ресурс с большим количеством информации о создании своего языка на основе XML.

0 comments on commit cd964ef

Please sign in to comment.