UpdatedPharoByExample
UpdatedPharoByExample copied to clipboard
Update Pillar-related installation instructions
Our installation / Pillar setup instructions no longer seem to work. I went to set up Updated Pharo by Example on a new laptop, and couldn't get it to compile either the whole book or individual chapters.
I took the following steps:
- Installed MacTex (made sure
pdftex
was accessible on my current path, etc) - Ran
./download.sh
, it ran no problem, installed Pillar on Pharo 4.0, etc. - But now running either
./compile.sh
or./compileBook.sh
doesn't work.
Running ./compile.sh
by itself gives the following error:
o compile your LaTeX files launch "bash pillarPostExport.sh".
==========================================================
Begining of the LaTeX compilation...
==========================================================
Compiling PDF from book-result/Preface/Preface.tex
This is LuaTeX, Version 0.95.0 (TeX Live 2016) (format=lualatex 2016.5.22) 1 APR 2017 15:50
restricted system commands enabled.
file:line:error style messages enabled.
**Preface.tex
(./Preface.tex
LaTeX2e <2016/03/31>
Babel <3.9r> and hyphenation patterns for 1 language(s) loaded.
(./root/support/latex/sbabook/sbabook.cls
LaTeX Warning: You have requested document class `root/support/latex/sbabook/sba
book',
but the document class provides `sbabook'.
...
// (a bunch of LaTeX)
...
(/usr/local/texlive/2016/texmf-dist/tex/generic/tracklang/tracklang.tex)))
Runaway argument?
\pdffeedback creationdate\@dtm@endparsepdfdatetime \let \@dtm@currentyear \ETC.
./root/support/latex/common.tex:10: File ended while scanning use of \@dtm@parse
pdfdatetime.
<inserted text>
\par
l.10
Here is how much of LuaTeX's memory you used:
...
./root/support/latex/common.tex:10: ==> Fatal error occurred, no output PDF fil
e produced!
Can't generate the PDF!
Running ./compileBook.sh
gives the following error:
./compileBook.sh
/Library/TeX/texbin/texfot: invoking: latexmk UpdatedPharoByExample
This is pdfTeX, Version 3.14159265-2.6-1.40.17 (TeX Live 2016) (preloaded format=latex)
! LaTeX Error: File `support/latex/sbabook/sbabook.cls' not found.
! Emergency stop.
<read *>
l.4 \let
No pages of output.
Latexmk: Errors, so I did not complete making targets
[stderr] Latexmk: This is Latexmk, John Collins, 22 April 2016, version: 4.45.
[stderr] Rule 'latex': File changes, etc:
[stderr] Non-existent destination files:
[stderr] 'UpdatedPharoByExample.dvi'
[stderr] ------------
[stderr] Run number 1 of rule 'latex'
[stderr] ------------
[stderr] ------------
[stderr] Running 'latex -recorder "UpdatedPharoByExample.tex"'
[stderr] ------------
[stderr] Latexmk: Missing input file: 'support/latex/sbabook/sbabook.cls' from line
[stderr] '! LaTeX Error: File `support/latex/sbabook/sbabook.cls' not found.'
[stderr] Latexmk: Log file says no output from latex
[stderr] Latexmk: For rule 'latex', no output was made
[stderr] Collected error summary (may duplicate other messages):
[stderr] latex: Command for 'latex' gave return code 256
[stderr] Latexmk: Use the -f option to force complete processing,
[stderr] unless error was exceeding maximum runs of latex/pdflatex.
I'm not sure what is causing the File 'support/latex/sbabook/sbabook.cls' not found.
error, because the file is there:
ls support/latex/sbabook/sbabook.cls
-rw-r--r-- 1 dmitri staff 11K Apr 1 14:29 support/latex/sbabook/sbabook.cls
It looks like something has changed as of the Migrate to the sbabook class commit. How do I install / compile things now?
(Oh, I also noticed that /pillarPostExport.sh
is in the .gitignore
file. That doesn't seem right; should it be ignored?)
pillarPostExport.sh
should definitely be ignored as it's generated each time pillar export
gets called.
About sbabook.cls
not being found, I'm not sure. The LaTeX compile happens from inside the book-result
directory, so you should check that it's accessible from there, instead of from the git clone. In any case I'd try a clean (removing book-result
) build before anything else.
I keep seeing references to ./root/support/latex/sbabook/sbabook.cls
in the errors. Where's the root
part coming from
Those are links that are created from the pillarPostExport.sh
script. They should be created in each book-result/$CHAPTER/
directory and pointing back up to book-result
.
@cdlm - If you check out a fresh copy of this repo, run the download script, does compiling work for you? (And if so, what are the environmental differences? What OS, etc?) I can't get it to work (and another person at Camp Smalltalk this weekend couldn't get it to work either).
On my machine download.sh
gets a VM that's too old to run on OS X 10.12 so it doesn't even build the Pillar image… I'll try to get the build to work by downloading a working VM/Pillar image myself, but cannot guarantee when :(
Thanks, very much appreciate it.