How to Recover When Re:VIEW Starter Breaks Even Though You Changed Nothing

This page has been machine-translated from the original page.

This article explains how to recover when Re:VIEW Starter suddenly stops generating PDFs even though you did not change anything.

Recently, as a new challenge, I have been writing a technical doujin book to distribute at Tech Book Fest. For that writing work, I use a tool called Re:VIEW Starter.

Reference: Introduction to Re:VIEW Starter, a great tool for people writing technical doujin books - Qiita

At one point, I suddenly ran into a problem where PDF generation stopped working, so I am leaving a record of how I resolved it.

Specifically, I deleted every file with the following extensions directly under the *-pdf directory generated by Re:VIEW Starter.

• .tex
• .aux
• .dvi
• .log
• .maf
• .mtc*
• .out
• .toc

Problem that occurred

All of a sudden, Re:VIEW Starter started outputting the following error and failed to generate a PDF.

Package pagecolor Warning: Option nopagecolor=none requested but \nopagecolor u
nknown:
(pagecolor)                By option nopagecolor the "colour" to be used with\n
opagecolor
(pagecolor)                is set. The current value is "none" (maybe by defaul
t),
(pagecolor)                but command \nopagecolor is undefined.
(pagecolor)                Therefore the colour cannot be "none".
(pagecolor)                Please change the option accordingly!
(pagecolor)                As first aid nopagecolor is now set to white
(pagecolor)                 on input line 116.


Package pagecolor Warning: Option pagecolor=none (maybe by default) used,
(pagecolor)                but \nopagecolor is unknown.
(pagecolor)                Please use anotheroption value;
(pagecolor)                white
(pagecolor)                will be used now
(pagecolor)                 on input line 127.

)) (./mycolophon.sty) (./mystyle.sty) (./book.aux)
Runaway argument?
{\contentsline {subsection}{\nu
./book.tex:193: File ended while scanning use of \@writefile.
<inserted text>
                \par
l.193 \begin{document}

No pages of output.
Transcript written on book.log.
*
* ERROR (review-pdfmaker):
*  failed to run command: uplatex -halt-on-error -file-line-error book.tex
*
make: *** [Makefile:45: create_pdf] Error 1

In most cases, something like this is caused by a problem in a *.re file. However, in this case PDF generation failed even when I used a completely valid *.re file.

In the end I never identified the exact cause, but it looked like the issue was somewhere in the TeX compilation step, so I deleted all of the following files and the problem was resolved successfully.

• .tex
• .aux
• .dvi
• .log
• .maf
• .mtc*
• .out
• .toc

This happened completely out of nowhere, and because I could not figure out the cause, I ended up wasting about an hour. For now, if PDF generation fails, it seems worth trying to delete previously generated files first, so I am leaving this as a memo.