From b5143d25517e642e4d4ccb6347f6f3f7a528dce3 Mon Sep 17 00:00:00 2001
From: Brandon Nielsen <nielsenb@jetfuse.net>
Date: May 27 2022 19:02:21 +0000
Subject: Update build procedure to use podman


Required build dependencies are no longer available on later versions of
Fedora, update the build and test procedure to use a podman container
running an older version of Fedora.

---

diff --git a/README.md b/README.md
index 9763823..9669f8b 100644
--- a/README.md
+++ b/README.md
@@ -48,28 +48,46 @@ This repository contains the sources for the following Fedora Websites:
 
 #### 1. Setup your system
 
-    sudo dnf install git gettext python2-genshi python-lxml python-setuptools python-dateutil \
-    python-dogpile-cache babel python-feedparser fedfind python-requests python2-babel
+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](https://podman.io/). Podman should be installed by default on Fedora Workstation, for other Fedora releases:
 
-    sudo dnf groups install 'Web Server'
+    sudo dnf install podman
 
 #### 2. Clone the fedora-websites repo
 
     git clone https://pagure.io/fedora-websites.git
 
-#### 3. Enter the directory of the website you want to work on
-For example, if you want to work on getfedora.org, use:
+#### 3. Build the fedora-websites image
 
-    cd fedora-websites/getfedora.org
+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:
 
-#### 4. Launch a test instance
+    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
 
-#### 5. Stop the test instance
+This will run the build, start httpd to serve the built content at [localhost:5000](http://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