¿Cuál es un buen estilo para documentar las teclas de acceso rápido de OS X en la web con una reducción?

3

A menudo necesito dar instrucciones sobre el uso de las teclas de acceso rápido de OS X en la documentación. Lo escribo en markdown, generalmente en las páginas de GitHub y algunas veces en StackExchange. Las claves están formateadas con <kbd>key</kbd> = clave .

En las interfaces OS X, las claves generalmente se listan juntas, sin espacios entre ellas. Pero OS X usa una fuente bien legible, por lo que la cadena se ve bonita.

Pero cuando se representan en un sitio web, los símbolos no siempre se ven bien. Así que hay dos opciones: escribir todas las claves en una etiqueta, o cada una en una etiqueta separada

Opción 1.

* <kbd>⌥\</kbd> = '«'
* <kbd>⌥⇧\</kbd> = '»'

Resultando en

  • ⌥ \ = «
  • ⌥⇧ \ = »

Opción 2

* <kbd>⌥</kbd><kbd>\</kbd> = '«'
* <kbd>⌥</kbd><kbd>⇧</kbd><kbd>\</kbd> = '»'

Resultando en

  • \ = «
  • \ = »

¿Cuál es mejor? ¿Debería tal vez agregar + símbolos en medio? (Que me parece un estilo de Windows).

Opción 2a

  • + \ = «
  • + + \ = »
pregunta Nick Volynkin 05.07.2015 - 10:54

1 respuesta

5

No estoy seguro de que esté escrito en piedra en ninguna parte, pero la convención de Ask Different parece estar en la línea de

<kbd> Cmd ⌘ </kbd> <kbd> Ctrl ⌃ </kbd> <kbd> Opt ⌥ </kbd> <kbd> Shift ⇧ </kbd> <kbd> T </kbd>
Cmd ⌘ Ctrl ⌃ Opt ⌥ Shift ⇧ T

dando el nombre abreviado & símbolo clave, no + entre

Es cierto que no está tan ordenado como Apple.

No estoy seguro de los 'equivalentes clave', pero quizás
Opt ⌥ Shift ⇧ \ = »
como su opción 2.

Por cierto, utilizo System Prefs > Teclado > Texto para generar estos rápidamente en Stack Exchange. (que aparentemente solo funciona en Safari, no en Firefox o Chrome, consulte Reemplazar texto con valor predefinido en el navegador )

    
respondido por el Tetsujin 05.07.2015 - 11:08

Lea otras preguntas en las etiquetas