Plantía:Kbd/doc

Esta plantía ye pa indicar de mou esplícitu que'l conteníu de dientro d'ella representa la entrada dende un tecláu o otra fonte (software de reconocimientu de voz, entrada estándar, etc.) Usa l'elementu [X]HTML <kbd>...</kbd> (keyboard input) qu'esiste con esti propósitu, y aplica-y daqué d'estilu, en concreto un fondu buxu dilíu (emprestáu de la plantía rellacionada {{key press}}) y un llixeru espaciáu de lletra CSS pa suxerir caráuteres introducíos individualmente. Caltién l'estilu de fonte monoespaciáu (non-proporcional) predetermináu del elementu <kbd>. Como usa <kbd>...</kbd> en llugar d'aplicar simplemente efeutos d'estilu visuales, ye un marcáu semánticu qu'espresa significáu, y sobre'l que puede siguir actuando l'axente d'usuariu (p.ex. con fueyes d'estilu llocales personalizaes). Esta etiqueta ye exautamente lo contrario de {{samp}}, que ye pa una salida d'exemplu.

Usu

La plantía toma un parámetru obligatoriu, el conteníu a marcar. Si esti conteníu contién "=" (un signu igual), el parámetru tien de llamase de mou esplícitu |1=, o la plantía fallará. (Esto ye un problema del software MediaWiki, non de la plantía.) Siempre ye más seguro usar la sintaxis |1=. Puede usase como contenedor pa {{var}}, {{varserif}} o <var>...</var> cuando la entrada de tecláu d'exemplu contenga o consista enteramente nuna variable. Tamién puede usase con (pero non dientro de) {{code}}, o con <code>...</code> (polo xeneral nun tendría d'usase dientro de la última, porque la entrada nun ye parte del códigu fonte, sinón daqué qu'interactúa col mesmu; sicasí, esti puede usase pa ilustrar una pantalla d'ordenador de tipu mistu, como s'ilustra más abaxo).

Hai un parámetru opcional | (o | o cualquier otru valor), pa quitar el llixeru espaciáu de lletres, que puede quedar mal en pasaxes d'entrada llargos.

Exemplos:

• {{kbd|71077345}}: "Al escribir 71077345 nuna calculadora y da-y vuelta, paez que pon ShellOil."
• {{kbd|1=ssh {{var|hostname}}}} con {{samp|%}}: "Col prompt Plantía:Samp, l'usuariu tien d'escribir ssh Plantía:Var."
• {{kbd|1=ssh {{var|hostname}}}} con {{samp|%}} y {{key press|Enter}}: "Col prompt Plantía:Samp, l'usuariu tien d'escribir ssh Plantía:Var↵ Entrar."
• Dientro de <code>...</code>: "Na llinia de comandos tendría de vese: % ssh Plantía:Var (onde Plantía:Var ye la direición IP o'l nome de dominiu del sistema al que coneutase); si esto ye correuto, pulsia ↵ Entrar."
• {{kbd|1={{lorem}}|spacing=0}} pa quitar l'espaciáu: Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.

Dalgunos d'estos exemplos pueden vese llixeramente distintes fora d'esta documentación, porque'l color de fondu predetermináu cambia col tipu de páxina (los artículos son blancos dafechu, la plantía documentación verde pálidu, y munches otres páxines son un buxu bien pálidu). Exemplu en artículu:

• {{kbd|71077345}}: "Al escribir 71077345 nuna calculadora y da-y vuelta, paez que pon ShellOil."
• {{kbd|1=ssh {{var|hostname}}}} with {{samp|%}}: "Col prompt Plantía:Samp, l'usuariu tien d'escribir ssh Plantía:Var."
• {{kbd|1=ssh {{var|hostname}}}} con {{samp|%}} y {{key press|Enter}}: "Col prompt Plantía:Samp, l'usuariu tien d'escribir ssh Plantía:Var↵ Entrar."
• Dientro de <code>...</code>: "Na llinia de comandos tendría de vese: % ssh Plantía:Var (onde Plantía:Var ye la direición IP o'l nome de dominiu del sistema al que coneutase); si esto ye correuto, pulsia ↵ Entrar."
• {{kbd|1={{lorem}}|spacing=0}} pa quitar l'espaciáu: Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.