Add stylized folder structure to Storage (#1110)

* Add stylized folder structure to Storage

* Add empty line in Stylus file

Lint

website/src/.vitepress/theme/styles/tree.styl

@@ -24,6 +24,10 @@
       &.main {
         color: var(--vp-c-brand-darker)
       }
+
+      &.dynamic {
+        color: var(--vp-c-brand-darker)
+      }
     }
 
     &.file.zip {
@@ -94,6 +98,10 @@
       &.file.zip {
         color: var(--vp-c-brand-lighter) !important
       }
+
+      &.dynamic {
+        color: var(--vp-c-brand-lightest) !important
+      }
     }
   }
 }

website/src/docs/faq/storage.md

@@ -10,26 +10,94 @@ Tachiyomi manages several things within a selected storage location, including a
 
 The following illustrates the folder structure:
 
-```txt
+:::info Example
-<Your selected storage location>/
+<div class="tree">
-├── autobackup
+  <ul>
-│   ├── eu.kanade.tachiyomi_yyyy-mm-dd_hh-mm.tachibk
+    <img src="/img/folder.svg" alt="Folder" class="tree-icon icon-folder">
-│   └── ...
+    <span class="folder root">[your selected storage location]</span>
-├── downloads
+    <li>
-│   └── Source name (LANG)
+      <img src="/img/folder.svg" alt="Folder" class="tree-icon icon-folder">
-│       ├── Title
+      <span class="folder main">autobackup</span>
-│       │   ├── Chapter01.cbz
+      <ul>
-│       │   └── ...
+        <li>
-│       └── Other title
+          <img src="/img/tachiyomi-book.png" alt="File" class="tree-icon icon-tachiyomi">
-│           ├── Chapter01.cbz
+          <span class="file jpg">eu.kanade.tachiyomi_yyyy-mm-dd_hh-mm<span class="file-extension">.tachibk</span></span>
-│           └── ...
+        </li>
-└── local
+        <li>
-    ├── Title
+          <img src="/img/tachiyomi-book.png" alt="File" class="tree-icon icon-tachiyomi">
-    │   ├── Chapter01.cbz
+          <span>...</span>
-    │   └── ...
+        </li>
-    └── Other title
+      </ul>
-        └── Chapter01.cbz
+    </li>
-```
+    <li>
+      <img src="/img/folder.svg" alt="Folder" class="tree-icon icon-folder">
+      <span class="folder main">downloads</span>
+      <ul>
+        <li>
+          <img src="/img/folder.svg" alt="Folder" class="tree-icon icon-folder">
+          <span class="folder dynamic">Source name (LANG)</span>
+            <ul>
+              <li>
+                <img src="/img/folder.svg" alt="Folder" class="tree-icon icon-folder">
+                <span class="folder dynamic">Series title</span>
+                <ul>
+                  <li>
+                    <img src="/img/zip.svg" alt="Compressed File" class="tree-icon icon-cbz">
+                    <span class="file cbz">Chapter01<span class="file-extension">.cbz</span></span>
+                  </li>
+                  <li>
+                    <img src="/img/zip.svg" alt="Compressed File" class="tree-icon icon-cbz">
+                    <span class="file cbz">...</span>
+                  </li>
+                </ul>
+              </li>
+              <li>
+                <img src="/img/folder.svg" alt="Folder" class="tree-icon icon-folder">
+                <span class="folder dynamic">Other series title</span>
+                <ul>
+                  <li>
+                    <img src="/img/zip.svg" alt="Compressed File" class="tree-icon icon-cbz">
+                    <span class="file cbz">Chapter01<span class="file-extension">.cbz</span></span>
+                  </li>
+                </ul>
+              </li>
+            </ul>
+        </li>
+      </ul>
+    </li>
+    <li>
+      <img src="/img/folder.svg" alt="Folder" class="tree-icon icon-folder">
+      <span class="folder main">local</span>
+      <ul>
+        <li>
+          <img src="/img/folder.svg" alt="Folder" class="tree-icon icon-folder">
+          <span class="folder dynamic">Series title</span>
+          <ul>
+            <li>
+              <img src="/img/zip.svg" alt="Compressed File" class="tree-icon icon-cbz">
+              <span class="file cbz">Chapter01<span class="file-extension">.cbz</span></span>
+            </li>
+            <li>
+              <img src="/img/zip.svg" alt="Compressed File" class="tree-icon icon-cbz">
+              <span class="file cbz">...</span>
+            </li>
+          </ul>
+        </li>
+        <li>
+          <img src="/img/folder.svg" alt="Folder" class="tree-icon icon-folder">
+          <span class="folder dynamic">Other series title</span>
+          <ul>
+            <li>
+              <img src="/img/zip.svg" alt="Compressed File" class="tree-icon icon-cbz">
+              <span class="file cbz">Chapter01<span class="file-extension">.cbz</span></span>
+            </li>
+          </ul>
+        </li>
+      </ul>
+    </li>
+  </ul>
+</div>
+:::
 
 Backup file name prefixes are unique for the app to avoid potential collisions between forks.
 
@@ -53,3 +121,7 @@ Since Android 11, most apps are enforced to use [Scoped Storage](https://develop
 These functions may become slower due to **Scoped Storage**'s inherent latency, as discussed in detail [here](https://www.xda-developers.com/android-q-storage-access-framework-scoped-storage/).
 
 This can impact tasks like deleting chapters, library loading times, accessing local files like downloads or the local source, and more. As always, using internal storage is recommended over SD cards if latency is of concern.
+
+<style scoped>
+  @import "../../.vitepress/theme/styles/tree.styl"
+</style>