% Copyright (C) 2013 Eduardo C. Lourenço de Lima % % This work may be distributed and/or modified under the % conditions of the LaTeX Project Public License, either % version 1.3 of this license or (at your option) any later % version. The latest version of this license is in % % http://www.latex-project.org/lppl.txt % % and version 1.3 or later is part of all distributions of LaTeX % version 2005/12/01 or later. % \documentclass{ltxdoc} \newcommand\fileversion {0.3} \newcommand\filedate {May 18, 2016} \newenvironment{Description} {\par\medskip\noindent\ignorespaces}{} \newenvironment{synopsis} {\begin{list}{}{\setlength\parsep{0pt}\setlength\itemsep{0pt}}} {\end{list}} \title {The \textsf{clipboard} package\thanks{This document corresponds to \textsf{clipboard}~\fileversion, dated~\filedate.}} \author {Eduardo C. Louren\c{c}o de Lima\\\texttt{elourenco@phi.pro.br}} \date {\filedate} \begin{document} \maketitle \section*{Introduction} The |clipboard| package provides a basic framework for copying and pasting content within a single document or across multiple documents. \begin{synopsis} \item |\newclipboard | \marg{basename} \item |\openclipboard| \marg{basename}\medskip \item |\Copy | \marg{key} \marg{content} \item |\Paste| \marg{key} \end{synopsis} \section{Usage} \begin{Description} \DescribeMacro{\newclipboard} The first step is to create a clipboard. \begin{synopsis} \item |\newclipboard| \marg{basename} \end{synopsis} \end{Description} \begin{Description} \DescribeMacro{\Copy} The command |\Copy| copies a \meta{content} identified as \meta{key} to the clipboard.\footnote {Lowercase \texttt{\char92 copy} is already defined in {\TeX}.} \begin{synopsis} \item |\Copy| \marg{key} \marg{content} \end{synopsis} \end{Description} \begin{Description} \DescribeMacro{\Paste} And the command |\Paste| pastes the content identified by \meta{key} somewhere else in the same or another document. See below. \begin{synopsis} \item |\Paste| \marg{key} \end{synopsis} \end{Description} \begin{Description} \DescribeMacro{\openclipboard} Finally, |\openclipboard| makes the same content available across multiple documents. For instance, you can paste content from |doc1.tex| into |doc2.tex|. Make sure to use the same \meta{basename} in both documents. \begin{synopsis} \item |\openclipboard| \marg{basename} \end{synopsis} \end{Description} \section{Example} This is how to copy and paste text from |book.tex| into |article.tex|:\bigskip \noindent |book.tex|: \begin{verbatim} \documentclass{book} \usepackage{clipboard} \newclipboard{myclipboard} \begin{document} \Copy{dolorem ipsum}{Nor again is there anyone who loves or pursues or desires to obtain pain of itself}, because it is pain, but occasionally circumstances occur in which toil and pain can procure him some great pleasure. \end{document} \end{verbatim} \noindent |article.tex|: \begin{verbatim} \documentclass{article} \usepackage{clipboard} \openclipboard{myclipboard} \begin{document} According to Cicero, \begin{quote} \Paste{dolorem ipsum} \end{quote} \end{document} \end{verbatim} \noindent\textbf{Note:} Because content from |book.tex| is being copied and pasted into |article.tex|, you must run |latex book.tex| before running |latex article.tex|. \end{document}