Merge branch 'restructure-part1' of https://github.com/ronzulu/talon-community-wiki into restructure-part1

ronzulu · ronzulu · commit f13530b6886f · 2025-03-24T17:30:21.000+11:00
diff --git a/docs/Resource Hub/Talon Installation/installation_guide.md b/docs/Resource Hub/Talon Installation/installation_guide.md
@@ -11,7 +11,6 @@ some steps are specific to the Talon community user file set, and will be marked
 
 :::
 
-
 ## 1: Check System Requirements
 
 Talon has various [system requirements](../Hardware/os), covering the computer hardware, operating system and microphone hardware.
@@ -87,9 +86,6 @@ If you install a different user file set then portions of this wiki will not be
 These will be marked as such.
 :::
 
-
-
-
 A `user file set` is simply a bunch of files that need to be downloaded and placed in the correct directory -
 the Talon user directory.
 <!-- Update in later phase of https://github.com/TalonCommunity/Wiki/pull/312
@@ -111,10 +107,9 @@ If you have installed a different user file set, consult its documentation on us
 
 ## 6: Next steps
 
-
 - If needed, try ways to [improve recognition accuracy](../Speech%20Recognition/improving_recognition_accuracy.md)
 - [Customize Talon](../../Customization/basic_customization): learn about how to configure Talon to your liking.
- - If at any point you need help with your Talon setup, join the [Talon Voice Slack](https://talonvoice.com/chat) and ask in the `#help` channel.
+- If at any point you need help with your Talon setup, join the [Talon Voice Slack](https://talonvoice.com/chat) and ask in the `#help` channel.
 - For earlier access to new features, priority support, and access to additional [speech engines](../Speech%20Recognition/speech%20engines.md), install the [beta version](../../Help/beta_talon).
 
 <!-- Update in later phase of https://github.com/TalonCommunity/Wiki/pull/312
diff --git a/docusaurus.config.ts b/docusaurus.config.ts
@@ -86,7 +86,7 @@ const config: Config = {
         removeDefaultStemmer: true,
       },
     ],
-    "@docusaurus/theme-mermaid"
+    "@docusaurus/theme-mermaid",
   ],
   themeConfig: {
     // Replace with your project's social card
diff --git a/src/css/custom.css b/src/css/custom.css
@@ -6,55 +6,55 @@
 
 /* You can override the default Infima variables here. */
 :root {
-    --ifm-color-primary: #2e8555;
-    --ifm-color-primary-dark: #29784c;
-    --ifm-color-primary-darker: #277148;
-    --ifm-color-primary-darkest: #205d3b;
-    --ifm-color-primary-light: #33925d;
-    --ifm-color-primary-lighter: #359962;
-    --ifm-color-primary-lightest: #3cad6e;
-    --ifm-code-font-size: 95%;
-    --docusaurus-highlighted-code-line-bg: rgba(0, 0, 0, 0.1);
-  }
-  
-  /* For readability concerns, you should choose a lighter palette in dark mode. */
-  [data-theme="dark"] {
-    --ifm-color-primary: #25c2a0;
-    --ifm-color-primary-dark: #21af90;
-    --ifm-color-primary-darker: #1fa588;
-    --ifm-color-primary-darkest: #1a8870;
-    --ifm-color-primary-light: #29d5b0;
-    --ifm-color-primary-lighter: #32d8b4;
-    --ifm-color-primary-lightest: #4fddbf;
-    --docusaurus-highlighted-code-line-bg: rgba(0, 0, 0, 0.3);
-  }
-  
-  .hidden {
-    display: none !important;
-  }
+  --ifm-color-primary: #2e8555;
+  --ifm-color-primary-dark: #29784c;
+  --ifm-color-primary-darker: #277148;
+  --ifm-color-primary-darkest: #205d3b;
+  --ifm-color-primary-light: #33925d;
+  --ifm-color-primary-lighter: #359962;
+  --ifm-color-primary-lightest: #3cad6e;
+  --ifm-code-font-size: 95%;
+  --docusaurus-highlighted-code-line-bg: rgba(0, 0, 0, 0.1);
+}
+
+/* For readability concerns, you should choose a lighter palette in dark mode. */
+[data-theme="dark"] {
+  --ifm-color-primary: #25c2a0;
+  --ifm-color-primary-dark: #21af90;
+  --ifm-color-primary-darker: #1fa588;
+  --ifm-color-primary-darkest: #1a8870;
+  --ifm-color-primary-light: #29d5b0;
+  --ifm-color-primary-lighter: #32d8b4;
+  --ifm-color-primary-lightest: #4fddbf;
+  --docusaurus-highlighted-code-line-bg: rgba(0, 0, 0, 0.3);
+}
+
+.hidden {
+  display: none !important;
+}
 
 [data-theme="dark"] pre {
   color: var(--shiki-dark) !important;
   background-color: var(--shiki-dark-bg) !important;
 }
 [data-theme="dark"] pre span {
- color: var(--shiki-dark) !important;
+  color: var(--shiki-dark) !important;
 }
 
 .theme-admonition.docotodo {
-    background-color: rgb(121, 68, 146);
-    border-left: 4px solid rgb(58, 23, 73);
-    color: white;
+  background-color: rgb(121, 68, 146);
+  border-left: 4px solid rgb(58, 23, 73);
+  color: white;
 }
 
 .theme-admonition.docofeedback {
-    background-color: rgb(92, 104, 61);
-    border-left: 4px solid rgb(4, 43, 7);
-    color: white;
+  background-color: rgb(92, 104, 61);
+  border-left: 4px solid rgb(4, 43, 7);
+  color: white;
 }
 
 .theme-admonition.docoscope {
-    background-color: #373255;
-    border-left: 4px solid #651FFF;
-    color: white;
+  background-color: #373255;
+  border-left: 4px solid #651fff;
+  color: white;
 }
