| Line 94: |
Line 94: |
| | It is encouraged to use [https://unicode.org/emoji/charts/full-emoji-list.html unicode emojis] (which you can just copy-paste as text) in places where they can draw extra attention, help illustrate your point, or break up the monotony of a long text. | | It is encouraged to use [https://unicode.org/emoji/charts/full-emoji-list.html unicode emojis] (which you can just copy-paste as text) in places where they can draw extra attention, help illustrate your point, or break up the monotony of a long text. |
| | | | |
| − | Be aware that emojis may be rendered differently in different browsers or operating systems, so try to pick ones that are common and unambiguous, and also recognizable in a small font. | + | Be aware that emojis may be rendered differently in different browsers or operating systems, so try to pick ones that are common and unambiguous, and also recognizable at the scale they get reduced to when placed in-line on our Wiki. |
| | | | |
| − | Don't overdo the emojis, as that may make it seem like our wiki was written by AI.
| + | Lastly, don't overdo the emojis, as that could make it seem like our wiki was written by AI. |
| | | | |
| | ====Examples==== | | ====Examples==== |
| Line 114: |
Line 114: |
| | | | |
| | 🐽 Oink. | | 🐽 Oink. |
| | + | |
| | + | These are just examples; feel free to come up with your own conventions so we can later compare and discuss what works best. |
| | + | |
| | + | ==Shields and Badges== |
| | + | Github-style shields or badges are useful for providing software details like programming language and licensing at a glance. There's a case to be made for our Wiki and Gitlab READMEs to use similar layouts and features for more uniformity in our documentation, and so badges could help with that too. Unfortunately, it is currently a bit of a faff to implement badges on our wiki, as hotlinking dynamic content from external sources is disabled for security reasons. |
| | + | The workaround: |
| | + | # Generate a badge at https://shields.io |
| | + | # Create a new CSS rule in [[MediaWiki:Common.css]] (see examples at bottom) |
| | + | # On the page you want to edit, add a custom span with class="shield" and the id as named in the CSS, e.g.: <code><nowiki><span class="shield" id="shield-python310")></span></nowiki></code> |
| | + | # Add to the list of shields below. |
| | + | |
| | + | ===Available Shields=== |
| | + | :<span class="shield" id="shield-python310")></span> <code><nowiki><span class="shield" id="shield-python310")></span></nowiki></code> |
| | | | |
| | ==Downloads== | | ==Downloads== |