Source files of fsfe.org, pdfreaders.org, freeyourandroid.org, ilovefs.org, drm.info, and test.fsfe.org. Contribute: https://fsfe.org/contribute/web/ https://fsfe.org
Go to file
anaghz b5247c5316
All checks were successful
continuous-integration/drone/push Build is passing
Merge pull request 'fixing typo banner in IT' (#4661) from 20241204-banner into master
Reviewed-on: #4661
2024-12-04 13:44:49 +00:00
build feat: move countries xml to global instead of tools 2024-12-03 14:35:11 +00:00
drm.info fix: remove unneeded css and font files from pdfreaders.org and drm.info 2024-09-14 14:25:35 +01:00
fsfe.org feat: move countries xml to global instead of tools 2024-12-03 14:35:11 +00:00
global Merge pull request 'fixing typo banner in IT' (#4661) from 20241204-banner into master 2024-12-04 13:44:49 +00:00
pdfreaders.org fix: use fileurl for several links, fixing them 2024-09-18 18:40:06 +01:00
status.fsfe.org update status 2024-11-25 11:56:33 +01:00
tools feat: move countries xml to global instead of tools 2024-12-03 14:35:11 +00:00
.drone.yml Remove nixery dep, as it has been getting flaky 2024-08-27 16:06:28 +02:00
.gitignore feat: create output dir in script instead of gitignoring its readme 2024-10-15 14:30:02 +01:00
build.sh feat/build-improvements-2 (#4553) 2024-10-29 14:56:41 +00:00
docker-compose.yml feat: add support for building in docker 2024-10-15 14:10:15 +01:00
Dockerfile feat: add support for building in docker 2024-10-15 14:10:15 +01:00
Makefile feat/build-improvements-2 (#4553) 2024-10-29 14:56:41 +00:00
README.md feat/build-improvements-2 (#4553) 2024-10-29 14:56:41 +00:00
serve-websites.py feat: add script for serving webpages and support for it to build.sh 2024-10-15 14:10:15 +01:00
shell.nix Add nix shell for developing 2024-09-02 12:49:39 +00:00

FSFE Website

This repository contains the source files of fsfe.org, pdfreaders.org, freeyourandroid.org, ilovefs.org, drm.info, and test.fsfe.org.

Table of Contents

Technical information

Our web team has compiled some information about technology used for this website on the Information for Webmasters page.

Structure

Most files are XHTML files organised in a rather logical folder structure.

Every website served using this repo has its own folder with the full domain name it is to be served from.

Domains

This repository also contains the source files of other websites the FSFE hosts:

Important folders

Notable top level directories are:

  • build: Mostly custom Bash and XSL scripts to build the website
  • global: Globally used data files and modules, also the static translated strings.
  • tools: Contains miscellaneous XML, XSL, and SH files.

And of course the different website folders.

And here are dome notable directories inside the folder for the main webpage, fsfe.org.

  • about: Information about the FSFE itself, its team members etc
  • activities: All specific FSFE activities
  • at, de, ee etc: Folders used for the FSFE country teams
  • cgi-bin: Our very few CGI scripts
  • error: Custom 4xx and 5xx error pages
  • events: Files for our events, ordered by year
  • freesoftware: More timeless pages explaining Free Software and related topics
  • graphics: Icons, pictures and logos
  • internal: Forms used mostly by FSFE staff for internal processes
  • look: CSS and other style files
  • news: Files for news articles, press releases, and newsletters ordered by year
  • order: Our web shop
  • scripts: JavaScript files used on our pages
  • tags: Files necessary to display used tags throughout the website. Mostly automatically generated

Contribute

Become member of our awesome webmaster team and help to improve our online information platform!

Translate

We adore our voluntary translators who make information about Free Software available over 30 languages, from Arabic to Turkish!

Join them to spread the message of our community in all over Europe and beyond. The translators team page will introduce you to their amazing work.

You can see the current status of translation progress of fsfe.org at status.fsfe.org/translations

Build

There are two ways to build and develop the directory locally. Initial builds of the webpages may take ~40 minutes, but subsequent builds should be much faster. Using the --languages flag to avoid building all supported languages can make this much faster. See ./build/README.md for more information.

Alterations to build scripts or the files used site-wide will result in near full rebuilds.

Native

We can either install the required dependencies manually using our preferred package manager. If you are a nix use one can run nix-shell to enter a shell with the required build dependencies.

The required binary names are

realpath rsync xsltproc xmllint sed find egrep grep wc make tee date iconv wget shuf python3

The package names for Debian, are

bash bash-completion coreutils diffutils findutils inotify-tools libxml2-utils libxslt make procps python3 rsync

After getting the dependencies one way or another we can actually build and serve the pages.

The pages can be built and served by running ./build.sh. Try --help for more information. The simple web server used lacks the features of apache which used on the FSFE web servers. This is why no index is automatically selected form and directory and other behaviors.

Docker

Simply running docker compose run --service-ports build --serve should build the webpages and make them available over localhost. Some more explanation: we are essentially just using docker as a way to provide dependencies and then running the build script. All flags after build are passed to build.sh. The service-ports flag is required to open ports from the container for serving the output, not needed if not using the --serve flag of the build script.

Please note that files generated during the build process using docker are owned by root. This does not cause issues unless you with to manually alter the output or switch to native building instead of docker.

If you wish to switch to native building after using docker, you must use sudo git clean -fdx to remove the files generated using docker.

Testing

While most small changes can be tested adequately by building locally some larger changes, particularly ones relating to the order pages, event registration and other forms may require more integrated testing. This can be achieved using the test branch. This branch is built and served in the same way as the main site, fsfe.org. The built version of the test branch may be viewed at test.fsfe.org.

Status Viewing

The status of builds of fsfe.org and test.fsfe.org can be viewed at status.fsfe.org