Print Book Production: Essays on Dalits, Religion and Liberation II

Print Book Production documents the preparation of the paperback edition of Essays on Dalits, Religion and Liberation II by A. M. Abraham Ayrookuzhiel. It records the production decisions, technical requirements and workflow for creating a complete print-ready PDF, which will be supplied to the printer through Pranesh.

This page is the print-production companion to E-book Export: A. M. A. Ayrookuzhiel. The two editions belong to the same publication project, but their layout and production systems are different.

Purpose

The objective is to produce a professionally typeset, print-ready interior PDF for the paperback edition. The Sunil Abraham Project will take responsibility for the book’s editorial layout and typesetting decisions rather than sending an EPUB to the printer for the printer to redesign.

The finished PDF will be supplied to Pranesh. His role, as discussed, is to coordinate with the printer and arrange for the printing plates to be made from the supplied print-ready PDF. The printer’s production specifications must therefore be confirmed before the final PDF is approved.

Scope

This documentation covers the paperback interior and its production workflow, including:

The EPUB remains a separate digital edition. Its content and editorial structure should remain consistent with the print book, but its CSS and reflowable layout rules will not be reused as the print layout. The print design will reproduce the same editorial identity through Typst’s own typesetting and styling system.

Production direction and responsibilities

The following direction was given by Sunil:

The printer is not being asked to make the book’s design decisions. The project must supply a finished interior PDF that meets the printer’s technical requirements.

Subject index

A subject index will be prepared for the paperback edition. It will help readers locate people, places, concepts, movements, institutions and other significant subjects discussed across the essays. The index is an editorial component of the book, not simply a list of frequently occurring words. Entries must be selected for their significance and usefulness to readers, and page references must be checked against the final printed pagination.

Tools and division of work

The subject-index workflow will use the Ubuntu laptop for PDF text extraction and the Windows 7 second-hand desktop for Cindex 4.4:

PyMuPDF is a text-extraction tool, not an automatic subject-indexing system. It can extract searchable text and identify PDF pages, but editorial judgement is required to select and structure index entries. If the source PDF consists of scanned page images rather than selectable text, OCR will be required before text extraction. OCR output must be checked against the page images, particularly for names and specialised terminology.

Page references and pagination control

The index must refer to the page numbers printed in the book, not blindly to the PDF viewer’s page count. Preliminary pages, unnumbered pages, Roman-numbered pages, blank pages and the main-text sequence can make these values different. The extraction process must therefore record the relationship between each PDF page and its printed folio.

The body text and its pagination should be treated as stable before the index is finalised. The preferred sequence is to generate and proof the complete paginated interior without the index, extract and verify page references from that version, prepare the index in Cindex, and then append the index to the book. Because the index is placed at the end, adding it should not change the page references in the preceding text. Any later change that affects the main text’s pagination must trigger a fresh page-reference check.

Indexing principles

Subject-index deliverables

The indexing stage should produce:

  1. A page-by-page extracted text file or structured dataset from the paginated PDF.
  2. A working list of candidate subjects with their occurrence locations.
  3. A reviewed Cindex database containing the selected entries, subentries and cross-references.
  4. An exported index suitable for integration into the Typst print source.
  5. A final proofed index checked against the completed interior PDF.

The Cindex database and the extracted text should be retained as production files so that corrections can be made and the index can be regenerated if the manuscript or pagination changes.

Draft book production plan

The following is a working plan for completing the paperback edition of Essays on Dalits, Religion and Liberation II. It is a proposed sequence, not a statement that every stage has already been completed. The existing source essays and front matter remain the authoritative manuscript; production work must not silently rewrite them.

Stage 1 - Confirm and freeze the publication manuscript

Stage 2 - Complete the interior design and typesetting

Stage 3 - Generate and proof the paginated book

Stage 4 - Prepare the subject index

Stage 5 - Produce and proof the complete interior

Stage 6 - Prepare the cover

Stage 7 - Technical validation and final proof

Stage 8 - Printer handover and publication archive

Working completion criteria

The paperback should be considered ready for printer handover only when the complete interior and cover have passed their respective checks, the subject index has been verified against the final printed pagination, and the printer’s technical requirements have been confirmed. A successful automated build or an uploaded PDF artifact is necessary evidence of production, but it is not by itself proof of editorial or print readiness.

Proposed production workflow

  1. Confirm the printer’s requirements: Obtain any printer-specific PDF instructions, templates, bleed and crop-mark requirements, and the required binding allowance.
  2. Prepare the manuscript: Use the approved essay sequence and front matter from the e-book project, checking the complete text and publication details before print composition.
  3. Set up the Typst project: Create a separate print-production directory containing the Typst source, reusable layout rules, required fonts and images.
  4. Establish the page design: Configure A5 pages, margins, typography, paragraph rhythm, heading styles, page numbering and other book conventions.
  5. Define pagination: Configure automatic page numbering (folios), decide how preliminary pages are numbered or left unnumbered, establish the main-text numbering sequence, and set consistent folio placement and running-head rules.
  6. Prepare print-specific links: Remove active hyperlink behaviour and styling from the print interior. Retain references and URLs as readable printed text wherever they form part of the approved content.
  7. Typeset the complete book: Compose the front matter and all nine essays, preserving notes, references, tables, illustrations and captions.
  8. Generate the interior PDF: Run Typst in GitHub Actions so that the PDF can be built from the repository without requiring Typst to be installed on the Ubuntu laptop.
  9. Prepare the cover separately: Create a full-wrap cover layout containing the back cover, spine and front cover in the printer’s required dimensions and order. Calculate the spine width only after the final interior page count and printer’s paper specification are known. Add bleed, crop marks and other production marks only as required by the printer.
  10. Proof both outputs: Inspect the interior for missing text, pagination errors, widows and orphans, footnotes, references and image quality. Inspect the cover separately for dimensions, alignment, spine placement and bleed.
  11. Validate for the printer: Check both PDFs against the printer’s supplied specifications. A successful build alone does not establish printer approval.
  12. Supply the approved PDFs: Send the print-ready interior PDF and separate full-wrap cover PDF to Pranesh for coordination with the printer and plate preparation.

Page size and initial layout specifications

Herbert suggested the following specifications, which we intend to use as the starting point for the design:

Element Suggested specification
Page size A5
Page width 14.8 cm
Page height 21 cm
Left margin 1 cm
Right margin 1 cm
Top margin 1.7 cm
Bottom margin to text 1 cm
Body text 10-12 pt
Main headings 16-18 pt
Subheadings 14-16 pt

A5 (148 × 210 mm) is the specified page size and will be retained. The type sizes are ranges for design and proofing, not a claim that one final size has already been selected. A body size around 11 pt can be tested as an initial setting, with the final choice judged on actual pages and a printed proof.

The stated 1 cm left and right margins are an initial proposal. The inner margin may need to be increased to provide sufficient binding allowance. The final gutter should be settled after the printer’s requirements and the likely page extent are understood. The bottom measurement also needs to be applied consistently to the text area and any footer or page number.

Typography and visual design

The print edition will have its own fixed-page typographic system. The design should be calm, scholarly, readable and appropriate for a collection of essays. It should prioritise sustained reading over decorative effects.

The design work will establish:

The e-book and print editions should share the same editorial identity, including consistent titles, heading hierarchy, emphasis, references and publication details. However, the EPUB stylesheet is not a print stylesheet: EPUB CSS controls the reflowable digital edition, while Typst controls the fixed-page PDF.

International publishing standards and typographic principles

The print design will be reviewed against established international book-production guidance and recognised principles of book typography. These references are intended to inform decisions during design and proofing; they are not a claim that every publisher follows one universal layout or that every recommendation must be applied mechanically. Some or all of the points below may be adopted where they suit this book, its content, its A5 format and the printer’s requirements.

The purpose of recording these principles is to preserve them as a reference for the remaining design, typesetting and proofreading work. They should be considered alongside the existing production specifications and the findings in the PDF audit.

Page architecture and pagination

Body typography and measure

Tables, illustrations and captions

Footnotes, references and other matter

Printer and PDF production checks

Reference sources

The following sources inform this review. Publisher instructions are production guidance for their own workflows; typographic principles are reference points to evaluate, not universal rules.

  1. Oxford University Press - Preparing print-ready files
  2. Oxford University Press - Tables and boxes
  3. Wiley - Preparing print-ready PDFs
  4. The Chicago Manual of Style - Production technologies
  5. Robert Bringhurst, The Elements of Typographic Style.
  6. University of Alabama Press - Illustration guidelines.

These references should be revisited when the page design, tables and final PDF are reviewed. Any adopted change should be recorded in the production log, and should not silently alter the source essays or previously approved page elements.

Typst and technical implementation

Typst will be the typesetting system for the paperback interior. It will generate the PDF from source files maintained in the TSAP GitHub repository.

The planned approach is to run Typst through GitHub Actions, just as the e-book build uses tools installed in a GitHub-hosted runner. Typst does not need to be installed on the Ubuntu laptop for this workflow. Local installation may be useful for optional experimentation, but it is not a requirement.

The print project should remain separate from the EPUB build. A likely location for its source files is ebook/edrl-ii/print/. The exact file structure and workflow will be recorded when implementation begins. The print workflow should generate a PDF artifact that can be inspected and supplied to the printer; it should not change the EPUB output or its CSS.

The source manuscript should remain traceable to the approved essays and front matter. Any publication-only corrections must be deliberate and recorded. The original website articles should not be silently rewritten as part of print composition.

Typst versus Markdown

Markdown and Typst are both text-based markup systems, but their formatting symbols are not interchangeable. Markdown is used for the TSAP source pages and the reflowable e-book content. Typst is used to compose the fixed-page print PDF. When text is transferred from a Markdown source into a Typst document, its emphasis markers must be converted to Typst syntax rather than copied unchanged.

The TSAP Markdown cheatsheet documents the Markdown conventions used across the project. The comparisons below focus on the formatting features that matter directly to this print workflow.

Inline formatting

FormattingMarkdown (TSAP source)Typst (print source)Important difference
Bold**bold text***bold text* or #strong[bold text]In Typst, asterisks indicate bold.
Italic*italic text* or _italic text__italic text_ or #emph[italic text]In Typst, underscores indicate italic.
UnderlineNot part of standard Markdown. HTML <u>underlined text</u> may work where raw HTML is permitted.#underline[underlined text]Typst has a native underline function; Markdown does not have a standard underline marker.

Headings and tables

ElementMarkdown (TSAP source)Typst (print source)Important difference
Level 1 heading# Heading= HeadingMarkdown uses hash signs; Typst uses equals signs.
Level 2 heading## Heading== HeadingEach additional marker indicates a lower heading level.
Level 3 heading### Heading=== HeadingThe marker sequence is different even though the heading hierarchy is comparable.
TablePipe table, with a header separator row: | Name | Year | followed by |---|---|#table(columns: 2, [Name], [Year], [Example], [2026])Markdown uses pipe-delimited rows; Typst uses the #table() function and explicit column definitions.

