There is already an article called How to contribute to the Python Barranquilla blog. This article highlights how you can facilitate contributions using a self-configuring virtual workspace – you won't need to install anything; everything is online.

Codespaces is a virtual workspace that can be automatically configured, provided by GitHub. A free account comes with 60 core-hours of runtime. That's more than enough time to work on contributing to our site or other projects. The Python Barranquilla page repository has a .devcontainer folder with the necessary configurations to start working immediately on any contribution you want to make.

Edit

After creating a branch, we can open a codespace. Thanks to the .devcontainer.json file, a codespace will be created with everything you need. If your first question is, what is a branch and why is it necessary to create one? I recommend you go to Annex 2 of the article mentioned at the beginning.

Open Codespace

The creation process may take a while the first time you open it.

Create Codespace

Once the editor opens, you'll see 3 parts:

  1. The file browser
  2. A console with the lektor server running
  3. A simple browser window showing the generated page.
    The page can be opened in a separate tab using the button in the top-right corner (see arrow).

Editor Codespace

Finally, you can use the editor to perform both commits and pushes, but it's easiest to do this after closing the codespace window:

  1. Export changes to the branch.
  2. Close the codespace
    It’s important to close the codespace to prevent it from consuming more runtime.

Close Codespace

How do I create a post?

To create a blog post, follow the instructions in the article "How to contribute to the Python Barranquilla blog" starting from the title Creating an entry in Lektor.

If you have any questions, don't hesitate to ask in our Discord.