diff options
author | Karl Berry <karl@freefriends.org> | 2024-04-21 20:15:32 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2024-04-21 20:15:32 +0000 |
commit | 3d83a1fdca3cdede368f6ccce91559bdb2c60bbc (patch) | |
tree | ea3f8677818d232bad2da1817aad4a269e07a20f /Master/texmf-dist/doc | |
parent | 3110e4fa3dff1aebd4f9e6604757dcb865afa684 (diff) |
huaz (21apr24)
git-svn-id: svn://tug.org/texlive/trunk@71030 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc')
-rw-r--r-- | Master/texmf-dist/doc/latex/huaz/huaz.pdf | bin | 328438 -> 323827 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/latex/huaz/huaz.tex | 77 |
2 files changed, 38 insertions, 39 deletions
diff --git a/Master/texmf-dist/doc/latex/huaz/huaz.pdf b/Master/texmf-dist/doc/latex/huaz/huaz.pdf Binary files differindex ab19e2a95f5..fe31b1cfad3 100644 --- a/Master/texmf-dist/doc/latex/huaz/huaz.pdf +++ b/Master/texmf-dist/doc/latex/huaz/huaz.pdf 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 |