Default and custom templates used for lists.fsfe.org
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
Max Mehl 2b5a486a4b
fix donate link
11 months ago
assets update EN base template to v3 11 months ago
lists fix donate link 11 months ago
templates update subscribe templates to v3 11 months ago
.gitignore initial commit 3 years ago
README.md add docu how to deploy new languages for newsletter texts 3 years ago

README.md

FSFE Mailman Templates

This repository contains the default templates we use for our lists (in templates/) and some custom ones for specific lists (in lists/).

Translate custom FSFE templates

Most of the templates in the templates/ folder are Mailman defaults, but some important ones have been changed by us to look nicer and/or to contain additional information.

Under lists/, you will find templates for some special mailing lists like the newsletter. You can translate everything in the en folder and put your contribution under a separate folder named after your language code.

If you intent to translate them (which is highly welcome!), please note:

  • You may take some of the texts from the already existing translations.
  • In the HTML files, you may copy a lot from fsfe.org.
  • In the custom HTML files, please note the comment in the first line stating the revision, e.g. <!-- fsfe rev 1 -->. This may help you to find out whether the file in your language is on the same state content-wise as the English original.

Thank you for your contribution!

Deployment

The template folder of this repository is symlinked: /var/lib/mailman/templates -> /etc/mailman/mailman-templates-git/templates.

For the custom list templates, these are symlinked as well, for example: /var/lib/mailman/lists/newsletter-en/en -> /etc/mailman/mailman-templates-git/lists/newsletter-all/en. For a newly added language, this can be done by (exmaple for nl (Dutch), so replace for new language code):

for list in /var/lib/mailman/lists/newsletter-*; do 
  ln -s /etc/mailman/mailman-templates-git/lists/newsletter-all/nl $list/nl
done

Custom changes necessary for deployment

Our custom templates require some server-side changes in order to make them work.

Enable CORS

In Apache config for fsfe.org, add

# Allow CORS for fsfe.org domains
SetEnvIf Origin ^(https?://.+\.fsfe\.org(?::\d{1,5})?)$   CORS_ALLOW_ORIGIN=$1
Header append Access-Control-Allow-Origin  %{CORS_ALLOW_ORIGIN}e   env=CORS_ALLOW_ORIGIN
Header merge  Vary "Origin"

Loosen Mailman HTML blocklist

In /usr/lib/mailman/Mailman/Utils.py, add to _badwords = [:

'<link(?! href="https://fsfe.org/.*")',