\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