Provide an example build command in the README

[ssavinel]

I've just realized, thanks to stackoverflow, that tikz and pgfkeys rely on lualatex and not xelatex or else. Providing a building command line example might help new users.

[tecosaur]

That's funny, because I use this with pdflatex 😛

[ssavinel]

Ow, pdflatex returns me plethora of issues related to pgfkeys that I do not encounter with lualatex on linux mint, using the latest version of texlive.

[tecosaur]

I see a few pdf/pdfkeys error when building documentation/bmc.tex:

! Package pgf Error: No shape named `' is known.
! Package pgf Error: No shape named `' is known.
! Package pgf Error: No shape named `' is known.
! Package pgf Error: No shape named `' is known.
! Package pgfkeys Error: I do not know the key '/tikz/{1}{draw=none}{}' and I a
! Package pgfkeys Error: I do not know the key '/tikz/{2}{draw=none}{}' and I a
! Package pgfkeys Error: I do not know the key '/tikz/{4}{draw=none}{}' and I a
! Package pgfkeys Error: I do not know the key '/tikz/{5}{draw=none}{}' and I a

[ssavinel]

So, I tried using pdflatex per your usage and used this command to reduce verbosity :
pdflatex -shell-escape -interaction=nonstopmode -file-line-error bmc.tex | grep -i ".*:[0-9]*:.*\|Warning"
And here are all the errors/warnings I encounter : https://pastebin.com/b3khtFBV
Should I start an issue by error type ?

[tecosaur]

The reference errors should disappear on a second run, but the:

• etoolbox errors
• Missing \begin{document} error
• Package pgf Error: No shape named `' is known.
• Package pgfkeys Error: I do not know the key '/tikz/{2}{draw=non

All need to be fixed. We could open issues for them, or just work on them within an issue. I don't mind either approach.

[ssavinel]

So far, fixing the etoolbox errors opened a new batch of errors, I'm currently trying to fix the chemfig arrow as the Stackoverflow version stopped working with the latest chemfig updates.
The Mint repository version of texlive was apparently pretty outdated and I'm updating everything to the latest version to have a clean base. I hope I'll get everything working in a few days. 🤞