Edició de «Plantilla:Fquim/doc»

{{Subpágina de documentación}}
=== Uso ===
Esta plantilla, {{ep|fquim}}, tiene la finalidad de simplificar la escritura de las [[fórmula química|fórmulas químicas]]. Por ejemplo al escribir,

{{epc|fquim|H|2|O}}

;Se obtiene:
:{{fquim|H|2|O}}

Junto con esta plantilla y con el mismo formato se pueden utilizar las plantillas de partículas subatómicas {{ep|e-}}, {{ep|p+}} y {{ep|n0}} las cuales respectivamente producen los siguientes resultados: {{e-}}, {{p+}}, {{n0}}.

=== Expresiones algebraicas como subíndice ===

Las expresiones algebraicas son renderizadas como subíndices (pero no pueden contener letras en mayúscula).
<pre>
{{fquim|C|''n''|H|2''n''&amp;nbsp;+&amp;nbsp;2}}
</pre>
Se obtiene
: {{fquim|C|''n''|H|2''n''&nbsp;+&nbsp;2}}

===Carga===
La plantilla soporta la expresión de carga de iones como superíndices:
<pre>
{{fquim|H|3|O|+}}
</pre>
Obteniéndose un "+" como superíndice:
: {{fquim|H|3|O|+}}

Se pueden utilizar simultáneamente subíndices y superíndices, distinguiendo la plantilla cuando corresponde a uno y cuando a otro (nota: Utilizar un guión - en el lugar de un signo menos):
<pre>
{{fquim|SO|4|2-}}
</pre>
Produce un "2-" como superíndice:
: {{fquim|SO|4|2-}}
;Nota: 
:El guion se convierte en un signo menos verdadero.

===Fórmulas semidesarrolladas y complejos===
La planilla permite utilizar signos de agrupación para definir fórmulas semidesarrolladas y complejos, por ejemplo:
<pre>
{{fquim|[|Fe|(|C|N|)|6|]|4-}}
</pre>
Produce:
: {{fquim|[|Fe|(|C|N|)|6|]|4-}}
y
<pre>
{{fquim|(|Cr|2|O|6|)|Fe|(|O|H|)}}
</pre>
Produce:
: {{fquim|(|Cr|2|O|6|)|Fe|(|O|H|)}}

===Número atómico y número másico===
El primer parámetro puede utilizarse como número másico, al escribir:
<pre>
{{fquim|4|He}}
</pre>
Se obtiene:
: {{fquim|4|He}}

Los dos primeros parámetros pueden ser utilizados como número másico y número atómico, por ejemplo al escribir:
<pre>
{{fquim|4|2|He}}
</pre>
Se obtiene:
: {{fquim|4|2|He}}

;Nota: 
:Únicamente los dos primeros parámetros pueden renderizar dos números sin signo. De otra forma la plantilla puede terminar invertida.

===Enlaces===
El parámetro opcional <tt>link</tt> convierte la fórmula en un enlace interno. Por ejemplo, al escribir:
<pre>
{{fquim|link=agua|H|2|O}}
</pre>
Obtenemos:
: {{fquim|link=agua|H|2|O}}

Para enlazar cada uno de los elementos en forma individual, puede hacerse de la siguiente manera:

<pre>
{{fquim|[[Hidrógeno|H]]|2|[[Oxígeno|O]]}} 
</pre>
Obteniéndose
: {{fquim|[[Hidrógeno|H]]|2|[[Oxígeno|O]]}} 

==Notas==

*Para incluir un simple enlace "-" en la fórmula, utiliar el código <code>&amp;#150;</code>. Por ejemplo, <code><nowiki>{{fquim|CH|3|&amp;#150;CH|3}}</nowiki></code> produce {{fquim|CH|3|&#150;CH|3}}.
*Para incluir un doble enlace "=" en la fórmula, utilizar el código <code>&amp;#61;</code>. Por ejemplo, <code><nowiki>{{fquim|CH|2|&amp;#61;CH|2}}</nowiki></code> produce {{fquim|CH|2&#61;CH|2}}.
**O, en su defecto, <code><nowiki>{{fquim|CH|2}}={{fquim|CH|2}}</nowiki></code>, lo que produce {{fquim|CH|2}}={{fquim|CH|2}}.
**O, no utilices esta plantilla. Por ejemplo, <code><nowiki>CH<sub>2</sub>=CH<sub>2</sub></nowiki></code> produce CH<sub>2</sub>=CH<sub>2</sub>.
*Para incluir un triple enlace "≡" en la fórmula, utilizar el código <code>&amp;#8801;</code> por ejemplo, "<nowiki>{{fquim|HC&amp;#8801;CH}}</nowiki>" produce {{fquim|HC&#8801;CH}}.
*Esta plantilla acepta mas de 24 parámetros, además del código de enlace <code>link</code>.
*Esta plantilla utiliza {{tl|su}}.

