This is the homepage for the BeeWare project.

It is a Lektor-based site.

If you want to contribute a modification, you can fork this repository and submit a pull request. However, do not fork the main branch - fork the lektor branch and make changes there instead.

If you want to test out a change before you submit it, create a virtual environment, and install Lektor:

$ python3 -m venv venv
$ source venv/bin/activate
(venv) $ python -m pip install lektor

Then from the root directory of the checkout, run:

(venv) $ lektor server

This will start a webserver that will autoreload whenever you make a change to site content.

You can talk to the community through:

• @beeware@fosstodon.org on Mastodon
• BeeWare Discord server: Discord
• Tickets on the beeware.github.io issue tracker

If you find problems with this website, log them on GitHub. If you want to contribute, please fork the code and submit a pull request.

Before submitting a pull request, please make sure your forked branch is up-to-date with the original branch. To do this:

• Set your upstream remote:

$ git remote add upstream https://github.com/beeware/beeware.github.io.git

• Make sure you have the latest changes from upstream:

$ git fetch upstream

• Rebase your lektor branch to upstream before pushing to git and submitting a pull request:

$ git rebase upstream/lektor

We manage translations using Weblate.

If you'd like to contribute to the translation effort, join the #translations channel on Discord and introduce yourself!