Improve README.md: Update command-line options for clarity and add new arguments

Signed-off-by: Stephen Simpson <ssimpson89@users.noreply.github.com>

.github/workflows/build.yml

@@ -25,39 +25,26 @@ on:
 jobs:
   build:
     runs-on: ubuntu-latest
-    container:
-      image: rockylinux:9
 
     steps:
       - name: Checkout code
         uses: actions/checkout@v4
 
-      - name: Install system dependencies
+      - name: Build Docker image
         run: |
-          dnf install -y \
-            python3.11 \
-            python3.11-pip \
-            mandoc \
-            rpm-build \
-            dnf-plugins-core \
-            git
+          docker build -t rocky-man:latest .
 
-      - name: Install UV
+      - name: Create output directories
         run: |
-          curl -LsSf https://astral.sh/uv/install.sh | sh
-          echo "$HOME/.cargo/bin" >> $GITHUB_PATH
+          mkdir -p ./html ./tmp
 
-      - name: Install Python dependencies
+      - name: Build man pages in container
         run: |
-          uv pip install --system -e .
-
-      - name: Build man pages
-        run: |
-          python3.11 -m rocky_man.main \
-            --versions ${{ github.event.inputs.versions || '8.10 9.5' }} \
-            --output-dir ./html \
-            --download-dir ./tmp/downloads \
-            --extract-dir ./tmp/extracts \
+          docker run --rm \
+            -v "$(pwd)/html:/data/html" \
+            -v "$(pwd)/tmp:/data/tmp" \
+            rocky-man:latest \
+            --versions ${{ github.event.inputs.versions || '8.10 9.6 10.0' }} \
             --verbose
         env:
           PYTHONUNBUFFERED: 1
@@ -68,11 +55,3 @@ jobs:
           name: rocky-man-pages
           path: html/
           retention-days: 30
-
-      - name: Deploy to GitHub Pages
-        if: github.ref == 'refs/heads/main'
-        uses: peaceiris/actions-gh-pages@v3
-        with:
-          github_token: ${{ secrets.GITHUB_TOKEN }}
-          publish_dir: ./html
-          force_orphan: true

Jenkinsfile

@@ -0,0 +1,155 @@
+// Jenkinsfile for Rocky Man
+pipeline {
+    agent {
+        kubernetes {
+            yaml """
+apiVersion: v1
+kind: Pod
+metadata:
+  labels:
+    jenkins: agent
+spec:
+  containers:
+  - name: docker
+    image: docker:24-dind
+    securityContext:
+      privileged: true
+    volumeMounts:
+    - name: docker-sock
+      mountPath: /var/run
+    command:
+    - dockerd-entrypoint.sh
+  - name: docker-cli
+    image: docker:24-cli
+    command:
+    - cat
+    tty: true
+    volumeMounts:
+    - name: docker-sock
+      mountPath: /var/run
+  - name: b2
+    image: backblazeit/b2:latest
+    command:
+    - cat
+    tty: true
+  volumes:
+  - name: docker-sock
+    emptyDir: {}
+"""
+        }
+    }
+
+    parameters {
+        string(
+            name: 'VERSIONS',
+            defaultValue: '8.10 9.6 10.1',
+            description: 'Rocky Linux versions to build (space-separated)'
+        )
+        string(
+            name: 'B2_BUCKET_NAME',
+            defaultValue: 'rockyman',
+            description: 'B2 bucket name for uploads'
+        )
+        string(
+            name: 'EXISTING_VERSIONS',
+            defaultValue: '',
+            description: 'Existing versions already built (space-separated)'
+        )
+        string(
+            name: 'PARALLEL_DOWNLOADS',
+            defaultValue: '5',
+            description: 'Number of parallel downloads'
+        )
+        string(
+            name: 'PARALLEL_CONVERSIONS',
+            defaultValue: '10',
+            description: 'Number of parallel conversions'
+        )
+    }
+
+    options {
+        buildDiscarder(logRotator(numToKeepStr: '10'))
+        timeout(time: 2, unit: 'HOURS')
+    }
+
+    stages {
+        stage('Checkout') {
+            steps {
+                checkout scm
+            }
+        }
+
+        stage('Build Docker Image') {
+            steps {
+                container('docker-cli') {
+                    sh '''
+docker build -t rocky-man:${BUILD_NUMBER} .
+docker tag rocky-man:${BUILD_NUMBER} rocky-man:latest
+                    '''
+                }
+            }
+        }
+
+        stage('Build Man Pages') {
+            steps {
+                container('docker-cli') {
+                    sh '''
+# Create output directories
+mkdir -p ./html ./tmp
+
+# Run the container to build man pages
+docker run --rm \
+  -v "$(pwd)/html:/app/html" \
+  -v "$(pwd)/tmp:/data/tmp" \
+  rocky-man:${BUILD_NUMBER} \
+      --versions ${VERSIONS} \
+      --verbose \
+      --parallel-downloads ${PARALLEL_DOWNLOADS} \
+      --parallel-conversions ${PARALLEL_CONVERSIONS} \
+      --existing-versions "${EXISTING_VERSIONS}"
+                    '''
+                }
+            }
+        }
+
+        stage('Upload to B2') {
+            when {
+                expression { return params.B2_BUCKET_NAME != "" }
+            }
+            steps {
+                container('docker-cli') {
+                    withCredentials([
+                        string(credentialsId: 'b2-app-id', variable: 'B2_APPLICATION_KEY_ID'),
+                        string(credentialsId: 'b2-app-key', variable: 'B2_APPLICATION_KEY')
+                    ]) {
+                        sh '''
+docker run --rm \
+  -v "$(pwd)/html:/workspace/html" \
+  -e B2_APPLICATION_KEY \
+  -e B2_APPLICATION_KEY_ID \
+  backblazeit/b2:latest \
+  b2v4 sync /workspace/html/ "b2://${B2_BUCKET_NAME}/"
+                        '''
+                    }
+                }
+            }
+        }
+    }
+
+    post {
+        success {
+            echo 'Build completed and uploaded to B2!'
+        }
+        failure {
+            echo 'Build failed!'
+        }
+        cleanup {
+            container('docker-cli') {
+                sh '''
+docker rmi rocky-man:${BUILD_NUMBER} || true
+docker rmi rocky-man:latest || true
+                '''
+            }
+        }
+    }
+}

src/rocky_man/web/generator.py

@@ -284,7 +284,8 @@ class WebGenerator:
             max_minors = max(len(major_to_minors[major]) for major in sorted_majors)
             num_columns = len(sorted_majors)
 
-            # Create rows of versions for side-by-side display
+            # Create rows for grid layout (each row has one version from each major)
+            # This creates the data structure for proper column grouping
             version_rows = []
             for minor_idx in range(max_minors):
                 row = []
@@ -293,7 +294,7 @@ class WebGenerator:
                     if minor_idx < len(minors_list):
                         row.append((major, minors_list[minor_idx]))
                     else:
-                        row.append(None)  # Empty cell placeholder
+                        row.append(None)  # Placeholder for empty cells
                 version_rows.append(row)
 
             html = template.render(

templates/root.html

@@ -174,8 +174,6 @@
                 <div class="version-browse">Browse man pages →</div>
                 {% endif %}
             </a>
-            {% else %}
-            <div></div>
             {% endif %}
             {% endfor %}
             {% endfor %}