The distinction between bold and italic is especially important in this project. The Markdown cheatsheet uses *italics* and **bold**. In Typst, the meanings are different: *bold* and _italics_. Copying Markdown emphasis markers directly into a Typst source can therefore change the intended appearance. The Editor’s Note uses Typst’s underscore syntax for book and journal titles; all other text in that note is plain, without bold styling.

The two comparison tables are placed in horizontally scrollable containers on narrow screens. This keeps the table columns readable on mobile rather than forcing the page layout to compress the contents.

Pagination and print treatment

Page numbers will be generated automatically by Typst as part of the interior layout; they will not be typed manually into the manuscript. The design will establish their position, type style and whether running heads are used.

The pagination plan will distinguish preliminary matter from the main text. Preliminary pages may use a separate numbering convention or remain unnumbered where appropriate; the main text will begin with the agreed numbering sequence. The exact convention and first displayed page number will be settled during layout. Pagination must be checked again after the complete book has been composed, because changes to text, images or page breaks can alter the final sequence.

The print edition is not an interactive digital document. Active hyperlinks, link colours and underlining used only to signal clickable links will be removed. References, citations and URLs that belong to the content will remain as readable printed text. No reference should depend on being clicked to make sense on paper.

Paperback cover: back, spine and front

The cover is a separate production item from the interior PDF. It will be designed as one full-wrap spread, arranged in the printer’s required order and dimensions: back cover panel, spine panel and front cover panel.

The cover PDF will be supplied separately from the A5 interior PDF. Spine width cannot be finalised from page size alone: it depends on the final interior page count, paper stock and binding method. The printer must confirm the cover template or exact spine calculation, overall spread dimensions, bleed, crop marks and any other required production marks before final export.

Cover artwork and text can be prepared while the interior is being typeset, but the final spine width and complete wrap dimensions must wait until the interior pagination and printer specifications are confirmed.

Printer requirements: questions to confirm

Before final PDF export, the following details need confirmation from Herbert or the printer:

  1. Does the printer have specific PDF requirements or a template that the project must follow?
  2. What inner binding margin (gutter) should be allowed for the A5 pages?
  3. Does the printer require bleed and crop marks, or any other specific printing marks in the PDF?

These are the outstanding questions identified so far. Paper type and GSM do not need to be fixed in order to begin the Typst layout. They may be relevant to the printer’s production choices and spine calculation, but they are not prerequisites for designing the interior pages.

PDF proofing and quality assurance

The generated PDF must be inspected as a complete book, not judged solely by whether Typst exits successfully. Checks should include:

The PDF should be checked on screen and, where practicable, through a physical test print. Final approval should follow visual proofing and confirmation that the printer can accept the file.

Current decisions and pending items

Decisions and directions recorded

Pending confirmation or implementation

The print builder is maintained separately from the EPUB builder. The current implementation is in ebook/edrl-ii/print/build.py, with automation in .github/workflows/build-edrl-ii-print.yml. The values below record the current implementation; they are configuration facts, not all final design approvals.

Paths and source configuration

Variable or setting Current value or purpose
ROOT Repository root, derived from the location of build.py
BASE ebook/edrl-ii/
PRINT ebook/edrl-ii/print/
OUT ebook/edrl-ii/print/output/
COVER_URL https://raw.githubusercontent.com/sunilabrahamindia/sunilabrahammedia/main/amaa/edrl-ii-v0.2.jpg
COVER Downloaded cover image at output/edrl-ii-cover.jpg
Manifest ebook/edrl-ii/manifest.yml; the builder expects nine essay entries and sorts them by order
Source text Original TSAP Markdown pages named in the manifest; these remain the source of truth

The cover download is checked for a minimum file size and JPEG signature before the build continues. The supplied artwork is currently treated as a front-cover image only; it is not a printer’s full-wrap cover.

Current interior typesetting values

Setting Current implementation
Page size A5, 148 × 210 mm
Binding model Mirrored pages, binding on the left
Inside margin 18 mm
Outside margin 14 mm
Top margin 18 mm
Bottom margin 17 mm
Body typeface Linux Libertine O
Body size 11 pt
Paragraph alignment Justified
Line leading 0.85 em
First-line indent 1.1 em
Paragraph spacing 12 pt
Level-one headings 18 pt, bold, centred
Level-two headings 16 pt, bold
Level-three headings 14 pt, bold
Running head Book title only: ESSAYS ON DALITS, RELIGION AND LIBERATION II; centred, 7.5 pt, light grey, with a thin rule below
Folio Centred, 8 pt, light grey

These are the current proof settings, not final approved specifications. They must be compared with the EDRL I printed-book references when supplied. The final gutter and page design remain subject to printer requirements and physical proofing.

Build tools and workflow settings

The GitHub Actions workflow currently:

Extraction and conversion safeguards

The builder removes YAML front matter, website introductions and generated contents lists where identified, strips website navigation and Liquid include lines, and converts source HTML footnote references and note-list entries into Pandoc Markdown footnotes before Typst conversion. It checks that each detected footnote reference has a corresponding note target, checks that essay extraction is not suspiciously short, and checks the converted Typst text for common raw HTML elements. These checks are useful safeguards, not proof that every source feature has been preserved correctly. In particular, every essay, footnote and reference still requires visual comparison with the original source.

Output files

The current successful workflow produces:

The combined review is not the printer’s interior file. The front-cover proof is not a full-wrap cover. The full-wrap cover still requires the printer’s dimensions, bleed and crop-mark instructions, binding method, final page count and confirmed spine width.

Work log

Essay sources and original publication details

The following list identifies each essay in the print edition, links to its full text on the TSAP website, records its original publication details and gives the total number of footnote citation markers in the source text. Repeated citations are counted each time they appear, rather than counting only distinct note entries. These figures provide a checklist for checking the footnotes in the generated PDF.

Essay Full text Citations (footnote markers) Original publication
The State of Hinduism in 2000 A.D.—Some Emerging Trends Full text 0 Indian Journal of Theology, Vol. 26, No. 2, April–June 1977.
Religion, Spirituality and Aspirations of the People Full text 6 Religion and Society, Vol. XXV, No. 1, March 1978.
The Living Hindu Popular Religious Consciousness and Some Reflections on It in the Context of Hindu-Christian Dialogue Full text 8 Religion and Society, Vol. XXVI, No. 1, March 1979, pp. 5–25.
The Church and the Study of Religion Full text 6 Religion and Society, Vol. XXVIII, No. 3, September 1981, pp. 36–41.
Religions and the Aspirations of the People Full text 3 Religion and Society, Vol. XXX, Nos. 3 & 4, September–December 1983, pp. 102–108.
Religion: A Way of Salvation or an Ideology of Oppression? Full text 4 Religion and Society, Vol. XXXII, No. 1, March 1985.
Dalit Theology: A Movement of Counter-Culture Full text 42 Paper No. 7, pp. 83–103, in Towards a Dalit Theology (1988).
Dalit Liberation — Some Reflections on Their Ideological Predicament Full text 0 Religion and Society, Vol. XXXV, No. 2, June 1988, pp. 47–52.
The Ideological Nature of the Emerging Dalit Consciousness Full text 22 Religion and Society, Vol. XXXVII, No. 3, September 1990, pp. 14–23.
Total   91  

Footnote tally snapshot — 7 November 2026, 12:20 p.m.

This is the baseline PDF audit recorded before the next round of corrections. The tally was checked against the combined review PDF, artifact version 46 (edrl-ii-combined-review-46.pdf, 142 pages). It records what was actually visible in that PDF at the time of the audit; it is not a statement about the current or final build.

Essay Source citation markers Rendered as page-bottom footnotes Visible as raw markers
1. The State of Hinduism in 2000 A.D.000
2. Religion, Spirituality and Aspirations of the People660
3. The Living Hindu Popular Religious Consciousness880
4. The Church and the Study of Religion660
5. Religions and the Aspirations of the People330
6. Religion: A Way of Salvation or an Ideology of Oppression?440
7. Dalit Theology: A Movement of Counter-Culture42042
8. Dalit Liberation — Some Reflections on Their Ideological Predicament000
9. The Ideological Nature of the Emerging Dalit Consciousness22022
Total linked citation markers912764

The PDF also contains two additional manually numbered footnotes that are not included in the 91 linked source-marker tally: one in essay 7 (PDF page 120; printed page 119) and one in essay 9 (PDF page 142; printed page 141). These must be reconciled separately with the source articles before a final footnote total is declared.

Audit result: 27 of the 91 linked citation markers were correctly rendered as page-bottom footnotes. The remaining 64 appeared literally as Markdown markers ([^1], [^2], and so on) in the body text, without their corresponding page-bottom notes. The raw markers also caused a serious collision with the poetry layout on PDF page 142. This is the baseline against which the next corrected artifact must be checked.

Full PDF audit snapshot — 7 November 2026, 12:20 p.m.

This section preserves the other findings from the same inspection of combined review PDF artifact version 46. It is a historical audit record, not a claim that every item remains unresolved in a later artifact. The Foreword, Editor’s Note and production-credit wording were known working material at the time and are recorded here for completeness, not classified as errors requiring immediate correction.

Tables and boxed material

The tables are the most substantial non-footnote layout problem identified in the version 46 PDF.

PDF page Printed page Finding recorded
79 78 Table 1 is cramped; words break awkwardly across narrow columns.
80 79 Table 2 column headings collide with borders or overlap; narrow columns cause excessive word breaks.
80–81 79–80 Tables cross page boundaries without sufficiently clear continuation treatment. Table 3 continues without repeating its headings, making the context of continued rows difficult to follow.
81 80 Table 4 has narrow columns and awkward line breaks.

Required review when the tables are addressed:

Headings and hierarchy

Footnotes, poetry and source notes

The detailed marker count and version 46 footnote findings are recorded in the preceding Footnote tally snapshot. The additional observations from the visual audit were:

General typography and page composition

Front matter and production material — status at the time of audit

These items were visible in version 46 but were identified as work in progress, not as defects to fix in the citation-only pass:

The Foreword and Editor’s Note are being worked on separately. These passages must remain untouched during a citation-only correction.

Cover proof

PDF accessibility and archival preparation

The version 46 file was selectable/searchable as text, but the PDF inspection reported:

For the final digital/archival PDF, investigate adding accurate title, author, subject, keywords and language metadata; useful bookmarks/outlines for the front matter and nine essays; and tagged structure where the production toolchain permits it. These are quality and accessibility improvements, not part of the citation-only correction.

Stray notes and web material

Scope and order of subsequent work

