From e0c6872cf40896c7be36b11dcc744620f10adf1d Mon Sep 17 00:00:00 2001 From: Norbert Preining Date: Mon, 2 Sep 2019 13:46:59 +0900 Subject: Initial commit --- macros/latex/contrib/clipboard/clipboard.tex | 113 +++++++++++++++++++++++++++ 1 file changed, 113 insertions(+) create mode 100644 macros/latex/contrib/clipboard/clipboard.tex (limited to 'macros/latex/contrib/clipboard/clipboard.tex') diff --git a/macros/latex/contrib/clipboard/clipboard.tex b/macros/latex/contrib/clipboard/clipboard.tex new file mode 100644 index 0000000000..c758527baf --- /dev/null +++ b/macros/latex/contrib/clipboard/clipboard.tex @@ -0,0 +1,113 @@ +% 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} -- cgit v1.2.3