summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/hvqrurl
diff options
context:
space:
mode:
authorNorbert Preining <norbert@preining.info>2024-02-03 03:02:06 +0000
committerNorbert Preining <norbert@preining.info>2024-02-03 03:02:06 +0000
commit8d5a9f6bbecb297f513b9ed16e574db1c1310228 (patch)
tree4d9e1be6863ce68eb23b545add6e000edff4817c /macros/latex/contrib/hvqrurl
parentb5a938a222c59addea5ca0a22cd53b2bbf66e1fa (diff)
CTAN sync 202402030302
Diffstat (limited to 'macros/latex/contrib/hvqrurl')
-rw-r--r--macros/latex/contrib/hvqrurl/Changes1
-rw-r--r--macros/latex/contrib/hvqrurl/doc/hvqrurl.pdfbin113426 -> 113856 bytes
-rw-r--r--macros/latex/contrib/hvqrurl/doc/hvqrurl.tex29
-rw-r--r--macros/latex/contrib/hvqrurl/latex/hvqrurl.sty4
4 files changed, 23 insertions, 11 deletions
diff --git a/macros/latex/contrib/hvqrurl/Changes b/macros/latex/contrib/hvqrurl/Changes
index c4b25d48e5..a14d35f255 100644
--- a/macros/latex/contrib/hvqrurl/Changes
+++ b/macros/latex/contrib/hvqrurl/Changes
@@ -1,4 +1,5 @@
hvqrurl.sty:
+0.05a 2024-02-02 - modified documentation
0.05 2024-01-28 - added optional argument for alternative link text
0.04 2024-01-18 - fix for wrong text
0.03 2023-10-29 - fix for # in an url
diff --git a/macros/latex/contrib/hvqrurl/doc/hvqrurl.pdf b/macros/latex/contrib/hvqrurl/doc/hvqrurl.pdf
index 513df9f516..0ea564f2d7 100644
--- a/macros/latex/contrib/hvqrurl/doc/hvqrurl.pdf
+++ b/macros/latex/contrib/hvqrurl/doc/hvqrurl.pdf
Binary files differ
diff --git a/macros/latex/contrib/hvqrurl/doc/hvqrurl.tex b/macros/latex/contrib/hvqrurl/doc/hvqrurl.tex
index e60a7a2511..5b0e10dc06 100644
--- a/macros/latex/contrib/hvqrurl/doc/hvqrurl.tex
+++ b/macros/latex/contrib/hvqrurl/doc/hvqrurl.tex
@@ -1,4 +1,4 @@
-%% $Id: hvqrurl.tex 848 2024-01-28 11:57:35Z herbert $
+%% $Id: hvqrurl.tex 867 2024-02-02 09:03:16Z herbert $
\listfiles
\errorcontextlines=100
\documentclass[twoside=on,usegeometry]{scrartcl}
@@ -34,10 +34,11 @@
\usepackage{hvdoctools}
\usepackage{hyperref}
-\hypersetup{urlcolor=blue, linktocpage, colorlinks=true}%
+\hypersetup{%urlcolor=blue,
+linktocpage, colorlinks=true}%
\begin{document}
-\title{Package \texttt{hvqrurl}\\Creating a QR-code of an URL in the margin \\\small ver 0.04}
+\title{Package \texttt{hvqrurl}\\Creating a QR-code of an URL in the margin \\\small ver 0.05a}
\author{Herbert Voß\thanks{\protect\url{hvoss@tug.org}}}
\date{\today}
\maketitle
@@ -64,7 +65,10 @@ and
With the default macro \Lcs{hvqrurl} the URL is printed as as QR code into the margin and
in the the text as usual with the macro \Lcs{url}, for example \hvqrurl{https://mirror.ctan.org/pkg/hvqrurl}.
With \LPack{hyperref} you'll get the the same color for the QR code as for the URL link and, of course,
-is also a link. This example shows the default setting for a QR code.
+it is also a link. This example shows the output of the QR code with the default setting and
+an active \LPack{hyppref}.
+The star version of the command
+prints only the QR code but not the URL in the text.
With \Lcs{hvqrset} one can set the optional arguments globally. For example if one do not want all
QR codes not as a link when using \LPack{hyperref}:
@@ -78,6 +82,7 @@ QR codes not as a link when using \LPack{hyperref}:
\subsection{No link with \LPack{hyperref}}
+
\begin{lstlisting}
With qrlink=nolink the QR code is no link: \hvqrurl[qrlink=nolink]{https://mirror.ctan.org/pkg/hvqrurl}.
The default setting is qrlink=link.
@@ -88,8 +93,9 @@ has no meaning.
\subsection{Color of the QR code}
Without using \LPack{hyperref} the default color is \Lkeyval{black}. It can be changed by
-the optional argument \Lkeyword{qrcolor}. The package \LPack{xcolor}\hvqrurl*[qrlink=nolink,qrcolor=red!40!white]{https://mirror.ctan.org/pkg/xcolor}
- is loaded by default,
+the optional argument \Lkeyword{qrcolor}. The package
+\LPack{xcolor}\hvqrurl*[qrlink=nolink,qrcolor=red!40!white]{https://mirror.ctan.org/pkg/xcolor}
+is loaded by default,
the reason why an extended color definition is possible. For this example we used
\begin{lstlisting}
@@ -98,7 +104,7 @@ The package xcolor\hvqrurl*[qrcolor=red!40!white]{https://mirror.ctan.org/pkg/xc
\end{lstlisting}
\subsection{Vertical position of the QR code}
-By default the baseline of the QR code is nearly at the same height as the baseline of the textline.
+By default the baseline of the QR code is nearly at the same height as the baseline of the text.
However, when changing the size of the QR code it may be nessesary to move up or down the QR code.
The default value of \Lkeyword{qradjust} is \verb|-1.5\normalbaselineskip|. Setting the value
to 0pt the QR code
@@ -118,12 +124,12 @@ is moved down which is the default setting without a vertical adjustment.
By default the QR code is a square with height and width of 1cm.
it can be changed by setting \Lkeyword{qrheight} to another value, for example to 2cm:
\hvqrurl*[qrlink=nolink,qrheight=2cm]{https://identity.fu-berlin.de/idp-fub/profile/SAML2/Redirect/SSO;jsessionid=71C984647E3B8F2E716CA067CB13387E?execution=e1s1}
-This is an exetremely long url where it may make sense to use a larger QR code.
+This is an extremely long url where it may make sense to use a larger QR code.
\begin{lstlisting}
it can be changed by setting qrheight to another value, for example to 2cm:
\hvqrurl*[qrheight=2cm]{https://identity.fu-berlin.de/idp-fub/profile/SAML2/Redirect/SSO;jsessionid=71C984647E3B8F2E716CA067CB13387E?execution=e1s1}
-This is an exetremely long url where it may make sense to use a larger QR code.
+This is an extremely long url where it may make sense to use a larger QR code.
\end{lstlisting}
@@ -166,6 +172,7 @@ the long link for the qrcode, like
this one: \hvqrurl[linktext=https://www.uni-bonn.de]%
{https://www.uni-bonn.de/de/studium/studienangebot/studiengaenge-a-z/kunstgeschichte-bazf?set_language=de}.
+
\begin{lstlisting}
By default the QR code is set with the given text. If the link is too long, one
can use a short link with the optional argument \Lkeyword{linktext} for the text and
@@ -174,6 +181,10 @@ this one: \hvqrurl[linktext=https://www.uni-bonn.de]%
{https://www.uni-bonn.de/de/studium/studienangebot/studiengaenge-a-z/kunstgeschichte-bazf?set_language=de}.
\end{lstlisting}
+It makes no sense to use the star version \Lcs{hvqrurl*} together with the optional argument
+\Lkeyword{linktext}!
+
+
\printindex
diff --git a/macros/latex/contrib/hvqrurl/latex/hvqrurl.sty b/macros/latex/contrib/hvqrurl/latex/hvqrurl.sty
index 604a7ce87f..9786732d94 100644
--- a/macros/latex/contrib/hvqrurl/latex/hvqrurl.sty
+++ b/macros/latex/contrib/hvqrurl/latex/hvqrurl.sty
@@ -1,4 +1,4 @@
-%% $Id: hvqrurl.sty 848 2024-01-28 11:57:35Z herbert $
+%% $Id: hvqrurl.sty 867 2024-02-02 09:03:16Z herbert $
%%
%% This file is distributed under the terms of the LaTeX Project Public
%% License from CTAN archives in directory macros/latex/base/lppl.txt.
@@ -7,7 +7,7 @@
% Copyright 2019,21,23,24 Herbert Voss hvoss@tug.org
%%
\ProvidesPackage{hvqrurl}[%
- 2024/01/28 v.0.05 (Herbert Voss) Supports qr images into the margin (hv)]
+ 2024/02/02 v.0.05a (Herbert Voss) Supports qr images into the margin (hv)]
%
\NeedsTeXFormat{LaTeX2e}
\RequirePackage{url}