BartoszMilewski / DaoFP

The Dao of Functional Programming
291 stars 17 forks source link

Add building instructions #25

Open clehene opened 1 month ago

clehene commented 1 month ago

@BartoszMilewski what's your setup to produce the PDFs for this? It would be a good addition to the README so that issues like https://github.com/BartoszMilewski/Publications/issues/17 could be sorted out by the community. Generally the local building setup is the biggest hurdle for contributions.

clehene commented 1 month ago

Noting you mentioned TeXShop so I'm assumign it's not something scripted.

Here's what I did to compile it locally on MacOS

brew install texshop
brew install texbin
brew install --cask mactex-no-gui
# failed while trying to remove some files
# manually removed 
rm -rf  /usr/local/texlive/2024
# retried and worked after
pip install Pygments

Added -shell-escape flag

pdflatex -shell-escape 1-CleanSlate.tex

Changed this in main DaoFP.tex

% ! LaTeX Error: Command \ttfamily invalid in math mode.
\DeclareRobustCommand{\hask}[1]{\ifmmode\text{\texttt{#1}}\else\mintinline{Haskell}{#1}\fi}
BartoszMilewski commented 1 month ago

I did some experimentation, including building from the command line, but nothing seems to fix the problem.

clehene commented 1 month ago

@BartoszMilewski - I was able to build it locally and highlight works fine (closed the original issue) https://github.com/BartoszMilewski/Publications/issues/17#issuecomment-2278689873

I added this issue to document how to compile tex to PDF locally. If you want to add build instructions for mac. I'll make a PR, let me know.

On a separate note, I think it would be helpful to add a README with a link to this repository here https://github.com/BartoszMilewski/Publications. I notice most issues refer to this book and this would me more appropriate to have them.