summaryrefslogtreecommitdiffstats
path: root/source-builder/sb/asciidoc/examples/website/newlists.txt
blob: 3edc3a7d62d3c65d9decbe3ba0289a2104fa2520 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
AsciiDoc New Lists
==================

*New in version 8.3.0*

Lists can now be styled like other block elements, this allows the
normal bulleted and labeled list syntax to be used for 'glossary',
'qanda' (Question and Answer) and 'bibliography' lists instead of
having to remember a different syntax for each one. In the same vein
there is only one labeled list syntax, horizontal labeled lists are
rendered by applying the 'horizontal' style. Examples:

---------------------------------------------------------------------
[glossary]
A glossary term::
    The corresponding definition.
A second glossary term::
    The corresponding definition.

[horizontal]
Lorem:: Fusce euismod commodo velit.
Ipsum:: Vivamus fringilla mi eu lacus.
---------------------------------------------------------------------

The list related stuff in the configuration files has been
rationalized with separate 'listtags-\*' sections (c.f. table
'tabletags-*' sections). The old list tags are no longer supported so
you'll need to update your custom configuration file list definitions.

These changes necessitated the following backward incompatibilities:

. You have to explicitly precede horizontal labeled lists with the
  `[horizontal]` style attribute -- if you do nothing the existing
  horizontal labeled lists will be rendered vertically.
. The old 'compact' list style is now implemented as a list option, to
  update replace `[compact]` with `[options="compact"]`. You can now
  apply the 'compact' option globally by setting the `compact-option`
  document attribute.
. You'll need to update any customized configuration file list
  definitions that have been made.