From db86a7553484422dd5cd1d88b673b82644eecbfa Mon Sep 17 00:00:00 2001
From: fyears <1142836+fyears@users.noreply.github.com>
Date: Sun, 14 Jul 2024 22:31:08 +0800
Subject: [PATCH] Add vConsole tutorial

---
 docs/how_to_debug/README.md                |  8 +++++++-
 docs/how_to_debug/check_console_output.md  |  4 +++-
 docs/how_to_debug/check_vconsole_output.md | 21 +++++++++++++++++++++
 3 files changed, 31 insertions(+), 2 deletions(-)
 create mode 100644 docs/how_to_debug/check_vconsole_output.md

diff --git a/docs/how_to_debug/README.md b/docs/how_to_debug/README.md
index 8f46621..b6fd5fc 100644
--- a/docs/how_to_debug/README.md
+++ b/docs/how_to_debug/README.md
@@ -6,12 +6,18 @@ Ideally, users do not need to debug anything. But if something bad happened, we
 
 See [here](./export_sync_plans.md).
 
-## Advanced: Check Console Output Directly
+## Medium: Desktop: Check Console Output Directly
 
 ...of desktop and Android.
 
 See [here](./check_console_output.md).
 
+## Medium: Mobile: Use `Obsidian vConsole` to Check Console Ouput Directly
+
+...of mobile (iOS and Android).
+
+See [here](./check_vconsole_output.md).
+
 ## Advanced: Use `Logstravaganza` to export logs
 
 This method works for desktop and mobile devices (iOS, Android), especially useful for iOS.
diff --git a/docs/how_to_debug/check_console_output.md b/docs/how_to_debug/check_console_output.md
index b5c581f..0d99d53 100644
--- a/docs/how_to_debug/check_console_output.md
+++ b/docs/how_to_debug/check_console_output.md
@@ -18,6 +18,8 @@ Go to the plugin settings, scroll down to the section "Debug" -> "alter console
 
 - If you are using Android
 
-  You need to [enable USB debugging](https://developer.android.com/studio/debug/dev-options#enable) on your Android, then connect your Android to a computer using USB, then open the **desktop** Chrome browser and go to the special web page <chrome://inspect>. You shall be able to see the "inspect" link inside the special page, then click the link to open the console. After debugging, remember to turn off USB debugging.
+  If you want to check the console **with the help of desktop Chrome**, you need to [enable USB debugging](https://developer.android.com/studio/debug/dev-options#enable) on your Android, then connect your Android to a computer using USB, then open the **desktop** Chrome browser and go to the special web page <chrome://inspect>. You shall be able to see the "inspect" link inside the special page, then click the link to open the console. After debugging, remember to turn off USB debugging.
+
+  If you want to check the console **directly on the mobile device**, check out [this doc](./check_vconsole_output.md).
 
 Trigger the sync manually (by clicking the icon on the ribbon sidebar). Something (hopefully) helpful should show up in the console. You could understand what happened and what goes wrong more explictly by checking the output.
diff --git a/docs/how_to_debug/check_vconsole_output.md b/docs/how_to_debug/check_vconsole_output.md
new file mode 100644
index 0000000..b8ec3d9
--- /dev/null
+++ b/docs/how_to_debug/check_vconsole_output.md
@@ -0,0 +1,21 @@
+# Check "Obsidian vConsole" Output
+
+It's quite hard to debug on mobile. But fortunately you can use another plugin to rescue!
+
+This applies to both iOS (iPhone / iPad) and Android.
+
+## Disable Auto Sync Firstly
+
+You should disable auto sync to avoid any unexpected running.
+
+## Set The Output Level To Debug
+
+Go to the plugin settings, scroll down to the section "Debug" -> "alter console log level", and change it from "info" to "debug".
+
+## Use "Obsidian vConsole"
+
+1. Install the third-party plugin ["Obsidian vConsole"](https://github.com/zhouhua/obsidian-vconsole).
+2. Enable "Obsidian vConsole". You shall see a green button in the right buttom corner of the interface of your mobile Obsidian. You can drag this green button to where you like.
+3. Sync! And quickly click the vConsole green button, you will see the console logs in its panel! Moreover, you can check browser network and Storage (LocalStorage) in the panel! 
+4. You can copy (by clicking the small "disk" icon beside each line of the log) or take a screenshot of the logs, and report bugs in Remotely Save GitHub. You can click "Hide" in the panel to hide the panel.
+5. If you don't need to debug any more, you can disable Obsidian vConsole plugin, then the green button should disappear.