-
-
Notifications
You must be signed in to change notification settings - Fork 975
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
[documentation] custom site support #1658
Comments
There is also still this: https://github.com/mikf/gallery-dl/wiki Maybe that's a good point to start. I was a bit reluctant at recommending first, because everything that is on that wiki is not part of the repository itself (a wiki is its own repo, basically - still publicly accessible via git, of course), and proper documentation can and should absolutely be part of the reference repo, I think. But.. The wiki is basically just a collection of pages (searchable, thankfully), with one home page as the initial landing point, which basically can be used to link to all topic-specific pages. There's also a navigation tree at the right hand side, and it apparently is possible to group and nest the actual pages there a bit (An example of a wiki which does this that I've found: uBO) In short, having this wiki as a separate place means that it can be considered as a draft version for "proper" documentation, basically. So, it does not have to meet any standard of formal writing, and it does not even have to be stylistically consistent (only factually correct, of course) or particularly concise. Just a stick in the ground from which one can start. And as soon as any content on that wiki meets a required threshold, wherever that may be, it can still be lifted and added to the main repo, solely at mikf's discretion. |
Draft of this added here: Custom Site Support ‐ HowTo |
Manually adding certain custom domains to the list of gallery-dl's recognized URLs is possible since version 1.17.0, but hasn't been documented anywhere except in the commit message of 595bdaa.
To describe this functionality:
gallery-dl can support any site that fits into one of its "basecategories" (
gelbooru_v01
,gelbooru_v02
,moebooru
,philomena
,foolfuuka
,foolslide
,mastodon
,shopify
). Several sub-sites are already supported by default (see the bottom entries in supportedsites.md), but it is also possible to get it to recognize even more with the right config entries.The general way is to add a new entry with arbitrary name (this will be used as
category
) inside a block named after the basecategory, which in turn is inside the"extractor"
block. These entries must specify theroot
URL for this site, and can optionally set a custompattern
that gets used to match the site's domain.pattern
must not contain a capture group.For example the following would add support for two additional Gelbooru Beta 0.1.11 sites as well as two Shopify instances in addition to what is already supported by default:
This could definitely be described / documented in a better, easier to understand way, but I'm not very good at this. So if anyone could help with improving this, I'd be much obliged.
I'm also not entirely sure where this information should go. Maybe in the Configuration section of the README? Maybe as its very own section below Authentication?
The text was updated successfully, but these errors were encountered: