chore: improve config diagram accessibility, spacing

Author: zlataovce

src/components/ConfigNode.astro

@@ -23,7 +23,9 @@ interface Default {
   inline: boolean;
 }
 const formatDefault = (value?: string): Default => {
-  if (!value) value = "";
+  if (!value) {
+    value = lang === "properties" ? "" : '""';
+  }
   if (!json && value.length > 2 && value.match(/^\[.+]$/)) {
     return {
       value: value
@@ -44,7 +46,9 @@ const formatDefault = (value?: string): Default => {
   {
     Object.entries(data).map(([key, rawValue], i, entries) => {
       let displayKey = key.replace(/_+$/, ""); // remove trailing underscores, used for duplicating keys
-      if (json) displayKey = `"${displayKey}"`;
+      if (json) {
+        displayKey = `"${displayKey}"`;
+      }
 
       const childPath = [...path, key.replace(/-/g, "_")];
       const hasComma = json && i !== (entries.length - 1);
@@ -61,16 +65,16 @@ const formatDefault = (value?: string): Default => {
           ) : "description" in rawValue ? (
             <details id={childPath.join("_")}>
               <summary class="line notranslate" translate="no">
-                <span class="key">{displayKey}{separator}</span>{
+                <span class="key key-leaf">{displayKey}</span><span class="muted">{separator}</span>{
                   inline
-                    ? (<span class="value">{value}</span><>{hasComma && <span class="muted">,</span>}</><a class="link" href={`#${childPath.join("_")}`}>#</a>)
+                    ? (<span class="value">{value}</span><>{hasComma && <span class="muted">,</span>}</><a class="link link-inline" href={`#${childPath.join("_")}`}>#</a>)
                     : (<a class="link" href={`#${childPath.join("_")}`}>#</a><p class="value">{value}</p><>{hasComma && <span class="muted">,</span>}</>)
                 }
               </summary>
               <div class="block" set:html={render(rawValue.description)} />
             </details>
           ) : (
-            <span class="key notranslate" translate="no">{displayKey}{separator}</span>
+            <span class="key notranslate" translate="no">{displayKey}</span><span class="muted">{separator}</span>
             <Astro.self child data={rawValue} path={childPath} {lang} />
           )}
         </div>
@@ -108,6 +112,10 @@ const formatDefault = (value?: string): Default => {
 
   .key {
     white-space: pre-wrap;
+    color: var(--sl-color-gray-3);
+  }
+
+  .key-leaf {
     color: var(--sl-color-text-accent);
   }
 
@@ -125,7 +133,6 @@ const formatDefault = (value?: string): Default => {
     color: var(--sl-color-white);
     background-color: var(--sl-color-gray-5);
     border-left: 5px solid var(--sl-color-bg-accent);
-    white-space: pre-wrap;
   }
 
   .message {
@@ -144,14 +151,24 @@ const formatDefault = (value?: string): Default => {
     color: var(--sl-color-gray-3);
   }
 
-  .link {
-    opacity: 0;
-    padding-left: 0.5rem;
+  .link,
+  .link:visited {
+    color: var(--sl-color-accent-high);
     transition: opacity 0.2s ease;
   }
 
-  .line:hover .link {
-    opacity: 1;
+  .link-inline {
+    padding-left: 0.5rem;
+  }
+
+  @media not (hover: none) {
+    .link {
+      opacity: 0;
+    }
+
+    .line:hover .link {
+      opacity: 1;
+    }
   }
 </style>
 

src/config/paper/help.yml

@@ -7,19 +7,16 @@ general-topics:
         The first line of the help entry, used as a summary in index pages.
 
         This is formatted with legacy "&" style formatting.
-      default: '""'
     fullText:
       description: |
         The remaining lines of this help entry.
 
         This is formatted with legacy "&" style formatting.
-      default: '""'
     permission:
       description: |
         The permission required to view this help entry.
 
         If this is empty/not set, the entry does not require a permission.
-      default: '""'
 
 index-topics:
   <topic name>:
@@ -36,19 +33,16 @@ index-topics:
         This is not displayed when showing this topic itself.
 
         This is formatted with legacy "&" style formatting.
-      default: '""'
     preamble:
       description: |
         Information to show before the index.
 
         This is formatted with legacy "&" style formatting.
-      default: '""'
     permission:
       description: |
         A custom permission required to view this help entry.
 
         If this is empty/not set, the entry does not require a permission.
-      default: '""'
     commands:
       description: |
         What to show in the index.
@@ -72,7 +66,6 @@ amended-topics:
         If this contains the literal string `<text>`, it will be replaced with the original short text.
 
         This is formatted with legacy "&" style formatting.
-      default: '""'
     fullText:
       description: |
         A replacement for the full text of the topic.
@@ -82,13 +75,11 @@ amended-topics:
         If this contains the literal string `<text>`, it will be replaced with the original full text.
 
         This is formatted with legacy "&" style formatting.
-      default: '""'
     permission:
       description: |
         Overrides the permission required to view this help entry.
 
         If this is empty/not set, the original permission is NOT used, instead no permission is required.
-      default: '""'
 
 ignore-plugins:
   description: |

src/config/paper/paper-global.yml

@@ -477,6 +477,7 @@ unsupported-settings:
     message: >-
       **Unsupported settings**
 
+
       The following settings are provided by Paper but are not officially
       supported. Use them at your own risk and they may be removed at any time.
   allow-headless-pistons:

src/config/paper/paper-world-defaults.yml

@@ -1097,6 +1097,7 @@ unsupported-settings:
     message: >-
       **Unsupported settings**
 
+
       The following settings are provided by Paper but are not officially
       supported. Use them at your own risk and they may be removed at any time.
   disable-world-ticking-when-empty:

src/config/paper/permissions.yml

@@ -26,4 +26,3 @@
       default: "true"
   description_:
     description: The description of the permission.
-    default: '""'