UniWiki:Manual of Style/Lists: Difference between revisions

Line 96:

The Title provides a direct edit point, if one enables [[Wikipedia:Wikipedia:Section editing|section editing]]. It also enables the automatic table of contents system to detect the list. It is not required, however.

In particular, '''do not double-space the lines of the list''' by leaving blank lines or extra HTML <nowiki><br></nowiki> tags after them.

In particular, '''do not double-space the lines of the list''' by leaving blank lines or extra HTML <nowiki><br></nowiki> tags after them. Doing this actually produces three lists with one item each! This can adversely affect machine-readability of the content if a continuous list is expected.<ref>Blank lines cause particular problems for users of [[Wikipedia:Screen reader|screen readers]]. A badly formatted example would be read out loud like this: "List of 1 items: Example 1, list end. List of 1 items: Example 2, list end. List of 1 items: Example 3, list end." Improper formatting can more than triple the length of time it takes to read the list.</ref> Moreover in certain web browsers, the extra white-space between one singular list and the next can have a visually jarring effect.

~~Doing this actually produces three lists with one item each! Notice~~ the ~~rendered HTML in which there are as many <ul> tags as <li> tags. This can adversely affect machine-readability~~ of the content if a continuous list is expected.<ref>Blank lines cause particular problems for users of [[screen reader]]s. The badly formatted example above is read out loud like this: "List of 1 items: Example 1, list ~~end. List of 1 items: Example 2~~, ~~list end. List of 1 items: Example 3, list end." Improper formatting can more than triple~~ the ~~length of time it takes to read~~ the ~~list.</ref> Moreover~~ in ~~certain web browsers, the extra white-space between one singular list and the next can have a visually jarring effect~~.

To float pictures to the right of the list, one should put the image markup before the first item in most cases.

~~To float pictures to the right of the list, one should put the image markup before the first item in most cases, see the example "A" at right:~~

Inserting the image markup as a separate line within the list once again will split it into two half-lists.

Inserting the image markup as a separate line within the list ~~(as in example "B")~~ once again will split it into two half-lists.

Should the length of the list items or the topical relevance of said image discourage display at the top corner, consider placing it after the asterisk of the first list-item it illustrates ~~(as in example "C")~~ to avoid breaking continuity of the unordered list ({{~~code~~|<ul>}}) element.

Should the length of the list items or the topical relevance of said image discourage display at the top corner, consider placing it after the asterisk of the first list-item it illustrates to avoid breaking continuity of the unordered list ({{tag|ul}}) element.

'''Note''': Avoid floating images to the left of a list as this disrupts the indentation of the bullet-points, making the hierarchy of list-items more difficult for readers to ascertain.

@@ Line 96: / Line 96: @@
 The Title provides a direct edit point, if one enables [[Wikipedia:Wikipedia:Section editing|section editing]]. It also enables the automatic table of contents system to detect the list. It is not required, however.
-In particular, '''do not double-space the lines of the list''' by leaving blank lines or extra HTML <nowiki><br></nowiki> tags after them.
+In particular, '''do not double-space the lines of the list''' by leaving blank lines or extra HTML <nowiki><br></nowiki> tags after them. Doing this actually produces three lists with one item each! This can adversely affect machine-readability of the content if a continuous list is expected.<ref>Blank lines cause particular problems for users of [[Wikipedia:Screen reader|screen readers]]. A badly formatted example would be read out loud like this: "List of 1 items: Example 1, list end. List of 1 items: Example 2, list end. List of 1 items: Example 3, list end." Improper formatting can more than triple the length of time it takes to read the list.</ref> Moreover in certain web browsers, the extra white-space between one singular list and the next can have a visually jarring effect.
-Doing this actually produces three lists with one item each! Notice the rendered HTML in which there are as many &lt;ul&gt; tags as &lt;li&gt; tags. This can adversely affect machine-readability of the content if a continuous list is expected.<ref>Blank lines cause particular problems for users of [[screen reader]]s. The badly formatted example above is read out loud like this: "List of 1 items: Example 1, list end. List of 1 items: Example 2, list end. List of 1 items: Example 3, list end." Improper formatting can more than triple the length of time it takes to read the list.</ref> Moreover in certain web browsers, the extra white-space between one singular list and the next can have a visually jarring effect.
+To float pictures to the right of the list, one should put the image markup before the first item in most cases.
-To float pictures to the right of the list, one should put the image markup before the first item in most cases, see the example "A" at right:
+Inserting the image markup as a separate line within the list once again will split it into two half-lists.
-Inserting the image markup as a separate line within the list (as in example "B") once again will split it into two half-lists.
-Should the length of the list items or the topical relevance of said image discourage display at the top corner, consider placing it after the asterisk of the first list-item it illustrates (as in example "C") to avoid breaking continuity of the unordered list ({{code|<ul>}}) element.
+Should the length of the list items or the topical relevance of said image discourage display at the top corner, consider placing it after the asterisk of the first list-item it illustrates to avoid breaking continuity of the unordered list ({{tag|ul}}) element.
 '''Note''': Avoid floating images to the left of a list as this disrupts the indentation of the bullet-points, making the hierarchy of list-items more difficult for readers to ascertain.