Tex-to-HTML Process Rules
The governing requirement is exactness. The source TeX is the validated text. The HTML output must preserve the source prose without shortening, paraphrasing, summarizing, or rearranging the article content.
Hard Rules
- Use the TeX file as the validated source of truth.
- Conduct a line-by-line audit against the TeX before finalizing HTML.
- Do not shorten prose.
- Do not paraphrase prose.
- Do not summarize prose.
- Do not omit citations that appear in the source.
- Do not reorder citations.
- Do not invent new scholarly wording.
- Do not add editorial explanations to the article text.
- Use HTML format only as the formatting layer.
- Treat the PDF as a secondary check, not the source of record.
- If the HTML differs from the TeX, correct the HTML to match the TeX.
Conversion Workflow
Read the TeX completely. Read the bibliography completely. Build the HTML article structure. Translate formatting only. Preserve special typography. Verify against the PDF. Audit the HTML line by line against the TeX.
If a compiled TeX/Biber bibliography exists, treat it as the authoritative ordering for the article references. Mirror the compiled ordering exactly in the HTML references section. If the compiled bibliography is alphabetically sorted, preserve that alphabetical order exactly in the HTML. Do not renumber or renormalize year-letter suffixes by hand.
Deployment Workflow
- Verify authentication with npx wrangler whoami.
- Deploy with npx wrangler pages deploy . --project-name eaglesperchpress --commit-dirty=true.
- Wait for the preview URL.
- Verify the deployed page with curl.
- Verify production when requested.
User Instructions Required
- TeX file
- Bibliography file
- PDF file
- Any referenced image assets
- Desired volume location
- Publication date if it differs from the system date
- Special citation-key preferences
- Any special formatting instruction that differs from the established house rules
Final Rule
If there is any uncertainty about whether text in the HTML matches the TeX, return to the TeX and check the line again. The public page may differ in formatting. The public page may not differ in prose.
Before finalizing the HTML, compare the compiled bibliography output against the HTML references line by line. Check that the ordering, year-letter suffixes, titles, venue names, page ranges, DOI strings, and URL strings match the compiled source exactly.
When you provide the source package, include the compiled PDF with its reference section or the compiled bibliography output so this comparison can be made directly. If possible, also include the .bbl file or the compiled bibliography text so the reference ordering can be checked without guessing.