Template:es-conj/documentation

Usage
This template creates a conjugation table for all Spanish verbs.

This template should be placed in a conjugation section, headed by a ====Conjugation==== section header. The template automatically categorizes the entry into the appropriate Spanish verb subcategory (e.g. Category:Spanish verbs ending in -ar). If the verb has vowel or consonant alternations, it will be categorized appropriately (e.g. Category:Spanish verbs with e-ie alternation or Category:Spanish verbs with c-zc alternation), and if the verb is irregular, it will be categorized into Category:Spanish irregular verbs.

Basic usage
This template has no required parameters. For regular verbs, including verbs with predictable spelling alternations, no parameters are necessary. Certain verbs require one or more indicators to be given inside of angle brackets. For example, a verb such as with an o-ue alternation requires the   indicator to be given:

You can also specify the verb explicitly, e.g., or just e.g. if no indicators need to be given. This is useful to conjugate a verb that is different from the pagename of the entry in question, e.g. to give the conjugation of the verb on the page.

Regular verbs, including those with consonant alternations
1. The verb is fully regular. Use as follows:

which produces

2. The verb is regular other than having a predictable spelling change in the preterite. This is handled automatically, so no parameters are needed. Use as follows:

which produces

3. The verb is regular other than having a predictable change in the present. This is handled automatically, so no parameters are needed. Use as follows:

which produces

Verbs with vowel alternations
1. The verb is regular other than having a vowel alternation in the present. This is not predictable, so an indicator must be given in angle brackets, in this case specifically. Use as follows:

which produces

(Here and in the rest of this section we use 1 to suppress the combined-form table, to avoid hitting a template expansion limit on the documentation page. In reality it is not necessary.)

2. The verb is regular other than having a vowel alternation in the present. As with, an indicator must be given in angle brackets, in this case specifically. Use as follows:

which produces

3. The verb is regular other than having a vowel alternation in the present. It also has a predictable spelling change in the preterite. Both vowel alternation and spelling change occur in the subjunctive. The same indicator  as above should be given; the spelling changes from z to c and from u to ü when the vowel alternation occurs are handled automatically. Specify as follows:

which produces

4. The verb is regular other than having an optional vowel alternation in the present: both  and  are found. In case of multiple vowel alternations, separate the vowel alternation indicators with commas and use  to request no vowel alternation, as follows:

which produces

5. The verb is regular other than having a vowel alternation in the present. The is specified using the indicator :

which produces

This also shows the handling of reflexive verbs.

6. The verb is mostly regular, but in the present tense both  and  occur. To specify this, use  (  to request the non-alternating variant and   to request to alternating variant):

which produces

7. The verb has an irregular vowel alternation u-ue in the present tense. The code  still works in this case. Specify as follows:



which produces

8. The verb has a vowel alternation e-ie in the present tense, and raising to i in various other forms, e.g. the third-person singular preterite  and the gerund. For this, use the code, as follows:



which produces

9. The verb has a vowel alternation e-i in the present tense, as well as a predictable spelling alternation g-gu. As mentioned above, the spelling alternations are automatically detected, so only the indicator  for the vowel alternation needs to be given:



which produces

Irregular verbs
The module knows how to conjugate all irregular verbs, including compounds such as and, and no parameters are needed for them.

1. For example, the verb has various irregularities: present tense, preterite , past participle , imperative , etc. Specify simply as follows:

which produces

2. The verb has two alternative past participles,  (used in most places) and  (used in Argentina and Uruguay). The module knows about this, so specify simply as follows:

which produces

Here, a footnote is automatically added to indicate the different usage of the past participle.

Defective verbs
Certain verbs are defective, i.e. are missing some forms. Indicators are available to specify this.

1. The verb is an impersonal verb, with only 3rd-person singular verbs and no imperative. Specify as follows:

which produces

Here,  means "only third-person singular".

2. The verb is defective and only 3rd-person forms and no imperative. Specify as follows:

which produces

Here,  means "only third-person singular and plural".

3. The verb is defective and is missing forms whose ending does not begin with an i (specifically, the stressed present tense forms and the entire subjunctive). To specify this, use the indicator :

which produces

4. The verb is defective in the same way as. In addition, the root vowel raises to i in certain forms, such as the third-person singular preterite and the entire imperfect subjunctive. This requires two indicators:  as above, and   to indicate the vowel raising. When multiple indicators are required, separate them with a :

which produces

Parameters
The allowed parameters are as follows:


 * 1
 * Optional specification of the verb and/or indicators controlling unpredictable parts of the conjugation. See above.


 * 1
 * Don't display the combined-form table, showing forms like and.

The following indicators are defined for vowel alternations:
 * : Request the default form with no alternations. Useful primarily in verbs that can either have a vowel alternation or no alternation.
 * : Specify that a stressed e or i changes to ie, as in →  or  →.
 * : Specify that a stressed e changes to ie, and unstressed e raises to i in certain forms of verbs, as in  →,.
 * : Specify that a stressed o or u changes to ue, as in →  or  → . This automatically generates üe when appropriate, as in  →.
 * : Specify that a stressed o changes to ue, and unstressed o raises to u in certain forms of verbs, as in  →,.
 * : Specify that a stressed e changes to i, as in →.
 * : Specify that a stressed i changes to í, as in →  or  →.
 * : Specify that a stressed u changes to ú, as in →  or  →.
 * : Specify that a stressed e or i changes to ye, as in →.
 * : Specify that a stressed e changes to ye, and unstressed e raises to i in certain forms of verbs, as in  →,.
 * : Specify that a stressed o changes to hue, as in →  or  →.

Use a dot,, to combine a vowel alternation with one of the codes for defective verbs. For example, the stem vowel of takes ie when stressed, and the verb is impersonal and only appears in the 3rd person singular, so its conjugation table is created with.

Multiword expressions
For multiword expressions, place angle brackets after the verb(s) needing conjugation, with any indicators inside angle brackets as needed. This is not actually necessary if there is only a single verb that is the first word of the expression, as is common.

1. For example, for the idiom, both of the following work and are equivalent:

which produce

2. The expression has more than one conjugated verb. Place angle brackets after each:

which produces

Here we specify 1 to disable the combined-form table, which is cramped and unnecessary.

3. Normally, each word (including the verb) is autolinked separately. You can override the linking behavior by explicitly specifying links, as in, which can be written as follows:

which produces

In this case, the singular of is explicitly linked. In this case, the word also needs to be explicitly linked; otherwise, it would not be linked in the resulting headword and inflections. The verb does not explicitly need a link, however, because verbs and uninflected portions of the expression are autolinked separately.

4. Another example is, which is impersonal and requires an indicator specifying this:

which produces

5. Multiword subexpressions can be linked together if needed, as in the idiom :

which produces

This example also shows that angle brackets should be placed after any reflexive or other clitic pronouns, which will be handled correctly.