This audit record is intended to prevent findings from being lost between successive proof versions. The order agreed for the next checks is:

  1. Correct and verify citations/footnotes against the source articles and the version 46 baseline.
  2. Inspect the next artifact specifically for citation correctness before changing anything else.
  3. Address the four table-layout cases and their page continuations as a separate task.
  4. Review display-title hyphenation and page composition.
  5. Complete front matter and production credits when the relevant text/details are ready.
  6. Prepare the final full-wrap cover and improve PDF metadata/accessibility as part of final production.

No table, heading, front-matter, cover, metadata or general typography changes were made as part of the citation-only correction recorded after this audit.

Production log — publication page and final layout review — 7 November 2026

The following changes were made in the print builder after the version 46 audit and the subsequent table and heading-layout work.

  1. Publication details page composition: Replaced the previous centred “Publication details” heading and loosely stacked text with a restrained colophon-style layout. The existing publication information and wording were retained. The page now uses a compact imprint line, a clear title-and-author hierarchy, a ruled separation and a two-column label/value arrangement for the publisher, website, edition, ISBN, printed price and language.
  2. Page furniture: Suppressed the running header, footer and folio on the publication details page so that it reads as a deliberate preliminary page rather than an ordinary essay page.
  3. Typography and spacing: Used the book’s existing Linux Libertine O family, restrained sizes and greyscale rules. The composition is left-aligned within a narrower measure and avoids boxes or decorative graphics.
  4. Scope: No essay source text, publication facts, ISBN, price, date, author/editor attribution or existing production-credit wording was changed. The change is confined to the Typst builder.
  5. Existing layout work retained for verification: The builder also contains the earlier HTML-table-to-Typst conversion, content-weighted column proportions, repeating table-header treatment, non-breakable table cells, local table typography and non-hyphenated heading styles. These are to be checked in the generated PDF rather than assumed correct from source code alone.
  6. Build and proof checks: The GitHub Actions build is the validation step. The resulting combined review PDF must be inspected for table readability and continuation, caption placement, heading breaks and page-bottom placement, footnote rendering (including poetry), publication-page composition and contents pagination. A successful automated build is not by itself proof of visual correctness.

Builder change: 0eb937ed5fd93f39266038fddd7a1d3a11aa4ab1 (Redesign EDRL II publication details page). The workflow run number, artifact identifier, PDF page count and visual inspection findings should be appended here after the build completes and the generated files have been examined.

Table readability correction — 7 November 2026

The combined review PDF from workflow run 54 (artifact edrl-ii-print-preview-54, 143 pages) showed that the table headings remained difficult to read at A5 size. In particular, Table 4’s long column labels were broken into narrow fragments and justified spacing stretched the words across the header cells.

The print builder has now been adjusted, without changing the essay source or its data:

  1. Concise print-only column labels: Long headings are replaced in the printed tables with shorter labels that retain their meaning. Examples include “Families with land”, “Land held (acres)”, “Borewells and pumpsets”, “Amount (Rs.)”, “Fully employed: own farm / other work”, and “Agriculture + wage labour”. The original full wording remains in the source article.
  2. Natural header spacing: Table content now uses non-justified paragraph layout with no first-line indent or extra paragraph spacing. This prevents the large, uneven gaps between words visible in the previous proof.
  3. Clear header alignment: Header cells are explicitly left-aligned, while the numeric data columns retain their centred alignment.
  4. Scope: The change is confined to the print builder. No essay text, figures, row labels, credits-page content or other front matter has been changed.

The next proof must be visually checked at A5 size, especially Tables 1–5, including header wrapping, row integrity, page continuation and repeated headings. This correction is not considered complete until the generated PDF has been inspected.

Foreword preparation

The foreword by Y. T. Vinayaraj was received as a Word document and inspected on 11 November 2026. The original wording has been transcribed into the shared source file ebook/edrl-ii/foreword.md. No copy-editing or rewriting has been undertaken.

Front-matter spacing and preliminary folios — 11 November 2026

The paperback proof showed two front-matter spacing defects: the Foreword heading sat too close to its opening paragraph, and the Editor’s Note heading overlapped or crowded the draft-status notice. The preliminary page numbers were also set in uppercase Roman numerals, whereas the required style is lowercase Roman numerals.

The print builder is being adjusted as follows:

  1. Add deliberate vertical space between the Foreword heading and its first paragraph.
  2. Separate the Editor’s Note heading, its “DRAFT VERSION — NOT YET FINALISED” notice and the opening paragraph with consistent vertical spacing.
  3. Change preliminary folios to lowercase Roman numerals (i, ii, iii, iv, v, vi, and so on), retaining the restart at Arabic page 1 for the first essay.
  4. Keep the foreword wording, poem, references, essay text, table treatment, cover and other page furniture unchanged.

The documentation update is committed separately from the print-builder change so that only the builder commit triggers a new paperback workflow run. The visual result must still be checked in the resulting PDF; the source change alone does not establish that the spacing is correct.

Running heads, signatures and minimum type size — 11 November 2026

Paperback proof #71 was inspected visually. The revised Foreword heading-to-body spacing is satisfactory, the Editor’s Note draft notice no longer overlaps its heading, and the preliminary folios appear in lowercase Roman numerals. These corrections are retained.

The next consolidated paperback update implements the agreed production direction from Herbert Paul’s review and the subsequent clarification:

The global hyphenation proposal is not included in this update. It remains a separate decision because disabling hyphenation throughout may materially change justification and page texture. The existing Foreword and Editor’s Note spacing corrections, lowercase Roman folios and first-essay Arabic pagination must remain intact.

The builder update is intended to trigger one paperback proof build. The generated PDF must be checked for running-head parity, blank chapter-opening headers, signature alignment, table fit after type enlargement, footnote legibility and preservation of the earlier front-matter corrections.

Front-matter editorial copy and attribution — 11 November 2026

The print builder has been updated to prepare the Foreword and Editor’s Note as finished front matter rather than provisional copy.

Foreword attribution

The foreword signature is right-aligned and set as a separate line for each part of the author’s name and institutional designation:

The institute’s website address has been omitted from the print signature. The shared source file ebook/edrl-ii/foreword.md remains unchanged so that the e-book can apply its own digital treatment. The print builder replaces the source signature during print composition.

Editor’s Note and attribution

The draft-status notice, “DRAFT VERSION — NOT YET FINALISED”, has been removed. The Editor’s Note has been recast as finished editorial prose, retaining the documented publication history of the 2006 volume, the origins and archival purpose of The Sunil Abraham Project, the composition and publication history of the nine essays, and the continuing nature of the collection and preservation work.

The Editor’s attribution is right-aligned and line-broken as follows:

The planned publication date, 29 November 2026, is retained above the attribution. The place name Kolkata is not included.

The Foreword and Editor’s Note are composed for a physical book. No active hyperlinks or clickable website labels are used in these signature blocks, and the CISRS website address has been removed from the foreword attribution. The e-book is a separate digital edition and may retain useful hyperlinks where appropriate; these print decisions must not be copied automatically into its output.

Implementation and verification

The changes are confined to ebook/edrl-ii/print/build.py. The shared foreword source and original essay source pages have not been rewritten. The next paperback proof must be inspected to verify the line breaks, right alignment, paragraph spacing, front-matter pagination and the complete Editor’s Note. A successful Typst build alone does not establish that the printed pages are correct.

Correction: explicit signature line breaks — 11 November 2026

The first print proof showed that separate Typst text elements remained in the same paragraph and therefore flowed together on one long line. The signature blocks have now been corrected with explicit Typst line breaks; separate text elements alone are not sufficient.

The final intended print layout is:

Foreword attribution (right-aligned):

Dr. Y. T. Vinayaraj
Director,
Christian Institute for the Study of
Religion and Society

The abbreviation “(CISRS)” and the institute’s website address are omitted.

Editor’s attribution (right-aligned):

Tito Dutta
Co-founder and Administrator
The Sunil Abraham Project

Each item is forced onto its own line in the print builder. This correction supersedes the earlier attribution description in this log. The generated paperback proof must still be visually checked to confirm the final rendered line breaks and spacing.

Author biography for the paperback — plan and editorial scope — 11 November 2026

Sunil Abraham suggested including two biographies of A. M. A. Ayrookuzhiel in the book: a short biographical note on the back cover and a fuller biography within the preliminary pages. This entry records the plan for the longer, inside biography. The back-cover note is a separate piece of copy and will be prepared independently.

Purpose and placement

The inside biography will introduce the author to readers before they begin the collected essays. It will appear after the Editor’s Note and before the Contents. This creates a deliberate sequence: the Foreword introduces the intellectual significance of the work; the Editor’s Note explains the history and purpose of the collection; the biography introduces the author; and the Contents lead into the essays.

Length and format

Content to retain

The narrative will draw on the existing author biography at /amaa/index.md and prioritise information relevant to understanding the author and his work:

  1. His identity, dates and origins in Kerala.
  2. His early formation and theological education in India and abroad.
  3. His ministry in the United Kingdom and return to India.
  4. His work at the Christian Institute for the Study of Religion and Society (CISRS), including his research and role as Associate Director.
  5. His intellectual engagement with Dalit experience, caste, religious identity, popular religion, contextual theology and liberation.
  6. Selected publications and the unfinished work on Dalit and Hindu religious identity, followed by his death in 1996.

Material to omit or handle cautiously

The inside biography will not reproduce the website’s family genealogy, detailed family chronology, tabular bibliography, article-by-article inventory, references or external links. It will avoid claims about influence, institutional history or intellectual priority that are not established by the source biography. Where the source gives only broad information, the book will retain that level of generality rather than supply guessed dates, institutions, qualifications or explanations.

Relationship to the back-cover note

The back-cover biography will be approximately 70–100 words and will serve a different purpose: a concise introduction for prospective readers. It should not simply be a truncated version of the inside biography. The two texts should be consistent in facts and emphasis, but independently edited for their respective locations.

Production status and verification

The longer biography is to be added to the print interior after the Editor’s Note and before the Contents. Its final word count, paragraph flow, heading treatment and pagination must be checked in the generated A5 proof. The biography should be checked against /amaa/index.md for factual fidelity. The back-cover note remains a separate pending task.

Inside biography added to print builder — 11 November 2026

The first draft of the longer biography has now been added to ebook/edrl-ii/print/build.py under the heading About the Author. It follows the Editor’s Note and precedes the Contents, as specified in the plan above. A page break separates the Editor’s Note from the biography and another separates the biography from the Contents; the biography itself may flow naturally across pages if required.

The draft is written as continuous prose in six paragraphs, without tables, bullet lists, references or hyperlinks. It follows the existing /amaa/index.md biography and covers Ayrookuzhiel’s origins and education, ministry in the United Kingdom, work at CISRS, intellectual concerns, selected publications and unfinished manuscript. Family genealogy and detailed personal chronology have been left out. The text keeps broad source descriptions broad and does not add unsupported dates or qualifications.

The back-cover biography remains a separate, pending item. It is not included in this change.

Verification still required: inspect the generated A5 paperback proof for the biography’s word flow, page count, heading and paragraph spacing, page breaks, and its transition to the Contents. Check every biographical statement against /amaa/index.md. This draft should not be treated as final until that proofread is complete.

Approved author biography inserted — 11 November 2026

The editor-approved version of About the Author, supplied in the conversation on 11 November 2026, has replaced the earlier working draft in ebook/edrl-ii/print/build.py. The text is reproduced as approved, including the full-name usage, the description “theologian, scholar and researcher”, the date range with spaces around the en dash, and the six-paragraph structure. No further stylistic rewriting was made during implementation.

The biography remains positioned after the Editor’s Note and before the Contents. It is composed as continuous prose, with no table, list, references or hyperlinks. The separate short back-cover biography remains pending.

Pagination and proof requirements

The biography has been inserted into the existing preliminary matter; no folio numbers have been manually assigned or hard-coded for it. The existing preliminary-page numbering system is expected to continue in lowercase Roman numerals (i, ii, iii, iv, and so on), with Arabic numbering restarting at page 1 for the first essay. The added biography may increase the number of preliminary pages, so the next generated proof must be checked to confirm that Roman folios advance automatically, that the first essay still begins at Arabic page 1, and that the Contents page references and all subsequent pagination are correct.

The new A5 proof must also be visually inspected for the biography heading, paragraph spacing, page flow, blank-page behaviour and transition to the Contents. This implementation is not considered print-approved until the PDF itself has been reviewed.

Critical incident: paragraph and text overlap in the paperback interior — 11 November 2026

Summary

A serious composition defect appeared in the generated paperback PDF on 11 November 2026. Text from consecutive paragraphs overlaps vertically: the final line of one paragraph and the opening line of the next are printed at nearly the same vertical position. The defect is visible in the Foreword and is reported to affect the interior more broadly, including many pages across the book. It makes affected pages difficult or impossible to read and is a release-blocking production defect.

The problem was not present in the earlier series of paperback builds. More than 70 earlier workflow runs had been used during production without this particular paragraph-collision defect being reported. It appeared after changes were made to the print builder during the publication-details-page revision. The user’s laptop restart occurred after the defect had appeared; there is no evidence that the laptop or a local machine restart caused it. The relevant changes were made in the repository’s GitHub Actions build source.

The current cause has not yet been conclusively isolated. The incident must remain open until the exact source-level cause is demonstrated and a complete regenerated PDF has been inspected. A successful build status is not evidence that the layout is fixed.

What the defect looks like

The supplied screenshots show the following symptoms:

The visible symptom is paragraph-to-paragraph collision. It must not be described merely as tight line spacing: lines within individual paragraphs may remain legible while separate paragraphs are placed on top of one another.

Timeline of changes and investigation

  1. Earlier working state. The paperback had gone through more than 70 earlier GitHub Actions builds. The user had not reported this repeated paragraph-overlap defect in those proofs.

  2. Publication-details revision. During the revision of the publication and credits page, the print builder’s global paragraph settings were changed from the previous body-text configuration to leading: 1.2em and spacing: 8pt. The publication page was also changed to remove the project-name heading and horizontal rules after the user objected to them. These changes were committed as part of the work leading to print build 88.

  3. Build 88. The dedicated paperback workflow completed, but the PDF still showed the same paragraph collisions. This demonstrated that increasing the global line leading had not corrected the defect.

  4. Global block-spacing hypothesis. The builder contained a global #set block(spacing: 0.55em) rule. It was removed as a possible contributor to block separation. The resulting proof still showed collisions. Removing this setting was therefore not a demonstrated fix.

  5. Paragraph show-rule experiment. A global #show par rule wrapping paragraphs in blocks with a below spacing value was added as another attempted correction. The following proof still showed the defect. This experiment was subsequently removed. It must not be reintroduced without a clear, isolated test.

  6. Paragraph-spacing adjustment. The global paragraph spacing was increased again, to 16 pt. This also did not establish a fix.

  7. Inspection of generated Typst content. A temporary diagnostic print was added to the GitHub Actions build so that the Pandoc-generated Typst content for the Foreword could be inspected in the job log. The diagnostic output showed that ordinary paragraphs were separated by blank lines in the generated Typst text. The output did not show #parbreak() markers between those ordinary paragraphs. This matters because the earlier attempted replacement of #parbreak() did not target the paragraph separators actually present in the generated Foreword content.

  8. Explicit paragraph-gap experiment. A post-processing step was then added to the Pandoc-generated Typst text. It uses a regular expression to find blank-line paragraph boundaries and insert an explicit #v(10pt) between paragraphs. This is an experimental intervention, not yet a verified solution. Its effect must be checked in the PDF, and its behaviour around headings, lists, quotations, footnotes, poems and other structured content must be examined before it is accepted.

  9. Latest diagnostic/build state. The temporary diagnostic output and subsequent paragraph-boundary changes were committed during the investigation. The latest dedicated paperback workflow at the time of this entry is run 42966996529. Its final PDF and visual result must be checked before the status of the experiment can be determined.

What is known, and what is not yet known

Established from the source and build logs:

Not yet established:

Do not record any one of the attempted explanations as the confirmed root cause until a controlled test demonstrates it.

Required recovery and verification procedure

The priority is to restore reliable paragraph flow without changing the approved wording or introducing new design changes.

  1. Preserve the current source and diagnostic evidence so that the investigation can be reconstructed.
  2. Compare the current print builder with the last known working version from before the publication-details revision. Use Git history to identify the exact changes introduced after that working state; do not guess at a rollback point.
  3. Reproduce the defect with a minimal test containing two ordinary paragraphs, then compare the generated Typst source and PDF output with the last known working implementation.
  4. Identify the specific rule or transformation that causes the second paragraph to begin at the wrong vertical position. Change one variable at a time.
  5. Do not apply blanket regular-expression spacing changes to all generated Typst content unless tests demonstrate that headings, lists, block quotations, poems, footnotes, tables and other structures remain correct.
  6. Once a correction is identified, generate the complete A5 interior through the dedicated paperback workflow. Do not use the editorial preview workflow as a substitute.
  7. Inspect multiple pages from the Foreword and every essay, especially pages with consecutive paragraphs, headings, quotations, footnotes, lists, tables and page breaks. Check both the beginning and end of the book.
  8. Compare the regenerated PDF with the supplied defective proof. Confirm that no paragraph collisions remain and that the correction has not introduced excessive gaps, missing text, new overlaps, blank pages or pagination errors.
  9. Only after this inspection should the production log mark the incident resolved. A green GitHub Actions status alone is insufficient.

Scope control and safeguards

Until this incident is resolved:

Current status: OPEN — critical, unresolved. The paperback interior must not be approved or sent for printing until the paragraph-overlap defect has been conclusively corrected and the complete PDF has passed visual inspection.

PDF overlap-check false positives corrected — 11 November 2026

The dedicated EDRL II print workflow was failing after PDF generation because the automated check_pdf_overlaps() function reported six possible line collisions on pages 176 and 178. The build log showed that the failure came from the validation check, which compared the vertical starting positions (yMin) of text lines and flagged pairs whose starts were closer than 0.8 times the line height.

That test was too broad: two normally spaced consecutive lines can have nearby starting positions without their text bounding boxes actually intersecting. The six detections were therefore possible false positives, not proof that the PDF contained six actual text collisions. The workflow stopped with exit code 1 at this check.

Correction made: check_pdf_overlaps() in ebook/edrl-ii/print/build.py now compares the horizontal and vertical intersection of the two line bounding boxes. It reports a collision only when the boxes overlap horizontally by more than 1 point and vertically by more than 1 point. The previous proximity-based comparison of yMin values has been removed.

The change is limited to the automated PDF validation logic. No manuscript text, footnotes, typography, paragraph spacing, page dimensions, margins or layout settings were changed as part of this correction.

Implementation: commit 728eb658e872364f78c7e77031cf1a0f851638c4 in ebook/edrl-ii/print/build.py.

Build result: the dedicated EDRL II print proof workflow completed successfully on this commit: GitHub Actions run 42970201063.

Status and distinction: the false-positive failure in the automated overlap checker is corrected, and the workflow is green. This does not by itself establish that every visual text or paragraph overlap in the generated book has been resolved. The earlier critical incident concerning visible paragraph collisions remains a separate visual-proofing issue and must not be marked resolved solely because this automated check now passes. The generated PDF still requires visual inspection before print approval.

Stable recovery checkpoint — 11 November 2026

The current print-production source is being recorded as a stable recovery checkpoint. This is a deliberate preservation point, not a declaration that the paperback is finished, fully proofread or ready for printing.

Checkpoint commit: 11b45f870dab5c5ef25e826b00fcd270e851b4f7
Print builder: ebook/edrl-ii/print/build.py

This checkpoint preserves the current implementation as a known point to which the project can return if subsequent editing reintroduces paragraph collisions, overlapping text, pagination faults or other layout regressions. Further editorial corrections and formatting improvements may continue on the working branch. They must not overwrite or replace this recovery point.

The checkpoint is intentionally distinct from final publication approval:

Status: STABLE RECOVERY CHECKPOINT — further editing permitted; final proof and print approval pending.

Editorial and production suggestions from Sunil — 11 November 2026

The following suggestions were communicated by Sunil on 11 November 2026. They are recorded here as a checklist for consideration and follow-up.

Signature spacing and editor date placement — 11 November 2026

The next paperback proof showed that both front-matter signature blocks had excessive vertical separation between their lines, making the attributions look disconnected.

The print builder has been corrected:

Implementation: commit b173ac3a88a57b03b50adc96fb01bb573643e9e0 in ebook/edrl-ii/print/build.py.

The next generated A5 proof must be checked to confirm that the stack spacing renders as intended and that neither signature is split across pages. The source change is committed; visual verification remains pending.

Pambatti Cittar epigraph page — 11 November 2026

A dedicated, unnumbered epigraph page has been added to the paperback interior, after the publication-details page and before the Foreword. It contains only the four-line passage reproduced in A. M. Abraham Ayrookuzhiel’s deposited essay amaa/dalits-challenges-religious-systems-full-text.md, with its source attribution.

The wording is retained exactly:

We’ll set fire to divisions of caste,
We’ll debate philosophical questions in the market place;
We’ll have dealings with despised households,
We’ll go around in different paths.

Attribution: Cittar Gnanakkovai, Pambatti Cittar, verse 123. Only the collection title is italicised. The page has no heading, running header, footer or printed folio. It precedes the Roman-numbered preliminary matter; the Foreword’s Roman folio sequence must be checked in the next proof.

Implementation: commit 66b69ed0366c64191c854e5974b1f25c197c2c99 in ebook/edrl-ii/print/build.py.

Visual verification is pending the next dedicated print build. Confirm that the four lines retain their line breaks, the attribution is correctly aligned, the page has balanced white space, and Roman preliminary numbering begins as intended.

Epigraph refrain restored — 11 November 2026

