From 2ee346b14369d34b308ad2924177c2761739f34a Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Mon, 1 Jul 2019 21:09:12 +0000 Subject: zebra-goodies (1jul19) git-svn-id: svn://tug.org/texlive/trunk@51522 c570f23f-e606-0410-a88d-b1316a301751 --- .../texmf-dist/doc/latex/zebra-goodies/README.md | 28 +- .../doc/latex/zebra-goodies/zebra-goodies.pdf | Bin 0 -> 112889 bytes .../source/latex/zebra-goodies/zebra-goodies.dtx | 583 +++++++++++++++++++++ .../source/latex/zebra-goodies/zebra-goodies.ins | 57 ++ .../tex/latex/zebra-goodies/zebra-goodies.sty | 95 ++-- 5 files changed, 700 insertions(+), 63 deletions(-) create mode 100644 Master/texmf-dist/doc/latex/zebra-goodies/zebra-goodies.pdf create mode 100644 Master/texmf-dist/source/latex/zebra-goodies/zebra-goodies.dtx create mode 100644 Master/texmf-dist/source/latex/zebra-goodies/zebra-goodies.ins diff --git a/Master/texmf-dist/doc/latex/zebra-goodies/README.md b/Master/texmf-dist/doc/latex/zebra-goodies/README.md index 993b34dc014..4ddd4c2a9cc 100644 --- a/Master/texmf-dist/doc/latex/zebra-goodies/README.md +++ b/Master/texmf-dist/doc/latex/zebra-goodies/README.md @@ -1,23 +1,23 @@ # zebra-goodies -A collection of handy macros for paper writing in my group. Do remove this -package once the paper is finished. - -This is not intended for general cases. Use it at your own risk. +A collection of handy macros for note taking, like `todo` and `comment`. This is +not intended for general cases. Use it at your own risk. ## Options -* `draft`: boolean option, whether to show the notes. Enabled by default. Example to disable it: - -```latex -\usepackage[draft=false]{zebra-goodies} -``` - -* `microtype`: boolean option, whether to load package `microtype`. Enabled by default. +- `draft`: boolean option, whether to show the notes. Enabled by default. Example to disable it: + ```latex + \usepackage[draft=false]{zebra-goodies} + % or use the complementary option "final" + \usepackage[final]{zebra-goodies} + ``` +- `microtype`: boolean option, whether to load package `microtype`. Enabled by default. ## Take Notes -Add comments, todos, notes anything you like during revise in a colorful way. The package also summarizes the revise notes at the end of the document. Predefined commands are as follows: +Add comments, todos, notes anything you like during revise in a colorful way. +The package also summarizes the revise notes at the end of the document. +Predefined commands are as follows: ```latex \todo[]{bla bla} @@ -27,7 +27,9 @@ Add comments, todos, notes anything you like during revise in a colorful way. Th \placeholder[]{bla bla} ``` -If any of them does not work, it is very likely that it has been defined by other packages. We will not override the definition, so you have to turn to its full version as follows: +If any of them does not work, it is very likely that it has been defined by +other packages. We will not override the definition, so you have to turn to its +full version as follows: ```latex \zebratodo[]{bla bla} diff --git a/Master/texmf-dist/doc/latex/zebra-goodies/zebra-goodies.pdf b/Master/texmf-dist/doc/latex/zebra-goodies/zebra-goodies.pdf new file mode 100644 index 00000000000..dae723b5fbc Binary files /dev/null and b/Master/texmf-dist/doc/latex/zebra-goodies/zebra-goodies.pdf differ diff --git a/Master/texmf-dist/source/latex/zebra-goodies/zebra-goodies.dtx b/Master/texmf-dist/source/latex/zebra-goodies/zebra-goodies.dtx new file mode 100644 index 00000000000..dedcc483eb0 --- /dev/null +++ b/Master/texmf-dist/source/latex/zebra-goodies/zebra-goodies.dtx @@ -0,0 +1,583 @@ +% \iffalse meta-comment +%<*internal> +\iffalse +% +%<*dummy> +I'd like to keep this part here for later use. +% +%<*internal> +\fi +\def\nameofplainTeX{plain} +\ifx\fmtname\nameofplainTeX\else + \expandafter\begingroup +\fi +% +%<*install> +\input l3docstrip.tex +\keepsilent +\askforoverwritefalse +\preamble +Copyright (C) 2016-2019, Ruini Xue + +It may be distributed and/or modified under the conditions of +the LaTeX Project Public License (LPPL), either version 1.3c of +this license or (at your option) any later version. The latest +version of this license is in the file: + + http://www.latex-project.org/lppl.txt +\endpreamble +\postamble + +This work is "maintained" (as per LPPL maintenance status) by + Ruini Xue. + +This work consists of the file zebra-goodies.dtx + and the derived files zebra-goodies.ins, + zebra-goodies.pdf and + zebra-goodies.sty. + +\endpostamble +\usedir{tex/latex/zebra-goodies} +\generate{ + \file{\jobname.sty}{\from{\jobname.dtx}{package}} +} +% +%\endbatchfile +%<*internal> +\usedir{source/latex/zebra-goodies} +\generate{ + \file{\jobname.ins}{\from{\jobname.dtx}{install}} +} +%\nopreamble\nopostamble +%\usedir{doc/latex/zebra-goodies} +%\generate{ +% \file{README.md}{\from{\jobname.dtx}{dummy}} +%} +\ifx\fmtname\nameofplainTeX + \expandafter\endbatchfile +\else + \expandafter\endgroup +\fi +% +%<*driver|package> +%\RequirePackage{xparse} +% +%<*driver> +\documentclass[full]{l3doc} +\usepackage[scaled=0.93]{helvet} +\usepackage[final]{listings} +\usepackage{zebra-goodies} +\EnableCrossrefs +\CodelineIndex +\RecordChanges +\begin{document} + \DocInput{\jobname.dtx} +\end{document} +% +% \fi +% +%\makeatletter +% +%^^A For creating examples with nice highlighting of code, and so +%^^A on; based on the system used in the listings source (lstsample). +%\lst@RequireAspects{writefile} +%\newsavebox{\LaTeXdemo@box} +%\lstnewenvironment{LaTeXdemo}[1][code and example]{^^A +% \global\let\lst@intname\@empty +% \expandafter\let\expandafter\LaTeXdemo@end +% \csname LaTeXdemo@#1@end\endcsname +% \@nameuse{LaTeXdemo@#1}^^A +%}{^^A +% \LaTeXdemo@end +%} +%\newcommand*\LaTeXdemo@new[3]{^^A +% \expandafter\newcommand\expandafter*\expandafter +% {\csname LaTeXdemo@#1\endcsname}{#2}^^A +% \expandafter\newcommand\expandafter*\expandafter +% {\csname LaTeXdemo@#1@end\endcsname}{#3}^^A +%} +%\newcommand*\LaTeXdemo@common{^^A +% \setkeys{lst}{ +% basicstyle = \small\ttfamily, +% %basewidth = 0.51em, +% frame = l, +% backgroundcolor = \color{gray!5}, +% gobble = 3, +% keywordstyle = \bfseries\color{blue}, +% language = [LaTeX]{TeX}, +% moretexcs = { +% todo , +% note , +% comment , +% fixed , +% placeholder , +% zebratodo , +% zebranote , +% zebracomment , +% zebrafixed , +% zebraplaceholder, +% zebranewnote +% } +% }^^A +%} +%\newcommand*\LaTeXdemo@input{^^A +% \MakePercentComment +% \catcode`\^^M=10\relax +% \small +% \begingroup +% \setkeys{lst}{ +% SelectCharTable=\lst@ReplaceInput{\^\^I}{\lst@ProcessTabulator} +% }^^A +% \leavevmode +% \input{\jobname.tmp}^^A +% \endgroup +% \MakePercentIgnore +%} +%\LaTeXdemo@new{code and example}{^^A +% \setbox\LaTeXdemo@box=\hbox\bgroup +% \lst@BeginAlsoWriteFile{\jobname.tmp}^^A +% \LaTeXdemo@common +%}{^^A +% \lst@EndWriteFile +% \egroup +% \begin{center} +% \ifdim\wd\LaTeXdemo@box>0.48\linewidth\relax +% \hbox to\linewidth{\box\LaTeXdemo@box\hss}^^A +% \begin{minipage}{\linewidth} +% \LaTeXdemo@input +% \end{minipage} +% \else +% \begin{minipage}{0.48\linewidth} +% \LaTeXdemo@input +% \end{minipage} +% \hfill +% \begin{minipage}{0.48\linewidth} +% \hbox to\linewidth{\box\LaTeXdemo@box\hss}^^A +% \end{minipage} +% \fi +% \end{center} +%} +%\LaTeXdemo@new{code only}{^^A +% \LaTeXdemo@common +%}{^^A +%} +% +%\providecommand*\opt[1]{\texttt{#1}} +% +%\makeatother +% +%\GetFileInfo{\jobname.sty} +% +%\changes{v0.1.0}{2017/07/05}{Initial public release} +%\changes{v0.2.0}{2017/11/26}{Fix \pkg{xcolor} conflict} +%\changes{v0.3.0}{2017/12/06}{Detect command conflicts} +%\changes{v0.4.0}{2019/06/29}{Show note number for easy reference} +%\changes{v0.5.0}{2019/06/29}{Use darker color for label} +%\changes{v0.6.0}{2019/06/30}{Use gray background for label} +% +%\title{^^A +% \pkg{zebra-goodies} --- Easy Notes Taking^^A +% \thanks{^^A +% This file describes version \fileversion, last revised +% \filedate.^^A +% }^^A +%} +%\author{^^A +% Ruini Xue\thanks{E-mail: xueruini@gmail.com}^^A +%} +%\date{Released \filedate} +% +%\maketitle +% +%\begin{abstract} +% The \pkg{zebra-goodies} package defines a collection of handy macros for +% taking notes during document writing. It is designed to be very simple and +% good enough for writing common documents independently or collaboratively. +% Several commands, \cs{todo}, \cs{comment}, \cs{note}, \cs{fixed} and +% \cs{placeholder}, are provided for quick start. It is also possible to add +% new note taking commands with \cs{zebranewnote}. +%\end{abstract} +% +%\tableofcontents +% +%\begin{documentation} +% +%\section{Introduction} +% +% There are quite a few note taking and todo packages available. However, I do +% not like the interfaces they provided. Some of them create a huge, complex +% and complicated feature set trying to fit all use cases, while others abuse +% the margin par to show too many colorful boxes and long text, even worse, some +% packages link the annotations and the original text with arrows, which results +% in a really unreadable document. +% +% So, I need a simple and good enough note taking package. With ``simple'', I +% want the commands to be intuitive and equipped with just necessary arguments. +% With ``good enough'', the document's appearance could be changed a bit to +% present the notes for easy reading but not too much. Additionally, all notes +% should be addressed once the file is in final state. As a kind reminder, a +% summary table presents the notes statistics according to note types at the end +% of the document. +% +% With these objectives in mind, \pkg{zebra-goodies} is created and improved +% along with my writing activities. Apparently, this package is designed with a +% heavy personal bias. It is not supposed to be general and perfect. +% +%\section{Installation} +% +%\changes{v0.7.0}{2019/07/01}{Move to docstrip} +% +% The package is supplied in \file{dtx} format and as a pre-extracted zip file. +% The later is most convenient for most users: simply unzip this in your local +% texmf directory and run \texttt{texhash} to update the database of file +% locations, or just unzip the files into your working directory. If you want to +% unpack the \file{dtx} yourself, running \texttt{tex \jobname.dtx} will extract +% the package whereas \texttt{latex \jobname.dtx} will extract it and also +% typeset the documentation.\footnote{Actually, \texttt{latexmk \jobname.dtx} is +% much better.} +% +%\section{Using the package} +% +% The package should be loaded as normal in the preamble. The package +% recognises a number of options, which can also be used in the document +% body. These are described later in this document. +%\begin{LaTeXdemo}[code only] +% \usepackage[]{zebra-goodies} +%\end{LaTeXdemo} +% +%\subsection{Notes Macros} +%\begin{function}{\todo} +% \begin{syntax} +% \cs{todo}\oarg{name}\marg{note content} +% \end{syntax} +%\end{function} +% +% The basic function provided by \pkg{zebra-goodies} is the \cs{todo} macro. +% This is used to insert a piece of \texttt{todo} note right here, taking a +% mandatory argument, the \meta{note content} of the \texttt{todo}, and an +% optional argument, the \meta{name} who should be responsible for this note. +% For example, the author wants \meta{name} to address this todo. This is very +% helpful during collaboration. The todo note will be typesetted in a +% predefined color and quoted in the current paragraph along with the famous +% symbol in margin par. +% +% \begin{LaTeXdemo} +% A very simple example of a todo note \todo{how should we go to the lake?}, +% and the result will be presented right below the code snippet. Please +% compare the code and the result. +% \end{LaTeXdemo} +% +% And, the following example shows how to set the assignees: +% +% \begin{LaTeXdemo} +% Another one with an assignee is like \todo[tom]{you should buy the ticket}, +% and you will find the same type of notes are numbered. And the assignees are +% being \texttt{@}-ed right before the text. And another one with many +% assignees \todo[lucy,jessie]{prepare the foo}. +% \end{LaTeXdemo} + +% Since \pkg{zebra-goodies} uses running texts, so \cs{todo} also works in +% title macros like \cs{section} and \cs{caption}. +% +% \begin{LaTeXdemo}[code only] +% \section{Introduction\todo[jerry]{please figure out a better name}} +% \begin{figure} +% \centering +% \caption{Speed vs distance. \todo[need to insert the figure]} +% \end{figure} +% \end{LaTeXdemo} +% +%\begin{function}{\note} +% \begin{syntax} +% \cs{note}\oarg{name}\marg{note text} +% \end{syntax} +%\end{function} +%\begin{function}{\comment} +% \begin{syntax} +% \cs{comment}\oarg{name}\marg{comment text} +% \end{syntax} +%\end{function} +%\begin{function}{\fixed} +% \begin{syntax} +% \cs{fixed}\oarg{name}\marg{fixed text} +% \end{syntax} +%\end{function} +%\begin{function}{\placeholder} +% \begin{syntax} +% \cs{placeholder}\oarg{name}\marg{placeholder text} +% \end{syntax} +%\end{function} +% All these commands share the same syntax as \cs{todo}, so do the behaviour. +% They are defined just for convenience for different cases. Nothing magic are +% behind. +% +% If any of them does not work, it is very likely that they are defined by +% other packages. In order to avoid unnecessary confusion, \cs{zebra-goodies} +% will not \cs{renewcommand} them in case they are defined. So, it comes to +% their internal counterparts. +% \begin{LaTeXdemo} +% A very simple example of a todo note \note{how should we go to the lake?} +% and another one with an assignee is like \zebracomment[tom]{you should buy +% the ticket}. As you noticed, \cs{zebracomment} is used instead \cs{comment} +% here is because \cs{comment} has been defined by \pkg{l3doc}. Let's move on +% to other macros. and another one with many assignees +% \placeholder[lucy,jessie]{prepare the foo} and the issue has been +% \fixed[John]{good job!}. We'd like to add more lines to separate the bend +% symbols. Finally, let's try to use the full version like this, I am going +% to add a \todo{a new todo} and a extended note to be put in another line +% with useless words as you known like this, this and that and eventually we +% come to the \note[who]{note}. +% \end{LaTeXdemo} +% +% With these macros, it is very simple to good enough for note taking. +% +%\begin{function}{\zebratodo} +% \begin{syntax} +% \cs{zebratodo}\oarg{name}\marg{note text} +% \end{syntax} +% +% \cs{todo} will not be defined if it has been defined by other packages, +% please use its internal alias, \cs{zebratodo}. This is how the other notes +% macros are defined. +%\end{function} +%\begin{function}{\zebranote} +% \begin{syntax} +% \cs{zebranote}\oarg{name}\marg{note text} +% \end{syntax} +%\end{function} +%\begin{function}{\zebracomment} +% \begin{syntax} +% \cs{zebracomment}\oarg{name}\marg{comment text} +% \end{syntax} +%\end{function} +%\begin{function}{\zebrafixed} +% \begin{syntax} +% \cs{zebrafixed}\oarg{name}\marg{fixed text} +% \end{syntax} +%\end{function} +%\begin{function}{\zebraplaceholder} +% \begin{syntax} +% \cs{zebraplaceholder}\oarg{name}\marg{placeholder text} +% \end{syntax} +%\end{function} +% +%\begin{function}{\zebranewnote} +% \begin{syntax} +% \cs{zebranewnote}\marg{note name}\marg{xcolor color spec} +% \end{syntax} +% You will eventually need a new note type for whatever reasons. +% \cs{zebranewnote} needs two arguments to create a new note type. \meta{note +% name} will be used as the note's macro as \cs{todo}, while the \meta{xcolor +% color spec} defines in what color the new note show be. The color is defined +% with \pkg{xcolor}. +% \begin{LaTeXdemo} +% % \zebranewnote{question}{red!80} +% +% When it moves to the next step, we should be fine. %\question[who]{what's this?} +% \end{LaTeXdemo} +%\end{function} +% +%\subsection{Package Options} +% +%\DescribeOption{draft} +%\DescribeOption{final} + +% These two options are complementary to each other. When no explicit mode is +% given, \opt{draft} is \texttt{true}, in which case all notes will be +% typesetted as well as the the summary table at end of the document. By setting +% \opt{draft} to \texttt{false} or \opt{final}, notes will not be presented. +% +%\DescribeOption{microtype} +% Enable the great \pkg{microtype} package or not. Default: \texttt{true}. I +% personally love this package very much. +% +%\section{Predefined Colors} +% +% This is for personal use. I often use \pkg{pgfplots} to create plots, however, +% I do not like the default color. So several are define: +% \begin{itemize} +% \item \texttt{zebrablue} +% \item \texttt{zebrared} +% \item \texttt{zebrayellow} +% \item \texttt{zebrapurple} +% \item \texttt{zebragreen} +% \end{itemize} +% +%\end{documentation} +% +%\begin{implementation} +% +%\section{Implementation} +% +% \begin{macrocode} +%<*package> +% \end{macrocode} +% +% \begin{macrocode} +%<@@=zebra_goodies> +% \end{macrocode} +% +% Version data to start with. +% \begin{macrocode} +\ProvidesPackage{zebra-goodies} +[2019/07/01 0.7.0 Easy Notes Taking] +%\ProvidesExplPackage{zebra-goodies}{2019/07/01}{0.7.0}{Easy Notes Taking} +% \end{macrocode} +% +%\subsection{Package options} +% +% Two package options \opt{draft} and \opt{microtype} are created. +% \begin{macrocode} +\RequirePackage{kvoptions} +\SetupKeyvalOptions{ + family=zebra, + prefix=zebr@, + setkeys=\kvsetkeys} +\DeclareBoolOption{draft} +\DeclareComplementaryOption{final}{draft} +\DeclareBoolOption{microtype} +\setkeys{zebra}{draft,microtype} +\ProcessKeyvalOptions{zebra} +\ifzebr@microtype + \RequirePackage{microtype} +\fi +\RequirePackage{xcolor} +\RequirePackage{tikzpagenodes} +\RequirePackage{marginnote} +\@ifundefined{dbend}{\RequirePackage{manfnt}}{} +% \end{macrocode} +% +% \subsection{Main notes macros} +% Various helper macros are defined before reaching out to the \cs{todo} commands. +% +% First, the margin note code is from +% \href{http://tex.stackexchange.com/questions/247449/making-marginnote-to-appear-either-side-of-twocolumn-twoside-document-part-ii}{StackExchage.com} with a bit modification. +% \begin{macrocode} +\newlength{\zebr@tempdima} +\newcount{\zebr@tikzpage} +\newcommand*{\zebr@marginnote}[1]{% + \begin{tikzpicture}[remember picture, overlay]% + \pgfextractx{\zebr@tempdima}{\pgfpointanchor{current page text area}{center}}% + \global\zebr@tempdima=\zebr@tempdima + \global\zebr@tikzpage=\oddpage@page + \end{tikzpicture}% + \begingroup + \ifdim\zebr@tempdima>0pt \reversemarginpar\fi + \marginnote{#1}% + \endgroup% resets \reversemarginpar +} +% \end{macrocode} +% +% Then, two meta macros are used to create new types of note. +% \begin{macrocode} +\def\zebr@note{% + \ifzebr@draft\expandafter\zebr@note@\else\expandafter\@gobblefour\fi} +% \end{macrocode} +% +% \cs{zebr@note@} is the core macro to typeset the note. The syntax is: +% \begin{syntax} +% \cs{zebr@note@}\marg{note name}\marg{color}\marg{assignee}\marg{note text} +% \end{syntax} +% \begin{macrocode} +\newcommand{\zebr@note@}[4]{% + \zebr@marginnote{\textcolor{#2}{\dbend}}% + \expandafter\stepcounter{zebr@num@#1}% + \textcolor{#2}{[\colorbox[gray]{0.97}{% + \textcolor{#2!70!black}{% + \textsc{\MakeLowercase{\MakeUppercase#1}} + {\expandafter\csname thezebr@num@#1\endcsname}\texttt{#3}:}} #4]}} +\newcommand{\zebr@prepend}[2]{% + \ifx\relax#2\relax\relax\else#1#2\fi} +% \end{macrocode} +% +% \begin{macro}{\zebranewnote} +% All note types are created with \cs{zebranewnote}. +% \begin{macrocode} +\global\def\zebr@noteslist{} +\def\zebranewnote#1#2{% + \g@addto@macro\zebr@noteslist{,#1}% + \expandafter\newcounter\expandafter{zebr@num@#1} + \expandafter\newcommand\csname zebr@color@#1\endcsname{#2} + \expandafter\newcommand\csname zebra#1\endcsname[2][]{% + \zebr@note{#1}{#2}{\zebr@prepend{@}{##1}}{##2}} + \@ifundefined{#1}{% + \expandafter\def\csname #1\endcsname{\csname zebra#1\endcsname}}{% + \PackageWarning{zebra}{'\textbackslash{#1}' has been taken. + Use '\textbackslash{zebra#1}' instead.}}} +% \end{macrocode} +% \end{macro} +% +% \begin{macro}{\todo} +% \begin{macro}{\note} +% \begin{macro}{\fixed} +% \begin{macro}{\comment} +% \begin{macro}{\placeholder} +% They are defined with \cs{zebranewnote}. The colors are picked up from the default +% ones from \pkg{xcolor}. +% \begin{macrocode} +\zebranewnote{todo}{purple} +\zebranewnote{fixed}{teal} +\zebranewnote{comment}{blue} +\zebranewnote{note}{violet} +\zebranewnote{placeholder}{gray} +% \end{macrocode} +% \end{macro} +% \end{macro} +% \end{macro} +% \end{macro} +% \end{macro} +% +%\subsection{Print summary at end of the document} +% +% A summary table will be inserted automatically at end of the document for easy +% checking. Each note type is presend in a line with its associated color. +% +% \begin{macrocode} +\def\zebr@listnotes{% + \ifzebr@draft\zebr@listnotes@\fi} +\def\zebr@listnotes@{% + \def\temp@a{} + \edef\temp@noteslist{\expandafter\@gobble\zebr@noteslist} + \@for\temp@b:=\temp@noteslist\do{% + \expandafter\ifnum\expandafter\value\expandafter{zebr@num@\temp@b} > 0% + \def\temp@c{\expandafter\csname thezebr@num@\temp@b\endcsname} + \edef\temp@d{\noexpand\textcolor{% + \expandafter\csname zebr@color@\temp@b\endcsname}{\temp@b}% + \noexpand & \temp@c\noexpand\\} + \expandafter\g@addto@macro\expandafter\temp@a\expandafter{\temp@d}% + \fi} + \ifx\temp@a\@empty\else% + \noindent\dotfill\par + \section*{Zebra Notes} + \par \medskip + \begin{center} + \begin{tabular}{lr} + \hline + \textbf{Type} & \textbf{Number} \\\hline + \temp@a + \hline + \end{tabular} + \end{center} + \fi} +\AtEndDocument{\zebr@listnotes} +% \end{macrocode} +% +%\subsection{Personal Colors} +%\label{sec:colors} +% For colors are defined for plots. +% \begin{macrocode} +\definecolor{zebrablue}{HTML}{4F81BD} +\definecolor{zebrared}{HTML}{C0504D} +\definecolor{zebragreen}{HTML}{9BBB00} +\definecolor{zebrapurple}{HTML}{9F4C7C} +\definecolor{zebrayellow}{HTML}{D9CD2E} +\definecolor{zebragreen2}{HTML}{00E000} +% \end{macrocode} +% \begin{macrocode} +% +% \end{macrocode} +% +%\end{implementation} +% +%\PrintChanges +%\PrintIndex diff --git a/Master/texmf-dist/source/latex/zebra-goodies/zebra-goodies.ins b/Master/texmf-dist/source/latex/zebra-goodies/zebra-goodies.ins new file mode 100644 index 00000000000..ecb73c4a3dc --- /dev/null +++ b/Master/texmf-dist/source/latex/zebra-goodies/zebra-goodies.ins @@ -0,0 +1,57 @@ +%% +%% This is file `zebra-goodies.ins', +%% generated with the docstrip utility. +%% +%% The original source files were: +%% +%% zebra-goodies.dtx (with options: `install') +%% Copyright (C) 2016-2019, Ruini Xue +%% +%% It may be distributed and/or modified under the conditions of +%% the LaTeX Project Public License (LPPL), either version 1.3c of +%% this license or (at your option) any later version. The latest +%% version of this license is in the file: +%% +%% http://www.latex-project.org/lppl.txt +\input l3docstrip.tex +\keepsilent +\askforoverwritefalse +\preamble +Copyright (C) 2016-2019, Ruini Xue + +It may be distributed and/or modified under the conditions of +the LaTeX Project Public License (LPPL), either version 1.3c of +this license or (at your option) any later version. The latest +version of this license is in the file: + + http://www.latex-project.org/lppl.txt +\endpreamble +\postamble + +This work is "maintained" (as per LPPL maintenance status) by + Ruini Xue. + +This work consists of the file zebra-goodies.dtx + and the derived files zebra-goodies.ins, + zebra-goodies.pdf and + zebra-goodies.sty. + +\endpostamble +\usedir{tex/latex/zebra-goodies} +\generate{ + \file{\jobname.sty}{\from{\jobname.dtx}{package}} +} +\endbatchfile + + +%% +%% This work is "maintained" (as per LPPL maintenance status) by +%% Ruini Xue. +%% +%% This work consists of the file zebra-goodies.dtx +%% and the derived files zebra-goodies.ins, +%% zebra-goodies.pdf and +%% zebra-goodies.sty. +%% +%% +%% End of file `zebra-goodies.ins'. diff --git a/Master/texmf-dist/tex/latex/zebra-goodies/zebra-goodies.sty b/Master/texmf-dist/tex/latex/zebra-goodies/zebra-goodies.sty index 02275880605..cc73bb12415 100644 --- a/Master/texmf-dist/tex/latex/zebra-goodies/zebra-goodies.sty +++ b/Master/texmf-dist/tex/latex/zebra-goodies/zebra-goodies.sty @@ -1,44 +1,41 @@ -%% Copyright (C) 2017-2019 by Ruini Xue %% -%% This file may be distributed and/or modified under the -%% conditions of the LaTeX Project Public License, either version 1.3a -%% of this license or (at your option) any later version. -%% The latest version of this license is in: +%% This is file `zebra-goodies.sty', +%% generated with the docstrip utility. %% -%% http://www.latex-project.org/lppl.txt +%% The original source files were: %% -%% and version 1.3c or later is part of all distributions of LaTeX -%% version 2008/05/04 or later. -\ProvidesPackage{zebra-goodies}[2019/06/30 0.6.0 LaTeX goodies for paper writing.] +%% zebra-goodies.dtx (with options: `package') +%% Copyright (C) 2016-2019, Ruini Xue +%% +%% It may be distributed and/or modified under the conditions of +%% the LaTeX Project Public License (LPPL), either version 1.3c of +%% this license or (at your option) any later version. The latest +%% version of this license is in the file: +%% +%% http://www.latex-project.org/lppl.txt + +\ProvidesPackage{zebra-goodies} +[2019/07/01 0.7.0 Easy Notes Taking] \RequirePackage{kvoptions} \SetupKeyvalOptions{ family=zebra, prefix=zebr@, setkeys=\kvsetkeys} \DeclareBoolOption{draft} +\DeclareComplementaryOption{final}{draft} \DeclareBoolOption{microtype} \setkeys{zebra}{draft,microtype} \ProcessKeyvalOptions{zebra} - -% comment this if you do not need. \ifzebr@microtype \RequirePackage{microtype} \fi \RequirePackage{xcolor} \RequirePackage{tikzpagenodes} \RequirePackage{marginnote} -\RequirePackage{manfnt} - -%%%%%%%%%%%%%%%%%% -% zebra-note -%%%%%%%%%%%%%%%%%% - -% From: http://tex.stackexchange.com/questions/247449/making-marginnote-to-appear-either-side-of-twocolumn-twoside-document-part-ii -% I did a little edit. +\@ifundefined{dbend}{\RequirePackage{manfnt}}{} \newlength{\zebr@tempdima} \newcount{\zebr@tikzpage} - \newcommand*{\zebr@marginnote}[1]{% \begin{tikzpicture}[remember picture, overlay]% \pgfextractx{\zebr@tempdima}{\pgfpointanchor{current page text area}{center}}% @@ -50,42 +47,44 @@ \marginnote{#1}% \endgroup% resets \reversemarginpar } - \def\zebr@note{% \ifzebr@draft\expandafter\zebr@note@\else\expandafter\@gobblefour\fi} - -% #1: note name -% #2: color -% #3: assignee -% #4: note text \newcommand{\zebr@note@}[4]{% \zebr@marginnote{\textcolor{#2}{\dbend}}% \expandafter\stepcounter{zebr@num@#1}% - \textcolor{#2}{[\colorbox[gray]{0.97}{\textcolor{#2!70!black}{\textsc{\MakeLowercase{\MakeUppercase#1}} {\expandafter\csname thezebr@num@#1\endcsname}\texttt{#3}:}} #4]}} - + \textcolor{#2}{[\colorbox[gray]{0.97}{% + \textcolor{#2!70!black}{% + \textsc{\MakeLowercase{\MakeUppercase#1}} + {\expandafter\csname thezebr@num@#1\endcsname}\texttt{#3}:}} #4]}} \newcommand{\zebr@prepend}[2]{% \ifx\relax#2\relax\relax\else#1#2\fi} - \global\def\zebr@noteslist{} \def\zebranewnote#1#2{% \g@addto@macro\zebr@noteslist{,#1}% \expandafter\newcounter\expandafter{zebr@num@#1} \expandafter\newcommand\csname zebr@color@#1\endcsname{#2} - \expandafter\newcommand\csname zebra#1\endcsname[2][]{% we suppose it is not defined yet + \expandafter\newcommand\csname zebra#1\endcsname[2][]{% \zebr@note{#1}{#2}{\zebr@prepend{@}{##1}}{##2}} - \@ifundefined{#1}{\expandafter\def\csname #1\endcsname{\csname zebra#1\endcsname}}{% - \PackageWarning{zebra}{'\textbackslash{#1}' has been taken. Use '\textbackslash{zebra#1}' instead.}}} - + \@ifundefined{#1}{% + \expandafter\def\csname #1\endcsname{\csname zebra#1\endcsname}}{% + \PackageWarning{zebra}{'\textbackslash{#1}' has been taken. + Use '\textbackslash{zebra#1}' instead.}}} +\zebranewnote{todo}{purple} +\zebranewnote{fixed}{teal} +\zebranewnote{comment}{blue} +\zebranewnote{note}{violet} +\zebranewnote{placeholder}{gray} \def\zebr@listnotes{% \ifzebr@draft\zebr@listnotes@\fi} - \def\zebr@listnotes@{% \def\temp@a{} \edef\temp@noteslist{\expandafter\@gobble\zebr@noteslist} \@for\temp@b:=\temp@noteslist\do{% \expandafter\ifnum\expandafter\value\expandafter{zebr@num@\temp@b} > 0% \def\temp@c{\expandafter\csname thezebr@num@\temp@b\endcsname} - \edef\temp@d{\noexpand\textcolor{\expandafter\csname zebr@color@\temp@b\endcsname}{\temp@b} \noexpand & \temp@c\noexpand\\} + \edef\temp@d{\noexpand\textcolor{% + \expandafter\csname zebr@color@\temp@b\endcsname}{\temp@b}% + \noexpand & \temp@c\noexpand\\} \expandafter\g@addto@macro\expandafter\temp@a\expandafter{\temp@d}% \fi} \ifx\temp@a\@empty\else% @@ -99,27 +98,23 @@ \temp@a \hline \end{tabular} - \par \medskip - \textbf{Do fix all of them before submitting.} \end{center} \fi} - \AtEndDocument{\zebr@listnotes} - -\zebranewnote{todo}{purple} -\zebranewnote{fixed}{teal} -\zebranewnote{comment}{blue} -\zebranewnote{note}{violet} -\zebranewnote{placeholder}{gray} - -%%%%%%%%%%%%%% -% zebra-color -%%%%%%%%%%%%%% \definecolor{zebrablue}{HTML}{4F81BD} \definecolor{zebrared}{HTML}{C0504D} \definecolor{zebragreen}{HTML}{9BBB00} \definecolor{zebrapurple}{HTML}{9F4C7C} \definecolor{zebrayellow}{HTML}{D9CD2E} \definecolor{zebragreen2}{HTML}{00E000} - -\endinput +%% +%% This work is "maintained" (as per LPPL maintenance status) by +%% Ruini Xue. +%% +%% This work consists of the file zebra-goodies.dtx +%% and the derived files zebra-goodies.ins, +%% zebra-goodies.pdf and +%% zebra-goodies.sty. +%% +%% +%% End of file `zebra-goodies.sty'. -- cgit v1.2.3