AbertayHackers / Tex-Templates

0 stars 2 forks source link

Necessary packages #2

Open pshem opened 7 years ago

pshem commented 7 years ago

This template doesn't work with the default packages anyway, so let's stop pretending it does.

The default installation of Texmaker on Ubuntu 16.04 & derivatives is missing abbreviations, so they don't work. Unless you use any in your work based on the template, only warnings are shown. I think it required the BibLaTeX-extra package too, but I'm not sure about that.

That same installation does contain intputenc though, which https://github.com/AbertayHackers/Tex-Templates/pull/1 adds and which reportedly isn't present in the default installation of MacTeX. I think we can just list these 3 packages as "probable reasons for compilation failure"

ghost commented 7 years ago

@pshem I was not aware that those templates required non standard packages, I guess thats what we get for making them as we went along. This doesn't seem like too much work to fix though 👍.

The Tex packaged used for abbreviations is glossaries, line 19-21.

I'd like to keep the glossaries package in even if non standard as it's a pretty useful feature. If the complier is showing warning rather than failing we could reduce the number of example \newacronym{}{}{} entries and mention it in the README?

As I write this im just wondering if the goal should be to provide templates that will compile cross platform? Or have a few templates for pentest, forensics and then many example files. So for example @pshem your adding of UTF-8 encoding for non latin characters could be an example file rather than included in the template, same with the glossary stuff? (I'm thinking out loud here)

In the mean time i'd like to get your fix for the logo name into the repo, could you amend PR #1 to just include the logo fix and we can merge that ASAP?

pshem commented 7 years ago

I don't think there is much point in removing acronym examples, as they don't cause compilation failures, just warnings.

Non-standard package is used in an arbitrary way here, as all the mentioned packages are a part of the the texlive-full metapackage, which means that all of them are technically standard. I don't think it makes sense to limit ourselves to the texlive-latex-base(contents below) metapackage which every LaTeX distribution should(must? can be expected to?) contain.

ae -- Virtual fonts for T1 encoded CMR-fonts. amscls -- AMS document classes for LaTeX. amsmath -- AMS mathematical facilities for LaTeX babel -- Multilingual support for Plain TeX or LaTeX babel-english -- Babel support for English. babelbib -- Multilingual bibliographies. carlisle -- David Carlisle's small packages. colortbl -- Add colour to LaTeX tables. fancyhdr -- Extensive control of page headers and footers in LaTeX2e. fix2col -- Fix miscellaneous two column mode features geometry -- Flexible and complete interface to document dimensions. graphics -- Standard LaTeX graphics hyperref -- Extensive support for hypertext in LaTeX. latex -- A TeX macro package that defines LaTeX latex-bin -- LaTeX executables and man pages. latex-fonts -- A collection of fonts used in LaTeX distributions. latexconfig -- ltxmisc -- Miscellaneous LaTeX packages, etc. mfnfss -- Packages to typeset oldgerman and pandora fonts in LaTeX. mptopdf -- mpost to PDF, native MetaPost graphics inclusion natbib -- Flexible bibliography support. oberdiek -- A bundle of packages submitted by Heiko Oberdiek. pdftex-def -- Colour and Graphics support for PDFTeX. pslatex -- Use PostScript fonts by default. psnfss -- Font support for common PostScript fonts. pspicture -- PostScript picture support. tools -- The LaTeX standard tools bundle url -- Verbatim with URL-sensitive line breaks.

I think every Tex distribution(texmaker, MacTeX, whatever it's called for windows + weird receipes for turning your favourite text editor into a TeX editor) contains a bit more than texlive-latex-base and it's a lot of pointless work to create out own baseline. We should either go with texlive-latex-base, use texlive-latex-base + texlive-latex-extra or claim we require texlive-full. I'm not sure how complicated it is to manage LaTeX packages on OSX & Windows, but any other option smells like asking for trouble and overcomplication.