NOTE

The new fedoraproject.org website sources are available on GitLab.

Contributing

If you like to help the websites team but are not actually a member, you can easily file Pull Requests. Fork this repository, make your changes and submit them here. Check of the Fedora Websites wiki for details on how to become a member of the websites team.

Translations are handled by the Fedora localization team on Fedora Weblate.

Websites

This repository contains the sources for the following Fedora Websites:

• http://alt.fedoraproject.org
• http://fedoracommunity.org

Getting started

WARNING: DO NOT execute the following steps as root, just use your normal user:

1. Setup your system

Since the build process for these pages depend on python2 packages that are no longer packaged in Fedora, the build process and local test server may be run using podman. Podman should be installed by default on Fedora Workstation, for other Fedora releases:

sudo dnf install podman

2. Clone the fedora-websites repo

git clone https://pagure.io/fedora-websites.git

3. Build the fedora-websites image

We need a podman image with the dependencies installed, to build the image from the provided Dockerfile, run the following in the newly checked out fedora-websites directory:

podman build -t fedora-websites .

4. Enter the build environment container

Run podman specifying the current directory as the container working directory and the fedora-websites image:

podman run -it -p 5000:5000 -v "$(pwd):/opt/:z" -w /opt fedora-websites

5. Enter the directory of the website you want to work on

For example, if you want to work on alt.fedoraproject.org, use:

cd alt.fedoraproject.org

6. Launch a test instance

make en test

This will run the build, start httpd to serve the built content at localhost:5000.

7. Stop the test instance

make stoptest

Note: if you have caching problems you can clean the instance even more:

make veryclean

8. Exit the container

exit