diff --git a/src/pages/index.md b/src/pages/index.md
@@ -10,7 +10,6 @@ Talon is free to use and ongoing development is made possible by [donations on P
 
 ## Talon Landscape
 
-
 ```mermaid
 mindmap
   root{{"Talon Platform<br/>talonvoice.com"}}
@@ -39,13 +38,14 @@ mindmap
       Stream Deck
 
 ```
+
 ---
 
 ## Jumping In
 
 Before installing Talon, there is useful information on this page and on the linked pages for you to read.
 
-If you prefer jumping in, here is the [installation guide](/Resource%20Hub/Talon%20Installation/installation_guide) and 
+If you prefer jumping in, here is the [installation guide](/Resource%20Hub/Talon%20Installation/installation_guide) and
 information about [basic usage](/Basic%20Usage/basic_usage).
 
 ---
@@ -75,7 +75,6 @@ of this wiki is relevant. Those that are will be highlighted as follows.
   </div>
 </div>
 
-
 ---
 
 ## Goal of this Wiki
@@ -86,14 +85,14 @@ The goal of this wiki is to provide information and documentation for the users
 
 ## Wiki Navigation
 
-| If you are looking for:                                    | See:                                                                                                                       |
-| ---------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |
-| Videos of Talon in use                                     | [Video Demos](/Integrations/talon_related_resources)                                                                     |
-| Help with deciding on a microphone or eye tracker          | [Hardware](/Resource%20Hub/Hardware)                                                                                       |
+| If you are looking for:                                    | See:                                                                                                                   |
+| ---------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------- |
+| Videos of Talon in use                                     | [Video Demos](/Integrations/talon_related_resources)                                                                   |
+| Help with deciding on a microphone or eye tracker          | [Hardware](/Resource%20Hub/Hardware)                                                                                   |
 | Installing and getting started with Talon                  | [Installing Talon](/Resource%20Hub/Talon%20Installation/installation_guide), [Basic Usage](/Basic%20Usage/basic_usage) |
-| How to customize Talon, obtaining additional functionality | [Basic Customization](/Customization/basic_customization), [Integrations](/Integrations/essential-tools)                                              |
-| Troubleshooting help                                       | [Troubleshooting](/Resource%20Hub/Speech%20Recognition/troubleshooting)                                                            |
-| Answers to frequently asked questions                      | [FAQ](/Help/FAQ)                                                                                                           |
+| How to customize Talon, obtaining additional functionality | [Basic Customization](/Customization/basic_customization), [Integrations](/Integrations/essential-tools)               |
+| Troubleshooting help                                       | [Troubleshooting](/Resource%20Hub/Speech%20Recognition/troubleshooting)                                                |
+| Answers to frequently asked questions                      | [FAQ](/Help/FAQ)                                                                                                       |
 
 :::tip Talon Slack
 
diff --git a/src/theme/Admonition/Type/Info.tsx b/src/theme/Admonition/Type/Info.tsx
@@ -1,49 +1,59 @@
-import React, {type ReactNode} from 'react';
-import Info from '@theme-original/Admonition/Type/Info';
-import type InfoType from '@theme/Admonition/Type/Info';
-import type {WrapperProps} from '@docusaurus/types';
+import React, { type ReactNode } from "react";
+import Info from "@theme-original/Admonition/Type/Info";
+import type InfoType from "@theme/Admonition/Type/Info";
+import type { WrapperProps } from "@docusaurus/types";
 
 type Props = WrapperProps<typeof InfoType>;
 
 function ScopeIcon() {
-    return (
-        <svg viewBox="0 0 24 24">
-            <path d="M4 12H4.01M8 12H8.01M16 12H16.01M12 12H12.01M20 12H20.01M8.5 4H7.2C6.0799 4 5.51984 4 5.09202 4.21799C4.71569 4.40973 4.40973 4.71569 4.21799 5.09202C4 5.51984 4 6.0799 4 7.2V8.5M15.5 4H16.8C17.9201 4 18.4802 4 18.908 4.21799C19.2843 4.40973 19.5903 4.71569 19.782 5.09202C20 5.51984 20 6.07989 20 7.2V8.5M20 15.5V16.8C20 17.9201 20 18.4802 19.782 18.908C19.5903 19.2843 19.2843 19.5903 18.908 19.782C18.4802 20 17.9201 20 16.8 20H15.5M4 15.5V16.8C4 17.9201 4 18.4802 4.21799 18.908C4.40973 19.2843 4.71569 19.5903 5.09202 19.782C5.51984 20 6.0799 20 7.2 20H8.5" 
-            stroke="#ffffff" strokeWidth="1" strokeLinecap="round" strokeLinejoin="round"/>
-        </svg>
-    );
+  return (
+    <svg viewBox="0 0 24 24">
+      <path
+        d="M4 12H4.01M8 12H8.01M16 12H16.01M12 12H12.01M20 12H20.01M8.5 4H7.2C6.0799 4 5.51984 4 5.09202 4.21799C4.71569 4.40973 4.40973 4.71569 4.21799 5.09202C4 5.51984 4 6.0799 4 7.2V8.5M15.5 4H16.8C17.9201 4 18.4802 4 18.908 4.21799C19.2843 4.40973 19.5903 4.71569 19.782 5.09202C20 5.51984 20 6.07989 20 7.2V8.5M20 15.5V16.8C20 17.9201 20 18.4802 19.782 18.908C19.5903 19.2843 19.2843 19.5903 18.908 19.782C18.4802 20 17.9201 20 16.8 20H15.5M4 15.5V16.8C4 17.9201 4 18.4802 4.21799 18.908C4.40973 19.2843 4.71569 19.5903 5.09202 19.782C5.51984 20 6.0799 20 7.2 20H8.5"
+        stroke="#ffffff"
+        strokeWidth="1"
+        strokeLinecap="round"
+        strokeLinejoin="round"
+      />
+    </svg>
+  );
 }
 
 export default function InfoWrapper(props: Props): ReactNode {
-    const { title, children } = props;
+  const { title, children } = props;
 
-    let scope = null;
-    let body = null;
-    if (props.title == "talon-scope-platform") {
-        scope = "Talon Platform";
-        body = `This section is relevant to all users of the talon platform, regardless of whether or not the Talon community user file set
+  let scope = null;
+  let body = null;
+  if (props.title == "talon-scope-platform") {
+    scope = "Talon Platform";
+    body = `This section is relevant to all users of the talon platform, regardless of whether or not the Talon community user file set
             has also been installed.`;
-    } else if (props.title == "talon-scope-community") {
-        scope = "Talon Community User File Set";
-        body = (<span>This section is only relevant to users who have installed the 
-            <a href="Resource Hub/Talon Installation/downloading-community">Talon community user file set</a></span>);
-    } else if (props.title == "talon-scope") {
-        scope = "";
-        body = children;
-    }
-    const isCustom = Boolean(body);
-    const heading = isCustom ? `[SCOPE] ${scope}` : null;
-
-    
-    return (
-        <>
-        {  isCustom ?
-            <Info icon={<ScopeIcon />} className="docoscope" title={heading} >
-                {body} 
-            </Info>
-            :
-            <Info {...props} />
-        }
-        </>
+  } else if (props.title == "talon-scope-community") {
+    scope = "Talon Community User File Set";
+    body = (
+      <span>
+        This section is only relevant to users who have installed the
+        <a href="Resource Hub/Talon Installation/downloading-community">
+          Talon community user file set
+        </a>
+      </span>
     );
+  } else if (props.title == "talon-scope") {
+    scope = "";
+    body = children;
+  }
+  const isCustom = Boolean(body);
+  const heading = isCustom ? `[SCOPE] ${scope}` : null;
+
+  return (
+    <>
+      {isCustom ? (
+        <Info icon={<ScopeIcon />} className="docoscope" title={heading}>
+          {body}
+        </Info>
+      ) : (
+        <Info {...props} />
+      )}
+    </>
+  );
 }
