Open Study Room (OSR) is a community of go/baduk/weiqi players who share, build and organize knowledge, opportunities and resources for learning, studying and playing Go online as part of a thriving worldwide community.
You can always meet us in our discord server.
This is the code of our website that runs at openstudyroom.org.
This website is written in python and powered by the django framework.
The project is under GNU GPL 3.
You are welcome to help us improve it or use it as the base for your own go community website.
It comes with the folowing tools:
To manage the content, we use the wagtail CMS along with the puput blogging app.
The models and templates of this app can be found in the home folder.
The forum is powered by machina and uses mistune for markdown formating.
Custom template forum base template in openstudyroom/templates/boardbase.html.
Allow hosting go leagues where games are played on the KGS or OGS go server. A cron job can get games automatically from those servers.
Note that the auth model league.models.User is in here.
The scraper() function inside league.views is run by cron every 5 mins.
It's all under the league folder.
Allow hosting go tournaments. Games must be uploaded manually by admins.
Allow admins to manage calendar events and users to plan games.
The client side is rendered by the js fullcalendar library.
This js will replace every [gmt]YYYY/MM/DD HH:mm[/gmt] to the locale datetime in the user timezone. Example output in french "dimanche 11 novembre 2018 19:00 (Europe/Paris)".
It is loaded on all .rich-text elements here and in the forum .post elements here.
This js allow to replace [goban url="url/of/the/url"]some interactive comments[/goban] to a go board using the wgo.js library.
It's loaded on the forum .post-content elements here.
It's functionalities are documented here.
Have a look at our contributing guidelines here.
- Run the web server:
docker compose up app- Run ruff checks:
docker compose run --rm ruff- Launch the container CLI (for ewample to update translations):
docker compose run --rm cli