Laws.Africa Editor Guide
English
English
  • Welcome
  • Getting started
    • Lesson plan
    • Signing up
    • Digitising legislation
    • What is Akoma Ntoso
    • Terminology guide
  • Managing Works
    • Creating and editing works
      • Working with commencements
    • Deleting a document
    • Amending works
      • Creating the amending work
      • Linking the amendment
      • Creating a new document at the new point in time
      • Applying the amendments
      • Annotating the amendments
      • Example
      • Exercise
      • Consolidating the annotations
        • Simple example
        • Complicated example
    • Bulk imports (spreadsheet)
  • How-tos
    • Tasks
    • Importing a document
      • The importer
    • Cleaning up an import
    • Going back to a previous version of a document
    • Fixing all-caps headings
    • Working with tables
      • Table errors
    • Working with links
    • Working with italicised terms
    • Inserting an image
    • Inserting special characters
    • Resolving editor warnings
    • Making comments
    • Inserting editorial notes
    • Changing a document's date
    • Changing a document's short title or language
    • Search and rescue
    • How to handle different language documents
    • How to mark up defined terms which do not occur in a Definitions section
    • Very complicated amendments
      • Research
      • Undo some amendments?
      • Update the timeline
      • Create the tasks
      • Apply the amendments
  • Markup guide
    • Introduction
    • Marking up the structure
    • Preface, Long title, and Preamble
    • Headings
    • Marking up Schedules / Annexes
    • Marking up annotations
    • Marking up tables
    • Marking up links
    • Marking up images
    • Marking up footnotes
    • Marking up formatting
    • Marking up insertions and deletions
    • Keyword reference
  • Reviewing a document
    • Reviewing a document
    • Reviewer checklist
    • Signing off a work
  • Style Guides
    • Laws.Africa
    • Côte d'Ivoire
    • Ghana
    • Namibia
      • Regulations
    • Lesotho
    • Malawi
    • Nigeria
    • Zambia
    • South African Acts
    • South African By-laws
    • Tanzania
    • Uganda
    • UNEP
    • Zimbabwe
    • Seychelles
    • Mauritius
    • Pan-African Parliament/ AGP
    • Turks and Caicos
    • Papua New Guinea
    • eSwatini
    • Rwanda
    • Documents in languages other than English
  • Administration
    • Site settings
    • Managing administrators
    • Countries and localities
    • Document subtypes
    • Task labels
    • Taxonomies
    • Notion templates
Powered by GitBook
On this page
  • How to mark up Chapters
  • How to mark up Parts
  • How to mark up Subparts
  • How to mark up Crossheadings
  • Exercise
  1. Markup guide

Headings

PreviousPreface, Long title, and PreambleNextMarking up Schedules / Annexes

Last updated 3 years ago

Chapters and Parts are often used to group sections. Sometimes a Chapter will contain Parts, and sometimes a Part will contain Chapters. Subparts serve the same function, but usually only have a number (or letter) and a heading. Crossheadings don't group sections and they never have a number; they are standalone 'headings' and are not preferred.

How to mark up Chapters

  1. Enter Edit mode.

  2. On one line, start a Chapter with CHAP <number> - <heading>.

  3. The number and heading are both optional.

  4. The heading should use , not ALL CAPS.

  5. Use "space hyphen space" between the number and the heading.

  6. Put the contents of the Chapter on the following lines, indented.

If the Chapter doesn't have a number, you should still use a hyphen before the heading – otherwise the heading will be recorded as the number in the XML.

Example

CHAP 2 - Interpretation

  SEC 2. - Terms

    The following terms shall be interpreted …

How to mark up Parts

  1. Enter Edit mode.

  2. On one line, start a Part with PART <number> - <heading>.

  3. The number and heading are both optional.

  4. Use "space hyphen space" between the number and the heading.

  5. Put the contents of the Part on the following lines, indented.

If the Part doesn't have a number, you should still use a hyphen before the heading – otherwise the heading will be recorded as the number in the XML.

Example

PART 2 - Tariffs

  SEC 4. - Calculating tariffs

    Tariffs shall be calculated …

How to mark up Subparts

  1. Enter Edit mode.

  2. On one line, start a Subpart with SUBPART <number> - <heading>.

  3. The number and heading are both optional.

  4. Use "space hyphen space" before the heading.

  5. Put the contents of the Subpart on the following lines, indented.

If the Subpart doesn't have a number, you should still use a hyphen before the heading – otherwise the heading will be recorded as the number in the XML.

Example

SUBPART A - Fines

  SEC 6. - Calculating fines

    SUBSEC (1)

      Fines should never …

How to mark up Crossheadings

Only use Crossheadings when no other type of heading or grouping makes sense. This happens most often in Schedules.

  1. Enter Edit mode.

  2. On one line, mark text as a heading with CROSSHEADING <the heading>.

Example

SCHEDULE First Schedule
  SUBHEADING Laws Repealed

  Regular text.

  CROSSHEADING A heading

  More regular text.

Exercise

  1. In Edit mode, copy and paste the following content into your editor.

  2. Correct it so that it looks like the screenshot below in View mode.

    1. Chapter 2 should have the correct heading (using Sentence case).

    2. Part 1 should have the correct heading (also using Sentence case).

    3. The first Subpart should contain sections 5 and 6.

    4. The second Subpart should contain sections 7 and 8.

2
GENERAL

Part: 1
Municipal Services and Taxes

Services

5. Rubbish removal

Rubbish removal will be …

6. Stormwater drainage

Stormwater should …

Taxes

7. Calculating taxes

Taxes are …

8. Paying taxes

Taxes should …

Your goal is to make it look like this:

The heading should use , not ALL CAPS.

The heading should use , not ALL CAPS.

The heading should use , not ALL CAPS.

Sentence case
Sentence case
Sentence case
Sentence case