summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/clipboard
diff options
context:
space:
mode:
authorNorbert Preining <norbert@preining.info>2019-09-02 13:46:59 +0900
committerNorbert Preining <norbert@preining.info>2019-09-02 13:46:59 +0900
commite0c6872cf40896c7be36b11dcc744620f10adf1d (patch)
tree60335e10d2f4354b0674ec22d7b53f0f8abee672 /macros/latex/contrib/clipboard
Initial commit
Diffstat (limited to 'macros/latex/contrib/clipboard')
-rw-r--r--macros/latex/contrib/clipboard/README39
-rw-r--r--macros/latex/contrib/clipboard/clipboard.pdfbin0 -> 170869 bytes
-rw-r--r--macros/latex/contrib/clipboard/clipboard.sty34
-rw-r--r--macros/latex/contrib/clipboard/clipboard.tex113
4 files changed, 186 insertions, 0 deletions
diff --git a/macros/latex/contrib/clipboard/README b/macros/latex/contrib/clipboard/README
new file mode 100644
index 0000000000..0b5f21eb13
--- /dev/null
+++ b/macros/latex/contrib/clipboard/README
@@ -0,0 +1,39 @@
+Package: clipboard
+Description: Copy and paste into and across documents
+
+The clipboard package provides a basic framework for copying and pasting
+text and commands into and across multiple documents.
+
+2016/05/18 v0.3
+ Content definitions take global scope
+
+2013/01/18 v0.2
+ Package: Renamed: copypaste->clipboard
+ Commands:
+ \Copy {key} {content}
+ \Paste {key} {content}
+ \newclipboard {basename}
+ \openclipboard {basename}
+
+2013/01/11 v0.1
+ Initial version (copypaste)
+
+--------------------------------------------------------------------------------
+Installation:
+
+*Copy clipboard.sty to a location where LaTeX will find it.
+ See http://www.tex.ac.uk/faq
+
+--------------------------------------------------------------------------------
+Usage:
+
+*See clipboard.pdf
+
+--------------------------------------------------------------------------------
+Copyright (C) 2013-2016 Eduardo C. Lourenço de Lima
+
+This material is subject to the LaTeX Project Public License. See
+http://www.ctan.org/tex-archive/help/Catalogue/licenses.lppl.html
+for the details of that license
+
+This work has the LPPL maintenance status "author-maintained"
diff --git a/macros/latex/contrib/clipboard/clipboard.pdf b/macros/latex/contrib/clipboard/clipboard.pdf
new file mode 100644
index 0000000000..f22b7eed01
--- /dev/null
+++ b/macros/latex/contrib/clipboard/clipboard.pdf
Binary files differ
diff --git a/macros/latex/contrib/clipboard/clipboard.sty b/macros/latex/contrib/clipboard/clipboard.sty
new file mode 100644
index 0000000000..dc3dfe64be
--- /dev/null
+++ b/macros/latex/contrib/clipboard/clipboard.sty
@@ -0,0 +1,34 @@
+%%
+%% This is file `clipboard.sty',
+%%
+%% 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.
+%%
+\NeedsTeXFormat{LaTeX2e}[1996/06/01]
+\ProvidesPackage{clipboard}[2016/05/18 v0.3 Copy and paste into and across documents]
+
+\newwrite \clipboard@fileout
+\newcommand\clipboard@write [2] {\immediate\write\clipboard@fileout{\noexpand\clipboard{#1}{\unexpanded{#2}}}}
+\newcommand\clipboard@copy [2] {\global\@namedef{clipboard@#1}{#2}}
+\newcommand\clipboard@paste [1] {\@nameuse{clipboard@#1}}
+
+\newcommand\newclipboard [1] {\immediate\openout\clipboard@fileout=#1.cpy}
+\newcommand\openclipboard [1] {\input{#1.cpy}}
+
+\newcommand\clipboard [2] {\clipboard@copy{#1}{#2}}
+
+\newcommand\Copy [2] {\clipboard{#1}{#2}\clipboard@write{#1}{#2}#2}
+\newcommand\Paste [1] {\clipboard@paste{#1}}
+
+\endinput
+%%
+%% End of file `clipboard.sty'.
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}