Template:ar-decl-adj/documentation

Documentation for Template:ar-decl-adj. [edit]
This page contains usage information, categories, interwiki links and other content describing the template.

This template displays an inflection table for Arabic adjectives. The parameters are largely the same as for the headword template {{ar-adj}}, and in general it is possible to copy such a template, change its name to {{ar-decl-adj}}, and get an appropriate declension table -- provided that the masculine plural is specified appropriately, or that the adjective is of a sort that uses a sound masculine plural (e.g. participles of non-form-I verbs and some form-I participles).

See also {{ar-decl-noun}}.

Parameters edit

|1=
The stem used in the masculine singular, including vowels. Can optionally be of the form 'STEM:TYPE' with an explicitly specified inflection type (see below); otherwise the inflection type is inferred from the form of the stem. Can also be 'STEM/TR' or 'STEM/TR:TYPE' with manual transliteration supplied (note that manual transliteration can also be specified using separate parameters, as with headword templates like {{ar-adj}}). Can be "-" to suppress the masculine singular.
|head2=, |head3=, ...
Additional masculine singular stems.
|tr=, |tr2=, |tr3=, ...
Alternative way to specify manual transliteration for |1=, |head2=, |head3=, ..., respectively, instead of using the 'STEM/TR' specification. Provided for compatibility with headword templates.
|f=, |f2=, ...
The stem(s) used in the feminine singular, including vowels. Normally unnecessary; if omitted, the feminine singular will be inferred from the masculine singular (equivalent to specifying |f=f). Can be of the form 'STEM' (inflection type inferred), 'STEM:TYPE' (with an explicitly specified inflection type, as above), or 'TYPE' (feminine singular stem inferred from inflection type and masculine singular stem; only works for 'f', 'rf', 'intf', 'cdf', 'elf'). Can also be 'STEM/TR' or 'STEM/TR:TYPE' with manual transliteration supplied. Can be "-" to suppress the feminine.
|ftr=, |f2tr=, ...
Alternative way to specify manual transliteration for |f=, |f2=, ..., respectively, instead of using the 'STEM/TR' specification. Provided for compatibility with headword templates. Similar parameters are available for plurals and duals.
|pl=, |pl2=, ...
The stem(s) used in the masculine plural, including vowels. If omitted, equivalent to specifying |pl=p; i.e. defaults to being unknown, except for color-defect adjectives, where the plural can automatically be determined. To specify a strong plural (as for derived participles), use |pl=sp. Has the same allowed forms as for the feminine singular.
|fpl=, |fpl2=, ...
The stem(s) used in the feminine plural, including vowels. Normally unnecessary; if omitted, inferred from the feminine singular (equivalent to specifying |fpl=sp). Has the same allowed forms as for the feminine singular.
|cpl=, |cpl2=, ...
The stem(s) used in the masculine and feminine plural, including vowels. Equivalent to specifying both |pl= and |fpl= with the same value. Can be freely mixed with |pl= and |fpl= and will be listed after them. Has the same allowed forms as for the feminine singular.
|d=, |d2=, ...
The stem(s) used in the masculine dual, including vowels. Normally unnecessary; if omitted, inferred from the masculine singular (equivalent to specifying |d=d). Has the same allowed forms as for the feminine singular.
|fd=, |fd2=, ...
The stem(s) used in the feminine dual, including vowels. Normally unnecessary; if omitted, inferred from the feminine singular (equivalent to specifying |fd=d). Has the same allowed forms as for the feminine singular.
|number=
Explicitly control which numbers appear. The value is a comma-separated list of one or more of sg, du, pl. By default, all numbers appear.
|state=
Explicitly control which states appear. The value is a comma-separated list of one or more of ind (indefinite) or def (definite); the value con (construct), possible for nouns, doesn't apply to adjectives (although it does apply to gendered nouns and numerals, which otherwise use the same parameters as adjectives). By default, all states appear. Currently, non-"appearing" states are displayed with a dash in place of the appropriate declension members instead of not appearing at all.
|basestate=
Override the morphological state. This is mostly used with proper nouns. The value is one of ind or def (con doesn't apply to adjectives, although it does apply to gendered nouns and numerals, which otherwise use the same parameters as adjectives).
|omitarticle=
If specified, omit the definite article that is otherwise automatically added in the definite state.
|nom_m_sg_ind=, |nom_m_sg_def=, |nom_m_sg_con=, ...
Override particular forms. The param name is a combination of case (nom/acc/gen/inf where inf is the informal form), gender (m/f), number (sg/du/pl) and state (ind/def/con). The value can have semicolons or commas (or Arabic equivalents) to separate distinct stems and a vertical bar to separate alternative spellings for a given stem (typically different possible hamza seats). Manual transliterations can be specified using the 'STEM/TR' form (no alternative parameters are provided in this case for manual translits). When overrides are specified, the page will be placed in a category indicating irregular declension such as Category:Arabic irregular adjectives (or Category:Arabic irregular numerals, etc. depending on the part of speech), unless |noirreg= is given a value.
|lemma=
Override the lemma (displayed at the head of the declension table).
|noirreg=
If specified, don't place the page in an irregular-declension category when overrides are specified.
|pos=
Override the part of speech (displayed at the head of the declension table).
|mod=,|modhead2=,|modhead3=,...; |modf=,|modf2=,...; |modpl=,|modpl2=,...; |modfpl=,|modfpl2=,...; |modd=,|modd2=,...; |modfd=,|modfd2=,...; etc. Also |idafa=. Also |modstate=, |modcase=, |modnumgen=, and |modtr=,|modtr2=,...; |modftr=,|modf2tr=,...; etc.
Specify another word that is declined separately as a modifier. See {{ar-decl-noun}}, except that |modnumgen= is used to restrict both number and gender, typically |modnumgen=m_sg.
|mod2=,|mod2head2=,|mod2head3=,...; |mod2f=,|mod2f2=,...; |mod2pl=,|mod2pl2=,...; |mod2fpl=,|mod2fpl2=,...; |mod2d=,|mod2d2=,...; |mod2fd=,|mod2fd2=,...; etc. Also |idafa2=. Also |mod2state=, |mod2tr=, etc.
Specify a second modifying word. See {{ar-decl-noun}}. Similarly, a third modifying word, etc. can be specified using |mod3= and derivatives, up to |mod9=.

Inflection types edit

tri
Regular triptote.
di
Regular diptote.
in
Form ending in -in, such as final-weak active participles. This automatically selects the "triptote" or "diptote" variant according to the number (singular or plural) and form of the adjective.
triin
Form ending in -in, forcing the "triptote" variant (with indefinite accusative in -iyan). Rarely needed for adjectives.
diin
Form ending in -in, forcing the "diptote" variant (with indefinite accusative in -iya). Rarely needed for adjectives. See {{ar-decl-noun}} for a discussion of the singular and plural -in variants in nouns.
inv
Invariable declension ending in alif or alif maqṣūra. Such words will have feminine plurals in -ayāt and duals in -ayān.
lwinv
Invariable declension, loanword-type. Always ends in tall alif. Such words will have feminine plurals in -āt and duals in -atān, as if the alif was a tāʾ marbūṭa.
an
Forms ending in -an, such as final-weak passive participles.
el
Elative adjective. Same as di but causes the feminine to be inferred as type elf.
cd
Color-defect adjective. Same as di but causes the feminine to be inferred as type cdf and plural to be inferred as type cdp.
rf
Regular feminine in -a.
intf
Intensive feminine, e.g. كَسْلَى (kaslā) to masculine كَسْلَان (kaslān, lazy).
elf
Elative feminine, e.g. كُبْرَى (kubrā) to masculine أَكْبَر (ʔakbar, bigger).
cdf
Color-defect feminine, e.g. حَمْرَاء (ḥamrāʔ) to masculine أَحْمَر (ʔaḥmar, red).
f
Select the appropriate feminine form. Equivalent to elp if the masculine is of type el; cdp if the masculine is of type cd; intf if the masculine is of the form of an intensive adjective, such as كَسْلَان (kaslān, lazy) or عَطْشَان (ʕaṭšān, thirsty); else rf.
smp
Sound masculine plural in -ūn(a)/-īn(a).
sfp
Sound feminine plural in -āt-.
awnp
Plural ending in -awn(a), esp. of adjectives, such as أَدْنَوْنَ (ʔadnawna) plural of أَدْنَى (ʔadnā, closer, lower).
cdp
Color-defect adjective plural.
p
Select the appropriate plural form if known (currently only if the singular is of type cd, in which case it is equivalent to cdp); else, equivalent to type ?.
sp
Select the appropriate plural form if known, else a strong plural. Equivalent to cdp if the singular is of type cd; else sfp for feminines, awnp for masculines if the singular is of type an, smp for other masculines.
d
Select the appropriate dual form.
?
Indicate that the declension is unknown. All inflections will appear as question marks.

Examples edit

A simple example edit

For participles, nisbas and similar adjectives that take sound plurals, it is enough to simply specify a single stem, e.g. for the adjective مُسْلِم (muslim), a simple declaration works:

{{ar-decl-adj|مُسْلِم}}

This yields

A more complex example edit

For more complex examples, generally it is sufficient to copy the headword declaration for an adjective and make minor changes, mostly just changing the template name from {{ar-adj|...}} to {{ar-decl-adj|...}}. For example, for the adjective كَسْلَان (kaslān, lazy), the headword is declared as follows:

{{ar-adj|كَسْلَان|f=كَسْلَانَة|f2=كَسْلَى|pl=كَسَالَى|pl2=كُسَالَى|pl3=كَسْلَى}}

Just changing the template name yields the correct declension template:

{{ar-decl-adj|كَسْلَان|f=كَسْلَانَة|f2=كَسْلَى|pl=كَسَالَى|pl2=كُسَالَى|pl3=كَسْلَى}}

This produces

Note that the code automatically figures out the كَسْلَان (kaslān) is a diptote, and correctly infers the declension of all the other forms. Generally the code is quite good at doing this.

Nisba adjectives edit

Although nisba adjectives use a special template to produce the headword line, they behave like participles, and the normal adjective declension template works fine.

For example, for مِصْرِيّ (miṣriyy, Egyptian), the headword template is as follows:

{{ar-nisba|مِصْرِيّ|pl=sp}}

It is easily converted to a declension template:

{{ar-decl-adj|مِصْرِيّ|pl=sp}}

This produces

This works when the plural is overridden, as well, e.g. for عَرَبِيّ (ʕarabiyy, Arab), the headword template is as follows:

{{ar-nisba|عَرَبِيّ|pl=عَرَب}}

It is easily converted to a declension template just by changing the template name:

{{ar-decl-adj|عَرَبِيّ|pl=عَرَب}}

This produces

Color/defect adjectives edit

Color/defect adjectives typically have a particular format for the feminine and common plural, e.g. for أَصْفَر (ʔaṣfar, yellow):

{{ar-adj|أَصْفَر|f=صَفْرَاء|cpl=صُفْر}}

There is also a special declension class for them, which automatically conjugates the feminine and plural correctly:

{{ar-decl-adj|أَصْفَر:cd}}

This produces:

When the plural needs to be overridden, that can be done, e.g. for أَحْمَر (ʔaḥmar, red):

{{ar-decl-adj|أَحْمَر:cd|cpl=حُمْر|cpl2=أَحَامِر}}

producing

Note that both the masculine and feminine singular are diptotes. The :cd annotation gets this correct, but the code would also get this correct if the forms were explicitly specified, e.g. using

{{ar-decl-adj|أَحْمَر|f=حَمْرَاء|cpl=حُمْر|cpl2=أَحَامِر}}

because أَحْمَر (ʔaḥmar) and حَمْرَاء (ḥamrāʔ) have a shape that is recognizable as a diptote.

Irregular adjectives edit

Irregular adjectives can be specified using annotations and overrides, as necessary.

Irregular example 1 edit

One complex example is the demonstrative pronoun هٰذَا (hāḏā, this), which logically exists only in the definite state, but which doesn't have the definite article attached to it.

Its declension can be specified as follows:

{{ar-decl-adj|هٰذَا:inv|f=هٰذِهِ:inv|pl=هٰؤُلَاءِ:inv|fpl=هٰؤُلَاءِ:inv|d=هٰذَان|fd=هٰتَان|state=def|omitarticle=yes|pos=determiner}}

yielding

This is actually fairly straightforward. Except in the dual, the forms are invariable for case, and this is specified using the :inv annotation to put the words in the invariable declension. (Words in this declension normally end in ـى or ـا, but that is not a requirement of the declension.) The state is restricted to definite, and |omitarticle=yes is given so that the article won't be attached automatically to the forms given. We also override the part of speech displayed next to the lemma so it says "determiner" instead of "adjective".

Irregular example 2 edit

Slightly more complicated is the corresponding demonstrative pronoun ذٰلِكَ (ḏālika, that). For this demonstrative, the dual declension is irregular, with an extra morpheme ـكَ (-ka) attached to the end of all forms. As a result, overrides are needed to specify the declension, requiring a more complex specification:

{{ar-decl-adj|ذٰلِكَ:inv|inf_m_sg_def=ذٰلِك|f=تِلْكَ:inv
|pl=أُولٰئِكَ/ʾulāʾika:inv|fpl=أُولٰئِكَ/ʾulāʾika:inv
|nom_m_du_def=ذَانِكَ|acc_m_du_def=ذَيْنِكَ|gen_m_du_def=ذَيْنِكَ|inf_m_du_def=ذَيْنِكَ
|nom_f_du_def=تَانِكَ|acc_f_du_def=تَيْنِكَ|gen_f_du_def=تَيْنِكَ|inf_f_du_def=تَيْنِكَ
|state=def|omitarticle=yes|pos=determiner}}

Here the dual forms need to be specified using overrides because of their irregularity. Furthermore, the plural has an irregular transliteration, where the first vowel is written long but pronounced short; as a result, the transliteration needs to be given manually. Other than these complications, the specification is similar to هٰذَا (hāḏā, this).

This produces