Qual è uno stile buono per documentare i tasti di scelta rapida di OS X sul Web con markdown?

3

Spesso ho bisogno di dare istruzioni sull'uso dei tasti di scelta rapida di OS X nella documentazione. Lo scrivo in markdown, di solito su pagine GitHub e talvolta su StackExchange. Le chiavi sono formattate con <kbd>key</kbd> = .

Nelle interfacce OS X le chiavi sono generalmente elencate insieme, senza spazi tra loro. Ma OS X usa un font ben leggibile, quindi la stringa sembra carina.

Ma quando sono visualizzati su un sito web, i simboli non sono sempre belli. Quindi ci sono due opzioni: o scrivere tutte le chiavi in un tag, o ognuna in un tag separato

Opzione 1.

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

Risultante in

  • ⌥ \ = «
  • ⌥⇧ \ = »

Opzione 2

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

Risultante in

  • \ = «
  • \ = »

Quale è il migliore? Dovrei forse aggiungere tra i simboli + ? (A me sembra uno stile Windows).

Opzione 2a

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

1 risposta

5

Non sono sicuro che sia scolpito ovunque, ma la convenzione per Ask Different sembra essere sulla falsariga di

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

dare il nome abbreviato & simbolo della chiave, no + tra

Non è ordinato come il modo Apple, certamente.

Non sono sicuro per "equivalenti chiave" ma forse
Opt ⌥ Maiusc ⇧ \ = »
come opzione 2.

A proposito, io uso le Preferenze di Sistema > Tastiera > Testo per generare rapidamente in Stack Exchange Review (che a quanto pare funziona solo in Safari, non in Firefox o Chrome, vedi Sostituisci il testo con valore predefinito nel browser )

    
risposta data 05.07.2015 - 11:08
fonte

Leggi altre domande sui tag