Document installation requirements

[DaveParr]

We know there are quite a few dependencies for this package to get it to run. Where reasonable we should document an 'installation' process.

For ubuntu I've got this far:

sudo dpkg --configure -a
sudo apt --fix-broken install
sudo apt upgrade
sudo apt-get install texlive-full
sudo apt-get install texinfo

At which point I get an error:

Error in tools::texi2dvi(temp_badge_code, pdf = TRUE, clean = TRUE) : 
  Running 'texi2dvi' on './badgeb414e40e438.tex' failed.
LaTeX errors:
! LaTeX Error: File `ticket.sty' not found.

Type X to quit or <RETURN> to proceed,
or enter new name. (Default extension: sty)

! Emergency stop.
<read *> 

l.4 \usepackage
               {graphicx}^^M
!  ==> Fatal error occurred, no output PDF file produced! 

I try to determine if this CTAN package is in the system with: kpsewhich ticket.sty which gives no response, i.e. no package installed. Curiously when I run kpsewhich letter.sty I get: /home/davidparr/.TinyTeX/texmf-dist/tex/latex/base/letter.sty which indicates the tinytex install that I had thought I had removed.

Eitherway, i need to work out how to install this missing package to make it run. Will update this as I make more progress.

[DaveParr]

OK, fixed that with: tlmgr install ticket

which gives a return to kpsewhich ticket.sty of: /home/davidparr/.TinyTeX/texmf-dist/tex/latex/ticket/ticket.sty

New error:

Error in tools::texi2dvi(temp_badge_code, pdf = TRUE, clean = TRUE) :
  Running 'texi2dvi' on './badgeb411e00450a.tex' failed.
LaTeX errors:
! LaTeX Error: File `ifmlogoc' not found.

can work around it by deleting the line from template: \\put({logo_pos_x}, {footer_pos_y-12}){{\\includegraphics[width={graphics_size}]{{{graphic}}}}}

so this is the default IFM logo in the file I guess.

[DaveParr]

OK, finally fixed with tlmgr install ifmslide and generate pdf as I think is expected :)

[DaveParr]

FWIW if we get far enough that we have tests to run, we might get far enough to automate those tests on GitLab actions on Ubuntu boxes, at which point we'll need to be able to run these commands on setup of the test boxes.