otmp_site/README.md

48 lines
1.5 KiB
Markdown
Raw Normal View History

# OxideTalis Messaging Protocol (OTMP)
2022-12-03 20:01:01 +01:00
A simple site explaining the OxideTalis Messaging Protocol (OTMP).
2022-12-03 20:01:01 +01:00
## How to view the site?
There are three ways to view the site, you can choose any of them
2022-12-03 20:01:01 +01:00
### View the site online (if available)
You can view the site online by visiting the following link: [https://otmp.4rs.nl](https://otmp.4rs.nl)
2022-12-03 20:01:01 +01:00
### Build the site locally
You can build the site locally by following the steps below:
2022-12-03 20:01:01 +01:00
> [!NOTE]
> My current zola version is `0.18.0`.
```bash
# Clone the repository
git clone https://git.4rs.nl/awiteb/otmp_site.git
2022-12-03 20:01:01 +01:00
# Change directory to the repository
cd otmp_site
2022-12-03 20:01:01 +01:00
# Build the site
zola build
2022-12-03 20:01:01 +01:00
The site will be built in the `public` directory (you can view it by opening the `index.html` file in your browser)
2022-12-03 20:01:01 +01:00
```
### `site` branch
You can view the site by visiting the `site` branch of the repository. The site is built and pushed to the `site` branch automatically by the CI pipeline.
2022-12-03 20:01:01 +01:00
## How to contribute?
Write changes can be made at `templates` directory. You can't change the `content` directory as it contains the protocol itself.
2022-12-03 20:01:01 +01:00
You can open an issue to write a comments or suggestions about the protocol.
2022-12-03 20:01:01 +01:00
## `deploy.sh` script
Simple script to build the site and push it to GitHub pages.
2022-12-03 20:01:01 +01:00
## Credits
This **site** is built on top of Ahmed Alaa [no-style-please](https://gitlab.com/atgumx/no-style-please) theme, with some modifications, you can view the changes at the `templates` directory by running the following command:
```bash
git log --author="Awiteb <a@4rs.nl>" -p templates
```