Skip to content

feat: -no-volumes binds every chapter of a series into one book with no volumes - #45

Merged
gustavommcv merged 1 commit into
mainfrom
feat/no-volumes
Oct 25, 2026
Merged

gustavommcv merged 1 commit into
mainfrom
feat/no-volumes

Conversation

@gustavommcv

Copy link
Copy Markdown
Owner

What and why

-no-volumes binds every chapter of a manga into one <manga>.cbz with no volumes, so the table of contents of the book is the chapters alone (Ch.1, Ch.2, ...) and not a volume with its chapters under it. The volumes that the names, the volume folders or the mapping file give are not used, a chapter that names no volume is in the book too, and the order is the order of the chapters.

Manga2Ink got this result until now by writing a mapping that put all the chapters in one invented volume and hiding that volume afterwards. This puts it in the command line (ADR 0006), for whoever uses the tool alone as well. It is additive in protocol version 1 and listed as the capability no-volumes.

  • The report has without_volumes: true and one volume (number 1, because a volume has one); a unit's effective_volume is that volume and its metadata_assignment.status is not_applicable; what the name says stays in parser.volume.
  • Issues about a gap or a chapter two sources claim name no volume, and their messages speak of the book.
  • chapter_versions of the mapping file still choose among the files of a chapter, now across the series.
  • -no-volumes with -combine is refused (exit 2, no_volumes_with_combine); it composes with -batch.
  • ADR 0030, README, docs/machine-protocol-v1.md.

Verification

  • go vet and go test ./... pass, with new tests for the book, the ignored mapping volumes, a volume folder, the gap and the conflict (text and report), the plan, a library and the refusal.
  • Run on a real series (Ubunchu!, read only, output elsewhere): one Ubunchu!.cbz of 225 pages and 16 chapters, Ch.1 to Ch.16, no issues.
  • Not covered: the table of contents of the EPUB made from it by the converter is the same one that Manga2Ink's earlier mapping produced (same directory layout); Manga2Ink will use the flag only after a release of this tool.

@gustavommcv
gustavommcv merged commit ed5369e into main Oct 25, 2026
6 checks passed
@gustavommcv
gustavommcv deleted the feat/no-volumes branch October 25, 2026 06:09
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant