diff --git a/src/documents/views.py b/src/documents/views.py index 592702170e..581ce42dae 100644 --- a/src/documents/views.py +++ b/src/documents/views.py @@ -5895,7 +5895,10 @@ class OcrTemplateViewSet(BulkPermissionMixin, PassUserMixin, ModelViewSet[OcrTem doc_id: str, page: str, ) -> HttpResponse: - """Render a page for the template editor's zone overlay.""" + """ + Render a page for the template editor's zone overlay. The page in the URL is + 0-based, unlike a zone's page, which is 1-based. + """ from documents.zone_ocr import resolve_zone_source document: Document = get_object_or_404( diff --git a/src/documents/zone_ocr.py b/src/documents/zone_ocr.py index 68e4e9c891..cf56293de6 100644 --- a/src/documents/zone_ocr.py +++ b/src/documents/zone_ocr.py @@ -439,7 +439,10 @@ def zone_results_written(results: list[ZoneOcrResult]) -> bool: def _resolve_page_idx(page_value: int | None, page_count: int | None) -> int: - """Resolve a 1-based page or -1 (last page), defaulting to the first page.""" + """ + Resolve a zone's 1-based page or -1 (last page) to a 0-based index, defaulting + to the first page. Without a page count, the last page resolves to the first. + """ if page_value == -1: return max((page_count or 1) - 1, 0) return max((page_value or 1) - 1, 0)