The epigraph has been revised to reproduce the full selection shown in the memorial document. The opening refrain, “So dance snake, dance!”, was inadvertently omitted in the first implementation. It has now been restored as the opening line, followed by the four lines on caste divisions, philosophical debate, dealings with despised households and different paths.

The source essay presents this refrain in the preceding Pambatti Cittar verse sequence (footnote 19) and cites the final four lines separately to Cittar Gnanakkovai, verse 123 (footnote 20). The print epigraph follows the memorial document’s combined presentation. Retain this distinction when checking the final source note and do not imply that the entire five-line selection is independently verified as a single verse without checking the underlying edition.

Implementation: commit d8266cd5a597df7d10913b3880c4592ee23ecbc7 in ebook/edrl-ii/print/build.py. The dedicated print workflow is triggered by the source change. Visual verification remains pending.

Author portrait plate — 11 November 2026

A full-page portrait of A. M. Abraham Ayrookuzhiel has been added to the paperback interior. The image is maintained in the companion media repository at amaa/a-m-a-ayrookuzhiel-print-book-photo-01.png and is fetched by the print builder at build time; it is not duplicated in the TSAP repository.

The portrait is placed immediately after the publication-details page and before the Pambatti Cittar epigraph. It is a standalone photographic plate, centred and scaled proportionally to fit the A5 text area. It has no caption at this stage because the year and occasion have not yet been confirmed by the family.

The photographic plate is intentionally unnumbered: it has no running head, footer or Roman-numeral folio. Roman preliminary pagination begins with the Foreword after the epigraph, and the main text retains its existing Arabic page 1 restart.

Implementation: print builder commit ec86da5cd7062906b31ffe15da59a05b38238bf8. The dedicated paperback print workflow must be checked for image retrieval, successful compilation, page sequence and visual fit. The original source photograph remains in the media repository; no separate compressed copy is stored in the print repository.

Epigraph and biography typography corrections — 11 November 2026

The paperback builder has been corrected after review of the generated proof:

Implementation: commit 67cc1623f7b3ff1d067246a2937e7c870f2df1e5 in ebook/edrl-ii/print/build.py. The dedicated paperback workflow must be checked to verify the rendered line breaks, attribution and italic book titles. No source essay wording has been changed.

Initial paperback back-cover design — 11 November 2026

An initial visual design for the back cover of Essays on Dalits, Religion and Liberation II has been prepared. It follows the front cover’s visual identity: a warm parchment-coloured background, dark serif typography, restrained maroon rules and a solid maroon footer.

The current concept contains these elements:

The EAN-13 symbol in the current proof was decoded programmatically as 9789334585247, matching the allotted paperback ISBN. This confirms that the encoded number is correct; it does not replace a physical scan test of the final, printer-sized barcode.

This is an initial back-cover design, not the final full-wrap cover PDF. The title scale, barcode-label margins and overall spacing remain subject to final proofing. The spine width, bleed, trim and full-wrap dimensions must be set only after the printer supplies the cover template and the final interior page count and paper specification are confirmed. The barcode must be scan-tested at final print size before the cover is approved.

Preliminary running heads and Roman-numeral blank page — 11 November 2026

The running-head treatment has been revised in response to the latest proof review.

The blank page immediately before the first essay remains intentional. The transition to Arabic main-text pagination has been moved until after that blank page, so it remains part of the Roman-numbered preliminary matter. Its folio should therefore display as a Roman numeral (for example, XIII), not Arabic “13”. The first essay’s Arabic pagination is still reset to 1.

Implementation: commit fcda4ea5362af6c45b35f47f448e44181ea41d33 in ebook/edrl-ii/print/build.py.

Verification pending: the dedicated EDRL II print proof workflow has been queued for this commit. Inspect the Foreword, Editor’s Note, both pages of About the Author, Contents, the blank page and the first essay opening. Confirm that the preliminary pages show the horizontal rule without a running title, that the blank page carries the correct Roman folio XIII, and that the essay running heads and Arabic page 1 restart remain unchanged. Do not treat the source change as visually verified until the generated PDF has been inspected.

Indexing and PDF production-auditing software — 11 November 2026

This section records the software investigation arising from Sunil’s editorial and production suggestions. It distinguishes two separate requirements: software for preparing a subject index, and software for auditing the finished paperback PDF. These tools have different purposes and should not be treated as interchangeable.

The preferred working environment is Ubuntu/Linux. Native Linux applications and command-line tools should be preferred. A Windows-only application should not be selected merely because it is established or widely used. OpenCindex/Cindex is not being considered for this project.

1. Subject-indexing software

Sunil’s suggestion is to consider an alphabetical subject index of names, subjects and important terms, with references to the pages on which they appear. He also suggested that AI could assist in developing dedicated software, but that the index should not be compiled manually by an LLM. The index may be considered for a future edition; it should not create manual indexing work for the current production.

Indexing software generally helps an indexer compose, arrange, alphabetise, format and edit index entries. It does not necessarily identify the important subjects in a book automatically. The editorial decision about what deserves an entry, which terms should be grouped, and which cross-references are meaningful remains a separate task.

Picardy — first Ubuntu candidate

Cost: Free of charge (freeware).
Platform: Windows, macOS and Linux, according to the American Society for Indexing’s software directory.
Purpose: Editing and formatting back-of-the-book indexes.

Picardy allows an indexer to record indexable terms, names and concepts together with page references and cross-references. It then alphabetises, collates and formats those entries for incorporation into a published book.

It does not ingest the text of a book and independently produce a subject index. Its role is to manage and format entries that have been selected during the indexing process.

Why it is relevant: It is the first candidate to test on Ubuntu because it is free, is listed as supporting Linux, and is specifically intended for back-of-the-book indexes.

Proposed action: Obtain the software from its publisher, test it on Ubuntu, and check whether its output can be incorporated into the Typst print workflow.

References:

Index Manager — commercial alternative

Cost: Commercial product; a 14-day trial is advertised.
Platform: Windows and macOS; Linux support is listed as available on request.
Purpose: Professional index management, including embedded-index workflows.

Index Manager supports the management of index entries and provides add-ons for transferring entries between document versions and importing an existing index into a document. These facilities may be useful where an index must be embedded in a publishing file or transferred after layout changes.

Why it may be relevant: It is a possible advanced alternative if Picardy does not provide the required workflow.

Important limitation: “Linux on request” does not establish that a standard Ubuntu installer is publicly available. Before considering purchase, contact the vendor to confirm the Linux package, compatibility with the Ubuntu version in use, supported features, licence terms and total cost.

References:

xindy — free index processor

Cost: Free software.
Platform: Linux and other systems supported by the TeX ecosystem.
Purpose: Sorting, merging and formatting index entries supplied to it.

xindy processes index entries that have already been marked or supplied. It can apply sorting and language rules and produce formatted index output.

It does not read a book and decide which names, subjects or concepts should be indexed. It is a technical index processor rather than a full graphical indexing environment.

Why it may be relevant: It could be useful if indexing is integrated into a source-marked or TeX-oriented typesetting workflow. It is not the first choice for a standalone index-editing interface.

References:

MakeIndex — free index processor

Cost: Free software.
Platform: Linux and other systems supported by TeX distributions.
Purpose: Sorting and formatting supplied index entries.

MakeIndex processes entries supplied in an index file. It can arrange entries and subentries according to a style definition and produce index output.

It does not automatically discover subjects in a manuscript and does not replace editorial selection of index terms.

Why it may be relevant: It is an established option for a LaTeX-style source and typesetting workflow. It is a technical processor, not the preferred standalone interface for this project.

Reference:

Subject-indexing recommendation

  1. Test Picardy on Ubuntu first.
  2. Assess whether its output can be incorporated cleanly into the Typst book.
  3. If Picardy is insufficient, contact Index Manager about an actual Ubuntu/Linux version and its price.
  4. Consider xindy or MakeIndex only if the project adopts a source-integrated indexing workflow.
  5. Do not use OpenCindex/Cindex.

No decision has yet been made to produce a subject index for the current paperback. The existing direction from Sunil is that it may be considered for a future edition and should not create manual work for the current production.

2. PDF production-auditing and inspection software

The paperback is a fixed-page A5 PDF. A successful Typst build confirms that the source compiled; it does not establish that the PDF is visually correct or technically acceptable to the printer. The following tools inspect different aspects of the generated PDF.

callas pdfToolbox CLI — professional print preflight

Cost: Commercial; a 14-day trial is advertised.
Platform: Linux, Windows and macOS for the CLI/server product. The desktop graphical application has different platform availability.
Purpose: Automated PDF analysis, correction and print-production preflight.

The CLI can analyse PDF objects, apply preflight profiles, and identify technical issues involving such matters as fonts, colour, images, transparency and page geometry. Depending on the operation and profile, it can also correct or enhance PDF files and can be integrated into automated workflows.

Why it is relevant: It is the professional-grade candidate for checking whether the final PDF meets defined print-production requirements before it is sent to the printer.

Important qualification: The printer’s own specifications must determine the preflight checks. Do not assume that a generic profile is sufficient. The relevant Linux product is the CLI/server, not the Windows/macOS desktop interface.

Proposed action: Evaluate the Linux CLI during the trial after the printer’s specifications are available. Purchase only if it provides useful checks beyond the free tools and the cost is justified.

References:

veraPDF — PDF standards validation

Cost: Free and open source.
Platform: Java application; usable on Linux/Unix, Windows and macOS with a suitable Java installation.
Purpose: Validation against PDF/A archival and PDF/UA accessibility standards.

veraPDF checks whether a PDF conforms to defined requirements in the supported PDF/A and PDF/UA specifications. It produces validation reports identifying rules that pass or fail. For PDF/UA, the software can perform machine-verifiable checks; it cannot replace human accessibility evaluation.

Why it is relevant: It can provide a separate standards-based validation report and reveal certain structural, metadata and accessibility-conformance problems.

Important limitation: PDF/A and PDF/UA validation is not the same as commercial print preflight. Passing veraPDF does not establish that the book is ready for the printer. Use it when the relevant archival or accessibility conformance target is intended; do not treat every profile as a mandatory print requirement.

References:

qpdf — PDF structural integrity

Cost: Free and open source.
Platform: Linux/Ubuntu and other major operating systems.
Purpose: Checking the internal structure and syntax of a PDF.

qpdf can check PDF structure and report problems involving syntax, encryption, linearisation and encoded streams. Its command-line exit status can be used in automated scripts.

Why it is relevant: It is a basic first-stage check to establish that the generated PDF is structurally readable and syntactically sound.

Important limitation: qpdf explicitly does not validate the actual visual page content or its semantic correctness. A PDF can pass qpdf and still contain overlapping paragraphs, clipped text, misplaced headings or other visual defects.

Reference:

Poppler — PDF inspection and rendering utilities

