Mam README.md
plik do mojego projektu underscore-cli , całkiem miłe narzędzie do hakowania JSON i JS w wierszu poleceń.
Chcę udokumentować --color
flagę ... która ... koloruje rzeczy. Byłoby o wiele lepiej, gdybym mógł pokazać, jak wygląda wyjście. Nie mogę znaleźć sposobu na dodanie koloru do mojego README.md
. Jakieś pomysły?
Próbowałem tego:
<span style="color: green"> Some green text </span>
I to:
<font color="green"> Some green text </font>
Jak dotąd brak szczęścia.
Odpowiedzi:
Warto wspomnieć, że można dodać trochę koloru w README za pomocą zastępczej usługi obrazu. Na przykład, jeśli chcesz podać listę kolorów w celach informacyjnych:
Produkuje:
#f03c15
#c5f015
#1589F0
źródło
https://placehold.it/150/ffffff/ff0000?text=hello
Możesz użyć
diff
znacznika języka, aby wygenerować kolorowy tekst:Dodaje go jednak jako nową linię zaczynającą się na którąkolwiek z nich
- + ! #
Ten problem został podniesiony w znaczniku github # 369 , ale od tego czasu nie wprowadzili żadnych zmian w decyzji (2014).
źródło
@@
w kolorze fioletowym (i pogrubione). Codecov korzysta z tego w komentarzach bota integracji GitHub, na przykład: github.com/zeit/now/pull/2570#issuecomment-512585770W GitHub nie można pokolorować zwykłego tekstu
README.md
pliku . Możesz jednak dodać kolor do próbek kodu za pomocą poniższych tagów.Aby to zrobić, po prostu dodaj tagi takie jak te przykłady do pliku README.md:
Nie są potrzebne tagi „przed” ani „kod”.
Jest to opisane w dokumentacji GitHub Markdown (mniej więcej w połowie strony znajduje się przykład użycia Ruby). GitHub używa Linguist do identyfikowania i wyróżniania składni - możesz znaleźć pełną listę obsługiwanych języków (a także ich słów kluczowych przy przecenianiu) w pliku YAML Lingwisty .
źródło
Deprecated
´´´´. Działa dobrze, do dodawania tagów przestarzałych do dokumentów.Niestety obecnie nie jest to możliwe.
W dokumentacji GitHub Markdown nie ma wzmianki o „kolorze”, „css”, „html” ani „stylu”.
Podczas gdy niektóre procesory Markdown (np. Używane w Ghost ) pozwalają na HTML, na przykład
<span style="color:orange;">Word up</span>
GitHub odrzuca dowolny HTML.Jeśli konieczne jest użycie koloru w pliku Readme, plik README.md może po prostu skierować użytkowników do pliku README.html. Kompromisem tego jest oczywiście dostępność.
źródło
hr
,br
,p
,b
,i
a inni działają!Alternatywnie do renderowania obrazu rastrowego możesz osadzić plik SVG:
Następnie możesz jak zwykle dodać kolorowy tekst do pliku SVG:
Niestety, mimo że możesz zaznaczyć i skopiować tekst po otwarciu
.svg
pliku, nie można go zaznaczyć po osadzeniu obrazu SVG.Demo: https://gist.github.com/CyberShadow/95621a949b07db295000
źródło
Jestem skłonny zgodzić się z Qwertmanem, że obecnie nie jest możliwe określenie koloru tekstu w Markdown GitHub, przynajmniej nie poprzez HTML.
GitHub zezwala na niektóre elementy HTML i atrybuty, ale tylko niektóre (zobacz dokumentację dotyczącą ich czyszczenia HTML ). Robią dozwolone
p
idiv
tagi, a takżecolor
atrybuty. Jednak gdy próbowałem ich użyć w dokumencie GitHub, nie udało się to. Próbowałem następujące (między innymi odmianami), ale nie działały:<p style='color:red'>This is some red text.</p>
<font color="red">This is some text!</font>
These are <b style='color:red'>red words</b>.
Jak zasugerował Qwertman, jeśli naprawdę musisz użyć koloru, możesz to zrobić w pliku README.html i odwołać się do niego.
źródło
Dodałem trochę koloru do strony znaczników GitHub za pomocą znaków emoji Enicode, np. 💡 lub 🛑 - niektóre znaki emoji są kolorowe w niektórych przeglądarkach. (O ile mi wiadomo, nie ma kolorowych alfabetów emoji).
źródło
W chwili pisania Github Markdown wyświetla kody kolorów, takie jak
`#ffffff`
(uwaga backticks!), Z podglądem kolorów. Wystarczy użyć kodu koloru i otoczyć go backtickami.Na przykład:
staje się
źródło
`#hexhex`
W oparciu o pomysł @AlecRust wykonałem implementację usługi tekstowej png.
Demo jest tutaj:
http://lingtalfi.com/services/pngtext?color=cc0000&size=10&text=Hello%20World
Istnieją cztery parametry:
Nie używaj tej usługi bezpośrednio (z wyjątkiem testowania), ale skorzystaj z utworzonej przeze mnie klasy, która zapewnia usługę:
https://github.com/lingtalfi/WebBox/blob/master/Image/PngTextUtil.php
Uwaga: jeśli nie używasz frameworku wszechświata , musisz zastąpić ten wiersz:
Z tym kodem:
W takim przypadku Twój kolor heksadecymalny musi mieć dokładnie 6 znaków (nie umieszczaj przed nim symbolu skrótu (#)).
Uwaga: ostatecznie nie korzystałem z tej usługi, ponieważ okazało się, że czcionka była brzydka i gorzej: nie można było zaznaczyć tekstu. Ale ze względu na tę dyskusję pomyślałem, że ten kod warto udostępnić ...
źródło