cgnieder / acro

acronyms for LaTeX
LaTeX Project Public License v1.3c
41 stars 9 forks source link

Docs: Example 6 output cannot be read #190

Closed bersbersbers closed 3 years ago

bersbersbers commented 4 years ago

I only see "We use the Universal", and so I think I am missing the point of this example:

image

cgnieder commented 3 years ago

I don't understand your question. If I open the manual with

texdoc acro

navigate to example 6 and either click on the image or the [PDF] link a file called acro.example.issue-154.pdf opens which shows

image

Likewise if I click [TeX] a file called acro.example.issue-154.tex opens which contains these lines:

\documentclass{article}

\usepackage[version=3]{acro}

\RenewAcroCommand\ac{mo}{\UseAcroTemplate{first}{#1}\IfNoValueF{#2}{#2}}

\DeclareAcronym{uc}{
  short = UC ,
  long = Universal Composability ,
  cite = xxx
}

\begin{document}

We use the \ac{uc}[ model] for\dots

\end{document}

The small picture in the left of the example boxes show the exact same clipping of the example PDF.

bersbersbers commented 3 years ago

I see. Well, I open http://mirrors.ctan.org/macros/latex/contrib/acro/acro-manual.pdf in Chrome. The TeX link downloads a .tex file, alright. But the PDF link scrolls to the top of the document. And the "preview" on the right is incomplete, as you see in the snapshot in my original post ("We use the Universal"). When I click that, again, it scrolls to the top of the document.

cgnieder commented 3 years ago

Well, then maybe you should open the example files directly – http://mirrors.ctan.org/macros/latex/contrib/acro/examples or https://github.com/cgnieder/acro/tree/master/doc/examples for example.

In the manual the links are relative links which is why they work when you open the file with texdoc on your machine but not if you download it from some link in the internet.

And again: the small window is an automatic clip from the PDF. If I change the output window for that example it changes for all examples – and I have to make some compromise… I could show the complete page but then it were so small that you couldn't see anything. Or I could leave image and code snippet away and just refer to the example documents…

bersbersbers commented 3 years ago

I see. Alright, if everything works as intended ... ;)