summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2024-04-21 20:15:32 +0000
committerKarl Berry <karl@freefriends.org>2024-04-21 20:15:32 +0000
commit3d83a1fdca3cdede368f6ccce91559bdb2c60bbc (patch)
treeea3f8677818d232bad2da1817aad4a269e07a20f
parent3110e4fa3dff1aebd4f9e6604757dcb865afa684 (diff)
huaz (21apr24)
git-svn-id: svn://tug.org/texlive/trunk@71030 c570f23f-e606-0410-a88d-b1316a301751
-rw-r--r--Master/texmf-dist/doc/latex/huaz/huaz.pdfbin328438 -> 323827 bytes
-rw-r--r--Master/texmf-dist/doc/latex/huaz/huaz.tex77
-rw-r--r--Master/texmf-dist/tex/latex/huaz/huaz.sty17
3 files changed, 52 insertions, 42 deletions
diff --git a/Master/texmf-dist/doc/latex/huaz/huaz.pdf b/Master/texmf-dist/doc/latex/huaz/huaz.pdf
index ab19e2a95f5..fe31b1cfad3 100644
--- a/Master/texmf-dist/doc/latex/huaz/huaz.pdf
+++ b/Master/texmf-dist/doc/latex/huaz/huaz.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/huaz/huaz.tex b/Master/texmf-dist/doc/latex/huaz/huaz.tex
index c873d10fb45..a9bb258ad64 100644
--- a/Master/texmf-dist/doc/latex/huaz/huaz.tex
+++ b/Master/texmf-dist/doc/latex/huaz/huaz.tex
@@ -42,13 +42,13 @@ keepspaces}}{}
\newcommand{\commandinline}{\hspace*{-15mm}\lstinline[
delim={[is][\color{green!50!black}\normalfont\small\sffamily]{!}{!}},
-basicstyle=\color{red!70!black}\normalfont\ttfamily,
+basicstyle=\color{red!70!black}\normalfont\normalsize\ttfamily,
columns=fullflexible,
keepspaces]}
\newcommand{\verbinline}{\lstinline[
delim={[is][\color{green!50!black}\normalfont\small\sffamily]{!}{!}},
-basicstyle=\normalfont\ttfamily,
+basicstyle=\normalfont\normalsize\ttfamily,
columns=fullflexible,
keepspaces]}
@@ -63,7 +63,7 @@ keepspaces]}
\begin{document}
\title{The \huaz\ package\\
- {\large v1.1 (2024/04/12)}}
+ {\large v1.2 (2024/04/20)}}
\author{Tibor Tómács\\
{\normalsize\href{email:tomacs.tibor@gmail.com}{\nolinkurl{tomacs.tibor@gmail.com}}}}
\date{}
@@ -75,7 +75,7 @@ In Hungarian there are two definite articles, \emph{``a''} and \emph{``az''}, wh
The \huaz\ package helps the user to insert automatically the correct definite article for cross-references and other commands containing text. Thus, if these change, the definite articles will also change accordingly.
\medskip
-\emph{Sorry, the documentation is in Hungarian. This is because only Hungar\-ian-speaking users are interested.}
+\emph{The documentation is in Hungarian, because only Hungarian-speaking users are interested.}
\end{abstract}
\end{otherlanguage}
@@ -214,7 +214,7 @@ eredménye ,,az 1. szakaszban, a \textbf{2}. szakaszban''. Ha a \texttt{section}
\subsubsection*{Korlátozások}
\begin{enumerate}
-\item A \verbinline|!<szöveg>!| elején csak a \verb|\ref|, \verb|\pageref|, \verb|\eqref|, \verb|\cite| kereszthivatkozásokkal működik helyesen. Például a \texttt{hyperref} csomag \verb|\ref*| és \verb|\pageref*| parancsai nem működnek közvetlenül \verbinline|!<szöveg>!|-ként, de ez megoldható a később ismertetett \verb|\az*| paranccsal.
+\item A \verbinline|!<szöveg>!| elején csak a \verb|\ref|, \verb|\ref*|, \verb|\pageref|, \verb|\pageref*|, \verb|\eqref|, \verb|\cite| kereszthivatkozásokkal működik helyesen.
\item A \verbinline|!<szöveg>!| elején a \verb|\cite| parancs jól működik a \texttt{natbib} csomaggal és \texttt{bibtex} esetében is. A \texttt{biblatex} csomag használata esetén akkor működik jól, ha a \texttt{style} vagy \texttt{citestyle} opciók értéke \texttt{numeric}, \texttt{numeric-verb}, \texttt{alphabetic}, \texttt{alphabetic-verb} vagy \texttt{authoryear}. Akkor is jól működik, ha nem adjuk meg a \texttt{style} illetve \texttt{citestyle} opciók egyikét sem.
@@ -227,11 +227,7 @@ Viszont a cím a szövegben, fejlécben és a tartalomjegyzékben jól fog megje
\commandinline|\az*{!<szöveg>!}|
-Ugyanaz mint a \texttt{*} nélküli esetben, de ekkor csak a névelő kerül kiírásra. Például \texttt{hyperref} csomag használatával:
-\begin{examplelst}
-\section{Cím}\label{sec}
-\az*{\ref{sec}}~\ref*{sec}.~szakaszban
-\end{examplelst}
+Ugyanaz mint a \verb|*| nélküli esetben, de ekkor csak a névelő kerül kiírásra.
\commandinline|\azv{!<szöveg>!}|
@@ -246,16 +242,14 @@ eredménye ,,az V.~szakaszban, a V.~szakaszban'', mert az első esetben a V bet
\commandinline|\azv*{!<szöveg>!}|
-Ugyanaz mint a \texttt{*} nélküli esetben, de ekkor csak a névelő kerül kiírásra.
-
-A parancsok nevében az ,,a'' betű kicserélhető ,,A'' betűre. Ekkor a határozott névelő nagybetűvel fog kezdődni, ami mondatok elején szükséges.
+Ugyanaz mint a \verb|*| nélküli esetben, de ekkor csak a névelő kerül kiírásra.
\commandinline|\Az{!<szöveg>!}|\\
\commandinline|\Az*{!<szöveg>!}|\\
\commandinline|\Azv{!<szöveg>!}|\\
\commandinline|\Azv*{!<szöveg>!}|
-Például
+Ugyanaz, mint a kis ,,\texttt{a}'' betűvel kezdődő parancsok, de ekkor a határozott névelő nagybetűvel fog kezdődni, ami mondatok elején szükséges. Például
\begin{examplelst}
\section{Cím}\label{sec}
\Az{\ref{sec}}.~szakaszban áttekintjük a téma rövid történetét.
@@ -278,11 +272,11 @@ Ekkor a vázlatfába az
\begin{examplelst}
\azsaved~\ref{sec}...
\end{examplelst}
-kód kerül, ami már helyes eredményt ad. Ez a probléma a \verb|\texorpdfstring| helyett az
+kód kerül, ami már helyes eredményt ad.
\commandinline|\aznotshow|
-paranccsal egyszerűbben is megoldható. Ugyanis ezt helyezve az \verb|\az| (vagy bármelyik verziója) elé, az eredmény nem jelenik meg, csak az \verb|\azsaved| generálódik le a megfelelő határozott névelővel. Így
+Az előző probléma a \verb|\texorpdfstring| helyett ezzel a paranccsal egyszerűbben is megoldható. Ugyanis ezt helyezve az \verb|\az| (vagy bármelyik verziója) elé, az eredmény nem jelenik meg, csak az \verb|\azsaved| generálódik le a megfelelő határozott névelővel. Így
\begin{examplelst}
\aznotshow\Az{\ref{sec}}
\section{\azsaved~\ref{sec}...}
@@ -291,6 +285,8 @@ szintén helyes eredményt ad a vázlatfában is.
\subsection{Rövidítések}
+A \verb|\ref|, \verb|\pageref|, \verb|\eqref|, \verb|\cite| kereszthivatkozások (csak a \verb|*| nélküli verziók) elé nem csak az előbbi parancsokkal tehetünk határozott névelőt, mert mindegyiknek van egy rövidített egyparancsos verziója is:
+
\commandinline|\aref{!<kulcs>!} | $\equiv$ \verbinline|\az{\ref{!<kulcs>!}}|\\
\commandinline|\aref*{!<kulcs>!} | $\equiv$ \verbinline|\az*{\ref{!<kulcs>!}}|\\
\commandinline|\avref{!<kulcs>!} | $\equiv$ \verbinline|\azv{\ref{!<kulcs>!}}|\\
@@ -311,7 +307,7 @@ szintén helyes eredményt ad a vázlatfában is.
\commandinline|\avcite[!<szöveg>!]{!<kulcs1>!,!<kulcs2>!,!...!} | $\equiv$ \verbinline|\azv{\cite[!<szöveg>!]{!<kulcs1>!,!<kulcs2>!,!...!}}|\\
\commandinline|\avcite*[!<szöveg>!]{!<kulcs1>!,!<kulcs2>!,!...!}| $\equiv$ \verbinline|\azv*{\cite[!<szöveg>!]{!<kulcs1>!,!<kulcs2>!,!...!}}|
-A parancsok nevében az első ,,a'' betű kicserélhető ,,A'' betűre. Ekkor a határozott névelő nagybetűvel fog kezdődni, ami mondatok elején szükséges:
+A parancsok nevében az első ,,\texttt{a}'' betű kicserélhető ,,\texttt{A}'' betűre. Ekkor a határozott névelő nagybetűvel fog kezdődni, ami mondatok elején szükséges:
\commandinline|\Aref \Avref \Aeqref \Aveqref \Apageref \Avpageref \Acite \Avcite|
@@ -325,7 +321,7 @@ eredménye ,,Az 1. és a 2. szakaszban''.
\subsection{A huaz kapocs}\label{subsec-kapocs}
-Amikor a \huaz\ csomag megkeresi a megfelelő határozott névelőt, akkor a szövegben található kereszthivatkozásokat lecseréli a kifejthető verziójukra, továbbá a kifejtés során a formázó parancsokat (\verb|\emph|, \verb|\textbf|, \verb|\small|, stb.) figyelmen kívül hagyja. Emiatt lehetséges, hogy például a következő kódok működnek:
+Amikor a \huaz\ csomag megkeresi a megfelelő határozott névelőt, akkor a szövegben található \verb|\ref|, \verb|\ref*|, \verb|\pageref|, \verb|\pageref*|, \verb|\eqref|, \verb|\cite| kereszthivatkozásokat lecseréli a kifejthető verziójukra, továbbá a kifejtés során egy adott listában található formázó parancsokat (\verb|\emph|, \verb|\textbf|, \verb|\small|, stb.) figyelmen kívül hagyja. Emiatt lehetséges, hogy például a következő kódok működnek:
\begin{examplelst}
\newcommand{\osztaly}{V.B}
Idén \az{\textbf{\osztaly}}~osztály rendezi a farsangot.
@@ -336,39 +332,43 @@ Idén \az{\textbf{\osztaly}}~osztály rendezi a farsangot.
\az{\textbf{\ref{sec}}}
\end{examplelst}
+De a következő kód is jól fog működni:
+\begin{examplelst}
+\newcommand{\myfont}[1]{{\usefont{T1}{yv1d}{m}{n}#1}}
+\newcommand{\osztaly}{X.A~osztály}
+\az{\myfont{\osztaly}}
+\end{examplelst}
+Ez nem azért van, mert a \verb|\myfont| is szerepel ebben az adott listában, hanem azért, mert a \verb|\myfont| kifejtésében található \verb|\usefont| benne van.
+
\commandinline|\AddToHook{huaz}{!<kód>!}|
-A \huaz\ csomag azon szövegformázó parancsokat hagyja figyelmen kívül, melyek egy előre definiált listában szerepelnek. Amennyiben olyan formázó parancsot használ, ami még ezen a listán nem található, akkor az a felhasználó által is bővíthető. Például
+Amennyiben olyan formázó parancsot használ, ami még ezen a listán nem található, akkor az a felhasználó által is bővíthető. Például a \texttt{shadowtext} csomag \verb|\shadowtext| parancsa nincs a listában, ezért a következő kód eredménye hibás lesz:
\begin{examplelst}
-\newcommand{\myfont}[1]{{\usefont{T1}{yv1d}{m}{n}#1}}
-\newcommand{\mytext}{X.A~osztály}
-\az{\myfont{\mytext}}
+\newcommand{\osztaly}{X.A~osztály}
+\az{\shadowtext{\osztaly}}
\end{examplelst}
-esetén a \verb|\myfont| nincs ezen a listán, ezért ez a kód hibával fordul. A listára az
+A listára az
\begin{examplelst}
-\AddToHook{huaz}{\def\myfont{}}
+\AddToHook{huaz}{\def\shadowtext{}}
\end{examplelst}
-módon vehető fel. Ezzel azt érjük el, hogy a névelő megállapítása során a \verb|\myfont| parancs ne jelentsen semmit. Tehát a következő kód már megfelelően működik:
+módon vehető fel. Ezzel a névelő megállapítása során a \verb|\shadowtext| parancs nem jelent semmit. Tehát a következő kód már megfelelően működik:
\begin{examplelst}
-\AddToHook{huaz}{\def\myfont{}}
-\newcommand{\myfont}[1]{{\usefont{T1}{yv1d}{m}{n}#1}}
-\newcommand{\mytext}{X.A~osztály}
-\az{\myfont{\mytext}}
+\AddToHook{huaz}{\def\shadowtext{}}
+\newcommand{\osztaly}{X.A~osztály}
+\az{\shadowtext{\osztaly}}
\end{examplelst}
Az előző eset a \texttt{huaz} kapocs nélkül így is megoldható:
\begin{examplelst}
-\newcommand{\myfont}[1]{{\usefont{T1}{yv1d}{m}{n}#1}}
-\newcommand{\mytext}{X.A~osztály}
-\az*{\mytext}~\myfont{\mytext}
+\newcommand{\osztaly}{X.A~osztály}
+\az*{\osztaly}~\shadowtext{\osztaly}
\end{examplelst}
-Ha a \verb|\myfont| a \verb|\mytext| definíciójában szerepel, akkor a \texttt{huaz} kapocs használata nem kerülhető meg:
+Ha a \verb|\shadowtext| az \verb|\osztaly| definíciójában szerepel, akkor a \texttt{huaz} kapocs használata nem kerülhető meg:
\begin{examplelst}
-\AddToHook{huaz}{\def\myfont{}}
-\newcommand{\myfont}[1]{{\usefont{T1}{yv1d}{m}{n}#1}}
-\newcommand{\mytext}{\myfont{X.A~osztály}}
-\az{\mytext}
+\AddToHook{huaz}{\def\shadowtext{}}
+\newcommand{\osztaly}{\shadowtext{X.A~osztály}}
+\az{\osztaly}
\end{examplelst}
-Kereszthivatkozásnál, ha maga a számozás van standardtól különböző paranccsal formázva, akkor a \texttt{huaz} kapocs használata szintén nem kerülhető meg. Például
+Ha a formázó parancs erős, akkor a \texttt{huaz} kapocs használata szintén nem kerülhető meg. Például
\begin{examplelst}
\AddToHook{huaz}{\def\myfont{}}
\DeclareRobustCommand{\myfont}[1]{{\usefont{T1}{yv1d}{m}{n}#1}}
@@ -376,6 +376,5 @@ Kereszthivatkozásnál, ha maga a számozás van standardtól különböző para
\section{Cím}\label{sec}
\aref{sec}
\end{examplelst}
-Itt a \verb|\myfont| azért lett erős parancsként definiálva, mert mozgó argumentumba kerül. Az előző példa esete ritkán fordul elő, mert a számláló típusának megadásánál (arab, római, stb.) nem szokás szövegformázó parancsot is alkalmazni.
\end{document} \ No newline at end of file
diff --git a/Master/texmf-dist/tex/latex/huaz/huaz.sty b/Master/texmf-dist/tex/latex/huaz/huaz.sty
index 8127c5b5852..1a9435bfffd 100644
--- a/Master/texmf-dist/tex/latex/huaz/huaz.sty
+++ b/Master/texmf-dist/tex/latex/huaz/huaz.sty
@@ -18,7 +18,7 @@
%% The Current Maintainer of this work is Tibor Tomacs.
%%
\NeedsTeXFormat{LaTeX2e}[2021/10/10]
-\ProvidesPackage{huaz}[2024/04/12 v1.1 Automatic Hungarian definite articles]
+\ProvidesPackage{huaz}[2024/04/20 v1.2 Automatic Hungarian definite articles]
\RequirePackage{xstring,refcount,iftex}
@@ -83,6 +83,13 @@
\def\huaz@deloptparam{\huaz@y@\relax}% \def\textcolor{\huaz@deloptparam} --> \textcolor[RGB]{0,255,0}{text} --> text; \textcolor{red}{text} --> text
\AddToHook{huaz}{% Ignored commands
+ \def\usefont#1#2#3#4{}%
+ \def\fontsize#1#2{}%
+ \def\fontencoding#1{}%
+ \def\fontfamily#1{}%
+ \def\fontseries#1{}%
+ \def\fontshape#1{}%
+ \def\selectfont{}%
\def\textrm{}\def\rmfamily{}%
\def\textsf{}\def\sffamily{}%
\def\texttt{}\def\ttfamily{}%
@@ -103,12 +110,16 @@
\def\uppercase{}\def\lowercase{}\def\MakeUppercase{}\def\MakeLowercase{}%
\def\textcolor{\huaz@deloptparam}\def\color{\huaz@deloptparam}%
\def\mbox{}\def\fbox{}%
+ \def\makebox#1#{}% \makebox{text} and \makebox[opt]{text} --> text
+ \def\framebox#1#{}% \framebox{text} and \framebox[opt]{text} --> text
+ \def\textqq{}%
+ \def\enquote#1#{}% \enquote{text} and \enquote*{text} --> text
\def\told{}}
\AddToHook{huaz}{% Expandable cross-references commands
- \def\ref#1{\getrefnumber{#1}}%
+ \def\ref#1#{\getrefnumber}% \ref{...} and \ref*{...} --> \getrefnumber{...}
+ \def\pageref#1#{\getpagerefnumber}% \pageref{...} and \pageref*{...} --> \getpagerefnumber{...}
\def\eqref#1{\getrefnumber{#1}}%
- \def\pageref#1{\getpagerefnumber{#1}}%
\def\cite{\huaz@cite}}
%=================================================