Acciones

Plantilla

Diferencia entre revisiones de «Duración/doc»

De La Venciclopedia

(Página creada con «{{subpágina de documentación}} <!-- Please place categories where indicated at the bottom of this page and interwikis at Wikidata (see Wikipedia:Wikidata) --> This m…»)
 
mSin resumen de edición
Línea 1: Línea 1:
{{subpágina de documentación}}
{{subpágina de documentación}}
<!-- Please place categories where indicated at the bottom of this page and interwikis at Wikidata (see [[Wikipedia:Wikidata]]) -->
<!-- PLEASE ADD CATEGORIES AND INTERWIKIS AT THE BOTTOM OF THIS PAGE -->


This module implements {{tl|Duración}}. It tries to add a microformat to a duration (<code>hh:mm:ss</code> or <code>mm:ss</code>) whenever possible. If the module is unable to add hAudio microformat (and the input does not contain the microformat) then the page will be included in {{ccc|Venciclopedia:Duración sin microformato hAudio}}.
This template emits the hAudio microformat.


== Usage ==
== Usage ==


This template should normally be called through {{tl|Duración}}, and used as <code>{{((}}#invoke:Duration{{!}}main{{!}}duration=<var>duration</var>{{))}}</code> when included in other templates.
=== Unformatted input ===


Valid parameters are numbered parameters 1, 2 and 3, and unnumbered parameters {{para|h}}, {{para|m}}, {{para|s}} and {{para|duration}}. {{para|duration}} should not be used in {{tl|Duración}}, as {{para|1}} can provide the same function.
An unformatted duration can be input in the first parameter: <code>{{((}}Duración{{!}}10:20:30{{))}}</code> (hours:minutes:seconds) or <code>{{((}}Duration{{!}}20:30{{))}}</code> (minutes:seconds). There ''must'' be a seconds value, as inputs in hours and minutes are indistinguishable from inputs in minutes and seconds.
 
=== Numbered parameters ===
 
<pre>{{Duración|10|20|30}}</pre>
 
where parameters are hours, minutes and seconds respectively. If the hours or minutes values are zero, then leave them blank (e.g. <code>{{((}}Duration{{!}}{{!}}20{{!}}30{{))}}</code>). Minutes and seconds values default to zero, although they should ideally be specified.
 
=== h, m and s parameters ===
 
<pre>{{Duración|h=10|m=20|s=30}}</pre>
 
where h, m and s are hours, minutes and seconds respectively. Minutes and seconds values default to zero, although they should ideally be specified.
 
=== Parent templates ===
 
This template can be used in:
 
{{Flatlist|
* {{Tl|Infobox album}}
* {{Tl|Infobox single}}
* {{Tl|Infobox song}}
}}
 
In {{tl|Infobox album}}, the microformat is added automatically if there is not one already. However, more complicated values might require this template.
 
== Examples ==
 
=== Unformatted input ===
 
*<code><nowiki>{{Duración|1:22:34}}</nowiki></code> renders as: {{Duración|1:22:34}}
*<code><nowiki>{{Duración|74:32}}</nowiki></code> renders as: {{Duración|74:32}}
*<code><nowiki>{{Duración|1:02:34}}</nowiki></code> renders as: {{Duración|1:02:34}}
*<code><nowiki>{{Duración|1:2:3}}</nowiki></code> renders as: {{Duración|1:2:3}}
*<code><nowiki>{{Duración|0:22:34}}</nowiki></code> renders as: {{Duración|0:22:34}}
*<code><nowiki>{{Duración|0:0:34}}</nowiki></code> renders as: {{Duración|0:0:34}}
*<code><nowiki>{{Duración|0:34}}</nowiki></code> renders as: {{Duración|0:34}}
 
=== h, m and s parameters ===
 
*<code><nowiki>{{Duración|h=1|m=22|s=34}}</nowiki></code> renders as: {{Duración|h=1|m=22|s=34}}
*<code><nowiki>{{Duración|m=74|s=32}}</nowiki></code> renders as: {{Duración|m=74|s=32}}
*<code><nowiki>{{Duración|m=2|s=34}}</nowiki></code> renders as: {{Duración|m=2|s=34}}
*<code><nowiki>{{Duración|h=1|s=34}}</nowiki></code> renders as: {{Duración|h=1|s=34}}
*<code><nowiki>{{Duración|h=1}}</nowiki></code> renders as: {{Duración|h=1}}
*<code><nowiki>{{Duración|h=0|m=22|s=34}}</nowiki></code> renders as: {{Duración|h=0|m=22|s=34}}
*<code><nowiki>{{Duración|h=0|m=0|s=34}}</nowiki></code> renders as: {{Duración|h=0|m=0|s=34}}
*<code><nowiki>{{Duración|h=1|m=22|s=34.5678}}</nowiki></code> renders as: {{Duración|h=1|m=22|s=34.5678}}
*<code><nowiki>{{Duración|h=1|m=22|s=3}}</nowiki></code> renders as: {{Duración|h=1|m=22|s=3}}
*<code><nowiki>{{Duración|h=1|m=2|s=34}}</nowiki></code> renders as: {{Duración|h=1|m=2|s=34}}
*<code><nowiki>{{Duración|h=1|m=2|s=3}}</nowiki></code> renders as: {{Duración|h=1|m=2|s=3}}
*<code><nowiki>{{Duración|h=1|m=2}}</nowiki></code> renders as: {{Duración|h=1|m=2}}
*<code><nowiki>{{Duración|s=34}}</nowiki></code> renders as: {{Duración|s=34}}
*<code><nowiki>{{Duración|m=0|s=34}}</nowiki></code> renders as: {{Duración|=0|s=34}}
*<code><nowiki>{{Duración|h=1|m=0|s=34}}</nowiki></code> renders as: {{Duración|h=1|m=0|s=34}}
*<code><nowiki>{{Duración|h=1|m=22|s=0}}</nowiki></code> renders as: {{Duración|h=1|m=22|s=0}}
*{{x}} <code><nowiki>{{Duración|h=one|m=22|s=0}}</nowiki></code> renders as: {{Duración|h=one|m=22|s=0}}
*{{x}} <code><nowiki>{{Duración|h=1|m=22|s=78}}</nowiki></code> renders as: {{Duración|h=1|m=22|s=78}}
*{{x}} <code><nowiki>{{Duración|h=1.1|m=2.2}}</nowiki></code> renders as: {{Duración|h=1.1|m=2.2}}
 
=== Numbered parameters ===
 
*<code><nowiki>{{Duración|1|22|34}}</nowiki></code> renders as: {{Duración|1|22|34}}
*<code><nowiki>{{Duración||74|32}}</nowiki></code> renders as: {{Duración||74|32}}
*<code><nowiki>{{Duración|1|2|34}}</nowiki></code> renders as: {{Duración|1|2|34}}
*<code><nowiki>{{Duración|1|2|3}}</nowiki></code> renders as: {{Duración|1|2|3}}
*<code><nowiki>{{Duración|0|22|34}}</nowiki></code> renders as: {{Duración|0|22|34}}
*<code><nowiki>{{Duración|0|0|34}}</nowiki></code> renders as: {{Duración|0|0|34}}
*<code><nowiki>{{Duración||0|34}}</nowiki></code> renders as: {{Duración||0|34}}
*<code><nowiki>{{Duración|||34}}</nowiki></code> renders as: {{Duración|||34}}
*<code><nowiki>{{Duración|1|22|34.5678}}</nowiki></code> renders as: {{Duración|1|22|34.5678}}
*<code><nowiki>{{Duración||1|22}}</nowiki></code> renders as: {{Duración||1|22}}
*<code><nowiki>{{Duración|1|22}}</nowiki></code> renders as: {{Duración|1|22}}
*<code><nowiki>{{Duración|1|22|0}}</nowiki></code> renders as: {{Duración|1|22|0}}
*{{x}} <code><nowiki>{{Duración|1|22|}}</nowiki></code> renders as: {{Duración|1|22|}}
*<code><nowiki>{{Duración|0|0|0}}</nowiki></code> renders as: {{Duración|0|0|0}}(blank)
*<code><nowiki>{{Duración|||}}</nowiki></code> renders as: {{Duración|||}}(blank)
*{{x}} <code><nowiki>{{Duración|1|22|34|55}}</nowiki></code> renders as: {{Duración|1|22|34|55}}
*{{x}} <code><nowiki>{{Duración|one|22|0}}</nowiki></code> renders as: {{Duración|one|22|0}}
*{{x}} <code><nowiki>{{Duración|1|22|78}}</nowiki></code> renders as: {{Duración|1|22|78}}
*{{x}} <code><nowiki>{{Duración|1.1|2.2}}</nowiki></code> renders as: {{Duración|1.1|2.2}}
 
==TemplateData==
{{encabezado de TemplateData}}
<templatedata>
{
"params": {
"h": {
"aliases": [
"1"
],
"label": "Hours",
"example": "3",
"type": "number",
"suggested": true
},
"m": {
"aliases": [
"2"
],
"label": "Minutes",
"example": "32",
"type": "number",
"suggested": true
},
"s": {
"aliases": [
"3"
],
"label": "Seconds",
"example": "42",
"type": "number",
"suggested": true
}
},
"description": "For use in templates emitting the hAudio [[microformat]]",
"format": "inline"
}
</templatedata>
<includeonly>{{sandbox other||
[[Categoría:Venciclopedia:Plantillas de música|{{PAGENAME}}]]
}}</includeonly><noinclude>[[Categoría:Venciclopedia:Plantillas de uso|{{PAGENAME}}]]</noinclude>


The two triplets of parameters accept numbers as inputs (hours, minutes, seconds respectively). Only {{para|3}} and {{para|s}} can contain decimals; the others must be integers. The seconds value must not exceed 60, and the minutes value must not exceed 60 if there is an hours value. If the inputs are not recognized as numbers, an error message is returned.


{{para|1}} and {{para|duration}} accept strings. If the string contains a microformat then the string will be returned without modification. Otherwise, the module will attempt to add an hAudio microformat to the first unformatted duration found. If the string contains more than one duration, only the first one will have a microformat added.


Errors are placed in {{ccc|Venciclopedia:Duración con errores de parámetros}}.


<includeonly>{{#ifeq:{{SUBPAGENAME}}|sandbox | |
<includeonly>{{#ifeq:{{SUBPAGENAME}}|sandbox | |
<!-- Categories below this line, please; interwikis at Wikidata -->
<!-- Categories below this line, please; interwikis at Wikidata -->
[[Categoría:Venciclopedia:Plantillas de música|{{PAGENAME}}]]
 
}}</includeonly><noinclude>[[Categoría:Venciclopedia:Plantillas de uso|{{PAGENAME}}]]</noinclude>
}}</includeonly>

Revisión del 17:58 11 oct 2020

This template emits the hAudio microformat.

Usage

Unformatted input

An unformatted duration can be input in the first parameter: {{Duración|10:20:30}} (hours:minutes:seconds) or {{Duration|20:30}} (minutes:seconds). There must be a seconds value, as inputs in hours and minutes are indistinguishable from inputs in minutes and seconds.

Numbered parameters

{{Duración|10|20|30}}

where parameters are hours, minutes and seconds respectively. If the hours or minutes values are zero, then leave them blank (e.g. {{Duration||20|30}}). Minutes and seconds values default to zero, although they should ideally be specified.

h, m and s parameters

{{Duración|h=10|m=20|s=30}}

where h, m and s are hours, minutes and seconds respectively. Minutes and seconds values default to zero, although they should ideally be specified.

Parent templates

This template can be used in:

In {{Infobox album}}, the microformat is added automatically if there is not one already. However, more complicated values might require this template.

Examples

Unformatted input

  • {{Duración|1:22:34}} renders as: 1:22:34
  • {{Duración|74:32}} renders as: 74:32
  • {{Duración|1:02:34}} renders as: 1:02:34
  • {{Duración|1:2:3}} renders as: 1:02:03
  • {{Duración|0:22:34}} renders as: 0:22:34
  • {{Duración|0:0:34}} renders as: 0:00:34
  • {{Duración|0:34}} renders as: 0:34

h, m and s parameters

  • {{Duración|h=1|m=22|s=34}} renders as: 1:22:34
  • {{Duración|m=74|s=32}} renders as: 74:32
  • {{Duración|m=2|s=34}} renders as: 2:34
  • {{Duración|h=1|s=34}} renders as: 1:00:34
  • {{Duración|h=1}} renders as: 1:00:00
  • {{Duración|h=0|m=22|s=34}} renders as: 0:22:34
  • {{Duración|h=0|m=0|s=34}} renders as: 0:00:34
  • {{Duración|h=1|m=22|s=34.5678}} renders as: 1:22:34.5678
  • {{Duración|h=1|m=22|s=3}} renders as: 1:22:03
  • {{Duración|h=1|m=2|s=34}} renders as: 1:02:34
  • {{Duración|h=1|m=2|s=3}} renders as: 1:02:03
  • {{Duración|h=1|m=2}} renders as: 1:02:00
  • {{Duración|s=34}} renders as: 0:34
  • {{Duración|m=0|s=34}} renders as: 0:34
  • {{Duración|h=1|m=0|s=34}} renders as: 1:00:34
  • {{Duración|h=1|m=22|s=0}} renders as: 1:22:00
  • {{Duración|h=one|m=22|s=0}} renders as:Error en Módulo:Duration: Valores inválidos
    • {{Duración|h=1|m=22|s=78}} renders as:Error en Módulo:Duration: Los segundos deben ser menos de 60
      • {{Duración|h=1.1|m=2.2}} renders as:Error en Módulo:Duration: Las horas y minutos deben ser números

        Numbered parameters

        • {{Duración|1|22|34}} renders as: 1:22:34
        • {{Duración||74|32}} renders as: 74:32
        • {{Duración|1|2|34}} renders as: 1:02:34
        • {{Duración|1|2|3}} renders as: 1:02:03
        • {{Duración|0|22|34}} renders as: 0:22:34
        • {{Duración|0|0|34}} renders as: 0:00:34
        • {{Duración||0|34}} renders as: 0:34
        • {{Duración|||34}} renders as: 0:34
        • {{Duración|1|22|34.5678}} renders as: 1:22:34.5678
        • {{Duración||1|22}} renders as: 1:22
        • {{Duración|1|22}} renders as: 1:22:00
        • {{Duración|1|22|0}} renders as: 1:22:00
        • {{Duración|1|22|}} renders as: 1:22:00
          • {{Duración|0|0|0}} renders as: (blank)
          • {{Duración|||}} renders as: (blank)
          • {{Duración|1|22|34|55}} renders as:Error en Módulo:Duration: Parámetro 4 no debe especificarse
            • {{Duración|one|22|0}} renders as:Error en Módulo:Duration: Valores inválidos
              • {{Duración|1|22|78}} renders as:Error en Módulo:Duration: Los segundos deben ser menos de 60
                • {{Duración|1.1|2.2}} renders as:Error en Módulo:Duration: Las horas y minutos deben ser números

                  TemplateData

                  TemplateData de Duración

                  For use in templates emitting the hAudio [[microformat]]

                  Parámetros de la plantilla

                  Es preferible escribir los parámetros en una sola línea.

                  ParámetroDescripciónTipoEstado
                  Hoursh 1

                  sin descripción

                  Ejemplo
                  3
                  Númerosugerido
                  Minutesm 2

                  sin descripción

                  Ejemplo
                  32
                  Númerosugerido
                  Secondss 3

                  sin descripción

                  Ejemplo
                  42
                  Númerosugerido