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 FeatureDocbookAsciiDoc

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
====

All FreeBSD documents are available for download at https://download.freebsd.org/ftp/doc/

Questions that are not answered by the documentation may be sent to <freebsd-questions@FreeBSD.org>.
Send questions about this document to <freebsd-doc@FreeBSD.org>.