Quoting list items - electricbookworks/constitution GitHub Wiki

Some annexures contains quoted passages. The original quotation uses quote marks. We are going to use blockquotes, which are more sematically correct and can be better controlled with styling.

The quoted passages include list numbering that starts at, say, '2'. In HTML, by default an ordered list will always start at 1. But here we need to start the list at 2.

To do that, we have to add the attribute start='2' to the list.

In Annexure A, that looks like this, at section 2:

2.	The replacement of item 2 with the following item:

	> 2. The seats in the National Assembly as determined in terms of section 46 of the new Constitution, shall be filled as follows:
	> 	1.	One half of the seats from regional lists submitted by the respective parties, with a fixed number of seats reserved for each region as determined by the Commission for the next election of the Assembly, taking into account available scientifically based data in respect of voters, and representations by interested parties.
	> 	1.	The other half of the seats from national lists submitted by the respective parties, or from regional lists where national lists were not submitted.”.
	> {:start='2'}

Note that the indentation of the {:start='2'} tag must:

  1. match the indentation of the list item you want to affect; in this case, the 2. The seats…; and
  2. be placed after any sub items in the list.

To see what that looks like output, paste that markdown into kramdown.herokuapp.com. Also add this CSS to Settings > Custom styles:

ol li {
  list-style-type: decimal; }

ol li li {
  list-style-type: lower-alpha; }

ol li li li {
  list-style-type: lower-roman; }

ol li blockquote li {
  list-style-type: decimal; }

ol li blockquote li li {
  list-style-type: lower-alpha; }

ol li blockquote li li li {
  list-style-type: lower-roman; }

Exceptions

When the quoted passage starts with a second- or third-level list number (e.g. (a)), it's fine to just use the manual list number in this format. Markdown will not turn (a) into an HTML autonumbered list. For an example, see Annexure A, section 6:

6.	The amendment of item 7(3) by replacing paragraph (b) with the following paragraph:

	> (b) An amended quota of votes per seat shall be determined by dividing the total number of votes cast nationally, minus the number of votes cast nationally in favour of the party referred to in paragraph (a), by the number of seats in the Assembly, plus one, minus the number of seats finally allocated to the said party in terms of paragraph (a).

Annexure D also contains several similar issues.

When the quote includes a section heading (which we number), do not mark the heading as a heading (it should not appear in the table of contents generated from headings), and escape the autonumbering with a slash before the period in the number. For example, see Annexure A section 9:

9.	The replacement of item 16 with the following item:

	> 16\. Designation of representatives
	>
	1.	After the counting of votes has been concluded, the number of representatives of each party has been determined and the election result has been declared in terms of section 190 of the new Constitution, the Commission shall, within two days after such declaration, designate from each list of candidates, published in terms of national legislation, the representatives of each party in the legislature.\\
	1.	Following the designation in terms of subitem (1), if a candidate’s name appears on more than one list for the National Assembly or on lists for both the National Assembly and a provincial legislature (if an election of the Assembly and a provincial legislature is held at the same time), and such candidate is due for designation as a representative in more than one case, the party which submitted such lists shall, within two days after the said declaration, indicate to the Commission from which list such candidate will be designated or in which legislature the candidate will serve, as the case may be, in which event the candidate’s name shall be deleted from the other lists.\\
	1.	The Commission shall forthwith publish the list of names of representatives in the legislature or legislatures.”..

The slash (an 'escape character') before the period means markdown won't convert this number and text into a numbered HTML list.