summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/source/latex/morehype/texlinks.tex
blob: 9a4e660f92b2af163aa23bcb3ecd1790a2344548 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
\ProvidesFile{texlinks.tex}[2012/12/01 documenting texlinks.sty]
\title{{\Huge\textsf{texlinks.sty}}\\---\\\TeX-Related Links 
       for \textsf{hyperref}, \textsf{blog.sty}\\
       (and maybe more)\thanks{This 
       document describes version 
       \textcolor{blue}{\UseVersionOf{\jobname.sty}} 
       of \textsf{\jobname.sty} as of \UseDateOf{\jobname.sty}.}}
% \listfiles 
{ \RequirePackage{makedoc} \ProcessLineMessage{} 
%   %% 2011/01/24:
%   \renewcommand*{\mdSectionLevelOne}{\string\subsection}
%   \renewcommand*{\mdSectionLevelTwo}{\string\subsubsection}
%   \renewcommand*{\mdSectionLevelThree}{\string\paragraph}
  \MakeJobDoc{17}%                  %% 2011/01/24
  {\SectionLevelThreeParseInput}  }
\documentclass[fleqn]{article} %% TODO paper dimensions!?
\input{makedoc.cfg}     %% shared formatting settings
\usepackage{color} 
\newcommand*{\xmltagcode}[1]{\texttt{<#1>}}
\providecommand{\CTAN}{\acro{CTAN}}
\providecommand{\HTML}{\acro{HTML}}
\providecommand{\URL} {\acro{URL}}
\providecommand{\ctanpkgdref}[1]{%
    \ctanpkgref{#1}\,\urlfoot{CtanPkgRef}{#1}}
% \RequirePackage{filesdo}
% \MDfinaldatechecks
\sloppy
\begin{document}
\maketitle
\begin{abstract}\noindent
'texlinks.sty' provides a couple of shorthands for making hyperlinks 
with \ctanpkgref{hyperref}'s\urlpkgfoot{hyperref} `\href' command, 
linking to URLs that one often refers to in discussing \TeX-related material. 
Especially, \acro{TUG} material
(including texhax postings and TUGboat articles) and 
\CTAN\ pages (package descriptions, directories, Catalogue) 
are supported, also the UK~FAQ, 
the \LaTeX\ Wikibook,                   %% 2011/08/27
and Wikipedia 
(where much \TeX-related software is described in a 
 visually appealing manner).
However, up to now I have used them for \emph{\acro{HTML}} overviews 
generated with 'blog.sty'. 
They may as well be useful with better known (and better developed)
\TeX\,$\to$\,\acro{HTML} software such as 
\ctanpkgref{tex4ht}\urlpkgfoot{tex4ht} or 
\CtanPkgRef{latex2html}{LaTeX2HTML}\urlpkgfoot{latex2html}
(I don't know).
\end{abstract}

\tableofcontents

\section{Usage}
The file 'texlinks.sty' is provided ready, installation only requires 
putting it somewhere where \TeX\ finds it 
(which may need updating the filename data 
 base).\urlfoot{ukfaqref}{inst-wlcf}
 % \footnote{\url{http://www.tex.ac.uk/cgi-bin/texfaq2html?label=inst-wlcf}}

Below the `\documentclass' line(s) and above `\begin{document}', 
you load 'texlinks.sty' (as usually) by
\begin{verbatim}
  \usepackage{texlinks}
\end{verbatim}
Package options and user commands are described near their definitions 
below in the implementation section.

\section{Package File Header (Legalese)}    %% ize -> ese 2012/11/09

\input{texlinks.doc}

\ModDates
\CheckDateOfPDFmod{texlinks.sty}
\CheckDateOfPDFmod{texlinks.tex}
\end{document}

VERSION HISTORY

2011/01/24  for v0.1, very first
2011/01/27  for v0.2, use \urlfoot{ukfaq}
2011/07/23  using \acro
2011/08/27  mentioning LaTeX Wikibook in abstract
2011/09/03  \Huge first line
2011/10/10  [fleqn]
2011/10/20  \HTML, \URL
2012/11/09  Legalize -> Legalese
2012/11/28  \ctanpkgdref
2012/12/01  date checks