summaryrefslogtreecommitdiff
path: root/Master/texmf-dist
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2024-04-19 21:07:19 +0000
committerKarl Berry <karl@freefriends.org>2024-04-19 21:07:19 +0000
commit17b51d21a50c06223a80b428679b12a819d36c58 (patch)
tree738bf9aa910c8bcb103e401632026c4e4e0ccd8f /Master/texmf-dist
parent6687c7935b7c80b4940fad16987fe8a04110eca4 (diff)
fadingimage (19apr24)
git-svn-id: svn://tug.org/texlive/trunk@71001 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist')
-rw-r--r--Master/texmf-dist/doc/latex/fadingimage/README.md6
-rw-r--r--Master/texmf-dist/doc/latex/fadingimage/fadingimage.pdfbin228555 -> 138677 bytes
-rw-r--r--Master/texmf-dist/doc/latex/fadingimage/fadingimage.tex69
-rw-r--r--Master/texmf-dist/tex/latex/fadingimage/fadingimage.sty42
4 files changed, 56 insertions, 61 deletions
diff --git a/Master/texmf-dist/doc/latex/fadingimage/README.md b/Master/texmf-dist/doc/latex/fadingimage/README.md
index 7140d126e3e..d62c0a6078c 100644
--- a/Master/texmf-dist/doc/latex/fadingimage/README.md
+++ b/Master/texmf-dist/doc/latex/fadingimage/README.md
@@ -1,9 +1,9 @@
-# The `FadingImage` package
+# The `fadingimage` package
-This package provides two commands for adding fading full width picture at the top or bottom of a page.
+This package provides three commands for adding fading full width picture at the top or bottom of a page.
**Welcome to pull requests
-[here](https://github.com/xiamyphys/FadingImage).**
+[here](https://github.com/xiamyphys/fadingimage).**
## License
diff --git a/Master/texmf-dist/doc/latex/fadingimage/fadingimage.pdf b/Master/texmf-dist/doc/latex/fadingimage/fadingimage.pdf
index f0e81ecf62a..85856e112f2 100644
--- a/Master/texmf-dist/doc/latex/fadingimage/fadingimage.pdf
+++ b/Master/texmf-dist/doc/latex/fadingimage/fadingimage.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/fadingimage/fadingimage.tex b/Master/texmf-dist/doc/latex/fadingimage/fadingimage.tex
index 043d13b1294..2aa6637e950 100644
--- a/Master/texmf-dist/doc/latex/fadingimage/fadingimage.tex
+++ b/Master/texmf-dist/doc/latex/fadingimage/fadingimage.tex
@@ -1,60 +1,55 @@
-\documentclass[11pt]{article}
-\usepackage{geometry,indentfirst,titlesec,authblk,hyperref}
+\documentclass[11pt,svgnames]{article}
+\usepackage{geometry,titlesec,authblk,hyperref,hologo}
\titleformat*{\section}{\bfseries\large}
-\usepackage{datetime}
-\usepackage[libertine,mono=false]{libertine}
+\hologoFontSetup{general=\sffamily}
+\usepackage{datetime}\yyyymmdddate
+\usepackage[libertine,mono=false]{newtx}
\usepackage{fadingimage}
-\hypersetup{colorlinks,urlcolor=moducolor}
-\definecolor{pkgcolor}{Hsb}{103,.8,.5}
-\definecolor{moducolor}{Hsb}{290,.8,.5}
-\definecolor{cmdcolor}{Hsb}{188,.8,.5}
-\def\pkg#1{\texorpdfstring{\textcolor{pkgcolor}{
- \href{https://ctan.org/pkg/#1}{\textsf{#1}}}}{“#1”}}
-\def\mode#1{\texorpdfstring{\textcolor{moducolor}{\textsf{#1}}}{“#1”}}
-\def\cmd#1{\texorpdfstring{\textcolor{cmdcolor}{\textsf{#1}}}{“#1”}}
-\def\datechange#1#2{%
- \noindent{\makebox[\textwidth][r]{\color{H7}\rule{1.15\textwidth}{.4pt}}}
- \noindent\makebox[0pt][r]{\makebox[-3em][r]{\small\textbf{\textcolor{H7}{#1}}}\;\;}{\sffamily Update: \ignorespaces#2}}
-
-\title{\bfseries The \pkg{FadingImage} Package}
-\author{Hsia Mingyu, \href{https://www.hdu.edu.cn}{Hangzhou Dianzi University}}
-\yyyymmdddate\date{\today}
-\affil{\href{mailto:xiamyphys@gmail.com}{\ttfamily xiamyphys@gmail.com}}
-\date{\today\quad Version 0.1d\thanks{\url{https://github.com/xiamyphys/FadingImage}}}
-\begin{document}
+\hypersetup{colorlinks,urlcolor=MidnightBlue}
+\def\pkg#1{\textcolor{DarkGreen}{\textsf{#1}}}
+\def\mode#1{\textcolor{Indigo}{\textsf{#1}}}
+\def\cmd#1{\textcolor{MidnightBlue}{\texttt{\string#1}}}
+
+\title{\bfseries The \pkg{fadingimage} Package}
+\author{Mingyu Hsia, \href{mailto:xiamyphys@gmail.com}{\ttfamily xiamyphys@gmail.com}}
+\affil{Hangzhou Dianzi University}
+\date{\today\quad Version 0.2a\thanks{\url{https://github.com/xiamyphys/fadingimage}}}
+\begin{document}
\maketitle
\UPFadingImage[trim={0 {.96\paperheight} 0 0},clip]{Beautiful-realities}
\LOWFadingImage[trim={0 0 0 {.96\paperheight}},clip]{Beautiful-realities}
\vspace{-6ex}
\begin{abstract}
-This is \textsf{\textbf{not only the document but also the demo}} for the \pkg{FadingImage} package, which provides three commands for adding fading full width picture at the top, bottom or both of them on a page. And this package is used for my template \pkg{LiteBook} and \pkg{LiteSolution}.
+
+This is \textsf{\textbf{not only the document but also the demo}} for the \pkg{fadingimage} package, which provides three commands for adding fading full width picture at the top, bottom or both of them on a page. This package is contained in the \pkg{LiteBook} and \pkg{LiteSolution} class.
+
+Welcome to feedback bugs or ideas via email \href{mailto:xiamyphys@gmail.com}{\ttfamily xiamyphys@gmail.com} or \href{https://github.com/xiamyphys/fadingimage}{GitHub}.
+
\end{abstract}
-\section{The purpose of this package}
-This package provides three commands for adding fading full width picture at the top or bottom of a page. Welcome to feedback bugs or ideas via email \href{mailto:xiamyphys@gmail.com}{\ttfamily xiamyphys@gmail.com} or \href{https://github.com/xiamyphys/fadingimage}{GitHub}.
+\section{Installing \pkg{fadingimage} and loading it}
This package requires \pkg{tikz} package to node images and \pkg{fading} library to support fading image.
-\section{Loading \pkg{FadingImage}}
-I strongly advise you to use terminal/cmd to implement the commands to update all the packages (and install this package) to the latest version or switch to portable version instead
+Simply download \verb|fadingimage.cls| file from \href{https://github.com/xiamyphys/fadingimage}{GitHub} or \href{https://ctan.org/pkg/fadingimage}{CTAN} and save it under your working directory. However, I strongly suggest to use terminal to install and update all packages to the latest version
+
\begin{verbatim}
- sudo tlmgr update --self --all
+ sudo tlmgr update --self --all
\end{verbatim}
+To learn more, please refer to \href{https://tex.stackexchange.com/questions/55437/how-do-i-update-my-tex-distribution}{How do I update my \hologo{TeX} distribution?}
+
\section{Commands \cmd{UPFadingImage}, \cmd{LOWFadingImage} and \cmd{UPLOWFadingImage}}
-\begin{small}
-\begin{verbatim}
- \UPFadingImage [<keyval list>]{<file>} \LOWFadingImage[<keyval list>]{<file>}
- \UPFadingImage [<keyval list>]{<file>} [<keyval list>]{<file>}
-\end{verbatim}
-\end{small}
-The first two commands all have 2 variables and the first one is optional. The second variable of the commands can assign the image that you want to insert, and the first one can assign the parameters of command \cmd{includegraphics}, such as clip to the inserted image.
+\begin{small}\begin{verbatim}
+ \UPFadingImage [<keyval list>]{<file>} \LOWFadingImage[<keyval list>]{<file>}
+ \UPLOWFadingImage[<keyval list>]{<file>}[<keyval list>]{<file>}
+\end{verbatim}\end{small}
-The third command is a combination of the first two commands and it will call the \cmd{tikz} environment for only once time to reduce compile time.
+The first two commands all have 2 variables and the first one is optional. The second variable of the commands can assign the image that you want to insert, and the first one can assign the parameters of command \cmd{includegraphics}, such as clip to the inserted image.
-If a star (*) is added after the commands (such as \verb|\UPFadingImage*[...]{...}|), then the image you inserted won't be faded.
+The third command is just a combination of the first two commands. If a star (*) is added after the commands above, the image you inserted won't be faded.
\end{document} \ No newline at end of file
diff --git a/Master/texmf-dist/tex/latex/fadingimage/fadingimage.sty b/Master/texmf-dist/tex/latex/fadingimage/fadingimage.sty
index 2b63cf0cbe9..6cfceced3bb 100644
--- a/Master/texmf-dist/tex/latex/fadingimage/fadingimage.sty
+++ b/Master/texmf-dist/tex/latex/fadingimage/fadingimage.sty
@@ -1,24 +1,25 @@
-%% ****************************************************************************************************
-%% Copyright 2024 by Mingyu Hsia <xiamyphys@gmail.com> *
-%% *
-%% This work may be distributed and/or modified under * ***** * * *
-%% the conditions of the LaTeX Project Public License * ** * * *** * * *
-%% * * ** * * * ** *
-%% http://www.latex-project.org/lppl.txt * * * * ***** ** *
-%% * * ** * * * * *
-%% either version 1.3c of this license or any later ***** ** * * *** * * *
-%% version. *
-%% *
-%% This work has the LPPL maintenance status `maintained'. *
-%% *
-%% The Current Maintainer of this work is Mingyu Hsia. *
-%% *
-%% This work consists of the files fadingimage.sty, *
-%% and README.md. *
-%% available at https://github.com/xiamyphys/FadingImage *
-%% ****************************************************************************************************
+%% ***********************************************************
+%% Copyright 2024 by Mingyu Hsia <xiamyphys@gmail.com> *
+%% *
+%% This work may be distributed and/or modified under *
+%% the conditions of the LaTeX Project Public License *
+%% *
+%% http://www.latex-project.org/lppl.txt *
+%% *
+%% either version 1.3c of this license or any later *
+%% version. *
+%% *
+%% This work has the LPPL maintenance status `maintained'. *
+%% *
+%% The Current Maintainer of this work is Mingyu Hsia. *
+%% *
+%% This work consists of the files fadingimage.cls, *
+%% and README.md. *
+%% available at https://github.com/xiamyphys/fadingimage *
+%% ***********************************************************
+% !Mode:: "TeX:UTF-8"
\NeedsTeXFormat{LaTeX2e}[2020/10/01]
-\ProvidesPackage{fadingimage}[2024/03/17/ v0.1d Package for adding fading full width picture at the top or bottom of a page.]
+\ProvidesPackage{fadingimage}[2024/04/19/ v0.2a Package for adding fading full width picture at the top and bottom of a page.]
\RequirePackage{tikz,xcolor}
\usetikzlibrary{fadings}
@@ -32,7 +33,6 @@
\node[scope fading=south,below,inner sep=0pt,outer sep=auto] at (current page.north) {\includegraphics[width=\paperwidth,#2]{#3}};
}
}
-
\NewDocumentCommand{\LOWFadingImage}{ s O{} m }{
\IfBooleanTF{#1}
{