Mai mult
Cum de a adăuga culoare la Github's README.md fișier
Am un README.md fișier pentru proiectul meu subliniere-cli, destul de dulce instrument de hacking JSON și JS pe linia de comandă.
Vreau să-document "--culoare" pavilion ... care ... culori lucruri. Asta ar merge mult mai bine dacă am putea arăta de fapt, ceea ce ieșire se pare. Pot't par să găsească o modalitate de a adăuga culoare pentru a-mi README.md. Orice idei?
Am'am incercat asta:
<span style="color: green"> Some green text </span>
Și acest lucru:
<font color="green"> Some green text </font>
Nici un noroc până acum.
271
9
L's de remarcat faptul că puteți adăuga unele de culoare într-un README folosind o imagine substituent de servicii. De exemplu, dacă ai vrut pentru a oferi o listă de culori pentru referință:
Produce:
#f03c15
#c5f015
#1589F0
Puteți utiliza
diff
tagul de limba pentru a genera un text colorat:Nu poți culoare text simplu într-un GitHub
README.md
de fișier. Cu toate acestea, puteți adăuga culoare pentru exemple de cod cu tag-uri de mai jos.Pentru a face acest lucru trebuie doar să adăugați tag-uri, cum ar fi aceste probe la README.md fișier:
Nu "pre" sau "codul" tag-uri necesare.
Acesta este acoperit în GitHub Reduceri de documentare (aproximativ jumătate de drum în jos a paginii, acolo's un exemplu folosind Ruby). GitHub foloseste Lingvist pentru a identifica și evidenția sintaxa - puteți găsi o listă completă de limbi suportate (precum și reduceri cuvinte cheie) în Lingvist's YAML.
Din păcate, acest lucru nu este posibil în prezent.
De GitHub Reduceri documentația nu are nici o mențiune de 'de culoare', 'css', 'html', sau 'stil'.
În timp ce unele Reduceri de procesoare (de exemplu cel folosit în Duhul) permite HTML, cum ar fi
<span style="culoare:portocaliu;">Cuvantul</span>
, GitHub's abandonează orice HTML.Daca's imperativ ca voi folosi culoarea în readme, README.md ar putea pur și simplu se referă utilizatorilor la un README.html. Trade-off pentru aceasta, desigur, este accesibilitatea.
Am'm înclinat să fie de acord cu Qwertman care-l's, în prezent, nu este posibil să specificați o culoare pentru textul din GitHub markdown, cel puțin nu prin HTML.
GitHub permite unele elemente HTML și atribute, dar numai de unii (a se vedea documentația lor despre lor HTML igienizare). Ele permit
p
șidiv
tag-uri, precum și "culoare" atribut. Cu toate acestea, atunci când am încercat să le folosesc într-un markdown document pe GitHub, nu't de lucru. Am încercat următoarele (printre alte variante), și-au n't de lucru:<p style='culoare:rosu'>Acesta este un text rosu.</p>
<font color="roșu">Acesta este un text!</font>
Ca Qwertman a sugerat, dacă aveți cu adevărat trebuie să utilizați culoare ai putea-o face într-un README.html și ele se referă la ea.
Ca o alternativă la randarea unei imagini raster, puteți încorpora un fișier SVG:
Apoi, puteți adăuga culoare text în fișier SVG, ca de obicei:
Din păcate, deși puteți selecta și copia text atunci când deschideți `.svg file, textul nu este selectabil când SVG imagine este încorporat.
Demo: https://gist.github.com/CyberShadow/95621a949b07db295000
Am adăugat niște culoare la o GitHub marcaj de pagină folosind emoji Enicode caractere, de exemplu, 💡 sau 🛑 - unele caractere emoji sunt colorate în unele browsere. (Nu sunt de culoare emoji alfabete în măsura în care știu, totuși.)
Ca de scris, Github Markdown face
`#hexhex
cu o culoare de previzualizare.Bazat pe @AlecRust idee, am făcut o punere în aplicare a png text de servicii.
Demo-ul este aici:
http://lingtalfi.com/services/pngtext?color=cc0000&dimensiune=10&text=Alo%20World
Există patru parametri:
Vă rugăm să nu folosiți acest serviciu direct (cu excepția pentru testare), dar utilizarea la clasa I-a creat, care oferă servicii de:
https://github.com/lingtalfi/WebBox/blob/master/Image/PngTextUtil.php
Notă: dacă nu't de a folosi universul cadru, va trebui să înlocuiți această linie:
Cu acest cod:
În cazul în care dumneavoastră hex de culoare trebuie să fie exact 6 caractere lungime (don't pune simbolul hash (#) în fața lui).
Notă: în cele din urmă, nu am folosit acest serviciu, pentru că am constatat că fontul a fost urât și mai rău: nu a fost posibil pentru a selecta textul. Dar de dragul acestei discuții, am crezut că acest cod a fost în valoare de partajare...