_index.adoc

---
description: 'Розеттский камень с различиями между Docbook и AsciiDoc'
next: books/fdp-primer/translations
params:
  path: /books/fdp-primer/rosetta/
prev: books/fdp-primer/asciidoctor-primer
showBookMenu: 'true'
tags: ["rosetta", "docbook", "asciidoc", "comparison"]
title: 'Глава 7. Розеттский камень'
weight: 8
---

[[rosetta]]
= Розеттский камень
:doctype: book
:toc: macro
:toclevels: 1
:icons: font
:sectnums:
:sectnumlevels: 6
:sectnumoffset: 7
:partnums:
:source-highlighter: rouge
:experimental:
:images-path: books/fdp-primer/

ifdef::env-beastie[]
ifdef::backend-html5[]
:imagesdir: ../../../../images/{images-path}
endif::[]
ifndef::book[]
include::shared/authors.adoc[]
include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
include::shared/attributes/attributes-{{% lang %}}.adoc[]
include::shared/{{% lang %}}/teams.adoc[]
include::shared/{{% lang %}}/mailing-lists.adoc[]
include::shared/{{% lang %}}/urls.adoc[]
toc::[]
endif::[]
ifdef::backend-pdf,backend-epub3[]
include::../../../../../shared/asciidoctor.adoc[]
endif::[]
endif::[]

ifndef::env-beastie[]
toc::[]
include::../../../../../shared/asciidoctor.adoc[]
endif::[]

[[docbook-vs-asciidoc]]
== Сравнение Docbook и AsciiDoc

Эта шпаргалка пытается показать различия между Docbook и AsciiDoc.

.Сравнение Docbook и AsciiDoc
[cols="1,4,4"]
|===
|Языковая функция |Docbook | AsciiDoc

|*Жирный*
|<strong>жирный</strong>
|\*жирный*

|*Курсив*
|<emphasis>Курсив</emphasis>
|\_Курсив_

|*Моноширинный*
|<literal>Моноширинный</literal>
|\`Моноширинный`

|*Абзац*
|<para>Это абзац</para>
|Это абзац

|*Клавиша*
|<keycap>F11</keycap>
|\kbd:[F11]

|*Ссылки*
a| 
[source,xml]
----
<link xlink:href="https://www.freebsd.org/where/">
Загрузить FreeBSD</link>
----
a| 
[source]
----
link:https://www.freebsd.org/where/[Загрузить FreeBSD]
----

|*Разделы*
a| 
[source,xml]
----
 <sect1 xml:id="id">
 <title>Раздел 1</title>
 </sect1>
----
a| 
[source]
----
 [[id]]
 = Раздел 1
----

|*Неупорядоченный список*
a| 
[source,xml]
----
<itemizedlist>
  <listitem>
    <para>Когда следует собирать собственное ядро.</para>
  </listitem>

  <listitem>
    <para>Как выполнить инвентаризацию оборудования.</para>
  </listitem>
</itemizedlist>
----
a| 
[source]
----
* Когда необходимо собрать собственное ядро.
* Как выполнить инвентаризацию оборудования.
----

|*Упорядоченный список*
a| 
[source,xml]
----
<orderedlist>
  <listitem>
    <para>Один</para>
  </listitem>
  <listitem>
    <para>Два</para>
  </listitem>
  <listitem>
    <para>Три</para>
  </listitem>
  <listitem>
    <para>Четыре</para>
  </listitem>
</orderedlist>
----
a| 
[source]
----
. Один
. Два
. Три
. Четыре
----

|*Словарный список (Variable list)*
a| 
[source,xml]
----
<variablelist>
  <varlistentry>
    <term>amd64</term>
    <listitem>
      <para>Это наиболее распространённая десктопная...</para>
    </listitem>
  </varlistentry>
</variablelist>
----
a| 
[source]
----
amd64::
Это наиболее распространённая десктопная...
----

|*Исходный код*
a| 
[source,xml]
----
<screen>
 &prompt.root; <userinput>mkdir -p /var/spool/lpd/lp</userinput>
</screen>
----
a| 
[source]
....
[source,shell]
----
# mkdir -p /var/spool/lpd/lp
----
....

|*Неформатируемый блок*
a| 
[source,xml]
----
<programlisting>
include GENERIC
ident MYKERNEL

options  IPFIREWALL
options  DUMMYNET
options  IPFIREWALL_DEFAULT_TO_ACCEPT
options  IPDIVERT
</programlisting>
----
a| 
[source]
----
....
include GENERIC
ident MYKERNEL

options  IPFIREWALL
options  DUMMYNET
options  IPFIREWALL_DEFAULT_TO_ACCEPT
options  IPDIVERT
....
----

|*Изображения*
a| 
[source,xml]
----
<figure xml:id="bsdinstall-newboot-loader-menu">
  <title>Меню загрузчика FreeBSD</title>

  <mediaobject>
    <imageobject>
      <imagedata fileref="bsdinstall/bsdinstall-newboot-loader-menu"/>
    </imageobject>
    <textobject>
      </literallayout>
      Поддержка ASCII-графики более не предоставляется.
      </literallayout>
    </textobject>
    <textobject>
      <phrase>Меню загрузчика FreeBSD с вариантами 1-6 для загрузки
      в многопользовательском режиме, однопользовательском
      режиме, перехода в командную строку загрузчика, перезагрузки,
      выбора ядра для загрузки и параметров загрузки</phrase>
    </textobject>
  </mediaobject>
</figure>
----
a| 
[source]
----
[[bsdinstall-newboot-loader-menu]]
.Меню загрузчика FreeBSD
image::bsdinstall/bsdinstall-newboot-loader-menu[Меню загрузчика FreeBSD с вариантами 1-6: загрузка многопользовательского режима, загрузка однопользовательского режима, переход в командную строку загрузчика, перезагрузка, выбор ядра для загрузки и параметров загрузки]
----

|*Включение файла*
|не доступно
a| 
[source]
----
\include::chapter.adoc[]
----

|*Таблицы*
a| 
[source,xml]
----
<table xml:id="partition-schemes" frame="none" rowsep="1" pgwide="1">
 <title>Схемы разделов</title>

 <tgroup cols="2" align="left">
 <thead>
 <row>
 <entry align="left">Сокращение</entry>
 <entry align="left">Описание</entry>
 </row>
 </thead>

 <tbody>
 <row>
 <entry>APM</entry>
 <entry>Карта разделов Apple, используется в PowerPC(R).</entry>
 </row>
 </tbody>
 </tgroup>
</table>
----
a| 
[source]
----
[[partition-schemes]]
.Схемы разделов
[cols="1,1", frame="none", options="header"]
\|===
\| Сокращение
\| Описание

\|APM
\|Apple Partition Map, используется на PowerPC(R).

\|===
----

|*Блоки-уведомления*
a| 
[source,xml]
----
<tip>
 <para>Это подсказка</para>
</tip>
----
a| 
[source]
----
[ПОДСКАЗКА]
====
Это подсказка
====
----

|===