
## Basic Asciidoc

Scripta documents are written in `Asciidoc-LaTeX`, an extension of the Asciidoc markup language which incorporates LaTeX for writing mathematical text. In this section we discuss the bare minimum that you need for common writing tasks — sections, italics and bold type, lists, cross-references, etc. In the next section we will dicuss the bare minimum for writing mathematical text.

### Text

paragraphs

Just write like you would write an email (go for it!), Separate paragraphs by one or more blank lines.

verbatim text

Verbatim text is "as-is" text with no formatting, like this:

```This
is verbatim
text!```

It looks exactly as written. One way of writing a paragraph of verbatim text is to begin the first line with a space. If your rendered doesn’t look like what you wanted, you may have accidentally started the paragraph with a space.

bold-face

Write bold-face text like this: *bold-face text*.

italic

Write italic text like this: _italic text_.

sections

Precede a section heading by ==, a subsection heading by ===, and so on, like this:

```== Introduction

== Conservation Laws

=== Energy

=== Momentum```

Be sure to start the `=` right at the left margin.

References to a web site can be inserted verbatim, as in

or they can be "dressed up" like

For the latter, we say this:

`    https://en.wikipedia.org/wiki/Prime_number_theorem[Prime Number Theorem]`
numbered lists

Here is a numbered list

1. Eggs

2. Bacon

3. Strawberry Jam

You write it like this

```. Eggs
. Bacon
. Strawberry Jam```

Each item begins with a dot at the left margin.

itemized lists

Here is an itemized list

• Eggs

• Bacon

• Strawberry Jam

You write it like this

```* Eggs
* Bacon
* Strawberry Jam```

### Images

images

Images can be uploaded to Scripta by clicking on the icon. When you upload an image, its ID number will appear next to the icon. Place your cursor where you want to place the image, then click on the ID number. You can also search the image database for images to use. The image below was inserting by writing image ::458[]

There are many ways to control formatting, e.g.,

image ::458[width=200],   image ::458[float=left],   etc.