ilot.io

Upstream: https://forge.ilot.io/ilot/ilot.io

Forgejo Actions

This project's static Pages are built by Forgejo Actions, following the steps defined in .forgejo/workflows/pages.yaml. That builds this website using ikiwiki, and pushes the build artifacts to the pages branch.

The pages branch is then made available using pages-server according to the domains information available in .domains.

Follow Codeberg's own docs for more information.

Building locally

To work locally with this project, you'll have to follow the steps below:

1. Fork, clone or download this project
2. Install ikiwiki:
   • mac
   • linux
   • source
3. Generate the website: ikiwiki --setup ikiwiki.setup
4. Start http-server: ./tools/test-server.sh
5. Preview your project: open 127.0.0.1:8080 in your browser

Read more at ikiwiki's documentation.

Contributing

1. Fork the main ilot.io repo.

2. Checkout the forked repository.

   • git clone ssh://git@forge.ilot.io/$USER/ilot.io
   • cd ilot.io

3. Make your changes.

4. Do local build.

   • ikiwiki --setup ikiwiki.setup

5. Fix any errors that come up and rebuild until it works locally.

6. Commit the changes to the git repo in a git branch

   • git checkout -b <name>
   • git add changes
   • git commit -m 'content/index: descriptive description'
   • git push

7. Create a merge request with your changes by following link in server response.

8. Once the tests in the merge-request pass, and reviewers are happy, your changes will be merged.