https://github.com/engineervix/zm-ictaz
The Information and Communications Technology Association of Zambia Act, 2018 – powered by VitePress
https://github.com/engineervix/zm-ictaz
Last synced: 12 months ago
JSON representation
The Information and Communications Technology Association of Zambia Act, 2018 – powered by VitePress
- Host: GitHub
- URL: https://github.com/engineervix/zm-ictaz
- Owner: engineervix
- License: gfdl-1.3
- Created: 2024-07-15T16:51:16.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-03-08T04:25:33.000Z (about 1 year ago)
- Last Synced: 2025-03-08T05:20:54.000Z (about 1 year ago)
- Language: CSS
- Homepage: https://ictaz-act.pages.dev
- Size: 160 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: COPYING
Awesome Lists containing this project
README
# The Information and Communications Technology Association of Zambia Act, 2018
> An Act to establish the Information and Communications Technology Association of Zambia and provide for its functions; provide for the registration of information and communications technology professionals and regulate their professional conduct in the interest of the information and communications technology sector; and provide for matters connected with, or incidental to, the foregoing.
>
> Source:
[](https://github.com/engineervix/zm-ictaz/actions/workflows/main.yml)
[](https://nodejs.org/en/blog/release/v22.0.0)
[](https://prettier.io/)
[](https://conventionalcommits.org)
- [Introduction](#introduction)
- [Why this project exists](#why-this-project-exists)
- [How the content was put together](#how-the-content-was-put-together)
- [Development](#development)
- [First things first](#first-things-first)
- [Getting Started](#getting-started)
- [Contributing](#contributing)
- [TODO](#todo)
- [Notice](#notice)
## Introduction
Powered by [VitePress](https://vitepress.dev/), this project transforms a traditionally dense and difficult to navigate PDF of the aforementioned _Act_ into an easily navigable, searchable, and visually appealing online resource.
### Why this project exists
Navigating legislative documents can be daunting and often results in a headache. This project was born out of the desire to make the process of understanding the _Act_ more approachable and less painful.
### How the content was put together
This is the approach I took:
1. Download the original [pdf](https://www.parliament.gov.zm/sites/default/files/documents/acts/Information%20and%20Communications%20Technology.pdf) from the National Assembly of Zambia website.
2. Use [Adobe Acrobat Online PDF to Word Converter](https://www.adobe.com/uk/acrobat/online/pdf-to-word.html) to convert the pdf to a `docx` file.
3. Use [pandoc](https://pandoc.org/) to convert the `docx` file to [Markdown](https://daringfireball.net/projects/markdown/) (based on [this gist](https://gist.github.com/plembo/409a8d7b1bae66622dbcd26337bbb185)):
```bash
pandoc \
-t markdown_strict \
--extract-media='./attachments/source' \
source.docx \
-o output.md
```
4. Copy / paste the content, and clean up where the formatting is incorrect.
> [!WARNING]
> The formatting of the Pandoc-generated output was not 100% accurate. While I have made every effort to correct formatting issues and other minor bugs, you might encounter some typos, incorrect numbering, or potentially missing content.
>
> If you notice any of these issues, please help in fixing them by [opening an issue](https://github.com/engineervix/zm-ictaz/issues) or [submitting a pull request](https://github.com/engineervix/zm-ictaz/pulls). Your [contributions](#contributing) are greatly appreciated.
>
> Gracias
## Development
### First things first
You need to have [Node.js 22](https://nodejs.org/) installed on your machine. You can use tools such as [nvm](https://github.com/nvm-sh/nvm), [volta](https://volta.sh/), etc. to simplify managing Node.js versions on your machine.
### Getting Started
Upon cloning this repository (or forking + cloning your fork), navigate to the cloned project directory.
1. Install dependencies
```bash
npm install
```
2. Run the dev server
```bash
npm start
```
The documentation will be available at:
## Contributing
This project follows the [all-contributors](https://github.com/all-contributors/all-contributors) specification. Contributions are most welcome! A good place to start is by helping out with the unchecked items in the [TODO](#todo) section of this README!
Feel free to check the [issues page](https://github.com/engineervix/zm-ictaz/issues) and take a look at the [contributing guide](https://github.com/engineervix/zm-ictaz/blob/main/CONTRIBUTING.md) before you get started.
## TODO
- [ ] where reference is made to other sections, use hyperlinks to link to those sections
## Notice
I do not own the copyright to the contents of the aforementioned _Act_. The text of the _Act_ is a public document, and this project aims to make it more accessible and user-friendly. Any modifications or enhancements to the presentation are my own work, and permission is granted to copy, distribute and/or modify this work under the terms of the GNU Free Documentation License as published by the Free Software Foundation, either version 1.3, or (at your option) any later version; with no Invariant Sections, no Front-Cover Texts and no Back-Cover Texts. A copy of the license is contained in the file `COPYING`.
---