From c5a4bcd3f6fafeec813f2b45857b8785f3cd3eb0 Mon Sep 17 00:00:00 2001
From: carsakiller <carsakiller@gmail.com>
Date: Fri, 29 Aug 2025 04:24:11 +0000
Subject: [PATCH] add: introduce luarocks addons

---
 src/components/common/Remark.astro |  2 +-
 src/content/wiki/addons.mdx        | 18 +++++++++++++++++
 src/pages/index.astro              | 31 +++++++++++++-----------------
 3 files changed, 32 insertions(+), 19 deletions(-)

diff --git a/src/components/common/Remark.astro b/src/components/common/Remark.astro
index 7269923..b85e3da 100644
--- a/src/components/common/Remark.astro
+++ b/src/components/common/Remark.astro
@@ -50,7 +50,7 @@ const classList = [type, "remark", display ?? "block"];
     border-style: outset;
     margin: 1em auto;
     width: fit-content;
-    box-shadow: var(--remark-color) 1px 1px 0.5em 0px;
+    box-shadow: var(--remark-color) 0px 0px 0.75em 0px;
     border-color: var(--remark-color);
     background-color: color-mix(in srgb, var(--remark-color), #071521 80%);
 
diff --git a/src/content/wiki/addons.mdx b/src/content/wiki/addons.mdx
index 0c910ac..51c1656 100644
--- a/src/content/wiki/addons.mdx
+++ b/src/content/wiki/addons.mdx
@@ -148,5 +148,23 @@ The `config.json` file is very important for addons and must be included. A sche
 }
 ```
 
+## LuaRocks
+
+<Remark type="WIP">
+LuaRocks addons are currently in beta. Please report any encountered issues in the [luarocks build backend repo](https://github.com/LuaLS/luarocks-build-addon)!
+</Remark>
+
+We'd love feedback with publishing and installing addons via LuaRocks. Using LuaRocks for managing addons should be much more sustainable than the current method (and its independent of editor!). It is very similar to how addons have previously functioned, with some notable changes:
+
+1. The `config.json` file is deprecated, replaced by the `*.rockspec` file.
+    - `words` and `files` properties are no longer supported.
+    - `settings` are to be defined in `build.settings` in the `*.rockspec` file
+2. Plugins are now automatically discovered and enabled upon addon installation.
+3. Addons can depend on each other using the native `dependencies` table of the `*.rockspec` file.
+
+See the [README for the luarocks build backend](https://github.com/LuaLS/luarocks-build-addon#readme) to learn more. Please provide all feedback in that repo. <Icon name="heart" group="solid" color="red"/>
+
+See https://gitlab.com/carsakiller/lls-addon-cc-tweaked as an example, which is a migrated version of the [cc-tweaked addon](https://gitlab.com/carsakiller/cc-tweaked-documentation).
+
 {/* Links */}
 [LLS-Addons]: https://github.com/LuaLS/LLS-Addons
diff --git a/src/pages/index.astro b/src/pages/index.astro
index 2faf6eb..6727f5c 100644
--- a/src/pages/index.astro
+++ b/src/pages/index.astro
@@ -53,9 +53,10 @@ const annotationCount = annotationsPage
         </div>
 
         <div class="announcement">
-          <a href="#jetbrains-install">
-            <span class="tag">NEW</span>
-            <span class="description">JetBrains IntelliJ Plugin</span>
+          <a href="/wiki/addons/#luarocks">
+            <span class="tag">BETA</span><span class="description"
+              >Install Addons From LuaRocks</span
+            >
           </a>
         </div>
 
@@ -524,10 +525,12 @@ exec &quot;&lt;path-to-directory&gt;/bin/lua-language-server&quot; &quot;$@&quot
     .announcement {
       width: fit-content;
       margin: 1em auto auto auto;
-      border: 0.1em #2d8ae3 solid;
       border-radius: 99em;
       background-color: #16436e00;
-      box-shadow: #16436e 0px 0px 0.5em 0px;
+      font-size: 1.1em;
+      padding: 0.2em 0.2em;
+      background: linear-gradient(90deg, #702fc6 0%, #b710c0 100%);
+      box-shadow: #b669ff 0px 0px 1em 0px;
 
       a {
         color: white;
@@ -538,24 +541,16 @@ exec &quot;&lt;path-to-directory&gt;/bin/lua-language-server&quot; &quot;$@&quot
       }
 
       span.tag {
-        background-color: #2d8ae3;
+        font-weight: bold;
         border-radius: 1em 0px 0px 1em;
         position: relative;
-        padding-left: 0.75em;
-
-        &::after {
-          content: "";
-          position: absolute;
-          top: 0px;
-          right: -0.25em;
-          width: 0.25em;
-          height: 100%;
-          background: linear-gradient(90deg, #2d8ae3, #00000000);
-        }
+        padding: 0.2em 0.5em 0.2em 0.75em;
       }
 
       span.description {
-        margin: 0px 0.25em;
+        margin: 0px;
+        border-radius: 0px 99em 99em 0px;
+        border-left: 2px solid white
       }
     }