docs: add a workflow to deploy docs on demand and fix an issue (#1211)

Adds a dedicated GitHub Actions workflow to enable on-demand deployment of documentation to GitHub Pages, and fixes a documentation issue.

Signed-off-by: behnazh-w <[email protected]>

Author: behnazh-w

.github/workflows/manual-deploy-github-pages.yaml

@@ -0,0 +1,35 @@
+# Copyright (c) 2025 - 2025, Oracle and/or its affiliates. All rights reserved.
+# Licensed under the Universal Permissive License v 1.0 as shown at https://oss.oracle.com/licenses/upl/.
+
+# Builds and deploys documentation to GitHub Pages on demand.
+# Although documentation is by default deployed as part of the release process,
+# this workflow allows immediate updates for documentation-only changes or urgent fixes.
+
+name: Build and Deploy to GitHub Pages
+on: workflow_dispatch
+
+permissions:
+  contents: read
+env:
+  ARTIFACT_NAME: artifact-ubuntu-latest-python-3.11
+
+jobs:
+  # Build the artifact.
+  build:
+    uses: ./.github/workflows/_build.yaml
+    permissions:
+      contents: read
+      packages: read
+
+  # Publish docs to GitHub pages.
+  github-pages:
+    needs: [build]
+    name: Deploy GitHub pages
+    uses: ./.github/workflows/_deploy-github-pages.yaml
+    permissions:
+      contents: read
+      pages: write
+      id-token: write
+    with:
+      artifact-name: artifact-ubuntu-latest-python-3.11
+      artifact-sha256: ${{ needs.build.outputs.artifacts-sha256 }}

docs/source/pages/tutorials/rebuild_third_party_artifacts.rst

@@ -3,9 +3,9 @@
 
 .. _tutorial-gen-build-spec:
 
-*********************************************************
+---------------------------------------------------------
 Rebuilding Third-Party Artifacts from Source with Macaron
-*********************************************************
+---------------------------------------------------------
 
 In this tutorial, you'll learn how to use Macaron's new ``gen-build-spec`` command to automatically generate build specification (buildspec) files from analyzed software packages.
 These buildspecs help document and automate the build process for packages, enabling reproducibility and ease of integration with infrastructures such as `Reproducible Central <https://github.com/jvm-repo-rebuild/reproducible-central>`_. For a more detailed description of this feature, refer to our accepted ASE 2025 Industry Showcase paper: `Unlocking Reproducibility: Automating the Re-Build Process for Open-Source Software <https://arxiv.org/pdf/2509.08204>`_.

src/macaron/build_spec_generator/macaron_db_extractor.py

@@ -133,7 +133,7 @@ def compile_sqlite_select_statement(select_statement: Select) -> str:
         The equivalent SQLite SELECT statement as a string.
     """
     compiled_sqlite = select_statement.compile(
-        dialect=sqlite.dialect(),  # type: ignore
+        dialect=sqlite.dialect(),
         compile_kwargs={"literal_binds": True},
     )
     return f"\n----- Begin SQLite query \n{str(compiled_sqlite)}\n----- End SQLite query\n"