Cost: Free and open source.
Platform: Linux/Ubuntu and other major operating systems.
Purpose: Inspecting PDF properties, extracting text and fonts, and rendering pages.

The Poppler utilities are useful for different checks:

Why it is relevant: These utilities allow us to inspect the actual output: page dimensions, font embedding, extracted text and rendered pages. Rendered pages can be examined individually or assembled into contact sheets for a visual review.

Important limitation: Poppler is an inspection and rendering toolkit, not a complete automated print-production auditor. It does not decide whether the book’s typography and page design are professionally satisfactory.

References:

Python and PyMuPDF — foundation for our own book-production auditor

Cost: PyMuPDF is available under open-source and commercial licensing terms; the applicable licence must be checked for the intended use.
Platform: Python on Linux/Ubuntu and other supported platforms.
Purpose: Programmatic inspection of PDF text, coordinates, fonts, images and page geometry.

PyMuPDF exposes text blocks, words, their bounding boxes and font information. It can also inspect page dimensions, embedded images and image locations, vector drawings and other page elements.

We could develop a project-specific auditing programme around it. Proposed checks include:

Why it is relevant: The production has already encountered paragraph-overlap and layout problems. A generic PDF validator cannot understand every book-specific rule. We can build checks around the actual A5 page design, folios, running heads, footers, page sequence and Typst output.

Important limitations: This is a development project, not an already completed auditing application. Geometric checks can produce false positives and must be reviewed. PyMuPDF cannot replace human proofreading or visual design judgement.

Proposed action: Begin with a small, read-only audit programme. It should inspect and report problems without modifying the production PDF. Add checks incrementally and test each one against known-good and known-defective pages.

References:

3. What the PDF tools do — and do not do

Tool Main purpose What it does not establish
callas pdfToolbox CLI Professional print preflight against configured requirements Does not replace visual/editorial approval
veraPDF PDF/A and PDF/UA standards validation Is not a complete commercial print preflight
qpdf PDF structural and syntax integrity Does not inspect visual layout
Poppler Page information, fonts, text extraction and rendering Is not a complete automated quality auditor
Python + PyMuPDF Custom book-specific text, geometry and layout checks Does not replace human visual judgement

These tools are complementary. We do not need to purchase or deploy all of them.

4. Why these checks are needed at this production stage

The project is preparing a fixed-page A5 paperback PDF that will eventually be supplied to the printer. A defect discovered after printing may be expensive to correct. The checks should therefore be organised in layers:

  1. Structural integrity: Is the PDF internally sound? Use qpdf.
  2. Document properties: Are page count, dimensions, metadata and fonts correct? Use Poppler.
  3. Standards validation: Does the PDF meet a relevant archival or accessibility standard, if one is required? Use veraPDF.
  4. Print preflight: Does the PDF meet the printer’s technical specifications? Evaluate callas pdfToolbox CLI.
  5. Book-specific layout audit: Are there overlaps, clipped text, unexpected blank pages, pagination errors or other defects? Develop the PyMuPDF-based auditor.
  6. Visual design review: Does the book look professionally typeset when pages and spreads are inspected? Human review remains essential. A vision-capable LLM may assist by flagging suspicious pages, but it must not replace human approval.

A successful Typst build alone is not proof of a satisfactory printed book.

  1. Obtain the printer’s PDF, trim, bleed, binding, colour and other production specifications.
  2. Test Picardy on Ubuntu for the possible subject-index workflow.
  3. Use the free PDF inspection tools: qpdf, Poppler and veraPDF where its standards checks are relevant.
  4. Begin a read-only, book-specific PDF audit programme using Python and PyMuPDF.
  5. Evaluate callas pdfToolbox CLI on its trial only after the printer’s requirements are available.
  6. Generate a fresh paperback proof.
  7. Run the automated checks and retain their reports with the proof.
  8. Render and inspect the pages and facing-page spreads.
  9. Correct defects in the Typst source and rebuild.
  10. Obtain human approval before supplying the PDFs for printing.

6. Current decisions and status

Incident report: disruption of the EDRL II automated print build — 11 November 2026

Summary

On 11 November 2026, the previously working automated PDF production process for Essays on Dalits, Religion and Liberation II was disrupted during a series of substantial changes to the print builder and its GitHub Actions workflow.

The Python builder (ebook/edrl-ii/print/build.py) underwent extensive revisions, affecting significant parts of the document-generation and PDF-production process. The workflow was also revised to accommodate the changed builder and its installation and dependency requirements. Subsequent attempts moved between different versions of the builder and workflow, including attempts to return to an earlier working implementation.

This sequence did not restore a consistently working production process. Several builds failed, and the project temporarily lost its dependable ability to generate fresh, downloadable PDF proofs after manuscript or layout changes.

The last confirmed successful build in this sequence was GitHub Actions run #109, which generated the interior PDF, front-cover proof and combined review PDF. Later attempts did not consistently reproduce that result.

What happened

  1. Previously working production process. The EDRL II print workflow had completed more than 100 runs during development. Run #109, on 11 November 2026, completed successfully. It installed the required tools and dependencies, executed the Python builder, generated all three PDF outputs and uploaded them as a downloadable GitHub Actions artifact.

  2. Extensive builder revisions. Significant portions of build.py were subsequently rewritten. These revisions changed parts of the build process and introduced or altered the technical requirements of the builder. The workflow consequently needed corresponding changes to its setup, installation and dependency-management steps.

  3. Workflow and dependency changes. Different approaches were tried for installing Typst, setting up Python, managing Python packages and installing system-level packages. The workflow was no longer simply executing the same established sequence used by the last successful build. It had become dependent on a revised set of setup and installation steps.

  4. Movement between builder versions. After the revised implementation failed to produce a dependable result, attempts were made to return to an earlier builder and workflow. Further changes were then made to the workflow during recovery. As a result, the source files on the working branch did not consistently match the last known successful production configuration.

  5. The significance of a GitHub-hosted runner. GitHub Actions uses temporary, newly provisioned Ubuntu runners. Software installed during one workflow run is not permanently retained for the next run. Therefore, even when the source code is restored to an earlier version, the packages installed during a previous successful run are not automatically available. The workflow must install its required tools and dependencies again, unless an explicitly configured cache or another persistent distribution mechanism supplies them.

  6. Ubuntu package-server DNS failure. In run #115, the workflow reached the system-dependency installation step but could not download the required Ubuntu packages. The runner repeatedly reported:

    Temporary failure resolving 'azure.archive.ubuntu.com'

    The affected packages included Pandoc, Pandoc data, Linux Libertine fonts and Poppler utilities. The installation ended with exit code 100. The Python builder was never executed, and no PDF artifact was generated in that run.

    This was a package-server DNS/network resolution failure on the GitHub-hosted Ubuntu runner. It was not evidence of a defect in the manuscript or in the Linux Libertine font.

  7. A separate workflow-configuration failure. Run #116 failed at the Python setup stage for a different reason. The workflow attempted to enable pip dependency caching, but GitHub Actions could not find a requirements.txt or pyproject.toml file in the repository. The setup step therefore failed before the system-package installation and PDF build steps could run. The later steps, including PDF generation and artifact upload, were skipped.

Why restoring the older builder did not automatically restore the working process

Restoring an earlier Python file does not, by itself, restore the entire production environment.

The successful build depended on a combination of:

These components must work together. A builder restored from an earlier commit can still fail if the workflow surrounding it has changed, if the dependency setup is different, or if the newly provisioned runner cannot reach the package repositories.

The previous successful installation was not stored permanently on GitHub’s runners. Every new run had to provision its environment again. Consequently, the fact that run #109 installed the required packages successfully did not guarantee that a later run would be able to download the same packages.

Build history and confirmed outcomes

Run Date, 11 November 2026 Outcome Significance
#109 13:18 UTC Successful Last confirmed successful build in this sequence. All three PDFs were generated and uploaded.
#110 15:01 UTC Failed Build attempt after the builder and workflow revisions.
#111 15:23 UTC Failed Build attempt using the revised workflow.
#112 15:26 UTC Cancelled Build attempt cancelled during the recovery sequence.
#113 15:38 UTC Failed Subsequent recovery attempt.
#114 15:38 UTC Failed Subsequent recovery attempt.
#115 15:52 UTC Failed Ubuntu package installation failed because the runner could not resolve azure.archive.ubuntu.com.
#116 15:54 UTC Failed Python pip caching setup failed because no dependency manifest (requirements.txt or pyproject.toml) was found. The PDF build and upload steps were skipped.

The successful artifact from run #109 was retained and downloaded as a fallback. It contains the three PDFs generated by that successful build, but it does not include any editorial or layout changes committed after that run.

Current impact

The principal impact is a disruption to the editorial production cycle. The book requires further corrections and layout revisions, and each revision must be followed by a fresh PDF build so that the resulting pages can be inspected.

At present, a source-file edit can be committed to the repository, but the project cannot treat the automated build as dependable until the complete builder and workflow combination has been verified again. A failed workflow means that no fresh downloadable artifact is available for that revision.

The last successful PDF remains useful as a reference and fallback, but it cannot substitute for a newly generated proof containing subsequent changes.

Recovery requirements

The recovery should prioritise restoring a reproducible build rather than introducing another redesign of the print system.

  1. Establish the exact builder and workflow versions associated with the last confirmed successful build.
  2. Compare the current files with those versions and identify all differences before making further changes.
  3. Restore a matching builder-workflow combination, preserving the established book layout and production logic.
  4. Ensure that the workflow can install its required dependencies on a newly provisioned Ubuntu runner.
  5. Avoid dependency-caching configuration that assumes a requirements.txt or pyproject.toml file unless the corresponding manifest is deliberately added and maintained.
  6. Address temporary package-server failures without changing the manuscript or typesetting logic.
  7. Execute a complete build and confirm that the interior, front-cover proof and combined review PDF are all generated.
  8. Confirm that the artifact-upload step succeeds and that the files can actually be downloaded.
  9. Only after this end-to-end test should further editorial and layout revisions resume through the automated production workflow.

Status

Production disruption: OPEN.

Run #109 remains the last confirmed successful build and its PDFs have been preserved as a fallback. Runs #115 and #116 demonstrate two separate infrastructure and workflow-configuration failures. The project must re-establish a verified, repeatable build-and-download process before relying on GitHub Actions for the remaining paperback corrections.

The recovery is not complete merely because the source files have been reverted or a workflow reports that it has started. Completion requires a successful build of the current manuscript, successful upload of the resulting PDFs, and confirmation that the new artifacts are downloadable.

Historical baseline: first complete successful build on 6 November 2026

The first complete successful run of this Typst-based EDRL II print workflow was GitHub Actions run #4 on 6 November 2026. It completed all stages, including Python dependency installation, installation of Pandoc, Typst and fonts, PDF generation and artifact upload.

Successful run: EDRL II print workflow — run #4, 6 November 2026

