texlive[74635] Master/texmf-dist: callouts-box (15mar25)
commits+karl at tug.org
commits+karl at tug.org
Sat Mar 15 20:56:49 CET 2025
Revision: 74635
https://tug.org/svn/texlive?view=revision&revision=74635
Author: karl
Date: 2025-03-15 20:56:49 +0100 (Sat, 15 Mar 2025)
Log Message:
-----------
callouts-box (15mar25)
Modified Paths:
--------------
trunk/Master/texmf-dist/doc/latex/callouts-box/README.md
trunk/Master/texmf-dist/doc/latex/callouts-box/callouts-box.pdf
trunk/Master/texmf-dist/source/latex/callouts-box/callouts-box.dtx
trunk/Master/texmf-dist/tex/latex/callouts-box/callouts-box-colors.sty
trunk/Master/texmf-dist/tex/latex/callouts-box/callouts-box.sty
Modified: trunk/Master/texmf-dist/doc/latex/callouts-box/README.md
===================================================================
--- trunk/Master/texmf-dist/doc/latex/callouts-box/README.md 2025-03-15 19:56:33 UTC (rev 74634)
+++ trunk/Master/texmf-dist/doc/latex/callouts-box/README.md 2025-03-15 19:56:49 UTC (rev 74635)
@@ -1,8 +1,8 @@
# The `callouts-box` Package
-## Version 1.0
-**Date:** 2025/02/14
-**Author:** julinux60
+## Version 1.1
+**Date:** 2025/03/14
+**Author:** Julien Dujardin
## Table of Contents
1. [Introduction](#introduction)
@@ -99,71 +99,27 @@
### Customization
Users can modify the visual appearance of callout boxes by editing `callouts-box-colors.sty` or overriding the `tcbset` settings in their document.
-
+More documentation can be found at : https://ctan.org/pkg/tcolorbox.
To adjust layout settings, use the `tcbset` command:
```latex
+{
\tcbset{
boxsettings/.style={
- boxrule=2pt, rounded corners=10pt, arc=10pt,
+ boxrule=2pt, arc=20pt,
left=10pt, right=10pt, top=10pt, bottom=10pt,
boxsep=10pt, before skip=15pt, after skip=15pt,
breakable, before upper={\ignorespaces},
+ boxrule=2pt, arc=8pt,
+ colframe=black, colback=yellow!10,
}
}
-```
-## Defining Custom Boxes
-You can define your own callout box styles using `NewTColorBox`. Example:
-
-```latex
-\definecolor{custom-border}{HTML}{FFA500}
-\definecolor{custom-content}{HTML}{FFF3E0}
-\definecolor{custom-text}{HTML}{FF6D00}
-
-\NewTColorBox{custombox}{ O{Custom Box} o }{
- colframe=custom-border,
- colback=custom-content,
- coltitle=custom-text,
- fonttitle=\bfseries,
- coltext=custom-text,
- title={#1},
+\begin{notebox}[Style Note]
+ Style Note
+\end{notebox}
}
```
-To use the custom box:
-
-```latex
-\begin{custombox}[My Custom Box]
- This is a custom box.
-\end{custombox}
-```
-
-## Complete Example
-Here is a complete document using the `callouts-box` package:
-
-```latex
-\documentclass{article}
-\usepackage{callouts-box}
-
-\begin{document}
-
-\begin{warningbox}[Warning]
- This is a warning message.
-\end{warningbox}
-
-\begin{successbox}[Success]
- This is a success message.
-\end{successbox}
-
-\begin{notebox}[Math Example]
- \[
- E = mc^2
- \]
-\end{notebox}
-
-\end{document}
-```
-
## License
-This package is distributed under the LaTeX Project Public License (LPPL), version 1.3 or later. For more details, see the `LICENSE` file.
+This package is distributed under the LaTeX Project Public License (LPPL), version 1.3 or later. For more details, see the `LICENSE` file.
\ No newline at end of file
Modified: trunk/Master/texmf-dist/doc/latex/callouts-box/callouts-box.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/source/latex/callouts-box/callouts-box.dtx
===================================================================
--- trunk/Master/texmf-dist/source/latex/callouts-box/callouts-box.dtx 2025-03-15 19:56:33 UTC (rev 74634)
+++ trunk/Master/texmf-dist/source/latex/callouts-box/callouts-box.dtx 2025-03-15 19:56:49 UTC (rev 74635)
@@ -6,15 +6,16 @@
%<*driver>
\documentclass{ltxdoc}
\usepackage{makeidx}
+\usepackage{callouts-box}
\makeindex
\begin{document}
\title{The \texttt{callouts-box} Package\\
\smallskip
-\small Version 1.0\\
-\small Date: 2025/02/14}
-\author{julinux60}
-\date{14/02/2025}
+\small Version 1.1\\
+\small Date: 2025/03/14}
+\author{Julien Dujardin}
+\date{14/03/2025}
\maketitle
\tableofcontents
@@ -22,6 +23,10 @@
\section{Introduction}
The \texttt{callouts-box} package provides a collection of visually appealing, structured callout boxes for \LaTeX{} documents. These boxes are useful for highlighting important information such as warnings, errors, notes, and success messages. The package is built on top of \texttt{tcolorbox} for highly customizable, breakable callout boxes and \texttt{xcolor} for predefined color schemes.
+\begin{notebox}[Note]
+This package simplifies the creation of callout boxes in \LaTeX{} documents, making them more readable and visually structured.
+\end{notebox}
+
\section{Installation}
To install the \texttt{callouts-box} package, place the following files in your \LaTeX{} directory:
\begin{itemize}
@@ -41,10 +46,27 @@
\DescribeEnv{successbox}
Each environment takes an optional argument for the box title. If no title is provided, a default title is used.
+\begin{verbatim}
+\begin{warningbox}[Custom Warning Title]
+ This is a warning message.
+\end{warningbox}
+
+\begin{errorbox}
+ This is an error message.
+\end{errorbox}
+
+\begin{notebox}[Important Note]
+ This is a note.
+\end{notebox}
+
+\begin{successbox}
+ This is a success message.
+\end{successbox}
+\end{verbatim}
+
\subsection{Basic Examples}
Here are some examples of how to use the predefined callout boxes:
-\begin{verbatim}
\begin{warningbox}[Custom Warning Title]
This is a warning message.
\end{warningbox}
@@ -60,11 +82,9 @@
\begin{successbox}
This is a success message.
\end{successbox}
-\end{verbatim}
\subsection{Advanced Examples}
You can nest callout boxes inside each other:
-\begin{verbatim}
\begin{warningbox}[Outer Warning]
This is an outer warning message.
@@ -72,9 +92,8 @@
This is a nested note inside a warning.
\end{notebox}
\end{warningbox}
-\end{verbatim}
+
You can add equations, lists, or images inside callout boxes:
-\begin{verbatim}
\begin{successbox}[Success with Equation]
The famous Pythagorean theorem:
\[
@@ -81,9 +100,7 @@
a^2 + b^2 = c^2
\]
\end{successbox}
-\end{verbatim}
-\begin{verbatim}
\begin{notebox}[Note with List]
Key points to remember:
\begin{itemize}
@@ -91,73 +108,52 @@
\item They can also include images.
\end{itemize}
\end{notebox}
-\end{verbatim}
\subsection{Customization}
Users can modify the visual appearance of callout boxes by editing \texttt{callouts-box-colors.sty} or overriding the \texttt{tcbset} settings in their document.
+More documentation can be found at : https://ctan.org/pkg/tcolorbox.
-\DescribeMacro{\tcbset}
+\subsubsection{Code exemle}
+
To adjust layout settings, use the \texttt{tcbset} command:
\begin{verbatim}
+{
\tcbset{
boxsettings/.style={
- boxrule=2pt, rounded corners=10pt, arc=10pt,
+ boxrule=2pt, arc=20pt,
left=10pt, right=10pt, top=10pt, bottom=10pt,
boxsep=10pt, before skip=15pt, after skip=15pt,
breakable, before upper={\ignorespaces},
+ boxrule=2pt, arc=8pt,
+ colframe=black, colback=yellow!10,
}
}
-\end{verbatim}
-\section{Defining Custom Boxes}
-You can define your own callout box styles using \texttt{NewTColorBox}. Example:
-\begin{verbatim}
-\definecolor{custom-border}{HTML}{FFA500}
-\definecolor{custom-content}{HTML}{FFF3E0}
-\definecolor{custom-text}{HTML}{FF6D00}
-
-\NewTColorBox{custombox}{ O{Custom Box} o }{
- colframe=custom-border,
- colback=custom-content,
- coltitle=custom-text,
- fonttitle=\bfseries,
- coltext=custom-text,
- title={#1},
+\begin{notebox}[Style Note]
+ Style Note
+\end{notebox}
}
\end{verbatim}
-To use the custom box:
-\begin{verbatim}
-\begin{custombox}[My Custom Box]
- This is a custom box.
-\end{custombox}
-\end{verbatim}
+\subsubsection{Result}
-\section{Complete Example}
-Here is a complete document using the \texttt{callouts-box} package:
+{
+\tcbset{
+ boxsettings/.style={
+ boxrule=2pt, arc=20pt,
+ left=10pt, right=10pt, top=10pt, bottom=10pt,
+ boxsep=10pt, before skip=15pt, after skip=15pt,
+ breakable, before upper={\ignorespaces},
+ boxrule=2pt, arc=8pt,
+ colframe=black!10, colback=yellow!10,
+ }
+}
-\begin{verbatim}
-\documentclass{article}
-\usepackage{callouts-box}
-
-\begin{document}
-
-\begin{warningbox}[Warning]
- This is a warning message.
-\end{warningbox}
-
-\begin{successbox}[Success]
- This is a success message.
-\end{successbox}
-
-\begin{notebox}[Math Example]
- \[
- E = mc^2
- \]
+\begin{notebox}[Test Note]
+ Note with custom style
\end{notebox}
+}
-\end{document}
-\end{verbatim}
\section{License}
This package is distributed under the \LaTeX{} Project Public License (LPPL), version 1.3 or later. For more details, see the \texttt{LICENSE} file.
@@ -174,7 +170,7 @@
% \iffalse
%<*package>
\NeedsTeXFormat{LaTeX2e}
-\ProvidesPackage{callouts-box}[2025/02/14 v1.0 Styled callout boxes]
+\ProvidesPackage{callouts-box}[2025/03/14 v1.1 Styled callout boxes]
\RequirePackage{xcolor}
\RequirePackage{tcolorbox}
@@ -222,7 +218,7 @@
% --------------------------------------
% \iffalse
%<*colors>
-\ProvidesPackage{callouts-box-colors}[2025/02/14 v1.0 Predefined colors for callouts-box]
+\ProvidesPackage{callouts-box-colors}[2025/03/14 v1.1 Predefined colors for callouts-box]
\RequirePackage{xcolor}
% Define colors for callout boxes
Modified: trunk/Master/texmf-dist/tex/latex/callouts-box/callouts-box-colors.sty
===================================================================
--- trunk/Master/texmf-dist/tex/latex/callouts-box/callouts-box-colors.sty 2025-03-15 19:56:33 UTC (rev 74634)
+++ trunk/Master/texmf-dist/tex/latex/callouts-box/callouts-box-colors.sty 2025-03-15 19:56:49 UTC (rev 74635)
@@ -20,7 +20,7 @@
%% LaTeX version 2005/12/01 or later.
-\ProvidesPackage{callouts-box-colors}[2025/02/14 v1.0 Predefined colors for callouts-box]
+\ProvidesPackage{callouts-box-colors}[2025/03/14 v1.1 Predefined colors for callouts-box]
\RequirePackage{xcolor}
\definecolor{warning-title}{HTML}{FAE2A0}
Modified: trunk/Master/texmf-dist/tex/latex/callouts-box/callouts-box.sty
===================================================================
--- trunk/Master/texmf-dist/tex/latex/callouts-box/callouts-box.sty 2025-03-15 19:56:33 UTC (rev 74634)
+++ trunk/Master/texmf-dist/tex/latex/callouts-box/callouts-box.sty 2025-03-15 19:56:49 UTC (rev 74635)
@@ -20,7 +20,7 @@
%% LaTeX version 2005/12/01 or later.
\NeedsTeXFormat{LaTeX2e}
-\ProvidesPackage{callouts-box}[2025/02/14 v1.0 Styled callout boxes]
+\ProvidesPackage{callouts-box}[2025/03/14 v1.1 Styled callout boxes]
\RequirePackage{xcolor}
\RequirePackage{tcolorbox}
More information about the tex-live-commits
mailing list.