fix: fixed logo and improved docs on subs and homepage

Author: dreulavelle

docs/images/icon.png

@@ -59,6 +59,9 @@ hide:
     </a>
 </div>
 
+!!! riven "Riven"
+    **Riven** is a powerful media management and streaming solution designed to integrate with various media servers and third-party services. It automates the process of finding, downloading, and organizing media content, making it instantly available for streaming through your preferred media server.
+
 <div class="grid cards" markdown="1" style="justify-content: center;" id="home-cards">
 
 -   :gear: __Easy Installation__
@@ -99,13 +102,10 @@ hide:
 
 ---
 
-
 # Getting Started
 
 ![step-5](images/onboard/final.png)
 
-**Riven** is an advanced media management and streaming solution designed to integrate with various media servers and third-party services. It automates the process of finding, downloading, and organizing media content, making it instantly available for streaming through your preferred media server.
-
 !!! note "Beta"
     Riven is under active development, we are constantly working on new features and fixing bugs.
 
@@ -164,6 +164,12 @@ Grab the `docker-compose.yml` file from the [installation guide](#installation)
 
 For detailed information on the various services and configurations available in Riven, please refer to the [symlink](services/symlink/index.md) page. This page will help you understand how to configure and manage your media library using symlinks. It will help you understand why we map the Riven volumes to `/mnt` and how you can modify this in the `docker-compose.yml` file for the best outcome.
 
+!!! danger "Setup Rclone & Symlink Paths First! :fire:"
+
+    This is incredibly important and must be setup first! When configuring the rclone mount path and library path, you need to make sure that the paths are correct for your system. More information can be found at the [symlink](services/symlink/index.md) page.
+
+    If your debrid files are found in your rclone path, and you can successfully `ls -lh /mnt/zurg` your rclone path, you can skip this step.
+
 ---
 
 ## Installation

docs/images/riven.svg

@@ -36,9 +36,9 @@ OpenSubtitles is a popular subtitle provider.
 
 - **enabled** (boolean): Boolean value to enable or disable the provider. Default is false.
     - Example: `false`
-- **username** (string): The username for accessing OpenSubtitles.
+- **username** (string): The username for accessing OpenSubtitles. *(Optional)*
     - Example: `"your_username"`
-- **password** (string): The password for accessing OpenSubtitles.
+- **password** (string): The password for accessing OpenSubtitles. *(Optional)*
     - Example: `"your_password"`
 
 ### **OpenSubtitles.com**
@@ -47,11 +47,20 @@ OpenSubtitles.com is another popular subtitle provider.
 
 - **enabled** (boolean): Boolean value to enable or disable the provider. Default is false.
     - Example: `false`
-- **username** (string): The username for accessing OpenSubtitles.com.
+- **username** (string): The username for accessing OpenSubtitles.com. *(Optional)*
     - Example: `"your_username"`
-- **password** (string): The password for accessing OpenSubtitles.com.
+- **password** (string): The password for accessing OpenSubtitles.com. *(Optional)*
     - Example: `"your_password"`
 
+!!! riven "Optional Authentication"
+
+    OpenSubtitles and OpenSubtitles.com don't require additional authentication and can be used once enabled.
+
+!!! note "How Subliminal Works"
+
+    Subliminal is a powerful library that works by searching for subtitles in your media library and downloading them. It uses the configured providers to search for and download subtitles. You can find more information as to how providers work [here](https://subliminal.readthedocs.io/en/latest/user/how_it_works.html).
+
+
 ### **How Subtitles Work**
 
 Riven uses the Subliminal library to handle subtitles. When enabled, Subliminal will scan your media library for video files and download the best available subtitles in the specified languages. Here is a brief overview of how the process works:

docs/index.md

@@ -26,6 +26,7 @@ plugins:
 
 theme:
   name: 'material'
+  logo: images/icon.png
   custom_dir: overrides
   features:
       - navigation.tabs
@@ -44,10 +45,24 @@ theme:
       - content.code.copy
       - content.tabs.link
       - announce.dismiss
+      - header.autohide
       # - content.action.edit
+
   icon:
-    logo: github
     repo: fontawesome/brands/github
+    admonition:
+      note: fontawesome/solid/note-sticky
+      abstract: fontawesome/solid/book
+      info: fontawesome/solid/circle-info
+      tip: fontawesome/solid/bullhorn
+      success: fontawesome/solid/check
+      question: fontawesome/solid/circle-question
+      warning: fontawesome/solid/triangle-exclamation
+      failure: fontawesome/solid/bomb
+      danger: fontawesome/solid/skull
+      bug: fontawesome/solid/robot
+      example: fontawesome/solid/flask
+      quote: fontawesome/solid/quote-left
 
   palette:
     - media: "(prefers-color-scheme)"
@@ -75,7 +90,7 @@ extra:
     - icon: 'fontawesome/brands/github'
       link: 'https://github.com/rivenmedia/riven'
     - icon: 'fontawesome/solid/heart'
-      link: 'https://github.com/sponsors/rivenmedia'
+      link: 'https://github.com/sponsors/dreulavelle'
       text: 'Sponsor us on GitHub'
 
 markdown_extensions:
@@ -91,6 +106,7 @@ markdown_extensions:
   - pymdownx.emoji:
       emoji_index: !!python/name:material.extensions.emoji.twemoji
       emoji_generator: !!python/name:material.extensions.emoji.to_svg
+  - pymdownx.details
   - pymdownx.superfences:
       custom_fences:
         - name: mermaid

docs/services/subtitles/index.md

@@ -71,3 +71,28 @@ h1, h2, h3, h4, h5, h6 {
         transform: translateY(0);
     }
 }
+
+/* Remove border from admonitions */
+.md-typeset .admonition,
+.md-typeset details {
+  /* border-width: 0; */
+  border-left-width: 4px;
+}
+
+:root {
+    --md-admonition-icon--riven: url('../images/icon.png');
+  }
+  .md-typeset .admonition.riven,
+  .md-typeset details.riven {
+    border-color: rgb(43, 155, 70);
+  }
+  .md-typeset .riven > .admonition-title,
+  .md-typeset .riven > summary {
+    background-color: rgba(43, 155, 70, 0.1);
+  }
+  .md-typeset .riven > .admonition-title::before,
+  .md-typeset .riven > summary::before {
+    background-color: rgb(255, 255, 255);
+    -webkit-mask-image: var(--md-admonition-icon--riven);
+            mask-image: var(--md-admonition-icon--riven);
+  }