Build website via GHA and deploy to graalpy.org.

Author: olyagpl

.github/workflows/build-website.yml

@@ -0,0 +1,64 @@
+name: Build and deploy website
+
+on:
+  pull_request:
+    paths:
+      - 'docs/site/**'
+      - '.github/workflows/build-website.yml'
+  push:
+    branches:
+      - master
+    paths:
+      - 'docs/site/**'
+      - '.github/workflows/build-website.yml'
+  # Allows you to run this workflow manually from the Actions tab
+  workflow_dispatch:
+
+# Sets permissions of the GITHUB_TOKEN to allow deployment to GitHub Pages
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+# Allow only one concurrent deployment, skipping runs queued between the run in-progress and latest queued.
+# However, do NOT cancel in-progress runs as we want to allow these production deployments to complete.
+concurrency:
+  group: "pages"
+  cancel-in-progress: false
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v6
+      - name: Set up Ruby
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: '3.2'
+      - name: Install website dependencies
+        working-directory: docs/site
+        run: bundle install
+      - name: Build website
+        working-directory: docs/site
+        env:
+          JEKYLL_ENV: production
+        run: bundle exec jekyll build
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v5
+        with:
+          path: docs/site/_site
+
+  deploy:
+    # The website should only be deployed from a release branch:
+    # if: startsWith(github.head_ref, 'release/graal-vm/')
+    if: github.event_name == 'push' && github.ref == 'refs/heads/master'
+    runs-on: ubuntu-latest
+    needs: build
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v5

docs/site/01-python-developers.md

@@ -29,7 +29,7 @@ audience_identifier: python
               <h4>Single-Binary Packaging</h4>
             </div>
             <div class="langpage__benefits-text">
-              <h5>Package Python applications as a <a href="/python/python-developers/docs/#python-standalone-applications">single binary</a></h5>
+              <h5>Package Python applications as a <a href="{{ '/python-developers/docs/#python-standalone-applications' | relative_url }}">single binary</a></h5>
             </div>
           </div>
           <div class="langbenefits__card">
@@ -74,8 +74,8 @@ audience_identifier: python
         <h3 class="langstarter__title">Install or Download</h3>
         <div>
           <h5 class="download-text">
-          GraalPy is available for multiple platforms. Distributions based on Oracle GraalVM provide the best performance and advanced features and are released under the <a href="https://www.oracle.com/downloads/licenses/graal-free-license.html">GFTC license</a>. Distributions based on GraalVM Community Edition, released under the OSI-approved <a href="https://opensource.org/licenses/UPL">UPL license</a>, are available on <a href="https://github.com/oracle/graalpython/releases">GitHub</a>.
-          See <a href="/python/python-developers/docs/#choosing-a-graalpy-distribution">Choosing a GraalPy Distribution</a> for guidance on available distributions.
+          GraalPy is available for multiple platforms in two variants: <strong class="language-downloads__variant-native">Native</strong> (for a compact download size and smaller footprint) and <strong class="language-downloads__variant-jvm">JVM</strong> (for full Java interoperability). Distributions based on Oracle GraalVM provide the best performance and advanced features and are released under the <a href="https://www.oracle.com/downloads/licenses/graal-free-license.html">GFTC license</a>. Distributions based on GraalVM Community Edition, released under the OSI-approved <a href="https://opensource.org/licenses/UPL">UPL license</a>, are available on <a href="https://github.com/oracle/graalpython/releases">GitHub</a>.
+          See <a href="{{ '/python-developers/docs/#choosing-a-graalpy-distribution' | relative_url }}">Choosing a GraalPy Distribution</a> for guidance on selecting the appropriate runtime.
           </h5>
         </div>
         <div class="languages__example-card">

docs/site/03-jvm-developers-compatibility.md

@@ -166,7 +166,7 @@ img.pylogo {
         });
         var module_testing_csv = new Promise(function (resolve, reject) {
             const xhr = new XMLHttpRequest();
-            const url = `/python/module_results/python-module-testing-${graalpyVersion}.csv`;
+            const url = `{{ '/module_results/' | relative_url }}python-module-testing-${graalpyVersion}.csv`;
             xhr.open('GET', url);
             xhr.overrideMimeType('text/plain');
             xhr.onload = function () {
@@ -183,7 +183,7 @@ img.pylogo {
         });
         var wheels_csv = new Promise(function (resolve, reject) {
             const xhr = new XMLHttpRequest();
-            const url = `/python/wheels/${graalpyVersion}.csv`;
+            const url = `{{ '/wheels/' | relative_url }}${graalpyVersion}.csv`;
             xhr.open('GET', url);
             xhr.overrideMimeType('text/plain');
             xhr.onload = function () {

docs/site/03-python-developers-compatibility.md

@@ -166,7 +166,7 @@ img.pylogo {
         });
         var module_testing_csv = new Promise(function (resolve, reject) {
             const xhr = new XMLHttpRequest();
-            const url = `/python/module_results/python-module-testing-${graalpyVersion}.csv`;
+            const url = `{{ '/module_results/' | relative_url }}python-module-testing-${graalpyVersion}.csv`;
             xhr.open('GET', url);
             xhr.overrideMimeType('text/plain');
             xhr.onload = function () {
@@ -183,7 +183,7 @@ img.pylogo {
         });
         var wheels_csv = new Promise(function (resolve, reject) {
             const xhr = new XMLHttpRequest();
-            const url = `/python/wheels/${graalpyVersion}.csv`;
+            const url = `{{ '/wheels/' | relative_url }}${graalpyVersion}.csv`;
             xhr.open('GET', url);
             xhr.overrideMimeType('text/plain');
             xhr.onload = function () {

docs/site/CNAME

@@ -0,0 +1 @@
+graalpy.org

docs/site/_config.yml

@@ -1,5 +1,5 @@
-baseurl: "/python"
-url: "https://graalvm.org"
+baseurl: ""
+url: "https://graalpy.org"
 github: "oracle/graalpython"
 language_version: 25.0.2
 python_version: 3.12

docs/site/docs-redirect.md

@@ -5,11 +5,11 @@ redirect_to: jvm-developers/docs/
 ---
 
 <script>
-window.location.replace('/python/jvm-developers/docs/');
+window.location.replace({{ '/jvm-developers/docs/' | relative_url | jsonify }});
 </script>
 
 <noscript>
-<meta http-equiv="refresh" content="0; url=/python/jvm-developers/docs/" />
+<meta http-equiv="refresh" content="0; url={{ '/jvm-developers/docs/' | relative_url }}" />
 </noscript>
 
-<p>Redirecting to the documentation for <a href="/python/jvm-developers/docs/">JVM Developers</a>...</p>
+<p>Redirecting to the documentation for <a href="{{ '/jvm-developers/docs/' | relative_url }}">JVM Developers</a>...</p>

docs/user/Python-Standalone-Applications.md

@@ -13,7 +13,7 @@ The module bundles all your application's resources into a single file.
 
 ## Running Python Standalone Applications
 
-To create an native executable from a Python file with its dependencies, use this command:
+To create a native executable from a Python file with its dependencies, use this command:
 
 ```bash
 graalpy -m standalone native \