BlueGit

timfa hfy-novels

Overview

Activity

NovDecJanFebMarAprMayJunJulAugSepOctNov

15 contributions in the last 12 months

LessMore

Commits, merge requests and comments.

hfy-novels
README.md

HFY Novels

Een LNReader-pluginbron voor verhalen van r/HFY. Deze repository is zelf de plugin-repository: LNReader laadt een plugins.json en een gebouwde plugin-JS via de raw-URL van BlueGit.

De index bevat alleen metadata (titel, auteur, hoofdstukvolgorde, Reddit-IDs). De tekst van de verhalen staat er niet in. Die haalt de plugin pas op als je een hoofdstuk opent, via de publieke Arctic Shift-API.

In LNReader zetten

1. Open LNReader → Plugins (of Instellingen → Repos). 2. Voeg deze repository-URL toe, precies zo (inclusief ?rev=master):

https://git.timfalken.com/timfa/hfy-novels/-/raw/.dist/plugins.json?rev=master

Een verkleinde variant is .dist/plugins.min.json (zelfde inhoud). Daarna bronnen verversen en de plugin HFY Novels installeren.

BlueGit slaat de repository op als timfa/hfy-novels (kleine letters). Die spelling moet in de URL staan; HFY-Novels geeft een 404.

BlueGit serveert raw-bestanden als text/plain. Dat is voor LNReader geen probleem: de app evalueert de JS zelf en parst de JSON zelf. Een losse .apk-plugin bestaat niet; LNReader-plugins zijn JavaScript uit een repository-manifest.

Wat de plugin kan

  • Bladeren (paginagewijs, nieuwste reeksen eerst) en zoeken op titel of auteur.
  • Filters: reeksen / oneshots, NSFW verbergen of tonen.
  • Een reeks openen met de volledige hoofdstuklijst.
  • Een hoofdstuk lezen (tekst komt live van Arctic Shift, niet uit deze repo).

Elk verhaal zonder eigen omslag krijgt een deterministische cover: uit een hash van de titel volgt een kleurverloop of patroon, met de titel leesbaar erop. Dezelfde titel geeft altijd dezelfde cover; lange titels worden netjes afgebroken. De indexer schrijft een PNG (240×360) in public/covers/, omdat LNReader covers via expo-image laadt. Zonder Pillow valt hij terug op SVG. De covers worden bij het bouwen van de index meegenomen, ook in CI.

In de plugin-instellingen kun je de index-URL, de git-revisie en de hoofdstukbron aanpassen.

Hoe de index wordt gemaakt

Het programma indexer/build_index.py gebruikt de officiële wiki-serie-index van r/HFY als catalogus. Per serie komen daar titel, auteur (als die vermeld is) en de link naar de wiki-subpagina (eerste deel of inhoudsopgave) vandaan. Van die subpagina’s haalt de indexer de hoofdstuklinks, en volgt daarna de “next”-links in de posts zelf — met titelgelijkenis, in de geest van hfydl, maar zonder die code te kopiëren.

Omdat anonieme Reddit-JSON (/wiki/series.json en url/.json) sinds 2026 geblokkeerd is, gebeurt het ophalen via Arctic Shift: de wiki-API voor de index en subpagina’s, en /api/posts/ids voor post-metadata (geen /.json). Arctic Shift heeft niet elke wiki-subpagina in het archief; series zonder subpagina én zonder bekende auteur kunnen daardoor ontbreken. Titelzoeken op heel r/HFY wordt door die API geweigerd (te actieve subreddit); met auteur + titel lukt het wel.

De uitvoer staat in public/: een gesplitste catalogus, een zoekindex en per reeks een JSON-bestand met de hoofdstuklijst (geen verhaaltekst). Onderbroken runs hervatten via public/.cache/ (alleen metadata en links).

BlueGit heeft geen geplande pipelines. Op master staat een handmatige job update-index (of start een web-pipeline). Die ververst de index incrementeel. Om de nieuwe index ook terug in de repo te zetten, voeg je het geheim INDEX_PUSH_TOKEN toe (een token met schrijfrechten op deze repo, niet het job-token). Zonder dat geheim blijft de index een artifact.

Lokaal:

python3 -m unittest discover -s indexer/tests -v
node scripts/build-manifest.js
node scripts/test-plugin.js
python3 indexer/build_index.py --dest public --incremental --max-pages 200

Zet HFY_LIVE=1 bij de plugintest om parseChapter ook tegen de echte Arctic Shift-API te draaien.

Beperkingen

  • De catalogus volgt de wiki, niet een eigen scan van de subreddit. De wiki is zelf een momentopname (Arctic Shift bewaart een revisie) en is niet altijd volledig of bijgewerkt. Ontbrekende subpagina’s in het archief betekenen vaak dat een serie nog geen hoofdstukken in de index krijgt.
  • Hoofdstukken na het laatste wiki-deel worden via next-links en titelgelijkenis toegevoegd; die heuristiek kan een keten te vroeg stoppen of (zelden) een verkeerde link volgen.
  • Hoofdstukken laden hangt af van Arctic Shift (een onofficieel archief, zonder uptime-garantie). De officiële Reddit-API eist sinds 2026 OAuth; anonieme .json-URLs werken niet meer.
  • Auteurs houden het auteursrecht op hun verhalen. Deze repo host die teksten bewust niet. Gebruik is bedoeld voor persoonlijk lezen; een openbare herpublicatie van de teksten is iets anders.
  • --max-pages is een budget voor API-verzoeken per run. Een eerste volledige index kan meerdere update-index-runs nodig hebben.

Zie docs/ASSUMPTIONS.md voor de aannames en juridische kaders.

Licentie

De code in deze repository is MIT. Dat geldt niet voor de verhalen van r/HFY; die blijven van hun auteurs. hfydl zelf is GPL-3; deze indexer is opnieuw geschreven en bevat geen code daaruit.