4 ms·
I've been using Carbon more frequently lately in some development documents in my current team. We have a MediaWiki and, for some reason, the administrator wou
by genezeta 6y ago
I've been using Carbon more frequently lately in some development documents in my current team.
We have a MediaWiki and, for some reason, the administrator wouldn't be bothered to set up syntax highlighting correctly. So, after asking a number of times, I thought I would just use Carbon and be done with it and have the docs looking a bit nicer.
Immediately, I thought about the issue of having code as images. You put an example in the docs but the developers can't just copy and paste it into their code. But then I realized I actually wanted this. I didn't want them to continue copy&pasting code without understanding a single thing they do, like they have been doing for the last twelve years.
I have it set up to remove the window frame and background, and use Iosevka. It's much less noisy that way.
- jlengrand 6y agoThe corollary of that though is that your code is also not accessible. I've been struggling with this myself, I don't find it fair that my snippets, no matter how beautiful, aren't readable by screen readers. The only solution I found is to keep providing actual code as a snippet or gist next to the image.
- jlengrand 6y agoHa, reading the doc it seems it is at least partly improved since last time I checked. Good news then! https://github.com/carbon-app/carbon#exportsharing https://github.com/carbon-app/carbon#exportsharing
- genezeta 6y agoI understand that, and in a different setting I wouldn't use images for code no matter what. In this case though, as I said, the setting is very controlled (internal, temporary docs) and I explicitly did not want it to be easy to copy.
- yawaramin 6y agoAccessibility of the code should trump that. Stuff that we like to call 'temporary' inevitably ends up as long-term, and we have no idea what will really happen to it in future.
- jlengrand 6y agoNot saying you're doing any evil :). Those might not be yours to fix, but one could argue that if copy/pasting is such a problem in your current environment there are deeper issues at hand. Nothing that carbon will fix, and nothing that accessibility will helps with in any case. Good luck!
- genezeta 6y agoOh, sure. There are much deeper problems in that project. Thanks.
- fctorial 6y agoPut the text in image alt. Selecting an image in browser and pressing Ctrl v copies the alt text.