feat: upgrade speaker.bot docs to new content format

Author: Whipstickgostop

speakerbot/0.get-started/_dir.yml speakerbot/0.get-started/.navigation.ymlspeakerbot/0.get-started/_dir.yml renamed to speakerbot/0.get-started/.navigation.yml

@@ -8,22 +8,20 @@ Click the button below to download the latest stable version of Speaker.bot.
 
 You should end up with a regular `.zip` file.
 
-::card-group
-  ::card{icon=i-mdi-download title="Speaker.bot" to=https://streamer.bot/api/releases/twitchspeaker/latest/download target=_blank}
-  Download the latest stable version of Speaker.bot
-  ::
+::card{icon=i-mdi-download title="Speaker.bot" to=https://streamer.bot/api/releases/twitchspeaker/latest/download target=_blank}
+Download the latest stable version of Speaker.bot
 ::
 
 ## Extract
 Extract the `.zip` archive to your desired location.
 
-::callout{icon=i-mdi-lightbulb color=primary}
+::note
 Speaker.bot is a **portable** application, no further installation is needed!
 ::
 
 ## Run
 Open the directory where you chose to extract the archive and execute `Speaker.bot.exe`!
 
-::callout{icon=i-mdi-check color=green}
+::success
 Speaker.bot should now be running!
 ::

speakerbot/0.get-started/0.installation.md

@@ -1,63 +1,69 @@
-# Account Setup
+---
+title: Account Setup
+description: Configure your third-party accounts in Speaker.bot
+---
 
-::list{type="info"}
-- Navigate to `Settings -> Accounts`
+::navigate
+Navigate to **Settings > Accounts** in Speaker.bot
 ::
 
 Here you will find account configuration settings for supported integrations.
 
+## Integrations
+
 ### Twitch
 
 The [Twitch](https://twitch.tv) integration is **required** to perform TTS on any live stream events.
 
-::list{type="success"}
-- Login via OAuth
+::success
+Sign in to your Twitch account via OAuth
 ::
 
-::list{type="primary"}
-- Chat
-- Follows, subscriptions, gift bombs, etc.
-- Channel Point Rewards
-::
+| Supported Features                                |
+| ------------------------------------------------- |
+| Chat                                              |
+| Events (follows, subscriptions, gift bombs, etc.) |
+| Channel Point Rewards                             |
 
 ### Streamer.bot
+
 The [Streamer.bot](https://streamer.bot) integration allows you to authenticate with the Streamer.bot website for access to `beta` and `alpha` updates.
 
-::list{type="success"}
-- Login via OAuth
+::success
+Sign in to your Streamer.bot account via OAuth
 ::
 
-::list{type="primary"}
-- Automatic Speaker.bot `beta` updates
-- Automatic Speaker.bot `alpha` updates
-::
+| Supported Features                    |
+| ------------------------------------- |
+| Automatic Speaker.bot `beta` updates  |
+| Automatic Speaker.bot `alpha` updates |
 
 ### Streamlabs
 
 The [Streamlabs](https://stremalabs.com) integration allows you to connect with Streamlabs for donation events.
 
-::list{type="warning"}
-- Login via token
+::warning
+The Streamlabs integration requires an API token for authentication rather than OAuth.
 ::
 
 1. Navigate to the [API Settings](https://streamlabs.com/dashboard#/settings/api-settings) page in Streamlabs dashboard
 2. Continue to the `API Tokens` tab
 3. Copy your `API Access Token`
 4. Paste your token into the `Token` field in Speaker.bot Streamlabs account settings.
 
-::list{type="primary"}
-- Donation events
-::
+| Supported Features |
+| ------------------ |
+| Donation Events    |
 
 ### StreamElements
 
 The [StreamElements](https://streamelements.com) integration allows you to connect with StreamElements for tip and merch events.
 
-::list{type="success"}
-- Login via OAuth
+::success
+Sign in to your StreamElements account via OAuth
 ::
 
-::list{type="primary"}
-- Tip events
-- Merch events
-::
+| Supported Features |
+| ------------------ |
+| Tip Events         |
+| Merch Events       |

speakerbot/0.get-started/1.accounts.md

@@ -1,14 +1,31 @@
-# Speech Engine Setup
-::list{type="info"}
-- Navigate to `Settings -> Speech Engines`
+---
+title: Speech Engine Setup
+description: Configure and enable your speech engines in Speaker.bot
+---
+
+::navigate
+Navigate to **Settings > Speech Engines** in Speaker.bot
+
+- Here you will be able to configure any of the supported TTS engines in Speaker.bot and view a list of available voices for all engines that have been set up.
 ::
 
-Here you will be able to add any of the Engines that Speaker.bot supports, as well as a list of Available Voices for engines that have been added.
 
-::callout{color=amber icon=i-mdi-lightbulb}
-To **Enable** an engine, click the button `Add`, and pick the desired engine type from the dropdown
+::tip
+**To enable an engine**, click the `Add` button and pick the desired engine type from the dropdown
 ::
 
+| Speech Engine | Type | Description |
+| -------------- | ---- | ----------- |
+| SAPI5          | :badge{label=Free color=success icon=mdi:check} | Microsoft Speech API - Native Windows TTS |
+| [Google Cloud](https://cloud.google.com/text-to-speech/)   | :badge{label=Paid color=warning icon=mdi:currency-usd} :badge{label="Free Trial" color=info icon=mdi:party-popper} | Cloud-based TTS with WaveNet voices |
+| [Azure](https://azure.microsoft.com/en-us/products/cognitive-services/text-to-speech/#overview)         | :badge{label=Paid color=warning icon=mdi:currency-usd} :badge{label="Free Tier" color=success icon=mdi:check} | Microsoft's cloud TTS platform |
+| [Amazon Polly](https://aws.amazon.com/polly/)   | :badge{label=Paid color=warning icon=mdi:currency-usd} :badge{label="Free Tier" color=success icon=mdi:check} | AWS cloud TTS service |
+| [Watson](https://www.ibm.com/cloud/watson-text-to-speech)         | :badge{label=Paid color=warning icon=mdi:currency-usd} :badge{label="Free Tier" color=success icon=mdi:check} | IBM's cloud TTS platform |
+| [UberDuck](https://uberduck.ai)        | :badge{label=Paid color=warning icon=mdi:currency-usd} | AI voiceover and TTS platform |
+| [TTS Monster](https://tts.monster)     | :badge{label=Paid color=warning icon=mdi:currency-usd} :badge{label="Free Tier" color=success icon=mdi:check} | AI-based TTS for streamers |
+| [Acapela](https://www.acapela-cloud.com)       | :badge{label=Paid color=warning icon=mdi:currency-usd} | Cloud TTS by Acapela Group |
+| [CereProc](https://www.cereproc.com/en/products/cloud)      | :badge{label=Paid color=warning icon=mdi:currency-usd} | CereVoice Cloud TTS platform |
+
 ## SAPI5
 ::list{type="success"}
 - No account required

speakerbot/0.get-started/2.speech-engines.md

@@ -1,33 +1,32 @@
 ---
 title: Quick Start
+description: Get started with Speaker.bot!
 ---
 
-# Quick Start Guide
+Make sure you've completed installation of Speaker.bot, initial account setup, and speech engine configuration before proceeding with this guide.
 
-Make sure you've completed the following:
+:read-more{to="/get-started/installation"}
+:read-more{to="/get-started/accounts"}
+:read-more{to="/get-started/speech-engines"}
 
-::list{type=primary}
-- [Install Speaker.bot](/get-started/installation)
-- [Twitch Account Setup](/get-started/accounts)
-- [Speech Engine Setup](/get-started/speech-engines)
-::
+::steps{level=2}
 
 ## Create a Voice Alias
-::list{type=info}
-- Navigate to `Settings -> Voice Aliases`
+::navigate
+Navigate to **Settings > Voice Aliases** in Speaker.bot
 ::
 
 Enter a `Name` for your alias and select your desired output device.
 
 For the purposes of this guide, I recommend leaving the output device set to `Application Default`, which will use your current default audio output device.
 
-::list{type=success}
-- `Test Speak` at the bottom of the view should now successfully speak the test message.
+::success
+`Test Speak` at the bottom of the view should now successfully speak the test message.
 ::
 
 ## Enable Global TTS
-::list{type=info}
-- Navigate to `Settings -> General`
+::navigate
+Navigate to **Settings > General** in Speaker.bot
 ::
 
 1. Ensure the `Enabled` checkbox is checked.
@@ -36,13 +35,13 @@ For the purposes of this guide, I recommend leaving the output device set to `Ap
     - Choose the voice alias you created in the previous steps
 
 ## Test TTS from Twitch
-::list{type=primary}
-- Your Speaker.bot instance should now be ready to speak commands from Twitch Chat!
-::
+**Your Speaker.bot instance should now be ready to speak commands from Twitch chat!**
 
 1. Open Twitch Chat for the account you authenticated with Speaker.bot
-2. Enter `!say test` :copy-button{content="!say test"}
+2. Enter the command `!say test` :copy-button{content="!say test"}
 
-::list{type=success}
+::success
 If everything is working, Speaker.bot should have spoken "Test"!
+::
+
 ::

speakerbot/0.get-started/3.quick-start.md

@@ -1,11 +1,13 @@
-# Chat Commands
-
-Interact with your Speaker.bot instance directly from Twitch chat!
+---
+title: Chat Commands
+description: Interact with your Speaker.bot instance directly from Twitch chat!
+navigation.icon: mdi:chat-alert-outline
+---
 
 ## Default Commands
 
-::list{type=primary}
-- The following commands are made available by Speaker.bot automatically
+::tip
+The following commands are made available by Speaker.bot out of the box!
 ::
 
 Name | Description
@@ -30,28 +32,36 @@ Name | Description
 `!tts [about\|aboot]` :copy-button{content="!tts about"} | Sends to chat the information about your TwitchSpeaker instance.
 
 ## Custom Commands
-
-::list{type=info}
-- Navigate to the `Custom Commands` tab in Speaker.bot
+::tip
+Custom commands allow you to create your own TTS commands with specific voices and permission settings.
+- For example, a `!shoutout` command that uses a loud, energetic voice and is only available to moderators.
 ::
 
-Custom commands allow you to create TTS chat commands with a specified voice and user permissions configuration.
+### Configuration
+::navigate
+Navigate to the **Custom Commands** tab in Speaker.bot
+::
 
-### Add Command
 You can create a custom command by filling out the fields detailed below, then clicking the `Add` button.
 
-#### `Command`
-Enter the name you want to use for this command.
-- Example: `!say`
+::field-group
+:::field{name="Command" type="Text"}
+The text you want to use to trigger this command.
+<br>
+Example: `!say`
+:::
 
-#### `Voice Alias`
+:::field{name="Voice Alias" type="Select"}
 Select the voice to use with this command.
+:::
 
-#### `Permissions`
+:::field{name="Permissions" type="Checkbox Group"}
 Restrict this command to specific Twitch user roles.
+:::
+::
 
-### Modify Command
-To modify any existing command, select it in the list and change any fields you like.
+---
 
-### Delete Command
-To delete any existing command, select it in the list and then click the `Delete` button.
+::note
+To modify or delete an existing command, select it from the list, make your changes, then click `Update` or `Delete`.
+::