Debian Codegraph @

texmf-dist/source/latex/gender/gender.dtx

raw
1 % \iffalse meta-comment
2 %
3 % Copyright (C) 2015 by Steffen Banhardt
4 % -----------------------------------
5 %
6 % This file may be distributed and/or modified under the
7 % conditions of the LaTeX Project Public License, either version 1.3c
8 % of this license or (at your option) any later version.
9 % The latest version of this license is in:
10 %
11 % http://www.latex-project.org/lppl.txt
12 %
13 % and version 1.3c or later is part of all distributions of LaTeX
14 % version 2005/12/01 or later.
15 %
16 % \fi
17 %
18 % \iffalse
19 %<package>\NeedsTeXFormat{LaTeX2e}[1999/12/01]
20 %<package>\ProvidesPackage{gender}
21 %<package>[2015/03/07 v1.0 First official release]
22 %
23 %<*driver>
24 \documentclass{ltxdoc}
25 \usepackage[english,ngerman]{babel}
26 \usepackage[utf8]{inputenc}
27 \usepackage[T1]{fontenc}
28 \usepackage{gender}
29 \EnableCrossrefs
30 \CodelineIndex
31 \RecordChanges
32 \begin{document}
33 \DocInput{gender.dtx}
34 \end{document}
35 %</driver>
36 % \fi
37 %
38 % \CheckSum{0}
39 %
40 % \changes{v1.0}{ 2015/03/07 }{First official release}
41 %
42 % \GetFileInfo{gender.sty}
43 %
44 % \DoNotIndex{\iffem, \ifuc}
45 %
46 % \title{The \textsf{gender} package\thanks{This document
47 % corresponds to \textsf{gender}~\fileversion,
48 % dated \filedate.}}
49 % \author{ Steffen Banhardt \\ \texttt{ [email protected]}}
50 %
51 % \maketitle
52 %
53 % \begin{abstract}
54 % Many languages -- like German or French -- use masculine and feminine grammatical genders. There are many ideas how to promote gender neutrality in those languages. This package uses alternately masculine and feminine forms.
55 %
56 % It is also possible to use just one form out of a template.
57 % \end{abstract}
58 %
59 % \section{Einführung}
60 %
61 % \subsection{Ziel}
62 %
63 % Das Ziel dieses Paketes ist es, eine Möglichkeit zu einer geschlechtergerechten Sprache zu implementieren. Hierzu werden jeweils \gender{die weibliche(und)die männliche} Form angegeben und in abwechselnder Reihenfolge \gender{die weibliche(und)die männliche} Form ausgegeben.
64 %
65 % \section{Verwendung}
66 %
67 % \subsection{Aufruf}
68 %
69 % Zum Aufruf wird das Paket geladen mit
70 %
71 % |\usepackage{gender}|
72 %
73 % Dabei sind die folgenden Abschnitt vorgestellten Paketoptionen optional möglich.
74 %
75 % \subsection{Optionen}
76 %
77 % Das Paket nutzt für die Optionen die Syntax |key=value| des Pakets |xkeyval|, von dem es abhängt.
78 %
79 % \DescribeMacro{konj =}
80 % |Konjunktion|
81 %
82 % Das optionale Argument \oarg{konj=} nimmt eine Konjunktion als Standardverbindung für die Formen an, voreingestellt ist "`und"'.
83 %
84 % \DescribeMacro{single =}
85 % |true, false|
86 %
87 % Das optionale Argument \oarg{single=} nimmt die Werte |true| oder |false| an, voreingestellt ist |false|. Wird es auf |true| gesetzt, dann werden nicht die weibliche und die männliche Form ausgegeben, sondern abwechselnd jeweils nur eine Form.
88 %
89 % \DescribeMacro{malefirst =}
90 % |true, false|
91 %
92 % Das optionale Argument \oarg{malefirst=} nimmt die Werte |true| oder |false| an, voreingestellt ist |false|. Wird es auf |true| gesetzt, beginnt der erste Aufruf von |\gender| nicht wie üblich mit einer weiblichen, sondern mit einer männlichen Form.
93 %
94 % \DescribeMacro{fixmale =}
95 % |true, false|
96 %
97 % Das optionale Argument \oarg{fixmale=} nimmt die Werte |true| oder |false| an, voreingestellt ist |true|. Ist es auf |true| gesetzt, wird bei |\genderfix| die männliche, ansonsten die weibliche Form ausgegeben.
98 %
99 %
100 % \subsection{Allgemeine Makros}
101 %
102 % Das Paket stellt die folgenden Makros bereit:
103 %
104 % \DescribeMacro{\gender}
105 % \DescribeMacro{\Gender}
106 % benötigt als Argument \gender{eine weibliche(und)eine männliche} Form, die durch eine Konjuktion in Klammern getrennt werden:
107 %
108 % |\gender|\marg{Frau(konj)Mann}
109 %
110 % Bei der Version in Großschreibung wird das erste Wort großgeschrieben. Aus |\Gender|\marg{eine Frau(oder)ein Mann} wird "`\Gender{eine Frau(oder)ein Mann}"'.
111 %
112 %
113 % \DescribeMacro{\gend}
114 % \DescribeMacro{\Gend}
115 % wird aufgerufen wie |\gender| bzw.\ |\Gender|. Es werden jedoch nicht beide, sondern nur eine Form ausgegeben, also abwechselnd entweder \gender{die weibliche(oder)die männliche}.
116 %
117 % \DescribeMacro{\genderb}
118 % \DescribeMacro{\Genderb}
119 % wird aufgerufen wie |\gender| bzw.\ |\Gender|. Es werden jedoch immer beide Formen ausgegeben, auch wenn die Klassenoption \meta{single} gesetzt ist.
120 %
121 % \DescribeMacro{\keep}
122 % verändert die Reihenfolge der \gender{männlichen(und)weiblichen} Formen: es wird die gleiche Reihenfolge benutzt wie beim vorherigen Aufruf. Dies ist besonders mit gesetzter Klassenoption \meta{single} bzw.\ |\gend| und |\Gend| hilfreich:
123 %
124 % |\Gend{sie()er}| putzt |\keep||\gend{ihre()seine}| Nase.
125 %
126 % Dies ergibt\\\emph{\Gend{sie()er} putzt \keep\gend{ihre()seine} Nase.}\\anstatt des missverständlichen:\\\keep\emph{\Gend{sie()er} putzt \gend{ihre()seine} Nase.}
127 %
128 % \DescribeMacro{\genderk}
129 % \DescribeMacro{\Genderk}
130 % \DescribeMacro{\gendk}
131 % \DescribeMacro{\Gendk}
132 % \DescribeMacro{\genderbk}
133 % \DescribeMacro{\Genderbk}
134 % die Formen mit angehängtem |k| verhalten sich wie die Formen ohne k mit vorangestelltem |\keep|. Es wird also die Reihenfolge der vorherigen Form beibehalten.
135 %
136 % \vspace{8ex}
137 % \subsection{Kurzformen}
138 %
139 % \DescribeMacro{\gnd}
140 % ist eine Kurzform für Worte, bei denen die weibliche Form durch ein angehängtes "~in gebildet wird. Hierzu muss nur die männliche Form angegeben werden. Als optionales Argument kann eine Konjunktion übergeben werden:
141 %
142 % |\gnd[bzw.]{Fahrer}| wird zu \emph{\gnd[bzw.]{Fahrer}} erweitert.
143 %
144 % \DescribeMacro{\gndpl}
145 % ist die Pluralform zu |\gnd|, für die weibliche Form wird "~innen angehängt.
146 %
147 % \subsection{Pronomen}
148 %
149 % Neben den beschriebenen Makros stehen auch noch Kurzformen für die Pronomina \sieer[und]{} in allen vier Fällen bereit. Auch hier kann als optionales Argument eine Konjunktion übergeben werden: |\ersie|\oarg{Konjunktion}|{}| Für diese Makros ist es unerheblich, ob sie als |\ersie{}| oder |\sieer{}| aufgerufen werden. Für den Satzanfang stehen jeweils die Makros |\Sieer{}| bzw. |\Ersie{}| zur Verfügung.
150 %
151 % \begin{tabular}{lcccc}
152 % & \multicolumn{2}{c}{Kleinschreibung} & \multicolumn{2}{c}{Großschreibung} \\
153 % \hline
154 % Nominativ & |\sieer{}| & |\ersie{}| & |\Sieer{}| & |\Ersie{}| \\
155 % Genitiv & |\ihrsein{}| & |\seinihr{}| & |\Ihrsein{}| & |\Seinihr{}| \\
156 % & |\ihreseine{}| & |\seineihre{}| & |\Ihreseine{}| & |\Seineihre{}| \\
157 % Dativ & |\ihrihm{}| & |\ihmihr{}| & |\Ihrihm{}| & |\Ihmihr{}| \\
158 % Akkusativ & |\sieihn{}| & |\ihnsie{}| & |\Sieihn{}| & |\Ihnsie{}| \\
159 % \end{tabular}
160 %
161 % \subsection{Feste Formen mit genderfix}
162 %
163 % Neben den beschriebenen Formen, die abwechselnd unterschiedliche Formen ausgeben, beinhaltet das Paket die Möglichkeit eine einzelne, feste Form auszugeben. Die ist für Formulierungen in Vorlagen hilfreich, die an unterschiedliche Geschlechter angepasst werden müssen:
164 %
165 % \DescribeMacro{\genderfix}
166 %
167 % |Ich gelobe als \genderfix{Vorsitzende()Vorsitzender}|\ldots
168 %
169 % \emph{Ich gelobe als \genderfix{Vorsitzende()Vorsitzender}\ldots}
170 %
171 % Dabei müssen die weibliche und die männliche wie bei den Formen von |\gender| angegeben werden. Die Option \oarg{malefix=} legt hierbei fest, ob die männliche (|true|, Vorgabe) oder die weibliche (|false|) Form verwendet wird.
172 %
173 % \section{Implementierung}
174 %
175 % \subsection{Das \LaTeX-Dokument "`\texttt{gender.sty}"'}
176 %
177 % Das Paket benötigt |xkeyval| für die Klassenoptionen.
178 % \begin{macrocode}
179 \RequirePackage{xkeyval}
180 %
181 % Wird konj aufgerufen wird gndr@konj auf 'Wert', ansonsten auf 'und' gesetzt
182 \DeclareOptionX[GN]<gndr>{konj}[und]{\def\gndr@konj{#1}\PackageInfo{GENDER}{Setting 'gndr@konj' to '#1'}}
183 %
184 % Boolean 'single'
185 \define@boolkey+[GN]{gndr}{single}[true]%
186 {\PackageInfo{GENDER}{Setting boolean 'single' to '#1'}}
187 {\PackageWarning{GENDER}{Value #1 for 'single' ignored}}
188 %Setzt GN@gndr@single wenn es nicht aufgerufen wurde
189 \presetkeys[GN]{gndr}{single=false}{}
190 %
191 \define@boolkey+[GN]{gndr}{malefirst}[true]%
192 {\PackageInfo{GENDER}{Setting boolean 'malefirst' to '#1'}}
193 {\PackageWarning{GENDER}{Value #1 for 'malefirst' ignored}}
194 \presetkeys[GN]{gndr}{malefirst=false}{}
195 %
196 \define@boolkey+[GN]{gndr}{fixmale}[true]%
197 {\PackageInfo{GENDER}{Setting boolean 'fixmale' to '#1'}}
198 {\PackageWarning{GENDER}{Value #1 for 'fixmale' ignored}}
199 \presetkeys[GN]{gndr}{fixmale=true}{}
200 %
201 \DeclareOptionX*{\PackageWarning{GENDER}{Unknown Option '\CurrentOption'}}
202 \ProcessOptionsX[GN]<gndr>\relax
203 %
204 %-----------------------------
205 %
206 % Wurde konj nicht aufgerufen, wird es nun auf 'und' gesetzt
207 \@ifundefined{gndr@konj}{\def\gndr@konj{und}\PackageInfo{GENDER}{Setting 'gndr@konj' to 'und'}}{\relax}%
208 %
209 %
210 \newif\iffem\femtrue%female vorne
211 \newif\ifuc\uctrue%uppercase
212 \newif\iffixmale\fixmalefalse
213 \ifGN@gndr@malefirst\global\femfalse\fi
214 \ifGN@gndr@fixmale\global\fixmaletrue\fi
215 %
216 \def\keep{\iffem\global\femfalse\else\global\femtrue\fi}%
217 %
218 \def\gender#1{\global\ucfalse\ifGN@gndr@single\@gend#1\@nil\else\@gender#1\@nil\fi}%
219 \def\Gender#1{\global\uctrue\ifGN@gndr@single\@gend#1\@nil\else\@gender#1\@nil\fi}%
220 \def\gend#1{\global\ucfalse\@gend#1\@nil}%
221 \def\Gend#1{\global\uctrue\@gend#1\@nil}%
222 %Version mit b -- es werden immer beide Formen genommen, auch bei single=true
223 \def\genderb#1{\global\ucfalse\@gender#1\@nil}%
224 \def\Genderb#1{\global\uctrue\@gender#1\@nil}%
225 %Versionen mit k -- die Form wird behalten
226 \def\genderk#1{\keep\global\ucfalse\ifGN@gndr@single\@gend#1\@nil\else\@gender#1\@nil\fi}%
227 \def\Genderk#1{\keep\global\uctrue\ifGN@gndr@single\@gend#1\@nil\else\@gender#1\@nil\fi}%
228 \def\gendk#1{\keep\global\ucfalse\@gend#1\@nil}%
229 \def\Gendk#1{\keep\global\uctrue\@gend#1\@nil}%
230 \def\genderbk#1{\keep\global\ucfalse\@gender#1\@nil}%
231 \def\Genderbk#1{\keep\global\uctrue\@gender#1\@nil}%
232 %
233 \def\genderfix#1{\global\ucfalse\@genderfix#1\@nil}%
234 \def\Genderfix#1{\global\uctrue\@genderfix#1\@nil}%
235 %
236 \def\@gender#1(#2)#3\@nil{%
237 \if\relax\detokenize{#2}\relax%
238 \def\gndr@ko{\gndr@konj}%
239 \else\def\gndr@ko{#2}%
240 \fi%
241 \iffem%
242 \ifuc\MakeUppercase#1 \else#1 \fi\gndr@ko{} #3%
243 \global\femfalse%
244 \else%
245 \ifuc\MakeUppercase#3 \else#3 \fi\gndr@ko{} #1%
246 \global\femtrue%
247 \fi%
248 }
249 %
250 \def\@gend#1(#2)#3\@nil{%
251 \iffem%
252 \ifuc\MakeUppercase#1\else#1\fi%
253 \global\femfalse%
254 \else%
255 \ifuc\MakeUppercase#3\else#3\fi%
256 \global\femtrue%
257 \fi%
258 }
259 %
260 \def\@genderfix#1(#2)#3\@nil{%
261 \iffixmale%
262 \ifuc\MakeUppercase#3\else#3\fi%
263 \else%
264 \ifuc\MakeUppercase#1\else#1\fi%
265 \fi%
266 }
267 %
268 % Weitere Formen
269 % Dürfen nicht die @Versionen aufrufen!
270 \newcommand{\gnd}[2][\gndr@konj]{\gender{#2in(#1)#2}} %Kurzbefehl \gnd[konj]{neutr. Form}
271 \newcommand{\gndpl}[2][\gndr@konj]{\gender{#2innen(#1)#2}} %Kurzbefehl \gndpl[konj]{neutr. Form}
272 %
273 %Pronomen
274 \newcommand{\sieer}[1][\gndr@konj]{\gender{sie(#1)er}}
275 \newcommand{\ersie}{\sieer}
276 \newcommand{\ihrsein}[1][\gndr@konj]{\gender{ihr(#1)sein}}
277 \newcommand{\seinihr}{\ihrsein}
278 \newcommand{\ihreseine}[1][\gndr@konj]{\gender{ihre(#1)seine}}
279 \newcommand{\seineihre}{\ihreseine}
280 \newcommand{\ihrihm}[1][\gndr@konj]{\gender{ihr(#1)ihm}}
281 \newcommand{\ihmihr}{\ihrihm}
282 \newcommand{\sieihn}[1][\gndr@konj]{\gender{sie(#1)ihn}}
283 \newcommand{\ihnsie}{\sieihn}
284 %Großschreibung
285 \newcommand{\Sieer}[1][\gndr@konj]{\Gender{sie(#1)er}}
286 \newcommand{\Ersie}{\Sieer}
287 \newcommand{\Ihrsein}[1][\gndr@konj]{\Gender{ihr(#1)sein}}
288 \newcommand{\Seinihr}{\Ihrsein}
289 \newcommand{\Ihreseine}[1][\gndr@konj]{\Gender{ihre(#1)seine}}
290 \newcommand{\Seineihre}{\Ihreseine}
291 \newcommand{\Ihrihm}[1][\gndr@konj]{\Gender{ihr(#1)ihm}}
292 \newcommand{\Ihmihr}{\Ihrihm}
293 \newcommand{\Sieihn}[1][\gndr@konj]{\Gender{sie(#1)ihn}}
294 \newcommand{\Ihnsie}{\Sieihn}
295 % \end{macrocode}
296 %
297 %
298 % \Finale
299 \endinput
300
301
302