# Chapter 7. Rosetta Stone

## 7.1. Comparison between Docbook and AsciiDoc

This rosetta stone tries to show the differences between Docbook and AsciiDoc.

Table 1. Comparison between Docbook and AsciiDoc
Language Feature | Docbook | AsciiDoc
--- | --- | ---
Bold | <strong>bold</strong> | *bold*
Italic | <emphasis>Italic</emphasis> | _Italic_
Monospace | <literal>Monospace</literal> | `Monospace`
Paragraph | <para>This is a paragraph</para> | This is a paragraph
Keycap | <keycap>F11</keycap> | kbd:[F11]
Links |
    <link xlink:href="https://www.freebsd.org/where/">Download FreeBSD</link>
    link:https://www.freebsd.org/where/[Download FreeBSD]
Sections |
      <sect1 xml:id="id">
        <title>Section 1</title>
      </sect1>
     [[id]]
     = Section 1
Unordered list |
    <itemizedlist>
      <listitem>
        <para>When to build a custom kernel.</para>
      </listitem>

      <listitem>
        <para>How to take a hardware inventory.</para>
      </listitem>
    </itemizedlist>
    * When to build a custom kernel.
    * How to take a hardware inventory.
Ordered list |
    <orderedlist>
      <listitem>
        <para>One</para>
      </listitem>
      <listitem>
        <para>Two</para>
      </listitem>
      <listitem>
        <para>Three</para>
      </listitem>
      <listitem>
        <para>Four</para>
      </listitem>
    </orderedlist>
    . One
    . Two
    . Three
    . Four
Variable list |
    <variablelist>
      <varlistentry>
        <term>amd64</term>
        <listitem>
          <para>This is the most common desktop...</para>
        </listitem>
      </varlistentry>
    </variablelist>
    amd64::
    This is the most common desktop...
Source code |
    <screen>
      &prompt.root; <userinput>mkdir -p /var/spool/lpd/lp</userinput>
    </screen>
    [source,shell]
    ----
    # mkdir -p /var/spool/lpd/lp
    ----
Literal block |
    <programlisting>
    include GENERIC
    ident MYKERNEL

    options         IPFIREWALL
    options         DUMMYNET
    options         IPFIREWALL_DEFAULT_TO_ACCEPT
    options         IPDIVERT
    </programlisting>
    ....
    include GENERIC
    ident MYKERNEL

    options         IPFIREWALL
    options         DUMMYNET
    options         IPFIREWALL_DEFAULT_TO_ACCEPT
    options         IPDIVERT
    ....
Images |
    <figure xml:id="bsdinstall-newboot-loader-menu">
      <title>FreeBSD Boot Loader Menu</title>

      <mediaobject>
        <imageobject>
          <imagedata fileref="bsdinstall/bsdinstall-newboot-loader-menu"/>
        </imageobject>
        <textobject>
          </literallayout>ASCII art replacement is no longer supported.</literallayout>
        </textobject>
        <textobject>
          <phrase>The FreeBSD loader menu, with options 1-6 to boot
              multi-user, boot single user, escape to loader prompt, reboot,
              select a kernel to load, and select boot options</phrase>
        </textobject>
      </mediaobject>
    </figure>
    [[bsdinstall-newboot-loader-menu]]
    .FreeBSD Boot Loader Menu
    image::bsdinstall/bsdinstall-newboot-loader-menu[The FreeBSD loader menu, with options 1-6 to boot multi-user, boot single user, escape to loader prompt, reboot, select a kernel to load, and select boot options]
Includes | n/a |
    include::chapter.adoc[]
Tables |
    <table xml:id="partition-schemes" frame="none" rowsep="1" pgwide="1">
      <title>Partitioning Schemes</title>

      <tgroup cols="2" align="left">
        <thead>
          <row>
            <entry align="left">Abbreviation</entry>
            <entry align="left">Description</entry>
          </row>
        </thead>

        <tbody>
          <row>
            <entry>APM</entry>
            <entry>Apple Partition Map, used by PowerPC(R).</entry>
          </row>
        </tbody>
      </tgroup>
    </table>
    [[partition-schemes]]
    .Partitioning Schemes
    [cols="1,1", frame="none", options="header"]
    |===
    | Abbreviation
    | Description

    |APM
    |Apple Partition Map, used by PowerPC(R).

    |===
Admonitions |
    <tip>
      <para>This is a tip</para>
    </tip>
    [TIP]
    ====
    This is a tip
    ====

Last modified on: March 9, 2024 by Danilo G. Baio

Prev
Home
Next