We glad, that you want to contribute to the project. To make things easier please read the following.
To make sure you can develop the script install all the tools you need:
To prepare environment, clone the project and execute the following:
make setup-dev-envThis will install and set up all the things you need (Git Hooks, Dependencies).
To compile Bismuth execute the following:
make buildThis will compile the script via TypeScript and produce the JS output adapted to QML JavaScript Environment.
To install compiled package, execute:
make installNote however, that if you have the script already installed and enabled, you need to restart KWin, so that it can apply the changes you've made. To do so do:
make restart-kwin-x11You can uninstall the package using the following command:
make uninstallBismuth comes with unit tests. To run them execute the following:
make tests☝️ To view the current API documentation please go here.
To generate API docs, run the following:
make docsThis will generate the documentation in the build directory.
Do not worry, you can still contribute fixing the documentation or just opening the issues and reporting bugs! Do not underestimate your impact, as the job of tester and bug triager is one of the most valuable in any software project. What the use of being a developer if you don't know what to fix or implement?
Bismuth is written in TypeScript and C++, so you'll have to know some. To learn TypeScript, check out the Handbook. If you know JavaScript and have an experience in some strongly typed language, it will be easy, and even if it not, you're still doing a great job - you can do it!
You'll also need to know something about KWin scripting and Qt JavaScript Environment. For KWin scripting there is a tutorial on the KDE developer portal. And for Qt JavaScript things you can check out the official documentation.