docs(user): update device and sync navigation for sidebar UI

The new-ui redesign replaced the top header with a sidebar and removed
the Settings pages.

- Replace all 'Settings → Devices' paths with the Devices page in the
  sidebar
- Conflicts are resolved from the book detail page's Sync Progress
  button or the Conflicts page (/conflicts); drop the nonexistent
  'Settings → Conflicts' path
- Queue status and unlinked-book references no longer invent per-device
  button paths that don't exist on the Devices page
- Reading history now points to the Progress page / book detail
- Export FAQ no longer references a Settings → Export flow that isn't
  in the UI
This commit is contained in:
2026-08-20 14:29:54 -04:00
parent e310fa6a9d
commit 868003331c
2 changed files with 14 additions and 14 deletions
+5 -5
View File
@@ -89,8 +89,8 @@ Setup is done **on the server**: you approve the device from the Bookhoard web i
### Step 3: Approve the Device in Bookhoard ### Step 3: Approve the Device in Bookhoard
1. On your computer or phone, open Bookhoard and go to **Settings → Devices** 1. On your computer or phone, open Bookhoard and go to the **Devices** page (sidebar navigation)
2. Refresh the page — you'll see a **pending registration** for your device 2. Refresh the page — your device appears under **Pending Device Registrations**
3. Click **Approve** to connect the device 3. Click **Approve** to connect the device
Once approved, the plugin picks up its credentials automatically — reading progress sync and OPDS catalog access are set up automatically. No further configuration is needed. Once approved, the plugin picks up its credentials automatically — reading progress sync and OPDS catalog access are set up automatically. No further configuration is needed.
@@ -162,8 +162,8 @@ Books downloaded via OPDS are automatically matched to your library, so their pr
**Solutions**: **Solutions**:
- Trigger a manual sync from the plugin menu - Trigger a manual sync from the plugin menu
- Check the device shows as enabled in **Settings → Devices** - Check the device shows as enabled on the **Devices** page (open its settings from the icon next to the device)
- Verify the book appears in the device's Unlinked Books and link it if needed - Verify the book appears as an unlinked book for the device and link it if needed
- Check Bookhoard server logs for errors - Check Bookhoard server logs for errors
### Conflicts Detected ### Conflicts Detected
@@ -172,7 +172,7 @@ Books downloaded via OPDS are automatically matched to your library, so their pr
**Solutions**: **Solutions**:
1. Go to Bookhoard's **Conflicts** page 1. Open the book's detail page and click **Sync Progress**, or open the Conflicts page (`/conflicts`)
2. Review the progress reported by each device 2. Review the progress reported by each device
3. Choose which device's progress to keep 3. Choose which device's progress to keep
+9 -9
View File
@@ -87,13 +87,13 @@ For detailed device configuration instructions, see the appropriate setup guide:
**Registration Process** (KOReader): **Registration Process** (KOReader):
1. Install the Bookhoard plugin and enter your server URL in KOReader 1. Install the Bookhoard plugin and enter your server URL in KOReader
2. Approve the pending registration in Bookhoard (**Settings → Devices**) 2. Approve the pending registration on the Bookhoard **Devices** page (sidebar navigation)
3. That's it — sync starts automatically once approved 3. That's it — sync starts automatically once approved
**Device Management**: **Device Management**:
``` ```
Settings → Devices Devices page (sidebar navigation)
``` ```
You can: You can:
@@ -128,7 +128,7 @@ Sometimes a book on your device can't be automatically matched to your library.
### Viewing Unlinked Books ### Viewing Unlinked Books
``` ```
Settings → Devices → Select Device → View Unlinked Books Devices page select device → unlinked books
``` ```
### Resolving Unlinked Books ### Resolving Unlinked Books
@@ -288,7 +288,7 @@ This ensures your highlights work across all devices, even with different page c
**Solutions**: **Solutions**:
1. Check device is online: `Settings → Devices` 1. Check device is online: Devices page (sidebar navigation)
2. Verify sync is enabled for the device 2. Verify sync is enabled for the device
3. Check sync URL is correct 3. Check sync URL is correct
4. Ensure device has network connection 4. Ensure device has network connection
@@ -322,7 +322,7 @@ This ensures your highlights work across all devices, even with different page c
**Solutions**: **Solutions**:
1. Go to `Settings → Conflicts` 1. Open the book's detail page and click **Sync Progress**, or go to the Conflicts page (`/conflicts`)
2. Review both device progress 2. Review both device progress
3. Choose which device's progress to keep 3. Choose which device's progress to keep
4. Or choose "Merge" (keeps furthest progress) 4. Or choose "Merge" (keeps furthest progress)
@@ -397,7 +397,7 @@ This ensures your highlights work across all devices, even with different page c
**Manual Resolution**: **Manual Resolution**:
``` ```
Settings → Conflicts → Select conflictChoose winner Book detail → Sync Progresschoose winner
``` ```
**Options**: **Options**:
@@ -412,7 +412,7 @@ Settings → Conflicts → Select conflict → Choose winner
**View Queue Status**: **View Queue Status**:
``` ```
Settings → Devices → Select Device → View Queue Devices page → sync queue section
``` ```
**Queue Stats**: **Queue Stats**:
@@ -440,7 +440,7 @@ Settings → Devices → Select Device → View Queue
**View History**: **View History**:
``` ```
Book → Reading History Progress page (sidebar navigation), or the book's detail page
``` ```
**Privacy**: **Privacy**:
@@ -526,7 +526,7 @@ A: No, devices are tied to individual accounts for security.
A: All sync data for that book is removed from the server. A: All sync data for that book is removed from the server.
**Q: Can I export my reading data?** **Q: Can I export my reading data?**
A: Yes! Settings → Export → Download sync data. A: Reading data isn't exportable from the UI yet — it's accessible via the API.
**Q: Does sync work over the internet?** **Q: Does sync work over the internet?**
A: Yes, if your server is publicly accessible with HTTPS. A: Yes, if your server is publicly accessible with HTTPS.