Law Widget Styles

Stylesheets for use with HTML documents published using the Indigo platform. They make Akoma Ntoso documents look beautiful.

Usage

First, wrap your Akoma Ntoso HTML content with the .akoma-ntoso class, such as:

<div class="akoma-ntoso">...</div>

Second, include the CSS as described below.

From CDN

Use the assets directly from the jsDelivr CDN:

<link rel="stylesheet" type="text/css" href="https://cdn.jsdelivr.net/npm/@lawsafrica/[email protected]/css/law-widget-styles.min.css">

From your server

Install law-widget-styles using npm:

$ npm install @lawsafrica/law-widget-styles

Then use either the compiled CSS:

<link rel="stylesheet" type="text/css" href="law-widget-styles/css/law-widget-styles.min.css">

Or use the SCSS files:

@import '@lawsafrica/law-widget-styles/scss/law-widget-styles';

Building

GitHub actions will automatically build and commit changes when they are merged to the master branch. To build changes manually:

• npm install
• npm run build
• git add css/*

Testing

To run screenshot-based tests:

• npm run test-images

To update the output of these tests:

• Update the relevant .html file
• Delete the relevant snapshot in _image_snapshots_
• Run the tests, which will produce a fresh snapshot
• Check the new snapshot and commit it

Release process

• test: npm run test-images (these aren't run on GitHub because of font variations between OSes).
• commit your changes and merge them into main via a Pull Request
• See Releasing and publishing packages in the main repo.

Version history (no longer updated; see main repo)

8.1.1 (18 May 2022)

• Show table border for Kenya (KE) AKN styles

8.1.0 (12 January 2022)

• Styling for ins and del AKN elements

8.0.0 (8 December 2021)

• Tradition styling for Kenyan judgments
• Improved footnote styling
• Hierarchical numbered elements using padding not margin, so that show-structure works a bit better

7.0.0 (?)

• NEW: Scroll tables horizontally on small displays
• NEW: Explicitly style all AKN hierarchical container elements
• Collapse table borders
• Improved mixins to support better re-use
• Test suite

6.0.0 (15 November 2021)

• Move all styling into mixins, so other libraries can include our mixins and include them in their own top-level selectors
• Replace ruby sass with npm sass

5.2.1 (27 October 2021)

• Bulleted lists

5.2.0 (31 May 2021)

• Namibia (na) formatting

5.1.1 (23 March 2021)

• Support for commencement note on coverpage

5.1.0 (12 October 2020)

• Support for footnotes
• Support for embeddedStructures
• Support for headings for subsections, paragraphs and subparagraphs

5.0.0 (4 June 2020)

This version assumes AKN 3.0 documents from Indigo.

• Attachments (schedules) should not have italicised headings

4.0.0 (21 April 2020)

• BREAKING: akoma-ntoso.scss is now law-widget-styles.scss
• BREAKING: akoma-ntoso.css is now law-widget-styles.css

3.13.0 (15 April 2020)

• Cross headings in KE aren't italicised

3.12.0 (20 March 2020)

• Styling for parent work title on generated coverpage

3.11.0 (25 February 2020)

• Styling for commencement dates on generated coverpage

3.10.0 (23 January 2020)

• Styling for .place-name in generated coverpage

3.9.0 (3 December 2019)

• Utilities for aligning text: akn--text-left, akn--text-right and akn--text-center

3.8.0 (16 October 2019)

• Added Kenya (KE) styling
• KE: remarks are not italicised, and single-line remarks are centered

3.7.0 (4 October 2019)

• Styling for new .as-at-date-notice element on generated coverpage
• Split out generated coverpage styling into separate file

3.6.1 (19 September 2019)

• Explicit styling for crossHeading elements (italics)
• hcontainer elements are block elements
• Reduce spacing between schedule title and headings

3.5.0 (17 July 2019)

• Explicit font for h1, h2, h3, h4, h5 tags

3.4.0 (16 July 2019)

• Styling for new generated verification notice in coverpages

3.3.0 (7 June 2019)

• Include a small amount of whitespace after very long outdented numbers to prevent clashing with text when the numbers are wide

3.2.0 (1 May 2019)

• display .akn-p elements as blocks with paragraph spacing
• last child in table cell mustn't have padding

3.1.0 (23 April 2019)

• longTitle is a block element with padding beneath it

3.0.0 (22 April 2019)

• Correctly support overriding SCSS variables
• Add PT Serif from Google Fonts as a font fallback. This better supports print environments and Linux systems.

2.0.0 (28 March 2019)

• Show .akn-paragraph as a block
• Show .akn-longTitle in bold
• Don't indent .akn-subsection and .akn-paragraph if they have .akn--no-indent
• Moved away from custom CDN, use jsdelivr instead.

1.0.1 (22 May 2018)

• Minor fixes

1.0.0 (22 May 2018)

• Support for country-specific traditions
• Polish tradition
• Moved to npm in favour of bower

0.1.3 (22 October 2017)

• Styling for images

0.1.2 (19 March 2017)

• Styling for rendering commencement and assent notices as list items, not headings.

0.1.1 (19 March 2016)

• Bump base font size to 15px to improve legibility with serif fonts.

0.1.0 (19 March 2016)

• Initial release

License

Licensed under an MIT license.