Use ol to make an ordered list, and ul to make an unordered (bulleted) list. In both cases, use li for each entry. If an entry contains more than one paragraph, then each must be wrapped in p.
This section contains nested lists, to demonstrate how they get assigned labels (numbering, symbols). But we begin with two simple lists, demonstrating an ordered list and an unordered list. See the end of section for an example of a description list. Since Jupyter notebooks use markdown syntax, their lists are less flexible. So some assertions here may be wrong when viewed as a Jupyter notebook. Note in the source the optional use of a paragraph (p) for the list items.
Red
Green
Yellow
Purple
Next, we have a list with no customization and multiple levels to test the defaults. LaTeX allows a maximum of four levels of ordered/numbered lists, and a total of six levels if some unordered lists are mixed in. The second-level defaults (lower-case Latin) are formatted slightly different in LaTeX versus HTML. The HTML style is not easy to adjust, but you can specify the LaTeX version to match if it is important. The default order of the labels in Markdown/Jupyter (Arabic, Latin, latin, roman) is different than for LaTeX and HTML (Arabic, latin, roman, Latin), so cross-references are not correct. Note that to have nested lists you must structure your list items as paragraphs, since a list may only appear within a p element.
Level 1, first.
Level 1, second.
Level 2, first.
Level 2, second.
Level 3, first.
Level 3, second.
Level 4, first.
Level 4, second.
Level 4, third.
Level 3, third.
Level 2, third.
Level 1, third.
Items in ordered lists may be be give an xml:id and then may be the target of an xref. We test three here, referencing down into the hierarchy above. Level 1, second: 2. Level 3, second: 2.b.ii. Level 4, third: 2.b.ii.C.
And now a four-level deep unordered list with the default labels supplied by MBX (disc, circle, square, disc). Again, the defalt order for Markdown/Jupyter (disc, square, circle, circle) is different than for LaTeX and HTML (disc, circle, square, disc)
Level 1, first.
Level 1, second.
Level 2, first.
Level 2, second.
Level 3, first.
Level 3, second.
Level 4, first.
Level 4, second.
Level 4, third.
Level 3, third.
Level 2, third.
Level 1, third.
And a total of six levels with a mix of ordered and unordered lists, the most that out-of-the-box-LaTeX is able to handle.
Level 1, first.
Level 1, second.
Level 2, first.
Level 2, second.
Level 3, first.
Level 3, second.
Level 4, first.
Level 4, second.
Level 5, first.
Level 5, second.
Level 6, first.
Level 6, second.
Level 6, third.
Level 5, third.
Level 4, third.
Level 3, third.
Level 2, third.
Level 1, third.
Now, nested lists with the defaults replaced by custom choices. First, an ordered list, three deep, upper Roman numerals, then upper-case Latin, then more traditional Arabic numerals on the three elements of the third level. Note the adornments of the labels will be rendered in LaTeX, but not in HTML, and the label specifications have no effect in a Jupyter notebook.
Level 1, first.
Level 1, second.
Level 2, first.
Level 2, second.
Level 3, first.
Level 3, second.
Level 3, third.
Level 2, third.
Level 1, third.
A nested unordered list, with labels given as squares on the outer list and nothing (blank) on the inner lists.
Level 1, first.
Level 1, second.
Level 2, first.
Level 2, second.
Level 1, third.
A nested ordered list, to test intramural cross-references.
Level 1, first.
Level 1, second.
Level 2, first.
Level 2, second.
Level 1, third. With a cross-reference to second list item, 2.
Level 1, fourth. Whose number should not change when knowl just prior is opened.
The next definition is very poorly worded. It is meant to test leading off with a list (bad form), for which LaTeX normally begins right after the heading.
For every element \(b\text{,}\) there is an element \(c\) (the inverse), such that
\begin{equation*} b\cdot c=c\cdot b = e\text{.} \end{equation*}If these conditions are met for a set \(G\text{,}\) then we say \(G\) is a group.
Exercises and References are specialized subdivisions you can put anywhere. They are implemented as top-level lists, so should share behavior. For example, an exercise may have many parts and when expressed as a list, should have the expected labels.
Similarly, References may have lists in their annotations. Unlikely? But possible.
The next two subdivisions are an Exercises subdivision and a References subdivision, which have lists within an exercise and a bibliographic item (respectively).
This is a short list that ends a subsection, so can be used to address the necessary spacing. We also test two XML elements separated by a space (which should not go missing).
This is another short list that ends a subsection, so can be used to address the necessary spacing.
This exercise should have several parts, and labels should follow the defaults for second-level lists (since the exercise is numbered according to the top-level default).
Exercise 1, first part.
Exercise 1, second part.
Exercise 1, second part, first refinement.
Exercise 1, third part.
| 1111, 2222 | 3333 | |
| aaaa | bbbb,cccc | |
| AAAA | BBBB | CCCC |
This exercise (a list item really) has a table first. Default LaTeX aligns it vertically above the exercise number. Placement here tests correcting that alignment.
A small test of cross-references to subsidiary parts of exercises. Exercise 1, third part: 12.4.1.c. Exercise 1, second part, first refinement: 12.4.1.b.i.
Use dl to make a description list. Inside of those tags, use li for each entry. Then, use title to specify the term being described and p to specify the description.
A “description” list has a short term or phrase that is prominent, followed by a short description. It is modeled on the lists of similar structure in both LaTeX and HTML. It makes for a nice medium-weight way to define terms, somewhere in-between the term tag which just makes a term prominent in a sentence, and a definition, which is set off, has a heading, a number, and a title. This example is from Bob Plantz.
Controls most of the activities of the computer, performs the arithmetic and logical operations, and contains a small amount of very fast memory.
Provides storage for the instructions for the CPU and the data they manipulate.
Communicates with the outside world and with mass storage devices (e.g., disks).
A communication pathway with a protocol specifying exactly how the pathway is used.
Some presentations can be assisted by a hint from the author about the lengths of the titles. You can choose to provide a width attribute on a dl element with possible values narrow, medium, and wide. Conversion to LaTeX ignores this attribute, and conversion to HTML only reacts to narrow (medium is the default, and wide behaves identically).
The color of the sun at sunset.
The color of a clear sky.
The color of shallow tropical waters.
Sorry, not a color but testing titles with math in them.
A list can be wrapped with a <list> element, so that it earns a number, can be given a title and have an introduction and conclusion. Cross-references to individual list items get a bit absurd as they are prefixed with the number of the list and then the number of the item, so conceivably you could get a number like 4.5.3:2.a.ii.
Because the colors are always in the same order, an ordered list is natural here. The colors change continuously, but are often divided up into large ranges that human perception can easily distinguish.
Red
Orange
Yellow
Green
Blue
Indigo
Violet
So some people use the acronym ROY-G-BIV to remember this sequence.
This is a paragraph with three lists contained within it. For HTML output we have to “inside-out” the lists.
In other words, the text before, after, and between, needs to each be encapsulated as an HTML p element of its own.
Including definition lists.
A one item definition list.
That's all!
A one item list, whose item is a paragraph with two contained ordered lists, separated by text.
Introductory text.
Intermediate text.
Concluding text.
A list in a paragraph is a construction in HTML that browsers try to correct, which leads to unpredictable results, so we have to decompose an author's paragraph with lists into a sequence of HTML paragraphs, interrupted by lists. This subsection is only relevant to HTML output, and only for testing.
Now the paragraph continues, and we have an index item here, so we can test cross-references back here.
Here is the annotation and an ordered list as part of that annotation.
