JoinJabber website build with Hugo
Go to file
msavoritias 8d22f0a381 Merge pull request 'Migrate infra source code links.' (#93) from migrate_infra_links into main
Reviewed-on: #93
2023-12-04 17:08:06 +00:00
archetypes add static image files 2023-01-29 18:09:57 -01:00
assets/sass Fix search page; Update theme 2023-03-07 19:35:16 +01:00
config/_default - Resolve merge conflicts 2023-02-15 17:03:59 +01:00
content Migrate infra source code links. 2023-12-04 19:01:20 +02:00
i18n Remove `{{ .section }}` from i18n files (invalid for current theme logic) 2023-07-25 17:42:30 +02:00
layouts Fix reference to fee and add @joinjabber feed 2023-12-02 19:20:08 +00:00
po Migrate infra source code links. 2023-12-04 19:01:20 +02:00
static add movim to Android and ios + small ios changes 2023-10-09 16:08:36 +00:00
themes Remove `{{ .section }}` from i18n files (invalid for current theme logic) 2023-07-25 17:42:30 +02:00
.gitignore - Add History to Dutch, linking to English minutes 2023-03-20 14:58:24 +01:00
.gitmodules add static image files 2023-01-29 18:09:57 -01:00
.hugo_build.lock initial port of old website 2023-01-30 21:14:35 -01:00
LICENSE rename readme and add license 2023-01-30 21:16:31 -01:00
Makefile Makefile: =? isn't valid it's ?= 2023-02-20 17:28:24 +01:00 Migrate links to website source code. 2023-12-04 18:26:38 +02:00
config.toml Add translations script which uses po4a 2023-02-18 21:20:49 +01:00
disable-languages Translations: only generate a single POT file; enable FR 2023-02-20 14:32:12 +01:00 Translations: Update default copyright holder/package name 2023-02-22 17:52:56 +01:00

JoinJabber website

Based on Compose theme. Find the documentation here.

All text in the content folder is Creative Commons CC-by-SA licensed.


Contributions, especially tutorials and translations, are highly appreciated. This website uses plain-text files with simple Markdown formatting. Ready-made PRs or patch files for this repository are perfect and can be made quite easily on the Codeberg web-interface. But if you send us a simple markdown formatted text file with your changes that is also fine.

You can join our project channel via a Jabber client to discuss any contributions with us: or you can also use our simple webclient; no registration required.

Please note that all contributions should be licensed under the Creative Commons CC-by-SA license or a license compatible to it.

Running a local copy of the site for editing

After cloning or downloading the git repository (and ensuring you have the Hugo static site builder installed) open a terminal and change to the website directory. Run make init to pull the submodule for the theme. Then you can start an interactive version of the site by running make server. The terminal output will show a link you can open with any web-browser. Changes to the files will be automatically reflected on this live-updating local version of the website.

Helping with translations

We are comitted to providing our website in multiple languages, however keeping up with changes and adding additional languages is quite a challenge for our small team of voluteers. So please consider helping out!

Translating online

Translations are made available on Codeberg's Weblate instance.

All strings are being served from the same template that contains the whole website. You may want to filter based on language and location of the file (article) you want to translate using the following weblate search query: language:fr location:content/

It is possible to add a new language directly from Weblate but please contact us (web) (xmpp) when doing so.

Translating locally

Translations are available in the po folder at the root of the repository. Look for .<lang>.po files.

To update translation files with new (english) content, run make locale-update. To update the content folder that will be served on the website with new translations, run make locale-build. If a language is managed by our scripts, that is every language that has a .po files, and is not listed in disable-languages file, then any article that is not translated up to at least 80% will not be generated and will be deleted if it exists.

To add a new language, cp po/content.pot po/content.<lang>.pot, and please contact us if you do.

Usage of {{< ref "link" >}} or {{< relref "link" >}} in translations may fail if the linked page doesn't exist yet (or not translated enough). In this case, remove the link. Periodic checks that links are properly translated should happen.

When translating from weblate, add a "missing-link" label. When translating locally, leave a #. Missing link comment. Unfortunately it doesn't seem like weblate provides a way to leave comments in PO files.