Summary Files Commits Branches @commit @diff @stats
path: root / src
diff options
context:
space:
mode:
Commitbc3760fa69357f3d270d2a661ee0bb42f60043b6 (patch)
Author
 Syndamia <kamen@syndamia.com>
2023-07-11 15:52:56 +0300
Committer
 Syndamia <kamen@syndamia.com>
2023-07-11 15:52:56 +0300
Files972cc6dfc41e70a479d52f6319fa79bf1639c935 /src
syndamia.com-bc3760fa69357f3d270d2a661ee0bb42f60043b6.tar
syndamia.com-bc3760fa69357f3d270d2a661ee0bb42f60043b6.tar.gz
syndamia.com-bc3760fa69357f3d270d2a661ee0bb42f60043b6.zip
Parent9a638fc25df29edd4b4b135347470ab358797325 (diff)
[accessibility] Added a page explaning accessibility of this website
2 files changed, 37 insertions, 0 deletions
-rw-r--r--src/_header.html1
-rw-r--r--src/accessibility.md36
diff --git a/src/_header.html b/src/_header.html
index f40f189..47d768a 100644
--- a/src/_header.html
+++ b/src/_header.html
@@ -62,6 +62,7 @@
<br><br>
<a href="/policies.html" title="Policies">Policies</a><br>
<a href="/privacy.html" title="Privacy policy">Privacy policy</a><br>
+ <a href="/accessibility.html" title="Accessibility">Accessibility</a><br>
<a href="/regarding-js.html" title="Regarding usage of JavaScript">Regarding JavaScript</a><br>
<a href="/acknowledgements.html" title="Acknowledgements">Acknowledgements</a><br>
<br>
diff --git a/src/accessibility.md b/src/accessibility.md
new file mode 100644
index 0000000..61f3e48
--- /dev/null
+++ b/src/accessibility.md
@@ -0,0 +1,36 @@
+# Accessibility
+
+I do personally want to make sure the content on this website is useable by people with disabilities and/or with poor internet connection and browser speed.
+However, at the same time, I want to add any feature I deem useful to the website experience, for everyone else.
+This is how I reach a middle ground between both sides:
+
+### Bare bone website version
+
+At [tiny.syndamia.com](https://tiny.syndamia.com) I offer my website with all styling and JavaScript functionality removed.
+On all pages you'll get the text and assets of the given page and nothing more.
+
+From my testing, pages usually load two times faster on tiny.syndamia.com.
+I do also hope that without the styling and JavaScript, people with impairments will have an easier time either viewing the content or configuring their helping tools.
+
+### Consumable content with everything blocked
+
+By design, all "normal" pages[^normal-pages] can be viewed without any JavaScript, any styling and any custom font.
+All of those are meant to make the browsing experience prettier and easier for those that can benefit from it.
+Even my [talks](/talks), where each one is a collection of delicately crafted CSS and JS slides, can be viewed as any normal text article on my site.
+
+### Reasonable icons
+
+First, icons on this website are managed with an icon font.
+I've watched [Seren Davies' talk](https://www.youtube.com/watch?v=9xXBYcWgCHA), but I've found working with SVGs noticeably increases workload on my end.
+
+**However**, I've still implemented those icons with accessibility in mind:
+
+- Navigation is done with text entries in the sidebar, not icons.
+- Buttons for other functionalities use text to reference their action, rather than (only) an "image", most of the time.
+ The only mission-critical one that isn't represented with text is the sidebar folding and expanding button, right next to "Home".
+ But it is mapped to the standard up and down pointing triangle characters, so it should still be useable.
+- Icons that aren't decorative are "mapped" to their closest standard Unicode symbol, so even without the font, their purpose should be fairly understandable.
+ Furthermore, I make sure those Unicode symbols have been standardised since at least 1999.
+- My font has only the icons I use, and compared to the SVG equivalent setup, it takes up roughly a third of the size.
+
+[^normal-pages]: Meaning a page that has only text, images and video. If the page contains a JavaScript demo, it obviously cannot function entirely without JS.