the markdown and the non-markdown are not to touch
Permalink to “the markdown and the non-markdown are not to touch”Usually the rationale for this is “I don’t want to be reliant on 11ty forever”, but honestly, it’s just out of principle for me.
Closest I’ll allow is, like, the frontmatter at the top of a .md
page, and whatever markup you’d qualify markdown-it-container as having. Everything else, absolutely not; the entire appeal of using markdown is that, despite technically being a kind of code, it is also an extremely easy-to-read document, even when you throw it into a notepad or nano or whatever. I’ve tried putting custom HTML into a markdown file before, and, not so coincidentally, it results in WIPs that I never finish, where every time I go back to it, I have to spend another minute reminding myself why I put certain tags where I did.
If I have to remember how to read text, something has gone horribly wrong.
Ideally, stuff should just work, like this eleventy-img helper plugin that just pulls from the raw, already-converted HTML, but failing that, it at least needs to look like it’d belong in a readable document. 11ty shortcodes are outlawed in these files; those are all, quite literally, just custom HTML-esque functions but in curly brackets. When you see customized linebreaks (such as the ones preceding all my h2
tags), it’s because I did something else to get them in there automatically.
This isn’t a big deal, right? Just stack a bunch of markdown-it plugins, call it a day, surely. Well, unfortunately, uh,
it needs to actually work on stuff people use to read
Permalink to “it needs to actually work on stuff people use to read”I am, first and foremost, someone with a visible disability; I’ve got shit legs with blood vessels that seem to only function on pure guesswork, and as it turns out you often need those vessels to work well if you want to stand on your own two legs. To that end, I use a walking cane, this shitty little T-shaped stick I bought at a Shoppper’s Drug Mart for twenty bucks, assuming I’d buy a fancier one when it inevitably broke.
(It still works, nearly five years later, and that means I can’t justify one that actually looks good. About my kind of suspiciously bad-good luck, really.)
I say this because, even if I don’t technically need things like screen readers or zoom functions, I also know exactly how it feels to reminded, constantly, of how your surroundings could not even begin to adapt to you. If I were to make a point on what having this cane does to me, it’s exclusively in the realm of seeing a store, and then not being able to go in it, because instead of an elevator, some asshole decided that they really needed to make you go on the public lift of shame.
Yes, really. Those things your grandma doesn’t want to use, because it’s a very obviously miserable experience, not only can be put in public, they are actually extremely common where I live. They’re not only extremely slow, and embarrassing, but if you need to hold or be on literally anything, they’re also completely useless to you. Accessibility!
I feel like, if I am to learn webdev shit, I am to avoid creating stair lifts when I do. Make sure the screen readers play nice, and all. Again, this all seems reasonable, right?
And that’s where I admit, out loud, to a problem I am having.
i must get really mad on the computer when i have to choose between those two rules
Permalink to “i must get really mad on the computer when i have to choose between those two rules”There’s footnotes on this blog. Like this one! Link to footnote 1
I like footnotes, because I’m nothing if not a ball of endless rambling, and footnotes are designed to let you ramble without breaking the pace of your own writing. Big fan of footnotes!
Problem: out of the box, they aren’t very good footnotes. If you screen read them by default, they will not hand you anything resembling legibility, instead just awkwardly spitting out a text-to-speech’s best way to interpret [1]
. This is especially infuriating, because it’s not like the isn’t anything for it to be putting there instead. I’m formatting them like this, after all:
There's footnotes on this blog. Like this one![^this-one-right-here]
[^this-one-right-here]: Yeah, like that.
At minimum, you’d think it could at least, like, spit out that shorthand, right? It wouldn’t be perfect, since that shorthand has to have no spaces, but especially if I could, like, break that shorthand down to one word, I could have some screen reader shit set up like
Link to footnote: "${FOOTNOTE_MARKER}"
or whatever, and that would be pretty alright? Except when the plugin that I use, markdown-it-footnote
, parses the text in brackets, it doesn’t seem to put that anywhere I can use it for this purpose. There’s what I’d imagine is a more accessible footnote plugin for 11ty, Link to footnote 2 and it very much solves the second rule, but it doesn’t break the first rule so much as it puts the rule through a hydraulic press, being made up of gigantic shortcodes that kill the entire pace of the paragraph–and again, for not much reason, because there’s no reason I shouldn’t just be able to pull out the footnote label from the syntax I’m using right now and call it a day.
I’ve used 11ty before, on a much smaller project, and it is filled to the brim with shortcode-riddled markdown files. I also never wanted to touch that again, all because I cannot stand how awful it is to look at from a glance. If my options are “use things that make it harder to write” and “don’t write”, I will always end up choosing the latter, and then I end up never making anything at all.
This brings me to the last rule.
when there’s problems, just deal with it myself
Permalink to “when there’s problems, just deal with it myself”I have a snippet which gives markdown-it-footnote
something resembling extremely basic accessibility, and I posted it here. I will not tell you that it’s good; all it does is tell you, via screen reader, that there’s a link to a footnote defined by a number, because it’s primarily just me ripping cables right out of the plugin’s guts and hoping I can solder them in slightly better places, and none of the cables I tore seem to let me put in my own words. It also doesn’t work in firefox’s own reader mode, which is probably a sign I’m going about it the wrong way, but it at least shows that a) there are tools, even to someone as bad at coding as I am, to solve these things, and b) you could at least try a little bit to solve them, if you care so much about this stuff.
I don’t think that’s asking for much, honestly. The metaphorical ramp next to the stairs doesn’t even have to be a graceful one. I just need someone to consider the ramp at all before they shove another lift in my face. Yeah, like that. Return to article via footnote 1 I’d link it, but it feels wrong to link a project I’m explicitly saying I don’t like very much? Maybe that’s the wrong kind of etiquette to have? Is there a different rule to this when it comes to open-source code, I dunno, it just feels rude Return to article via footnote 2