From 8bddd07c5c249409b831e6c63781ca827665a434 Mon Sep 17 00:00:00 2001
From: zml <zml@stellardrift.ca>
Date: Sat, 29 Jul 2023 11:34:52 -0700
Subject: [PATCH] Add information about Vineflower maven publication

---
 .../vineflower_site_extensions/__init__.py    |  1 -
 source/conf.py                                | 10 ++-
 source/index.rst                              | 85 +++++++++++++++++++
 source/socials.rst                            |  1 -
 4 files changed, 94 insertions(+), 3 deletions(-)

diff --git a/source/_ext/vineflower_site_extensions/__init__.py b/source/_ext/vineflower_site_extensions/__init__.py
index 84e0f5f..7959d95 100644
--- a/source/_ext/vineflower_site_extensions/__init__.py
+++ b/source/_ext/vineflower_site_extensions/__init__.py
@@ -32,7 +32,6 @@ def setup(app: Sphinx):
     app.add_role("mojira", mojira_role)
     app.add_role("java", highlight_role("java"))
 
-
 _issue_regex = re.compile(r'[A-Z]+-[1-9][0-9]*')
 _mojira_url = "https://bugs.mojang.com/browse/"
 
diff --git a/source/conf.py b/source/conf.py
index 2530680..3370c80 100644
--- a/source/conf.py
+++ b/source/conf.py
@@ -29,6 +29,14 @@
 # The full api version, including alpha/beta/rc tags
 release = '1.9.2'
 
+rst_prolog = f"""
+.. |version| replace:: {release}
+"""
+
+myst_substitutions = {
+    'version': release
+}
+
 if release.endswith('-SNAPSHOT'):
     tags.add('draft')
 
@@ -36,7 +44,7 @@
     ref = os.environ['GITHUB_REF']
     if ref.startswith("refs/pull/"):
         pr_number = ref[len("refs/pull/"):-len("/merge")]
-        rst_prolog = f"""
+        rst_prolog += f"""
 .. caution::
 
     This version of the Vineflower site has been built as a preview of pull request :github:`vineflower-site#{pr_number}`, and has not been reviewed.
diff --git a/source/index.rst b/source/index.rst
index 91b2a27..9e1d9e6 100644
--- a/source/index.rst
+++ b/source/index.rst
@@ -9,6 +9,91 @@ Downloads
 
 The primary mode of distribution for Vineflower is the jar, which can be found on the `releases page <https://github.com/Vineflower/vineflower/releases>`_ on GitHub, which can also found on maven. There is also an `Intellij Plugin <https://plugins.jetbrains.com/plugin/18032-quiltflower>`_ for use.
 
+Running Vineflower requires a Java 11 or newer JVM, though classpath context can be loaded from any other JVM using the ``-jrt`` CLI parameter.
+
+Vineflower is published on Maven Central, and can be accessed from build scripts like so:
+
+.. tab-set::
+
+   .. tab-item:: Maven
+      :sync: maven
+
+      .. code-block:: xml
+        :substitutions:
+
+         <dependency>
+            <groupId>org.vineflower</groupId>
+            <artifactId>vineflower</artifactId>
+            <version>|version|</version>
+         </dependency>
+
+   .. tab-item:: Gradle (Groovy)
+      :sync: gradle-groovy
+
+      .. code-block:: groovy
+        :substitutions:
+
+         repositories {
+            mavenCentral()
+         }
+
+         dependencies {
+            implementation "org.vineflower:vineflower:|version|"
+         }
+
+
+   .. tab-item:: Gradle (Kotlin)
+      :sync: gradle-kotlin
+
+      .. code-block:: kotlin
+        :substitutions:
+
+         repositories {
+            mavenCentral()
+         }
+
+         dependencies {
+            implementation("org.vineflower:vineflower:|version|")
+         }
+
+Development (``-SNAPSHOT``) builds are published on the Sonatype OSS snapshots repository as well for testing purposes:
+
+.. tab-set::
+
+   .. tab-item:: Maven
+      :sync: maven
+
+      .. code:: xml
+
+         <repositories>
+             <repository>
+                <id>sonatype-oss-snapshots1</id>
+                <url>https://s01.oss.sonatype.org/content/repositories/snapshots/</url>
+             </repository>
+         </repositories>
+
+   .. tab-item:: Gradle (Groovy)
+      :sync: gradle-groovy
+
+      .. code:: groovy
+
+         repositories {
+            maven {
+                name = "sonatype-oss-snapshots1"
+                url = "https://s01.oss.sonatype.org/content/repositories/snapshots/"
+            }
+         }
+
+   .. tab-item:: Gradle (Kotlin)
+      :sync: gradle-kotlin
+
+      .. code:: kotlin
+
+         repositories {
+            maven(url = "https://s01.oss.sonatype.org/content/repositories/snapshots/") {
+                name = "sonatype-oss-snapshots"
+            }
+         }
 
 Socials
 =========
diff --git a/source/socials.rst b/source/socials.rst
index 5a7803a..64164bc 100644
--- a/source/socials.rst
+++ b/source/socials.rst
@@ -3,7 +3,6 @@ Socials
 
 Vineflower's social spaces consists of a Discord guild, Matrix room, and IRC channel, all bridged together as one. Before you join, there are some rules to be read:
 
-|
 1. No hate speech, bigotry, NSFW content, spam, or otherwise unwanted content.
 2. Keep on topic if there is on-topic discussion, and don't import drama from other communities.
 3. Keep discussions polite and respectful, and avoid meaningless arguments.