Update Pillar-related installation instructions

[dmitrizagidulin]

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:

1. Installed MacTex (made sure pdftex was accessible on my current path, etc)
2. Ran ./download.sh, it ran no problem, installed Pillar on Pharo 4.0, etc.
3. 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?)

[cdlm]

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.

[dmitrizagidulin]

I keep seeing references to ./root/support/latex/sbabook/sbabook.cls in the errors. Where's the root part coming from

[cdlm]

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.

[dmitrizagidulin]

@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).

[cdlm]

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 :(

[dmitrizagidulin]

Thanks, very much appreciate it.