The run is an important reference because it demonstrates that the repository’s print-production approach and its required tools were capable of producing and uploading the PDF successfully. The later successful run #109 on 11 November was another confirmed success, and remains the last successful build immediately before the failures recorded in this incident.

Why subsequent builds have not consistently succeeded

The available run logs do not establish one single cause. They show at least two distinct failures in the recovery attempts:

These are different failure points and should not be conflated. Run #115 failed while reaching the Ubuntu package repository; run #116 failed before attempting that installation. Neither run reached PDF generation, so neither provides evidence that the Python builder itself failed. The reason the process is not currently dependable is that the workflow setup has changed and the recent attempts have encountered separate setup failures. The exact current builder/workflow combination still needs an end-to-end successful run before it can be treated as restored.

The 6 November run is a historical proof of a successful installation and build, not a guarantee that a later GitHub-hosted runner will have identical network conditions. GitHub-hosted runners are newly provisioned for each run, so required packages must be installed again; successful installation in one run does not make those packages persist for subsequent runs.

Recovery record: successful restoration of the EDRL II print artifact — 11 November 2026

Outcome

The production build was recovered on 11 November 2026. GitHub Actions run #117 completed successfully on its second attempt and uploaded a new artifact containing the three expected PDF files:

Successful run: EDRL II print proof — run #117
Run ID: 43061265800
Successful job ID: 130672873198
Commit: a4cfcba453eddb548226a8a854498adaa64b7955
Commit message: Tito VSCode fix attempt #109 based
Artifact: edrl-ii-print-preview-117
Artifact size: 7,405,501 bytes (approximately 7.4 MB)
Artifact retention: 30 days; GitHub reported an expiry date of 11 December 2026.

The artifact was downloaded and opened. The user confirmed that the expected earlier version of the book was present. This confirms that the workflow generated and uploaded usable PDFs; it does not, by itself, certify every page or establish printer approval.

Important correction to the earlier incident status

The earlier incident report above described the production disruption as open because no later successful build had yet been confirmed. That status is now superseded: run #117 succeeded, and a downloadable artifact was obtained. The production workflow is therefore recovered to a working state, although the output still requires the normal editorial and visual proofing before it can be approved for printing.

Run #109 remains the last successful reference build before the disruption. Its exact commit was:

b20ffc15b3f238465b0e3ccbe7897525f497f0c5

It completed at 13:18:38 UTC on 11 November 2026. The recovery commit used for run #117 was different:

a4cfcba453eddb548226a8a854498adaa64b7955

The recovery commit message described the work as based on Run #109. This record does not claim that every file in the recovery commit is byte-for-byte identical to Run #109. The important operational result is that the current committed combination successfully produced the artifact that was downloaded and inspected.

Chronology of the disruption and recovery

The following chronology records the known events and distinguishes confirmed log evidence from conclusions that cannot be established.

  1. Run #109 — last known successful reference. The workflow installed its dependencies, ran the print builder, generated the interior, front-cover proof and combined review PDFs, and uploaded the artifact. This became the reference point for recovery.

  2. Builder and workflow experimentation. The print builder, ebook/edrl-ii/print/build.py, and the workflow, .github/workflows/build-edrl-ii-print.yml, were changed during attempts to revise the production process. The changes affected both the document-generation code and the environment setup. The experimental changes were not kept isolated from the production path as originally intended. This made it harder to identify which exact pair of files was responsible for a given result.

  3. Gemini-related production changes and attempted rollback. Changes associated with the experimental builder were committed to the production branch. The subsequent rollback attempts did not initially restore the exact Run #109 versions. An earlier version was mistakenly described as the Run #109 baseline. That assurance was incorrect. The distinction matters: restoring a file from an earlier point in the repository is not the same as restoring the file from the exact commit used by a known successful run.

  4. Repeated failed workflow attempts. Runs #110–#116 included failed and cancelled attempts while the builder and workflow were being changed and recovery was being attempted. The run records and logs show more than one failure point; they should not all be described as the same error.

  5. Run #115 — Ubuntu package repository resolution failure. The runner could not resolve azure.archive.ubuntu.com while APT was installing system packages. The log included Temporary failure resolving 'azure.archive.ubuntu.com' and APT ended with exit code 100. The affected packages included Pandoc, Pandoc data, Linux Libertine fonts and Poppler utilities. The builder did not run in this attempt. This is direct evidence of a runner-side DNS/network failure during dependency installation, not evidence of a manuscript or PDF-layout defect.

  6. Run #116 — Python setup configuration failure. The workflow attempted to use pip caching without a repository dependency manifest recognised by actions/setup-python. The action could not find requirements.txt or pyproject.toml and failed before the PDF build. This was a separate workflow configuration problem, not an Azure DNS failure and not a builder error.

  7. Local VS Code recovery. The repository was pulled into the local working copy. During the file replacement, the wrong path, ebook/edrl-ii/build.py, was briefly modified instead of the print builder at ebook/edrl-ii/print/build.py. That unrelated edit was restored. The final local status showed the intended workflow and print-builder files as the modified files. The user then committed the work with the message Tito VSCode fix attempt; the resulting commit on the successful run was a4cfcba453eddb548226a8a854498adaa64b7955.

  8. Run #117 — successful second attempt. The first attempt of run #117 did not provide the required successful artifact. The existing failed job was rerun. The second attempt completed successfully: dependency installation, PDF generation and artifact upload all completed. GitHub recorded run attempt 2 as successful. The artifact was then downloaded and opened by the user.

What the logs establish — and what they do not

The failed attempts do not support one single explanation for every failure:

Why a small formatting edit can still encounter the installation stage

The current workflow runs on ubuntu-latest and has explicit setup steps before it invokes the Python builder. The workflow currently:

  1. Checks out the repository.
  2. Sets up Python.
  3. Installs PyYAML and beautifulsoup4 with pip.
  4. Runs apt-get update.
  5. Installs pandoc, fonts-linuxlibertine and poppler-utils.
  6. Downloads the Typst Linux release archive and installs the typst executable.
  7. Runs python ebook/edrl-ii/print/build.py.
  8. Uploads the three PDF outputs as an artifact.

The workflow does not currently use a dependency cache. GitHub-hosted runners are temporary environments, so software installed during one run should not be assumed to remain installed for the next run. A formatting-only edit inside build.py does not inherently introduce a new package requirement, but if that edit triggers this workflow, the existing installation steps will still run. This is a property of the current workflow configuration, not a requirement created by the formatting edit itself.

The workflow is triggered by a push to main when a listed manuscript, print-production or workflow path changes, and it can also be started manually. The exact trigger paths are recorded in .github/workflows/build-edrl-ii-print.yml.

Production freeze and next editing approach

The immediate priority is to preserve the working production state. No dependency is to be added or removed, and no further redesign of the build environment is planned as part of routine formatting work.

Future visual refinements will be made manually in the existing Python builder, ebook/edrl-ii/print/build.py, by changing its existing Typst layout and styling instructions in small, deliberate steps. These are formatting adjustments, not a reason to introduce another typesetting system or a new package. The manuscript content must remain unchanged unless a separately approved editorial correction is requested.

The current successful commit and downloaded artifact should be retained as a recovery reference. Before any future production change, preserve the current working files and identify the exact lines or formatting rule being changed. Do not describe a future build as tested until a new artifact has actually been generated and checked.

Lessons recorded for future maintenance

Current status: RECOVERED WORKING BUILD. Run #117, attempt 2, successfully generated and uploaded the three PDF outputs. The user downloaded the artifact and confirmed that the expected earlier book file was present. The environment and dependency setup are to be left unchanged while the remaining formatting is considered.

Production log: credit-page redesign and opening-page audit — 12 November 2026

Credit/publication page redesign

The credit/publication page in the paperback interior was redesigned on 12 November 2026. The change was deliberately confined to the credit-page layout block in ebook/edrl-ii/print/build.py; no manuscript text, other front-matter pages, essay layouts, pagination rules or build-workflow configuration were changed.

The existing publication information was retained. This includes the book title and author, the website and contact details, the editor and design/print-production advisor credits, the first paperback edition date, publisher, paperback ISBN, printed price and place of publication. No permissions statement or other new publication claim was introduced.

The layout now organises the information into three visually separated groups: the book title and author near the top, contact and production credits in the middle, and edition, publisher and ISBN/price information towards the bottom. Flexible vertical spacing provides the separation while preserving the existing content.

Opening-page sequence checked

The combined review PDF generated by run #142 was inspected to identify the actual contents of its opening pages. The PDF page positions are:

PDF page Content
1 Front cover
2 Half-title page, carrying the book title
3 Blank page
4 Full title page, carrying the book title and author’s name
5 Credit/publication page
6 Blank page
7 Author photograph
8 Epigraph

This inspection distinguishes the half-title page from the full title page. Although both display the book title, they have different functions in the opening sequence. The page-2/page-4 comparison was therefore recorded on the basis of the actual PDF contents, not an assumption that page 2 was blank or duplicated. No page was deleted as part of this work.

The page sequence is an inspection record, not a final approval of the complete book’s front matter or a printer sign-off. Any decision to alter or remove a page must be made separately and must be followed by a fresh proof.

The essay-opening layout and preliminary-page running-head treatment were refined in the existing Typst print builder, ebook/edrl-ii/print/build.py. These are print-only layout changes; the original essay wording, publication details, manifest, page dimensions, margins, footnotes, tables and cover content were not changed.

Essay chapter openings

The essay-opening block now follows this sequence:

  1. The essay title remains left-aligned in the existing serif heading style.
  2. A 9 pt vertical gap follows the title.
  3. A thin horizontal rule spans the text measure.
  4. The label ORIGINAL PUBLICATION: and the original publication citation are set inline on the same line where space permits. The citation can wrap naturally if it is too long; the label is not split onto a separate line.
  5. A second thin horizontal rule follows the publication citation.
  6. A 9 pt gap follows the second rule before the essay’s first section heading.

The publication label and citation are set without first-line indentation. The ordinary essay body paragraph style and its established first-line indentation remain unchanged. The first section heading and essay text retain their existing styles.

Preliminary-page running heads

The preliminary pages before the first essay, numbered with Roman numerals (i–xii in the proof under review), no longer display the top horizontal running-head rule. The running-head function returns an empty header for this preliminary-page range. This change does not remove the running heads or their rules from the essay section. Existing chapter-opening pages continue to suppress running heads according to the established behaviour.

Dependency and workflow safeguards

The existing GitHub Actions print workflow was adjusted to reduce unnecessary repeated setup without introducing new dependencies:

No new Python package, system package or typesetting engine was introduced. GitHub-hosted runners remain temporary; caching reduces repeated downloads but does not guarantee that every dependency will always be available without a fallback installation.

Build failures and correction

Two intermediate builds failed because paragraph-formatting directives were inserted repeatedly into the generated Typst document. The builder’s existing lint check correctly rejected those unscoped paragraph rules. Those injected directives were removed; the paragraph indentation of the essay body was left intact. The corrected build then completed successfully.