== Datos de la plantilla ==
<!-- {{TemplateDataHeader}} -->
<templatedata>
{
    "description": "Codifica una fórmula química. Esta plantilla hace uso de sobrecarga, de forma que no puede ser documentada con facilidad para VisualEditor. Cada parámetro puede ser el símbolo de un elemento químico como 'Si'; un número, o una expresión algebraica (2''n''&nbsp;+&nbsp;2) – siendo renderizada como subíndices; las cargas '+', '-', '2+' etc. – son renderizadas como superíndices. Adicionalmente, los primeros parámetros pueden ser el número atómico o la masa atómica.",
    "params": {
        "1": {
            "label": "1",
            "description": "Ya sea un símbolo químico como 'H' renderizado en forma normal, o un número másico renderizado como superíndice.",
            "type": "string",
            "required": true
        },
        "2": {
            "label": "2",
            "description": "Ya sea un símbolo químico como 'H' renderizado en forma normal, o un número atómico renderizado como un subíndice.",
            "type": "string",
            "required": false
        },
        "3": {
            "label": "3",
            "description": "Ya sea un símbolo químico como 'H' renderizado en forma normal, o una fórmula renderizada como subíndice, o una carga renderizada como superíndice.",
            "type": "string",
            "required": false
        },
        "4": {
            "label": "4",
            "description": "",
            "type": "string",
            "required": false
        },
        "5": {
            "label": "5",
            "description": "",
            "type": "string",
            "required": false
        },
        "6": {
            "label": "6",
            "description": "",
            "type": "string",
            "required": false
        },
        "7": {
            "label": "7",
            "description": "",
            "type": "string",
            "required": false
        },
        "8": {
            "label": "8",
            "description": "",
            "type": "string",
            "required": false
        },
        "9": {
            "label": "9",
            "description": "",
            "type": "string",
            "required": false
        },
        "10": {
            "label": "10",
            "description": "",
            "type": "string",
            "required": false
        },
        "11": {
            "label": "11",
            "description": "",
            "type": "string",
            "required": false
        },
        "12": {
            "label": "12",
            "description": "",
            "type": "string",
            "required": false
        },
        "13": {
            "label": "13",
            "description": "",
            "type": "string",
            "required": false
        },
        "14": {
            "label": "14",
            "description": "",
            "type": "string",
            "required": false
        },
        "15": {
            "label": "15",
            "description": "",
            "type": "string",
            "required": false
        },
        "16": {
            "label": "16",
            "description": "",
            "type": "string",
            "required": false
        },
        "17": {
            "label": "17",
            "description": "",
            "type": "string",
            "required": false
        },
        "18": {
            "label": "18",
            "description": "",
            "type": "string",
            "required": false
        },
        "19": {
            "label": "19",
            "description": "",
            "type": "string",
            "required": false
        },
        "20": {
            "label": "20",
            "description": "",
            "type": "string",
            "required": false
        },
        "21": {
            "label": "21",
            "description": "",
            "type": "string",
            "required": false
        },
        "22": {
            "label": "22",
            "description": "",
            "type": "string",
            "required": false
        },
        "23": {
            "label": "23",
            "description": "",
            "type": "string",
            "required": false
        },
        "24": {
            "label": "24",
            "description": "",
            "type": "string",
            "required": false
        },
        "link": {
            "label": "link",
            "description": "Un enlace interno, por ejemplo 'agua'.",
            "type": "string",
            "required": false
        }
    }
}
</templatedata>

<includeonly>
[[Category:Wikipedia:Fiches de química]]
</includeonly>