Le intestazioni ASCII fanno risaltare un README
Un README banale apre con una riga di testo. Uno ottimo apre con un banner. L'ASCII art dà al tuo progetto un'intestazione riconoscibile, divisori di sezione e badge di stato senza aggiungere file immagine al repository — è solo testo, quindi carica all'istante e funziona in qualsiasi viewer Git.
Usa sempre un blocco di codice
Il Markdown di GitHub mostra il testo normale in modo proporzionale, distruggendo l'allineamento ASCII. Racchiudi l'arte in un blocco di codice così viene reso in monospazio:
```__ __ _ _ _ _ ___| \/ | | | | | | | / __|| |\/| | |_| | |_| \__ \|_| |_|\__, |\___/|___/|___/```
Usa un blocco con tripli backtick senza tag di linguaggio così nessun evidenziatore di sintassi ricolora l'arte.
Scegli la larghezza giusta
I README si leggono su schermi desktop ampi ma anche in anteprime mobile strette e nella lista file di GitHub. Punta a 80-100 caratteri: abbastanza largo per un'intestazione decisa, abbastanza stretto da non scorrere lateralmente su telefono. Per i divisori di sotto-sezione, più corto è meglio.
Dove usarlo
- Il banner del titolo del progetto in cima.
- Divisori di sezione sopra Installazione, Uso e Licenza.
- Semplici marcatori di stato come
== BUILD PASSING ==. - Un logo ASCII generato dall'icona della tua app.
Mantienilo accessibile
Gli screen reader leggono l'ASCII art carattere per carattere, quindi non nascondere informazioni essenziali dentro l'arte. Tieni un titolo testuale normale accanto al banner così la pagina ha senso anche senza.