docs: sync b07b103b13c3

Author: leqwin

.github/workflows/pages.yml

@@ -21,7 +21,12 @@ jobs:
       name: github-pages
       url: ${{ steps.deployment.outputs.page_url }}
     steps:
+      # Full history: hugo's enableGitInfo dates each page from the last
+      # commit that touched it. A shallow clone would date every page from
+      # the newest sync commit instead.
       - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
       - run: ./build.sh
       - uses: actions/upload-pages-artifact@v3
         with:

build.sh

@@ -43,5 +43,12 @@ else
     HUGO=$BIN_DIR/hugo
 fi
 
+# enableGitInfo dates each page from its last commit, so it needs a git
+# checkout; a source tarball has none, and hugo makes that a hard error.
+if ! git rev-parse --git-dir >/dev/null 2>&1; then
+    echo "no git checkout, building without per-page dates"
+    export HUGO_ENABLEGITINFO=false
+fi
+
 "$HUGO" --gc --cleanDestinationDir
 echo "built into public/"

content/_index.md

@@ -29,8 +29,8 @@ optional [addons](addons/_index.md).
 - Tag-based gallery with a folder tree, favorites, saved searches,
   collections and rating tags with an SFW ceiling. See
   [Searching](guides/searching/index.md) and [Tags](guides/tags/index.md).
-- A file watcher picks up new, moved and deleted files within seconds,
-  and new images land in an [inbox](guides/inbox/index.md) for review.
+- A file watcher picks up new, moved and deleted files within
+  seconds, and new images land in an [inbox](guides/inbox/index.md) for review.
 - Reads Stable Diffusion metadata (A1111/Forge and ComfyUI): prompts,
   models, seeds, full workflows. See [AI metadata](guides/ai-metadata.md).
 - Local [auto-tagging](guides/auto-tagger/index.md) with ONNX models (WD14

content/addons/_index.md

@@ -26,6 +26,9 @@ browser, once monloader is in place. You are looking at a page; you
 press the toolbar button; the page lands in monloader's queue and,
 once downloaded and mapped, appears in monbooru with its tags.
 
+**[Plugins](plugins.md)** are the open version of the same idea:
+anything you or someone else writes, showing up as a few buttons in monbooru.
+
 The apps connect by [pairing](pairing.md): each link is approved once
 in the receiving app's settings, and the apps exchange scoped API
 tokens on their own. The [quick start](quick-start.md) walks through

content/addons/monloader/configuration.md

@@ -60,8 +60,9 @@ fetch_sleep = 1.0
 min_free_gb = 70
 commit_sleep = 1.0                       # seconds between contribution uploads
 
-[lookup]                                 # the lookup chain's similarity stage
-min_similarity = 80                      # percent; candidates below are ignored
+[lookup]                                 # the chain's similarity stage, and what the nightly run may spend
+min_similarity         = 80              # percent; candidates below are ignored
+scheduled_daily_budget = 25              # images a day monbooru's scheduled lookups may cover; 0 refuses them
 
 [lookup.iqdb]
 order = 2                                # chain position; uses the danbooru site credentials

content/addons/monloader/development.md

@@ -76,7 +76,7 @@ monsender extension can branch on them:
 | `canceled` | the job was canceled while the item was in flight |
 
 The job's `summary` aggregates its items:
-`{ created, duplicate, enriched, replaced, skipped, failed, canceled, total }`.
+`{ created, duplicate, enriched, matched, replaced, skipped, failed, canceled, total }`.
 The outcomes themselves are described in
 [downloading](guides/downloading/index.md#per-item-outcomes).
 

content/addons/monloader/getting-started/pairing/index.md

@@ -62,11 +62,10 @@ instead.
 
 ## Re-pairing
 
-A peer that is already paired is refused until its pairing is removed.
-Removing a pairing (on either side) drops the local token and asks the peer
-to drop its own; if the peer was unreachable at that moment, a notice
-reminds you to remove it there too. monloader keeps the configured monbooru
-api url, so a re-pair reuses it.
+Removing a pairing (on either side) drops the local
+token and asks the peer to drop its own; if the peer was unreachable at that
+moment, a notice reminds you to remove it there too. monloader keeps the
+configured monbooru api url, so a re-pair reuses it.
 
 ## Manual setup
 

content/addons/monloader/guides/downloading/index.md

@@ -28,13 +28,14 @@ anything.
 
 ## Per-item outcomes
 
-Every item ends with one of seven outcomes:
+Every item ends with one of eight outcomes:
 
 | Outcome | Meaning |
 |---|---|
 | `created` | new image accepted by monbooru |
 | `duplicate` | monbooru already had this exact file; any new tags merge in |
 | `enriched` | a metadata-only refetch or a hash lookup merged tags into an image monbooru already holds |
+| `matched` | a batch PTR lookup answered with an image's tags; monloader wrote nothing, monbooru applies them |
 | `replaced` | the post's file was pushed over an existing image's, keeping its tags and history - this is monbooru's **[upgrade]** action doing its work through monloader (see [Lookup and sources](../../../../guides/lookup/index.md)) |
 | `skipped_archive` | this post was already fetched before; not downloaded again |
 | `skipped_unsupported` | monbooru cannot ingest this file type; not pushed |

content/addons/monloader/guides/lookup/index.md

@@ -99,3 +99,16 @@ With the [Hydrus PTR index](../ptr/index.md) enabled, monloader can also answer
 its local sha256-keyed copy of the PTR (offline, and covering files that
 were deleted from the boorus or never posted there). monbooru drives it
 per image (the PTR panel's **Pull tags**) or in batch.
+
+## Scheduled lookups from monbooru
+
+monbooru's nightly maintenance run can send lookups for the images that
+have no source, and monloader is what bounds them: the daily budget in
+**settings -> lookup**. Those lookups queue behind everything else, so a whole library sweeping
+overnight never delays a URL you paste while it runs.
+
+The budget is how many images a night they may cover, 25 out of the
+box. Once the budget is spent monloader refuses the rest and monbooru stops for the day,
+picking up where it left off tomorrow. 
+Lookups you trigger by hand from monbooru - the detail-page button, the
+batch action, are never counted against it and never refused.