3. Dog registration and licensing
`.
If you need to load images from a different location you can tell Laws.Africa to use apply a prefix to the `src` attribute of image tags by using the `?media-url` query parameter.
For example, using `?media-url=/static/assets/za/act/1995/2/eng/2018-11-10/` will produce image tags such as `
`.
{% hint style="info" %}
You should encode the FRBR URI into the `media-url` parameter to ensure that you show images for the correct work, point in time and language.
{% endhint %}
# API Reference
Content API reference.
The Content API is available under:
```
https://api.laws.africa/v3/
```
Use these reference pages when your product needs full legislation content, metadata, formats or update workflows.
{% content-ref url="/pages/KKgsm6edNwCb20bQZzec" %}
[Authentication](/content-api/reference/authentication)
{% endcontent-ref %}
{% content-ref url="/pages/I80b8edHcJXNrkmg3cfB" %}
[Pagination](/content-api/reference/pagination)
{% endcontent-ref %}
{% content-ref url="/pages/-LuBmqjMGU4cxRpMTWx9" %}
[Places](/content-api/reference/countries-and-localities)
{% endcontent-ref %}
{% content-ref url="/pages/-LuBr6Gv8a8hSMTKOk0y" %}
[Single work expression](/content-api/reference/works-and-expressions)
{% endcontent-ref %}
# Authentication
The Content API uses the shared Laws.Africa API token authentication scheme.
{% content-ref url="/pages/2mveWei9sQIkok9cag4Y" %}
[Authentication and API keys](/get-started/authentication)
{% endcontent-ref %}
# Pagination
API calls that return lists will be paginated and return a limited number of items per page. The response includes information on the total number of items and the URLs to use to fetch the next and previous pages of items:
| Field | Meaning | Type |
|---|---|---|
count | Total number of items in the entire response, across all pages. | number |
next | URL for the next page of results, if any. | string or null |
previous | URL for the previous page of results, if any. | string or null |
9. The rescue of stray dogs
Cape Town By-laws
| {{ work.title }} | {{ work.frbr_uri }} |
Cape Town By-laws
| {% with work.default_expression as expr %} {% if expr %} {{ expr.title }} {% else %} {{ work.title }} {% endif %} {% endwith %} | {{ work.frbr_uri }} |
{{ expression.title }}
{{ expression.content|safe }}
```
{% endcode %}
{% hint style="info" %}
If there are other expressions on the same work (different language or date), how would the user find them?
{% endhint %}
If you visit an expression detail page, you'll see the title and some ugly content. In the next section we'll add formatting to the content.
# Styling with Law Widgets
Adding styles to the document content.
## In this section
* Installing the Law Widgets web components library
* Using Law Widgets to add styles to document content
* Customising styles with CSS
## Law Widgets
Akoma Ntoso HTML documents don't look very good without styling. Laws.Africa's [Law Widgets](https://github.com/laws-africa/law-widgets/blob/main/core/README.md) is a collection of web components that make it simple to style the HTML provided by the Laws.Africa Content API.
Using Law Widgets is easy:
1. Add a reference to the Law Widgets javascript.
2. Use the law widgets in your HTML.
We'll use the [\{{ expression.title }}
{{ expression.title }}
...
<la-decorate-terms popup-definitions link-terms></la-decorate-terms>
<la-akoma-ntoso ...>...</la-akoma-ntoso>
...
The XML eId is included as both the id and data-eid elements in the corresponding HTML.
Visualisation of section 4(1) enriched with "Red"
# ...
<la-gutter id="gutter">
<la-gutter-item anchor="#{{ enrichment.provision_id }}">{{ enrichment.taxonomy_topic }}</la-gutter-item>
{% endfor %}
</la-gutter>
Showing enrichments pulled from the enrichments dataset.
Example of Akoma Ntoso XML, including metadata and text.
# itertext() iterates over all text nodes in the entire document
text = ' '.join(root.itertext())
print(text[:100])
# To provide for the control of undertakings selling liquor to the public including the control of tra
<p eId="sec_6__subsec_4__p_1">
<remark status="editorial">
[subsection (4) deleted by section 1 of the <ref href="/akn/za-cpt/act/by-law/2014/control-undertakings-liquor-amendment" eId="sec_6__subsec_4__p_1__ref_1">Amendment By-law, 2014</ref>]
</remark>
</p>
| XPath | Meaning |
|---|---|
// | Any node at any point in the tree. Alternatively, ./ means nodes at the current element (which is root in this case), or / which means the root of the entire document. |
text() | This matches text nodes. |
[...] | This applies additional conditions to the text nodes being matched. The conditions must evaluate to true to be included in the resulting node set. |
not(...) | This negates the condition inside the brackets. |
ancestor::a:remark | The ancestor:: means any ancestor element of the text node, and a:remark limits the ancestors to those that are <remark> elements in the Akoma Ntoso namespace. |
Section 3's HTML.
Section 3's XML.
| XPath | Meaning |
|---|---|
//a:section | Find all AKN section elements anywhere in the document |
[@eId="sec_3"] | Filter the section elements to return only those whose eId attribute is "sec_3". |
# BAD: extract headings without joining with a space
text = ''.join(root.xpath('//a:heading//text()', namespaces=nsmap))
print(text[:100])
# DefinitionsApplicationGeneral prohibitionOn-consumption premisesOff-consumption premisesApplication