Skip to content

LaTeX improvements #51

@rodarima

Description

@rodarima

Hi,

The GASPI specification provided in http://www.gaspi.de/, currently:

https://raw.githubusercontent.com/GASPI-Forum/GASPI-Forum.github.io/master/standards/GASPI-17.1.pdf

has two major typesetting issues:

  1. The document is using non-vectorial fonts, which are very ugly for use in computer screen. Here is what I see in okular (same in zathura and mupdf):
    gaspi-aliasing
    While, if I compile the document from the repository using pdflatex GASPI_Standard_Draft.tex it shows ok: gaspi-ok I'm not sure what causes the difference. This is what I found on the PDF metadata; maybe is related to the pdfTeX version:
# The original from the GASPI-forum website
% pdfinfo GASPI-17.1.pdf | egrep '(Creator:|Producer:)'  
Creator:         TeX
Producer:        pdfTeX-1.40.16
# The one I compiled:
% pdfinfo GASPI_Standard_Draft.pdf  | egrep '(Creator:|Producer:)'  
Creator:         LaTeX with hyperref
Producer:        pdfTeX-1.40.20
  1. The PDF document doesn't have a PDF index enabled, which I find very useful to quickly jump between sections, specially when I'm not familiar with the complete structure of the document. I was able to enable the index with the hyperref package, but there is a conflict with one of the macros that cause the document to fail. I disabled the macro, as I don't know how to fix it. Here is the patch:
diff --git a/gaspi-standard/tex/GASPI_Standard_Draft.tex b/gaspi-standard/tex/GASPI_Standard_Draft.tex
index 6847d29..18cd600 100644
--- a/gaspi-standard/tex/GASPI_Standard_Draft.tex
+++ b/gaspi-standard/tex/GASPI_Standard_Draft.tex
@@ -57,8 +57,8 @@
 \newcommand{\zerowsep}{\hskip 0pt plus 0.1pt minus 0.1pt}
 
 \makeatletter
-\newcommand{\ZSEP}[1]{\ifx#1\@@@EOZ@@@\let\next\relax\else\ifx#1\_#1\zerowsep\else#1\fi\let\next\ZSEP\fi\next}
-\newcommand{\zsep}[1]{\ZSEP{}#1\@@@EOZ@@@}
+%\newcommand{\ZSEP}[1]{\ifx#1\@@@EOZ@@@\let\next\relax\else\ifx#1\_#1\zerowsep\else#1\fi\let\next\ZSEP\fi\next}
+\newcommand{\zsep}[1]{#1}
 \makeatother
 
 \newcommand{\sol}[1]{\emph{\zsep{#1}}}
@@ -262,6 +262,10 @@ basicstyle=\ttfamily
 , classoffset=0
 }\lstinputlisting{#1}}
 
+\usepackage{hyperref}
+
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 %%%%%%%%%%%                              Document                                 %%%%
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

After enabling the index generation, I can see the sections and quickly jump between them:

index

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions