kiwix / operations

Kiwix Kubernetes Cluster
http://charts.k8s.kiwix.org/
6 stars 0 forks source link

How to get a quick index of the kiwix library? #95

Closed jojo2357 closed 1 year ago

jojo2357 commented 1 year ago

Following the instructions found here: https://download.kiwix.org/library/README

I followed https://library.kiwix.org/catalog/v2/ to a nonexistent page; the documentation suggests that it is only for local kiwix archives, which is not helpful to me.

Going here was helpful, but not in a machine readable format.

This is perfect, but the base64 images make it obnoxiously large when all i want is a list of files without having to do a recursive search of the zim directory. (also deprecation warnings)

So my question then: how do i get a quick, machine-readable, low-overhead listing of all the zims available from kiwix?

Thanks \:)

kelson42 commented 1 year ago

@jojo2357 Here is the doc you need IMO https://kiwix-tools.readthedocs.io/en/latest/kiwix-serve.html#catalog-v2-opds-api

jojo2357 commented 1 year ago

I just realized that all the endpoint other than /catalog/v2 work as intended :roll_eyes:

While im here, why does https://library.kiwix.org/catalog/v2/entries?count=-1 not return archived results? https://download.kiwix.org/zim/wikipedia/ has both wikipedia_en_100_2023-05.zim and wikipedia_en_100_2023-06.zim but the api only acknowledges wikipedia_en_100_2023-06

kelson42 commented 1 year ago

While im here, why does https://library.kiwix.org/catalog/v2/entries?count=-1 not return archived results?

There is no concept of archive. We just keep one older version to avoid interruption of downloads at switch time (publishing of new version).

jojo2357 commented 1 year ago

Alright, I will consider myself satisfied. thanks for the help