kiwix / kiwix/overview

Allow readers to change Catalog

Open
#155 1 comment 0 reactions 0 assignees View on GitHub
question
Dominant language
HTML
Stars
93
Forks
14
PR merge metrics
No merged PRs in 30d

Description

I remember us discussing this a very long time ago and while I think we wanted to do it, I can't find a related ticket.

The idea is to allow reader users to set an arbitrary Catalog URL instead of https://opds.library.kiwix.org one.

There are UX challenges as it needs to maybe point to server-setup instructions (`kiwix-serve` must be launched with `--contentServerURL`) and it must properly handle that URL not working or not having download links and inform the user correctly and allow him to easily switch back to the Kiwix Catalog.

Is this still something we want to do?

Note: this was requested on the desk today.

Contributor guide

Open the contributing guide

Research direction

Start by locating how the reader selects and stores its Catalog URL, then review the kiwix-serve --contentServerURL setup requirement. Define the behavior for unreachable catalogs, catalogs without download links, setup guidance, and switching back to the Kiwix Catalog; the issue does not name files or tests.

Written by the indexing model from the issue text.

Assessment

Domain
frontend
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
30/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.