Template:bg-adecl/documentation

Introduction
This template should be used to decline all Bulgarian adjectives.

Generally, a single argument is supplied to the template, consisting of an adjective (multisyllabic adjectives are required to have an acute accent indicating the stress) followed by a declension spec in angle brackets. In the most basic case, nothing needs to be supplied between the angle brackets. For example, for the adjective :

produces

Indicators
Indicators can be specified inside of angle brackets to modify the default declension behavior. For example, the   indicator specifies that the adjective lacks comparative and superlative forms, e.g. for :

produces

Note also here that the module automatically knows how to handle adjectives whose lemma ends in -и.

Reducible adjectives
Another indicator is, which specifies that the adjective is "reducible" (i.e. an е, ъ or я in the last syllable drops out in all forms that take an ending). For example, for the adjective, all forms but the lemma use the stem черн-:

produces

The module automatically knows how to handle reducible adjectives with a vowel directly preceding the reducible vowel, e.g. (stem бойк-) and  (stem войн-):

produces

produces

The last example shows that when multiple indicators need to be specified, they are simply concatenated.

Other stem alternations
Many adjectives alternate between -я- and -е- in different forms. There are two variants, exemplified by (feminine бя́ла, plural бе́ли) and  (feminine тя́сна, plural те́сни). Both are specified using the  indicator:

produces

produces

In the latter example, the adjective is reducible (the final -е- in the lemma form drops out in other forms), which is indicated by.

A few adjectives alternate between -ръ- and -ьр- in different forms. There are again two variants, exemplified by (feminine дръ́зка, plural дръ́зки) and  (feminine пъ́рва, plural пъ́рви). Both are specified using the  indicator:

produces

produces

Note that in the first example, is reducible (the final -ъ- in the lemma form drops out in other forms), which is indicated by. Meanwhile, in the second example, has no comparative or superlative, which is indicated by.

Stressed endings
A few adjectives, such as, , and  have the stress on the endings (e.g. definite subjective masculine sinuglar добри́ят, зли́ят, делови́ят, свети́ят. In the first three cases, the module can automatically figure this out, based on the following: For adjectives like , there is no way for the module to know that the endings are stressed. To indicate this, use the indicator   (compare the noun accent patterns in ):
 * 1) If the adjective ends in stressed -и́, it is assumed to be ending-stressed.
 * 2) If the adjective is reducible and the reducible vowel is stressed, it is assumed to be ending-stressed.

produces

You should know that the indicator, if given, indicates stem stress, but is rarely if ever required as stem stress is the default except in the two situations specified just above.

Soft endings
Some adjectives have "soft endings" (e.g. feminine in -я instead of -а). There are two variants, both of which are indicated using :
 * 1) Possessive adjectives in -и, typically referring to animals, with lemma in -и and neuter singular in -е, e.g..
 * 2) Adjectives whose lemma ends in a consonant, with neuter singular in -ьо, e.g..

Examples:

produces

produces

Some adjectives whose stem ends in a consonant such as ч or ш have their feminine singular in -а as normal, but the neuter singular in either -е or -о. These are indicated using, e.g.  and :

produces

produces

Multiple declensions
You can specify more than one collection of indicators, comma-separated. For example, has stem either бето́нен- (non-reduced) or бето́нн- (reduced). You can indicate this as follows:

which produces

Here we specify to decline both as  (no comparative) and   (no comparative, reducible). Note that the no-comparative indicator  must be specified in both indicator collections.

Another such adjective is, which has feminine either безвя́рна or безве́рна (i.e. either with or without alternation between -я- and -е-. You can indicate this as follows:

which produces

Here we specify to decline both as  (reducible, я/е alternation) and   (reducible but without я/е alternation).

Alternative stresses
You can specify alternative lemma forms, which is especially useful for words with multiple possible stress patterns. For example, (feminine не́добра) can also be stressed as  (feminine недобра́). You can indicate this as follows:

which produces

Here we have to repeat the reducible indicator  in both places, but the fact that  has stresss pattern   while  has stress pattern   (see above) is automatically detected.

Overriding individual forms
It is possible to override individual forms in unusual cases. To do this, add the syntax  after any indicators, inside of, where   is the particular form to override (e.g.   for the definite feminine singular) and   are the individual values that the form should take. For examples, see below and under pronoun/number support. The allowable slots are:

You can also use a similar syntax to specify boolean properties, i.e. yes-no properties that don't need to take a specific value: When specifying,   or  , manual overrides must be given for all the non-lemma slots. See below for examples.

Note that some of the above slots can be used to override the lemma form, specifically:
 * for normal adjectives
 * for -type adjectives
 * for -type adjectives
 * for -type adjectives

This can be useful when the lemma form is irregular compared with the remaining forms.

An example of using the above properties is, where all but the lemma forms use a stem нейн-:

produces

Here we do the following:
 * 1) Specify that there are no comparative or superlative forms, using.
 * 2) Use an override to specify a short form . Short forms don't exist by default, but specifying one will cause it to display in the table.
 * 3) Specify the lemma as нейн (the stem used for all but the actual lemma form), and override the lemma form (indefinite masculine singular) with the actual value . This ensures that all non-lemma forms are correctly declined using the stem нейн- (indefinite feminine singular не́йна, definite subjective masculine singular не́йният, etc.).

Pronouns, numbers, etc.
There is special support for declension tables for numbers that vary depending on gender (e.g., and compounds) and pronouns of two types: those with special accusative and dative forms in the masculine singular (e.g. , ) and those without (e.g. , ).

To enable this support, use a special property corresponding to the type of table required, and specify manual overrides for all the non-lemma forms. The supported properties are:
 * for and compounds
 * for, , and similar pronouns
 * for, , and similar pronouns

Examples:

1. For :

which produces

2. For :

which produces

Note here that we specify a footnote after кому́ to indicate that it is archaic (see for more information on specifying footnotes; the same format is used).

3. For :

which produces