nielsenb / fedora-websites

Forked from fedora-websites 2 years ago
Clone
README.md

NOTE

The getfedora.org sources now live in a new repository and are built with Flask and Frozen-Flask. The other sites remain in this current repository that you are looking at right now.


This is the Fedora Websites GIT repo used to build the websites starting from the F24 release cycle.

History of previous commits is still available in the old repo on Fedora Hosted. For more information please read the documentation and the Fedora Websites pages on the Fedora Wiki

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.

Translation status

Websites

This repository contains the sources for the following Fedora Websites:

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