About this website¶
This website is a synodal website made using a technology based on git, atelier, Python and Sphinx. The technology
This website is a living labyrinth. Its structuring is still unstable and under development.
How to request a change¶
Anybody can submit change requests. Unless they are trivial or merely cosmetic, your suggestions will be discussed by the core team.
For new content, write your text in any format and send it to us, together with explanations where this content should come.
To request modification of existing content, just describe the changes in some way that makes sense. Make sure to copy the URL of the page you are talking about. One possibility is to copy and paste the content from the website into a LibreOffice or Word document, enable change tracking, start editing, and then sending us the document.
How to edit Sphinx files directly on GitHub¶
The source code of this website is hosted as an source code repository on GitLab: https://gitlab.com/sinod2023/www/
We can give write permission to the code repository to certain team members so that they can edit Sphinx files directly on GitHub.
If you do not yet have your personal GitLab account, create one (click on the button “Sign in/Register” on the GitLab website).
Tell the name of your GitLab account to Luc.
Communicate with the other team members to decide which file(s) you are going to edit. We use to meet in our Jitsi room jitsi.eesti.ee/sinod.
Open the GitLab web interface, either directly via this link, or when you are on the website, by clicking the button with the GitLab logo in the upper right corner (it’s a fox).
Using the GitLab web interface, navigate to the file you want to edit. For each html web page there is one source file ending with
.rst
. Relative URLs on the website correspond to the file name paths in this repository. Estonian files are underdocs
, English files underendocs
, Russian files underrudocs
.When you are on a source file ending with
.rst
, click the button “Edit” or “WebIDE”.Don’t hesitate to ask for help!
This website uses a synodal technology¶
This section will probably sound weird to most readers because it relates two topics (Synodality and Free Software) that are classically covered by very different professions church workers and software developers.
- synodal website¶
TODO
The technology used for this website¶
TODO: Some documentation exists on https://dev.lino-framework.org/writedocs but needs to be reviewed
- git¶
A source versioning system used by software developers. See https://en.wikipedia.org/wiki/Git
- Python¶
A programming language. See https://www.python.org
- Sphinx¶
A program for building static websites.
- atelier¶
A program I wrote for my professional work as a software developer.