This repository contains the content of taskwarrior.org, the website for the Taskwarrior project.
To clone this repository, run
git clone https://github.com/GothenburgBitFactory/tw.org
For minor changes, it is perfectly fine to simply change the relevant Markdown files and make a pull request.
For more complex changes, here is how to build the documentation locally:
- Install hugo.
- Run
This defaults to running a web server on
hugo server -D -w
https://localhost:1313
.
If you are running on an external host, tryhugo server -D -w --bind 0.0.0.0 -b https://<hostname>
This repository has automation for searching GitHub for projects related to Taskwarrior and including them in the "Tools" page.
On first usage, generate API tokens and store them safely for later:
- GitHub: requires no special scopes
Then set up the Python 3 environment:
# Create a virtual environment to avoid clobbering global installation
$ python3 -m venv venv
# Activate the virtual environment
$ source venv/bin/activate
# Install dependencies
$ pip install -r tools/requirements.txt
Then create the update_tools.sh
script by copying the sample, and set API keys there. This file will be ignored and should not be committed.
Now that everything is set up, the tools can be updated by running update_tools.sh
:
$ source venv/bin/activate
$ ./update_tools.sh
Repositories that are always included are listed in tools/always_include.json
. Repositories that are always ignored are listed in tools/never_include.json
. This can be modified and committed to the repository.