0 Fork 0

Files

T

John O'Keefe 393a00e8dd docs(nav): Administration section lives in docs/admin/; sidebar ordered by usability

Two structural changes, one owner-approved plan:

- Move the admin guides out of docs/user/ into their own docs/admin/
  area — admin-guide.md becomes the Administration section landing page
  (pinned first), and the 32-line admin-library-management.md stub
  becomes admin/libraries.md, which the admin-docs build-out rebuilds
  into the real Libraries page next. Retired URLs 301 via a new
  docRedirects map in the docs HTTP handler (checked before .md
  canonicalization so even .md spellings one-hop to the new clean URL);
  the two inbound links (docs index, user-guide front door) updated.

- Sidebar direct items now sort by usabilityOrder — an explicit,
  per-section display order — instead of alphabetically: User Guide
  mirrors the 'Where to go' table on user-guide.md, Devices orders
  Android → KOReader → Kobo (alphabetically Kobo used to sort ahead of
  KOReader), and Administration pre-lists its planned pages so each
  lands in place as the admin build writes it. Unlisted docs fall back
  to alphabetical after the listed ones. Display-order only by
  construction: the URL-driven expand/highlight machinery keys on
  containsURL membership and never sees sort order — nav tests updated
  to pin the new orders plus a real-tree test
  (TestBuildNavigationUsabilityOrder) guarding all three sections.

2026-11-02 13:38:01 -05:00

997 B

Raw Blame History

Libraries

Adding Library Folders

When creating or managing a library, you can add folders containing your media files (ebooks, comics, manga).

Using the Folder Browser

The admin library page includes a folder browser to help you select folders on the server:

Open the Administration panel in the sidebar (admins only) and go to Libraries
Click a library in the list to expand its panel
Find the Folders section
Click Browse next to the folder path input — this opens the Browse Folders dialog
Navigate through the server's filesystem
Select a folder; it fills the path input, then click Add

Security

The folder browser only shows directories (not files)
Path traversal is protected (cannot access parent directories with ..)
Only admin users can browse the filesystem

Manual Entry

Alternatively, you can manually type the full server path if you know it:

/home/user/books
/media/external/ebooks
/var/lib/manga

997 B Raw Blame History