The successful runs generated the A5 interior, front-cover proof and combined review PDF. Their logs report that the PDF overlap check passed with no colliding lines. The latest verified run is EDRL II print proof — run 43173001495, associated with commit 158fa055c9a3a8ed236c4ecb180c7987c608382e.

Current status and limits of verification

Build status: successful. The latest recorded production build completed and uploaded its preview artifact. Automated overlap validation also passed. These results confirm that the current source and workflow generated the PDFs; they do not constitute final visual approval or printer approval. The latest PDF should still be checked page by page, including the Roman-numbered preliminary pages, essay openings, running heads, paragraph indents and page transitions.

The production workflow and its dependency setup should now be treated as established. Further design changes should be limited to the specific requested formatting, made in the existing builder, and checked with a fresh build. Do not change the manuscript or add dependencies as part of routine layout refinements.

Further corrections, failed attempts and production notes — 12 November 2026

This log records the additional work carried out after the earlier 12 November entries. It includes both successful corrections and failed approaches because the build history is useful when continuing the work in another session. The failures below were not all caused by the same problem: some were incorrect source-matching assumptions, some were conversion-order problems, and some were visual layout defects.

Title page and preliminary matter

The text THE SUNIL ABRAHAM PROJECT was removed from the full title page (PDF page 4). This was a targeted change to the title-page content. The separate page-5 line-break issue was identified but deliberately left for a later pass; it was not silently changed as part of the page-4 correction.

The four-line Vinayaraj signature also required attention. It was splitting across pages, so the intended treatment was to keep the signature block together rather than allow individual lines to be separated by pagination. An earlier negative vertical offset (above: -24pt) had caused the signature to overlap the final paragraph. That offset was removed, restoring the original positioning; the signature must be judged in the generated PDF, not assumed correct from the source change alone.

Footnotes: hanging indents and repeated markers

The paperback footnote treatment was changed to use hanging indents so that wrapped lines align with the footnote text rather than with the note number. This was a print-layout change in the existing builder, not an alteration to the wording of the notes.

A later inspection exposed a separate repeated-footnote problem. The correction was committed as 5f391dc and triggered print build #180. The purpose of this change was to prevent a repeated footnote reference from being treated as a fresh numbered note. The hanging-indent change and the repeated-reference correction address different aspects of footnote rendering and should not be conflated.

Orphaned “Notes” heading: conversion-order and matching failures

An unwanted standalone “Notes” heading remained in the output after the notes themselves had been converted into footnotes. The source essay contained two genuine notes; the problem was not that the notes were absent or that the source contained an extra set of notes.

The cause was the order of transformations in the builder. The HTML heading was converted into raw Typst before the later Markdown-heading cleanup ran. The cleanup therefore no longer saw a Markdown heading to remove, leaving the heading in the generated document even though the notes had already become footnotes.

Two attempted corrections then failed for separate reasons:

The durable lesson is to account for the builder’s actual conversion order and inspect the generated intermediate representation before writing a cleanup rule. A regular expression that looks plausible in Python source may still fail to match if its escaping does not represent the intended newline or heading syntax.

Heading conversion: failed assumptions and successful correction

A separate heading-formatting experiment failed because the code searched for a heading pattern that was not present in the Pandoc-generated content. Runs #158 and #159 failed during that speculative heading-3 matching attempt; run #160 failed for the same underlying reason, reporting: The complete section 3 heading was not found... and exiting with status 1. The failure was in the assumed source pattern, not in Typst’s ability to typeset the heading. The builder was returned to the last successful version before a later, narrower correction was made.

A subsequent build (#173) completed technically and generated 175-page PDFs, but inspection showed that the heading was still split. A successful build alone had therefore not proved that the visual defect was fixed. The cause was identified and corrected in the next iteration: build #174 (run ID 43179950408, commit 75ba5efa) produced the complete four-line heading together. That result was visually checked. This is an important distinction for future work: build success and visual correctness are separate checks.

Table-header contrast

The PDF review identified table headings on pages 102–105 with dark grey backgrounds and black text. The text was difficult to read because the header fill was too dark for the default black lettering. The fix was limited to the table-header fill in ebook/edrl-ii/print/build.py: the Typst fill changed from luma(94) to luma(235). The existing bold black header text, table contents, column widths and other table layout rules were retained.

Production safeguards for the next session

Running-title correction and poem stanza audit — 12 November 2026

Essay 3 running title

The running title for the third essay, The Living Hindu Popular Religious Consciousness and Some Reflections on It in the Context of Hindu-Christian Dialogue, was too long for the available running-head space. In the generated PDF it wrapped onto a second line and the first line was clipped at the top of the page. The first two essays checked at the same time did not show this problem, so a global running-head change was not justified.

The print builder now uses the shorter running title The Living Hindu Popular Religious Consciousness for this essay only. The full essay title remains unchanged in the essay opening, contents and source manuscript. No other essay’s running title was changed.

Poem line and stanza audit: final essay

A reverse-order comparison was begun using the source essay, The Ideological Nature of the Emerging Dalit Consciousness, and the generated print PDF. The purpose was to check whether the print conversion preserved explicit line breaks and blank-line stanza divisions.

The first three poems/verse passages checked were:

  1. Pambatti Cittar’s final poem: The source contains three stanzas. The individual line breaks were preserved, but the first and second stanzas did not have a sufficiently clear visual separation in the print PDF. The third stanza begins on the following page.
  2. Siddhalingiah’s Dalitaru Barvaru: The source has several distinct verse sections, separated by blank lines and dotted separators. The print presentation made some of these sections appear too continuous; the stanza gaps were not sufficiently distinct.
  3. Buddha’s four-line verse: The four lines appeared as one stanza, consistent with the source. No correction was identified for this verse.

The audit identified a poem-layout issue rather than a need to rewrite the poems. The source wording, punctuation, line order and explicit line breaks were not changed.

Poem stanza rendering: builder correction and iterations

The issue was traced to the poem conversion in ebook/edrl-ii/print/build.py. The earlier conversion passed an entire poem to Pandoc as one segment and relied on paragraph spacing to make stanza boundaries visible. That did not provide sufficiently reliable control over the distinction between lines within a stanza and the separation between stanzas.

The builder was changed to split each poem at its source blank lines, convert each stanza separately, and place the stanza blocks in sequence with explicit vertical space between them. The line spacing within each stanza remains separately controlled. Stanza boundaries are therefore an explicit part of the print layout rather than relying only on generic paragraph spacing.

Several proof iterations were needed:

The final implementation keeps stanza divisions visible without forcing every stanza to remain on a single page. A stanza may continue across a page boundary where the available space requires it; the source stanza division remains represented in the layout.

Scope and remaining audit

The stanza-rendering correction is a general print-builder change for poem blocks, not an editorial change to one poem. It should benefit other poems in the book wherever blank lines in the source mark stanza boundaries. The final proof confirms the visual result for the inspected poem, but it does not establish that every poem in all nine essays has been checked.

Continue the source-to-PDF poem audit in reverse order, in batches of two or three poems. For each passage, compare the source’s exact line breaks, stanza boundaries, dotted separators and page transitions with the generated PDF. Record any exceptions before making further layout changes. Do not alter poem wording or lineation without separate editorial approval.

This entry records the three narrowly scoped print-layout corrections made or initiated on 13 November. Each change was limited to the existing print builder, ebook/edrl-ii/print/build.py. The manuscript wording was not edited.

Running-header position

The running-header text was moved further down from the top trim edge to improve its safety distance from the page edge and bring it closer to the horizontal rule. The existing running-head content and the rule were retained.

Heading and following-paragraph separation

A formatting defect was identified in which the final line of a long Markdown heading was being rendered as ordinary body text and continued on the same line as the following paragraph. The affected PDF pages identified in the audit were 34, 45 and 72.

The heading conversion in the print builder was changed so that preserved Markdown headings are emitted as separate Typst heading blocks. An initial commit contained incorrect regular-expression escaping; that attempt was superseded by the corrected conversion.

Footnote markers: superscript correction

The audit found that footnote reference markers in the body text were being displayed at the normal body-text size and baseline rather than as superscripts. The print builder was changed to render the markers at 7 pt in superscript. The footnote text and the existing footnote-entry layout were not intentionally changed.

Only the footnote-marker correction is the active change in this final entry. No other audit item was included in that commit. The next step is to wait for this print build to complete and inspect the footnote markers in the resulting PDF before treating the correction as verified.

See also

Design and typographic review of combined proof 204 — 13 November 2026

This section records the design, layout and typographic recommendations arising from the complete visual review of the 176-page combined review PDF (proof 204). It is a record of recommendations, not an instruction to make all changes together. Each item must be considered separately, and only the specifically authorised item may be changed. The present working scope is the visual redesign of the page-5 credit page only. No other book page is authorised for alteration by this entry.

Page 5 — credit-page design (first and only current design task)

The page should be treated as a designed book credit/colophon page, not as a legal-status exercise or an administrative form. The review is concerned with visual hierarchy, typography, alignment, spacing and page composition. Do not invent missing printer, typesetter, designer or production details. If a detail has not yet been supplied, leave its wording and presence for the editor to decide; do not fill the gap with guessed information.

Design points to assess on page 5:

The page-5 redesign must be made and reviewed as one isolated change. Do not combine it with changes to the title page, portrait, Foreword, Editor’s Note, Contents or essay pages. Do not start a print build until the user explicitly authorises it.

Other design and composition findings from proof 204 — recorded for later, not authorised now

These observations are retained so they are not lost. They are not part of the current page-5 task.

Front matter and page architecture

Essay openings and running heads

Essay-opening label and display typography

Text flow and punctuation

Tables

Scholarly apparatus and navigation

Cover and final PDF presentation

Order of work and scope control

  1. Page 5 credit-page visual redesign only.
  2. Review that page in isolation and approve its composition before moving to another item.
  3. Take the next design issue only after the page-5 task is complete and the user selects or authorises it.
  4. Keep every later correction isolated, record the exact page or component affected, and inspect the resulting proof before calling it complete.

No book source, print-builder file, generated PDF or workflow was changed by adding this review record. This documentation entry itself does not trigger a print build.

Editor’s Note and acknowledgement drafting — 13 November 2026

Work began on the front matter for the print edition, including the drafting of the Editor’s Note and an Acknowledgement subsection. The acknowledgement material is being assembled from contributions and support received during the preparation of the volume, including a personal acknowledgement of the author’s family. The text is a working draft and has not yet been finalised. The individual acknowledgement wording is not reproduced in this production log.

The draft material was added to the print composition in ebook/edrl-ii/print/build.py. The wording was also adjusted during this work, including the removal of a term the editor did not wish to use. No essay text was changed.

📄 This page was created on 6 November 2026. You can view its history on GitHub, preview the fileTip: Press Alt+Shift+G, or inspect the .