diff options
author | Norbert Preining <norbert@preining.info> | 2019-09-02 13:46:59 +0900 |
---|---|---|
committer | Norbert Preining <norbert@preining.info> | 2019-09-02 13:46:59 +0900 |
commit | e0c6872cf40896c7be36b11dcc744620f10adf1d (patch) | |
tree | 60335e10d2f4354b0674ec22d7b53f0f8abee672 /macros/latex/contrib/randtext/randtext-doc.tex |
Initial commit
Diffstat (limited to 'macros/latex/contrib/randtext/randtext-doc.tex')
-rw-r--r-- | macros/latex/contrib/randtext/randtext-doc.tex | 69 |
1 files changed, 69 insertions, 0 deletions
diff --git a/macros/latex/contrib/randtext/randtext-doc.tex b/macros/latex/contrib/randtext/randtext-doc.tex new file mode 100644 index 0000000000..384d7fac7d --- /dev/null +++ b/macros/latex/contrib/randtext/randtext-doc.tex @@ -0,0 +1,69 @@ +\documentclass[pagesize=auto, parskip=half]{scrartcl} + +\usepackage{fixltx2e} +\usepackage{etex} +\usepackage{lmodern} +\usepackage[T1]{fontenc} +\usepackage{textcomp} +\usepackage{microtype} +\usepackage{hyperref} + +\newcommand*{\pkg}[1]{\textsf{#1}} +\newcommand*{\cs}[1]{\texttt{\textbackslash#1}} +\makeatletter +\newcommand*{\cmd}[1]{\cs{\expandafter\@gobble\string#1}} +\makeatother +\newcommand*{\meta}[1]{\textlangle\textsl{#1}\textrangle} +\newcommand*{\marg}[1]{\texttt{\{}\meta{#1}\texttt{\}}} + +\addtokomafont{title}{\rmfamily} + +\title{The \pkg{randtext} package\thanks{This manual corresponds to \pkg{randtext.sty}, dated~2004/12/20.}} +\author{Charles Duan} +\date{2004/12/20} + + +\begin{document} + +\maketitle + +Provides one useful macro, \cmd{\randomize}\marg{text}. Result is a typeset box that +looks, on paper, like \meta{text}, but whose letters have in fact been placed in +random order so that they are not copiable from the file directly. + +In other words, typing: +% +\begin{verbatim} + This is a \randomize{random-text} test. +\end{verbatim} +% +would produce output that looks like: +% +\begin{quote} + This is a random-text test. +\end{quote} +% +but if you tried to copy-paste it from the output file, you would probably get +% +\begin{quote} + This is a mdoxt-etnra test. +\end{quote} +% +The function of this odd macro is to obfuscate e-mail addresses, say on a PDF +document put online, so that the human reader sees the address as expected, +but e-mail address harvesters and spambots cannot determine the address. Since +this macro is done entirely using \TeX\ typesetting commands, it requires no +external image generation or anything, and the typeset result is just as +high-quality as if no obfuscation had taken place. + +This macro does take into account kerning between character pairs, but it does +not account for ligatures. To make appropriate ligatures, surround the +ligature characters with braces. + +This package supersedes \pkg{switcheml.sty}, written by the same author. (That is +the reason that the internal macros begin with \verb+se@+. + +Requires the file \texttt{random.tex}, by Donald Arseneau. I believe that this file +comes as part of a standard \TeX\ distribution. + +\end{document} |