<feedxmlns="http://www.w3.org/2005/Atom"><title>LEdoian's Blog</title><linkhref="https://blog.ledoian.cz/"rel="alternate"></link><linkhref="https://blog.ledoian.cz/feeds/all.atom.xml"rel="self"></link><id>https://blog.ledoian.cz/</id><updated>2024-09-09T16:28:00+02:00</updated><entry><title>Using Gleam in HTML with as little JavaScript knowledge as possible</title><linkhref="https://blog.ledoian.cz/using-gleam-in-html-low-js.html"rel="alternate"></link><published>2024-09-09T16:28:00+02:00</published><updated>2024-09-09T16:28:00+02:00</updated><author><name>LEdoian</name></author><id>tag:blog.ledoian.cz,2024-09-09:/using-gleam-in-html-low-js.html</id><summarytype="html"><p>I've been looking at the <a class="reference external" href="https://gleam.run">Gleam language</a> recently. Among other features, it can be compiled to JavaScript, and thus presumably used on web frontend. I wanted to try that. This is a short tutorial on how to do that with little idea how JavaScript is supposed to work.</p>
<p>My initial …</p></summary><contenttype="html"><p>I've been looking at the <a class="reference external" href="https://gleam.run">Gleam language</a> recently. Among other features, it can be compiled to JavaScript, and thus presumably used on web frontend. I wanted to try that. This is a short tutorial on how to do that with little idea how JavaScript is supposed to work.</p>
<p>My initial JS knowledge: <tt class="docutils literal">alert(3)</tt>, <tt class="docutils literal">onclick</tt> and some basic selectors, i.e. the little stuff that is useful to add minor interactivity to HTML pages and implement trivial ViolentMonkey scripts. Namely: I have no knowledge about modules and whatnot, and this post is just a result of my trial-and-error attempt at embedding my Gleam. I succeeded, but still have no idea what I am doing :-)</p>
<div class="section" id="my-code">
<h2>My code</h2>
<p>Let's start with some trivial code, in <tt class="docutils literal">src/lol.gleam</tt> (in a project initialised with <tt class="docutils literal">gleam new lol</tt> and the <tt class="docutils literal">repeatedly</tt> package added with <tt class="docutils literal">gleam add repeatedly</tt>):</p>
<p>This snippet has many of the basic stuff I might need in future: it does some io, it uses another package <a class="footnote-reference" href="#stdlib-package" id="footnote-reference-1">[1]</a>, it returns data I will want to show. At first I am mostly interested in multiplatform stuff (i.e. running also on the BEAM backend), so I don't want to use any DOM frameworks at first, though I will mention some of the ways later in the post.</p>
<p>So, build this for JavaScript: <tt class="docutils literal">gleam build <span class="pre">--target</span> javascript</tt>, and <em>stuff happens</em>. It is not very clear what to do now, but <tt class="docutils literal"><span class="pre">grep``ping</span> through the ``build/</tt> directory shows that the built code lives in <tt class="docutils literal">build/dev/javascript/lol/lol.mjs</tt>.</p>
<p>Here comes the fun part: the code is in JavaScript <em>module</em>, not plain code. That comes with several surprises:
- It can only be imported from other modules, not by “plain” code in global scope
- Due to CORS, imports only work with network schemes, not with the <tt class="docutils literal"><span class="pre">file://</span></tt> one
- Due to scoping, I have not found a way of using the functions from devtools console</p>
<p>Big wins for the platform /s, but we have to live with that, so let's try to write the respective HTML for this. I put that in <tt class="docutils literal">main.html</tt> in the project root, but it does not probably matter. The code:</p>
&lt;!-- the “binding” to our Gleam code. This probably needs to be at the end of the page, since it needs to be able to use the selectors. --&gt;
&lt;script type=module&gt; //It has to be a module to allow imports
import * as lol from &quot;./build/dev/javascript/lol/lol.mjs&quot;;
// Set the text of one element to the computed stuff:
let par = document.getElementById('uwu');
par.innerText = lol.get_greeting();
// Let's have an interactive button (I love the come-from pattern, but using `onclick` would be even trickier…)
let butt = document.getElementById('butt');
butt.addEventListener('click', lol.say_hello);
// Apparently, the `main` function does not get run automatically, so call that explicitly.
lol.main();
&lt;/script&gt;
&lt;/body&gt;
&lt;/html&gt;
</pre>
<p>Shoutout to <a class="reference external" href="https://stackoverflow.com/questions/53630310/use-functions-defined-in-es6-module-directly-in-html">the person who asked the same question on StackOverflow</a>. From this point on, we only need a HTTP server; luckily, Python has one in stdlib, so just calling <tt class="docutils literal">python3 <span class="pre">-m</span> http.server 12312</tt> in the project root lets us load <tt class="docutils literal"><span class="pre">http://localhost:12312/main.html</span></tt> and see our page.</p>
<h2>Next steps, alternatives et cetera</h2>
<p>When developing web frontend in Gleam, the more common way is using a framework like <a class="reference external" href="https://hexdocs.pm/lustre/index.html">Lustre</a> or at least a DOM library (there are <a class="reference external" href="https://packages.gleam.run/?search=dom">several</a>, I have no idea how mature those are). I did not go this route yet, because I am more interested in using backend-agnostic Gleam code from JavaScript and don't mind writing the trivial bindings in JavaScript. <a class="footnote-reference" href="#netzpevnik-gleam" id="footnote-reference-2">[2]</a></p>
<p>Also, a common thing to do is using a minifier+bundler like <a class="reference external" href="https://hexdocs.pm/esgleam/index.html">esgleam</a> (it uses <a class="reference external" href="https://esbuild.github.io/">esbuild</a> under the hood), so that the whole project is in one file. I don't think I need that now (having the JS be readable is more important to me atm and I don't want to complicate things further), but there is at least <a class="reference external" href="https://erikarow.land/notes/esgleam-embed">one tutorial</a> on how to do that.</p>
<p>Also, during writing of this article I realised Gleam can run all the JS code from itself, so I could have a <tt class="docutils literal">js_main</tt> function that would bind the HTML from Gleam itself. But this is probably more readable and separated anyway.</p>
<tr><td class="label"><a class="fn-backref" href="#footnote-reference-1">[1]</a></td><td>Well, as far as I understand it, Gleam's stdlib is actually just another package anyway.</td></tr>
<tr><td class="label"><a class="fn-backref" href="#footnote-reference-2">[2]</a></td><td>I will probably use some kind of framework eventually as a part of <a class="reference external" href="https://gitea.ledoian.cz/LEdoian/netzpevnik">netzpevnik</a>, but I am exploring the technologies that will be involved, so I want to keep stuff simple.</td></tr>
</tbody>
</table>
</div>
</content><categoryterm="programming"></category><categoryterm="gleam"></category><categoryterm="software"></category><categoryterm="web"></category></entry><entry><title>Hello, I'm agender</title><linkhref="https://blog.ledoian.cz/hello-im-agen.html"rel="alternate"></link><published>2024-05-21T17:03:00+02:00</published><updated>2024-05-21T17:03:00+02:00</updated><author><name>LEdoian</name></author><id>tag:blog.ledoian.cz,2024-05-21:/hello-im-agen.html</id><summarytype="html"><p>Hell yeah, a coming out!</p>
<p>Important: Please, read this article <em>in full</em> and do not just skim it. There
is no TL;DR, I don't think any reasonable summary of this post can be made
without me misrepresenting myself. Alternatively, please just skip this article
altogether – I am fine with …</p></summary><contenttype="html"><p>Hell yeah, a coming out!</p>
<p>Important: Please, read this article <em>in full</em> and do not just skim it. There
is no TL;DR, I don't think any reasonable summary of this post can be made
without me misrepresenting myself. Alternatively, please just skip this article
altogether – I am fine with people not knowing these details about me and not
acting upon them. Thank you a lot! (The way of interacting with me changes only
a little, if at all, but I care a lot about how this fact about me is handled.)</p>
<p>NB <a class="footnote-reference" href="#pun" id="footnote-reference-1">[1]</a>: This is only about me at this time. My experiences are my own,
please don't assume any of this applies to anybody else – while it might, there
are a lot of other agender experiences that are quite different from mine and
assuming others are feeling the same will probably lead to misrepresentation
and hurtful attitude. Please, just ask (it may feel weird, but being treated
wrong feels weirder), thanks.</p>
<p>Also, my own identity and feelings may change in the future (as they certainly
have in the past), so while I'll try to add an obsoletion banner to the top of
this article when/if that happens, if you think I'm inconsistent with what I
have written here, please also ask me about that.</p>
<p>This is a rather general post, I would like to write separate articles going
into more detail. I'll add them here, but before I do that, feel free to ask me <a class="footnote-reference" href="#asking-bad-questions" id="footnote-reference-2">[2]</a>.</p>
<p>Important disclaimer: Especially this section <strong>only talks about me</strong>, other
agender people may feel differently. Do <strong>not</strong> assume anything about other
(agender) people from this!</p>
<div class="section" id="language">
<h3>Language</h3>
<p>The first thing that comes to mind is the language. In general, I don't like
being titled with gendered words when referring specifically to me (i.e. I am
not a &quot;boy&quot;, &quot;lady&quot;, &quot;man&quot;, &quot;daughter&quot; etc.) – please prefer general words like
&quot;person&quot;. When addressing me together with other people, I will not complain to
be included under general statements like &quot;ladies and gentlemen&quot;. This means
that there should not be too much that changes in this regard.</p>
<p>Pronouns – everyone's favourite topic – are a bit tricky due to differences
between languages I speak. In English I slightly prefer they/them, but any
traditional pronouns (he/it/she) are also fine with me.</p>
<p>In Czech, due to inflection of names, first start to referring to me as
LEdoian, because my given name would sound very weird in other grammatical
genders. And then probably still keep using masculine for me (LEdoian is
declined the same way as &quot;pán&quot;) – while I am open to experimentation <a class="footnote-reference" href="#grammatically-neutral" id="footnote-reference-3">[3]</a>,
I have not figured out the details and would like to arrange individually (at
least at first). If you want to be part of the experimentation, ask me :-)</p>
<p>I do not consider my given name to be a deadname (at least for now), you can
keep using it and don't need to feel bad for doing that. However, don't use the
name in a different grammaical gender, that would sound weird. And unless we
already use some variation of my given name, do not try to invent a new one.</p>
<!-- I could put here a table like at pronouns.page (or other pages), but I am
afraid it would be too visually appealing for people to avoid reading the
text. And I can definitely not put everything in it, so it might cause more
harm than without the table. Sorry. (It's like four paragraphs anyway, so…) -->
<p>I am not completely out yet – in fact, sharing with &quot;whoever on the internet
actually cares about me enough to read my blog&quot; currently seems like one of the
safer ways. So while me being agender is not a secret anymore, I
wouldn't like it to be the &quot;gossip of the day&quot; either (it's not a good talking
point and I am giving way too litle detail here for anyone to be able to
represent me accurately anyway). Don't out me just because you can <a class="footnote-reference" href="#coming-out-to-some-people" id="footnote-reference-4">[4]</a>.</p>
<p>If somehow the talk comes to this topic and you need to reference me
specifically, I think the best thing is to hint that I am <em>non-binary</em> as the
reasonable compromise between misrepresenting me as any binary gender and fully
outing me. Also try keeping in mind that the term &quot;non-binary&quot; is an umbrella
term that conveys even <em>less</em> information about feeling of self than &quot;man&quot; or
&quot;woman&quot; do. See also <a class="reference internal" href="#the-queer-quirks">the queer quirks</a> below.</p>
<p>If the listener knows me, you can tell them to ask me if they are interested in
more. That is more preferred approach than referencing this blogpost, because
that lets me represent myself better and in a more concise way than this post
can.</p>
<p>On a related note, you may find yourself in a discussion that misrepresents me <a class="footnote-reference" href="#idk-how" id="footnote-reference-5">[5]</a>.
While I understand that you might want me to feel good and included, I would
like you to <em>not</em> stand up for me too explicitly. I don't want to it being the
big deal, if I am present, it is way more comfortable to be accidentally
misrepresented than having the conversation take a bad turn and becoming weird.
(See <a class="reference external" href="https://youtube.com/watch?v=auXqQp-jWsk">this episode of Couple-ish</a>
for a maybe-not-too-exaggerated example of a derailed discussion.) Probably the
best thing is to ignore the misrepresentation or dismiss it with something like
&quot;that is actually more complicated&quot;. If I am present, let me do most of the
speaking (or ignoring) – I think I know how much I want to stand for myself in
a given situation. (Standing up for non-binary/trans*/genderqueer/… people in
general is fine if you want to do that, just please don't make that inherently
about me <a class="footnote-reference" href="#being-ally-is-more-acceptable" id="footnote-reference-6">[6]</a>.)</p>
<p>That being said, referring to me as LEdoian is fine (I think most people know
that this is my nickname, even if they don't actively use it), if we decided to
use a different grammatical gender for Czech, it's both fine to use that and to
fall back to masculine if that feels it would fit the conversation. <a class="footnote-reference" href="#incompatible-agreements-maybe" id="footnote-reference-7">[7]</a></p>
<p>The fun part is interacting with me, which follows completely different rule:
if you think I am misgendering <em>myself</em>, please tell me you think so. This
helps me be more mindful about when I use gendered language. (If I misgender
someone who is out or you are allowed to out them, also please tell me, it is
probably unintentional.)</p>
</div>
<div class="section" id="other-stuff">
<h3>Other stuff</h3>
<p>It's nice to be able to represent myself in forms, so I like being able to
choose the third option for gender (if you need to ask). I don't particularly
mind whether it is described as &quot;other&quot; or &quot;not specified&quot;. (Just maybe don't
try to be too clever about the choice, <a class="reference external" href="https://genders.wtf">or else</a>.)</p>
<p>While I am not very proactive about my gender (as in, I don't have the urge to
tell anyone on sight), I am quite open about my experience. Feel free to ask me
if you are interested. If you think it would be too weird to ask out of the
blue (or you just want to let me know you read this blogpost – I appreciate
that!), ask me what my hair colour is :-)</p>
<p>And again, please prefer asking me to assuming stuff about me (or possibly
anyone). Gender is weird, there is a lot I am not telling in this post and a
lot of nuance that can be hard to convey to general public.</p>
</div>
</div>
<div class="section" id="the-queer-quirks">
<h2>The queer quirks</h2>
<p>I understand not everyone has studied queer-sensitive language <a class="footnote-reference" href="#ally-year-ago" id="footnote-reference-8">[8]</a>,
so let me put here a few basic rules for talking about queer people. (Again,
just a quick rundown, I may write a separate article about this.) As opposed to
the above, <strong>this section is general</strong> and represents the current usage of
language, to the best of my knowledge.</p>
<p>Parts of speech: Most labels like &quot;agender&quot;, &quot;transgender&quot;, &quot;non-binary&quot;,
&quot;genderqueer&quot; are used as adjectives (like e.g. the word &quot;blue&quot;), so they are
used like &quot;an agender person&quot;, &quot;the transgender flag&quot;, &quot;they are non-binary&quot;.
<em>Do not</em> say ~~&quot;flag of agenders&quot;, &quot;they are a genderqueer&quot;~~ or even ~~&quot;John is
transgendered&quot;~~. Some labels can be also used as nouns, and <em>some people</em> also
reclaim <em>some labels</em> to be used as nouns, but others may not think that is
appropriate usage for them. E.g. the word &quot;enby&quot; belongs to the former group,
but &quot;gay&quot; belongs to the later (acc. to <a class="reference external" href="https://en.wiktionary.org/wiki/gay#Usage_notes_2">wiktionary</a>).</p>
<p>This usage differs a bit in different languages, though. In Czech, most labels
are still adjectives, though. Usually labels are not inflected, except when the
word is &quot;Czech-compatible enough&quot;: „vidím transgender ženu“, „s nebinárními
přáteli“.</p>
<p>Labels: Labels itself are mostly useful as approximations of what someone
feels. They are useful to relate to others and in communicating, but almost
never give full information themselves. Some are
umbrella terms for many experiences, which may have their own label; however,
this does not mean that by using a sublabel one also identifies with the
umbrella term which the sublabel is canonicaly part of. It is <strong>up to the
person themself</strong> to determine which labels they want to use, labeling others
against their will is inappropriate/rude. Sublabels that are not widely known
are often termed &quot;microlabels&quot;. (Using labels is voluntary, queer people do
not need to use any labels for themselves.)</p>
<p>Few relevant labels/words:</p>
<dl class="docutils">
<dt>transgender</dt>
<dd>in the widest sense, a person who experiences their gender differently from
the gender they were assigned at birth. A broad umbrella term. (People who
experience gender in accordance to the gender they were assigned at birth are
<p>I guess people will ask, so let me just put down some answers here in advance :-)</p>
<dl class="docutils">
<dt>How do you know you really are agender? What will you do if you start feeling gender? Is it just a phase?</dt>
<dd>The label is just a way to put a name to what I feel now. And no, I don't
have all the answers <a class="footnote-reference" href="#reference" id="footnote-reference-9">[9]</a>. Using the label allows me to find other
people with similar feelings, learn how they navigate possible challenges and
puts my mind at peace that I am not completely insane/broken/alone. If my identity
changes, I'll try to find comfort in another label probably. If it is just a
phase, so be it, I can probably still learn something about myself from it.</dd>
<dt>Does anything else change about you?</dt>
<dd>Yes. Apart from what I have written on this page, I realised that I do not
have to follow gender stereotypes/expectations for myself, so I started
experimenting more with my appearance. Confused a few people already :-D</dd>
<dt>What if I accidentally outed you?</dt>
<dd>That's life, and it's not like it can be undone. Since me being agender is
low-key public information anyway, it is not a big deal to me. However, if
you tell me who you've told, it will help me be ready if they start asking
unexpected questions (esp. because when someone first interacts with a queer
topic they might be unintentionally insensitive). You can also tell the
person you outed me to that I am basically fine with them knowing, so that
they don't <a class="reference external" href="https://blog.ledoian.cz/do-not-gossip-identities.html">need to metagame</a> w.r.t.
my gender.</dd>
<dt>What do you have between your legs?</dt>
<dd>Not answering this one. You wouldn't ask your teacher. You wouldn't ask your
boss, you wouldn't ask your uncle and then make sure yourself. Asking such
questions is inappropriate and being asked such questions is unpleasant.
<a class="footnote-reference" href="#reference" id="footnote-reference-10">[9]</a> (How I feel my gender is not related to my anatomy. How does
having two nostrils make you feel?) <a class="footnote-reference" href="#dysphoria-question" id="footnote-reference-11">[10]</a></dd>
</dl>
<p>There are a few questions to which the answer is something like: &quot;no, it's
complicated, maybe read the blogpost in a few days again and if it still isn't
clear, please ask me directly.&quot;:</p>
<ul class="simple">
<li>So you are a man/boy?</li>
<li>So you are a woman/girl?</li>
<li>Are you transgender?</li>
</ul>
</div>
<div class="section" id="closing-thought">
<h2>Closing thought</h2>
<p>This is a rather sensitive topic, not just for me, but for many people who are
struggling with/doubting/hiding their gender (and the doubts can return or be
persistent). While this post is not focused on other such people, I'd be glad if you,
my dear reader, try being considerate to other
experiences/feelings similar to mine. Many other people are not in a position
to feel safe talking about these struggles. One of the reasons I am
writing this is because I want/need more people to try considering these
challenges (and through that help spread understanding) and I am &quot;lucky&quot; that I
can be relatively open about it, at least on the internet and in some irl
<tr><td class="label"><a class="fn-backref" href="#footnote-reference-2">[2]</a></td><td>If you are not sure whether your question would be
bad to ask, try being sensitive and tolerant and ask me anyway. And be sure
I know I don't have any obligation to answer, so if I don't, respect it. (I
don't think I am likely to reject you, but still I think it is better to
explicitly state the expectations.)</td></tr>
<tr><td class="label"><a class="fn-backref" href="#footnote-reference-3">[3]</a></td><td>In fact, I am now trying to use the neutral
grammatical gender for myself, but as a language exercise, not as the
definitive gender to use. You don't need to keep this in mind when
talking with me, though – I will adapt to whatever grammatical gender we
<tr><td class="label"><a class="fn-backref" href="#footnote-reference-4">[4]</a></td><td>There are several people I want to make sure I
come out to myself when I am ready. I need them to understand me
correctly, it would be painful to refute any misconceptions they get from
other sources. This blogpost is written carefully and would be OK for
them to read as an introduction, but probably still unnecessary. (Please
don't go around like &quot;Hey, I cannot tell you but LEdoian has an interesting
post on their blog, go check that out&quot;, ffs.)</td></tr>
<tr><td class="label"><a class="fn-backref" href="#footnote-reference-5">[5]</a></td><td>I haven't thought about what failure modes of discussion my
gender could yield, but I guess some could emerge, so I am adding this
<tr><td class="label"><a class="fn-backref" href="#footnote-reference-6">[6]</a></td><td>So far, being LGBTQ+ ally looks like being
a safe position for me. I am not yet sure if being openly non-binary would
be also safe. Therefore, while I can ~freely advocate for
queer/trans/non-binary people in general, standing up for myself in
particular might have unseen consequences.</td></tr>
<tr><td class="label"><a class="fn-backref" href="#footnote-reference-7">[7]</a></td><td>In the unlikely event you meet someone and
you use different grammatical gender for me, throw a game of
rock-paper-scissors or something. Or use another way to determine. &quot;Don't
make trouble and agree on something!&quot;</td></tr>
<tr><td class="label"><a class="fn-backref" href="#footnote-reference-8">[8]</a></td><td>To be fair, I didn't know the language a year ago myself
and I still keep finding new words and descriptions of gender experiences.</td></tr>
<tr><td class="label">[9]</td><td><em>(<a class="fn-backref" href="#footnote-reference-9">1</a>, <a class="fn-backref" href="#footnote-reference-10">2</a>)</em> Kudos to you if you recognise this reference :-)</td></tr>
<tr><td class="label"><a class="fn-backref" href="#footnote-reference-11">[10]</a></td><td>Asking this question is also insensitive and possibly
actively harmful towards people who feel distressed by the mismatch between
their gender and genitalia. Just please don't ask about this.</td></tr>
</tbody>
</table>
</div>
</content><categoryterm="queer"></category><categoryterm="gender"></category><categoryterm="identity"></category></entry><entry><title>Only NAT packets you can deliver responses for</title><linkhref="https://blog.ledoian.cz/masquerade-with-filter.html"rel="alternate"></link><published>2024-05-08T13:32:00+02:00</published><updated>2024-05-08T13:32:00+02:00</updated><author><name>LEdoian</name></author><id>tag:blog.ledoian.cz,2024-05-08:/masquerade-with-filter.html</id><summarytype="html"><p>When setting up a masquerading nat, it is worth considering masquerading only
packets from known networks. That is, instead of rule like <tt class="docutils literal">iifname <span class="pre">eth-inside</span>
masquerade</tt> use something like <tt class="docutils literal">iifname <span class="pre">eth-inside</span> ip saddr 198.51.100.0/24
masquerade</tt>.</p>
<p>I learned the hard way: my laptop in a masqueraded network picked …</p></summary><contenttype="html"><p>When setting up a masquerading nat, it is worth considering masquerading only
packets from known networks. That is, instead of rule like <tt class="docutils literal">iifname <span class="pre">eth-inside</span>
masquerade</tt> use something like <tt class="docutils literal">iifname <span class="pre">eth-inside</span> ip saddr 198.51.100.0/24
masquerade</tt>.</p>
<p>I learned the hard way: my laptop in a masqueraded network picked a wrong
source address from a subnet the router had no knowledge about. The outbound
packets passed through right, but the responses came in, undergone translation,
and since the destination was unknown to the router, it used the <em>default</em>
route, sending the packet back to the ISP.</p>
<p>The result: IDS triggered by <em>many</em> packets from my router with source IP
addresses from all around the Internet, all with destination to my private
address. (The ISP was not happy about that.)</p>
</content><categoryterm="til"></category><categoryterm="linux"></category></entry><entry><title>Creating own XKB tweaks</title><linkhref="https://blog.ledoian.cz/custom-xkb-tweaks.html"rel="alternate"></link><published>2024-04-17T16:40:00+02:00</published><updated>2024-04-17T16:40:00+02:00</updated><author><name>LEdoian</name></author><id>tag:blog.ledoian.cz,2024-04-17:/custom-xkb-tweaks.html</id><summarytype="html"><p>Debugging this took me a bit too long, so I want to write about the caveat.</p>
<p>My problem: My laptop does not have PageUp and PageDown keys, and many other
keyboards I use have similar deficiencies. And I use various environments and
various systems, some of which are shared with …</p></summary><contenttype="html"><p>Debugging this took me a bit too long, so I want to write about the caveat.</p>
<p>My problem: My laptop does not have PageUp and PageDown keys, and many other
keyboards I use have similar deficiencies. And I use various environments and
various systems, some of which are shared with other people who don't need/want
my tweaks. IOW: I want something generic, but it must be confined to my user –
no system-wide daemon, no udev remapping. (I mostly ended up with these
solutions when I searched for a way to remap keys on Wayland.)</p>
<p>Requirements: xkbcommon implementation of XKB with utilities. It is quite
common these days (duh…), but you could probably just compile this yourself if
you don't have it.</p>
<div class="section" id="the-tweaking">
<h2>The tweaking</h2>
<p>The <a class="reference external" href="https://xkbcommon.org/doc/current/user-configuration.html">xkbcommon guide</a> tells us that we
can inspect the files in <a class="footnote-reference" href="#lazy" id="footnote-reference-1">[1]</a><tt class="docutils literal">/usr/share/X11/xkb</tt> for the source files
and just write our bits to <tt class="docutils literal"><span class="pre">~/.config/xkb/symbols/ledoian</span></tt>. In particular, I
added this snippet to remap keyboard brightness controls to PageUp/Down:</p>
<pre class="literal-block">
partial
xkb_symbols &quot;qs&quot; {
key &lt;I238&gt; {[ Prior ]};
key &lt;I237&gt; {[ Next ]};
};
</pre>
<p>The key identifiers are taken e.g. from <tt class="docutils literal">xkbcli <span class="pre">interactive-wayland</span></tt>.
However, this is KcCGST <a class="footnote-reference" href="#kccgst-vs-rmlvo" id="footnote-reference-2">[2]</a> description, but layouts are
configured using RMLVO, so I need to define an option and tell what it should
do. The guide wants me to create <tt class="docutils literal"><span class="pre">~/.config/xkb/rules/evdev</span></tt> with:</p>
<pre class="literal-block">
! option = symbols
ledoian:qs = +ledoian(qs)
! include %S/evdev
</pre>
<p>Now I just add <tt class="docutils literal">ledoian:qs</tt><a class="footnote-reference" href="#option-vs-symbol" id="footnote-reference-3">[3]</a> to my keyboard configuration
and… it does not work. For this, at all, but if I remap e.g. the L key, that
gets applied. The problem? That included file says that the default keyboard
model always includes <tt class="docutils literal">inet(evdev)</tt> symbols. Those symbols set the default
meaning of the keys, but since that got applied later, it overrides my tweak.</p>
<p>Solution: first include, then add my option.</p>
<p>How to debug: read stuff that <tt class="docutils literal">xkbcli <span class="pre">compile-keymap</span><span class="pre">--verbose</span></tt> tells you
(pass your config as <tt class="docutils literal"><span class="pre">--layout</span></tt>, <tt class="docutils literal"><span class="pre">--variant</span></tt>, <tt class="docutils literal"><span class="pre">--options</span></tt>, …). At the top
it says what it does:</p>
<pre class="literal-block">
xkbcommon: DEBUG: Include path added: /home/ledoian/.config/xkb
xkbcommon: DEBUG: Include path added: /usr/share/X11/xkb
xkbcommon: DEBUG: Compiling from RMLVO: rules 'evdev', model 'pc105', layout 'us', variant '(null)', options '(null)'
<tr><td class="label"><a class="fn-backref" href="#footnote-reference-1">[1]</a></td><td>This is not technically accurate, really the paths reference
<tt class="docutils literal">$XDG_something</tt> variables. I am lazy and just copied my system, so YMMV
<tr><td class="label"><a class="fn-backref" href="#footnote-reference-2">[2]</a></td><td>There are two levels of describing the keymap: the
lowlevel one is called KcCGST (short for keycodes, compat, geometry,
symbols, types) and is considered to be an implementation detail; the
user-facing one is RMLVO (rules, model, layout, variant, options) and that
is what you use in the configs, with <tt class="docutils literal">setxkbmap</tt>&amp;c.</td></tr>
<tr><td class="label"><a class="fn-backref" href="#footnote-reference-3">[3]</a></td><td>While both this example and the <a class="reference external" href="https://www.freedesktop.org/wiki/Software/XKeyboardConfig/">upstream</a> layouts name
the symbols and options similarly, I think they don't need to be related –
you should be able to put whatever you want in your options to the left of
<tt class="docutils literal">=</tt>, the right hand side is the name of the symbol file and if a
non-default layout from that file is used, its name is put in the
parentheses.</td></tr>
</tbody>
</table>
</div>
</content><categoryterm="technology"></category><categoryterm="lifehack"></category><categoryterm="software"></category><categoryterm="linux"></category></entry><entry><title>You sure you want to hear the gossip?</title><linkhref="https://blog.ledoian.cz/do-not-gossip-identities.html"rel="alternate"></link><published>2024-03-11T22:49:00+01:00</published><updated>2024-03-11T22:49:00+01:00</updated><author><name>LEdoian</name></author><id>tag:blog.ledoian.cz,2024-03-11:/do-not-gossip-identities.html</id><summarytype="html"><p>Sometimes, not knowing something about your friends is simpler than knowing
something you know you aren't supposed to know…</p>
<p>TL;DR: If you are gossiping, please handle information which change attitude
towards others with care and maybe share them with consent of the <em>listener</em>. <a class="footnote-reference" href="#on-gossiping" id="footnote-reference-1">[1]</a></p>
<p>Some time ago, I was …</p></summary><contenttype="html"><p>Sometimes, not knowing something about your friends is simpler than knowing
something you know you aren't supposed to know…</p>
<p>TL;DR: If you are gossiping, please handle information which change attitude
towards others with care and maybe share them with consent of the <em>listener</em>. <a class="footnote-reference" href="#on-gossiping" id="footnote-reference-1">[1]</a></p>
<p>Some time ago, I was casually talking with my friend, let's call them Alex.
For one reason or another, we got to gossip and I learnt a new, very private
information about our mutual friend, Bay. <a class="footnote-reference" href="#names2" id="footnote-reference-2">[2]</a> I knew Bay would not
expect me to know or possibly even want me to know at that time, yet the new
part of their identity would require me to behave differently around Bay in
order not to hurt them. <a class="footnote-reference" href="#non-disclosure" id="footnote-reference-3">[3]</a></p>
<p>That turned my interactions with Bay into a bit of a minefield:</p>
<ol class="arabic simple">
<li>If I behaved according to what I learnt, I may easily overstep Bay's
boundaries and invade their privacy, possibly quite badly. <a class="footnote-reference" href="#my-privacy" id="footnote-reference-4">[4]</a></li>
<li>If I kept my old behaviour, I would feel like I am actively hurting Bay.</li>
<li>If I accidentally slipped my tongue in front of Bay and they notice, I still
ending up invading their privacy as in point 1.</li>
<li>I am also prone to sharing the gossip, maybe accidentally. I would be to
someone else what Alex was to me, and I certainly didn't want to cast this
&quot;curse&quot; on anyone. <a class="footnote-reference" href="#gossip-circumstances" id="footnote-reference-5">[5]</a></li>
<li>If Bay subconsciously noticed I am behaving in line with their secret and in
another interaction I wouldn't, they could feel invalidated (without an
obvious reason why).</li>
</ol>
<p>It sucks, it made talking to Bay needlessly stressful. Please don't do that.</p>
<p>So, to reiterate the message: <strong>Please gossip *safely* and *consensually* about
stuff that is private in nature and would change attitudes towards people.</strong>
For the queer stuff, this can be rephrased in layman's terms as <strong>please just
don't out other people to people who do not explicitly want to know.</strong><a class="footnote-reference" href="#consent" id="footnote-reference-6">[6]</a></p>
<!-- ReST wtf, why can't I put emphasis in strong? -->
<p>(Again, maybe gossip safely anyway, but for the &quot;regular&quot; gossip you can
usually hide what you know without feeling that bad.)</p>
<div class="section" id="final-remarks">
<h2>Final remarks</h2>
<p>I wrote this post mainly to raise awareness and help learn from past mistakes.
It is not meant to shame Alex for telling me, they might not have been aware
and neither were I at the time.</p>
<p>Apart from the role as &quot;me&quot; in the story, I also were &quot;Bay&quot; a few times,
luckily not with a too intimate part of my identity. And while I try not to be
another &quot;Alex&quot;, I cannot rule that completely out unfortunately.</p>
<p>This post has been a long time in my backlog (~6 months maybe), it is not a
reaction to any recent gossip I have heard. (The points I make still hold ofc,
but lately I only heard &quot;the ordinary stuff&quot; which I will probably just forget
and not care about without harming anyone.)</p>
<p>Lastly, Bay eventually told me themself, so my life is peaceful again. I didn't
ask if I am allowed to talk about that and with whom, so I err on the safe side
and will not write here anything else :-)</p>
<tr><td class="label"><a class="fn-backref" href="#footnote-reference-1">[1]</a></td><td>I mean, gossiping is not nice to the mentioned person who
doesn't usually consent, but it's not like I could prevent people from
gossiping, so this post is not about that. Also, you can conceal your
knowledge of &quot;regular&quot; gossip more easily than of gossip which changes your
<tr><td class="label"><a class="fn-backref" href="#footnote-reference-2">[2]</a></td><td>I originally wanted to have the friends be Alice and Bob, but that
might support the narative that &quot;girls gossip&quot;, which is sexist and IME not
accurate (more like &quot;everyone gossips&quot;). So I made my friends be of
ambiguous gender and use they/them pronouns. Sorry, this might make the post
a bit harder to read, but the stereotypes need to die :-)</td></tr>
<tr><td class="label"><a class="fn-backref" href="#footnote-reference-3">[3]</a></td><td>I will not give any more information here. Don't try to
guess, I am not telling. Bay is my friend and deserves privacy. (However, if
you suspect that you might be the Bay of this story, by all means ask me
whether you are. I don't want you to feel bad / insecure / unsure / … (And
in fact, there may be multiple Bays…))</td></tr>
<tr><td class="label"><a class="fn-backref" href="#footnote-reference-4">[4]</a></td><td>There are definitely parts of my identity I do not share much
and would probably get upset at various people (and also paranoid) if I got
outed. OTOH, the number of people who know my secrets is non-decreasing
anyway, so I try to prepare that someone unexpected inevitably will overstep
this boundary, possibly in a good faith. (If you want to try to act upon my
secrets, I'd appreciate you asking beforehand to avoid weird reactions.)</td></tr>
<tr><td class="label"><a class="fn-backref" href="#footnote-reference-5">[5]</a></td><td>Naturally, this gossip sharing can have various
circumstances: Me (or Alex) being unaware that the listener (call them
Cameron) doesn't know, slipping my tongue in a subtle way yet Cameron
understanding the subtext, being drunk, … It might be difficult to keep the
secret in all those situations.</td></tr>
<tr><td class="label"><a class="fn-backref" href="#footnote-reference-6">[6]</a></td><td>If the listener wants to know and go sweeping mines and you are
willing to tell them, ~~sure, tell them~~ it's up to you and I have no say
in that. Learn the consequences and go for the interactions you want to
have!</td></tr>
</tbody>
</table>
</div>
</content><categoryterm="queer"></category><categoryterm="relationships"></category><categoryterm="identity"></category></entry><entry><title>Print your stuff on Möbius bands!</title><linkhref="https://blog.ledoian.cz/mobius-print.html"rel="alternate"></link><published>2024-03-02T18:07:00+01:00</published><updated>2024-03-03T14:59:00+01:00</updated><author><name>LEdoian</name></author><id>tag:blog.ledoian.cz,2024-03-02:/mobius-print.html</id><summarytype="html"><p>I found a fun and useful way of printing stuff to ~~both~~all sides of a paper.
<h2>Quick recap: how to conventionally print stuff two-sided</h2>
<p>A typical way is just sending the page to get printed two-sided (with setting
the correct way …</p></div></summary><contenttype="html"><p>I found a fun and useful way of printing stuff to ~~both~~all sides of a paper.
<p>Booklets are fun and approachable, but still suffer from the same issues as the
conventional duplex print. They might be a bit hard to print, but programs like
<tt class="docutils literal">pdfbook</tt> or <tt class="docutils literal">paperjam</tt> make it easy to prepare for the classic duplex
printing. Also, it is maybe hard to tell which page ends up where, as the order
is: last+first, second+penultimate, third-from-end+third, … until the pages
<p class="caption">The &quot;Möbius order&quot; of pages.</p>
</div>
<p>And this is really easy to use: You read a page and when you don't need it
anymore, you flip it and put to the end of the page stack <a class="footnote-reference" href="#ordering" id="footnote-reference-2">[2]</a>. If you
need to look at several pages, just rotate them in the same order as they go the
first time. <a class="footnote-reference" href="#mistake" id="footnote-reference-3">[3]</a></p>
<p>Need to print this? For one-sided printers this is rather easy, too: just print
the first half (the bigger one) on the sheets, then put them back into the tray
and print the rest on them. You might need to experiment which side the sheets
should be put in and whether you need to print the rest in reverse order, but
that is it.</p>
<p>Got the pages shuffled? Sort them by the first half, as if the print was
one-sided.</p>
<p>The only annoying thing for me is that there is not much software that could
reorder the pages for two-sided printing, so that you don't need to re-insert
the sheets back in the tray. So I <a class="reference external" href="https://blog.ledoian.cz/images/mobius-print/interleave.patch">patched</a><a class="reference external" href="https://mj.ucw.cz/sw/paperjam/">paperjam</a> to enable this. <a class="footnote-reference" href="#multi-mobius" id="footnote-reference-4">[4]</a></p>
<p>And the best part? If you would try to glue consecutive pages side-to-side,
you'd end up with a Möbius band! So if you get a Möbius paper, you can just
<td><tt class="docutils literal">book</tt> (follow with <tt class="docutils literal">nup(2)</tt> for actual booklet print)</td>
</tr>
<tr><td>Leporello</td>
<td><tt class="docutils literal">modulo(2) {1 2} modulo(1,half) {1 <span class="pre">-1}</span></tt> (The first <tt class="docutils literal">modulo</tt> just adds blank pages to the end.)</td>
<tr><td class="label"><a class="fn-backref" href="#footnote-reference-1">[1]</a></td><td>Most of the figures in this article are drawn with a single
page per a side of a sheet. I consider putting more pages on a single side
of paper to be an implementation detail, because it is not always possible
(e.g. with too small font) and sometimes you could put more than two pages
on a single side of paper, which leads to the fact that if you put
everything on one side of the paper, you can see everything at once and save
the other side. Not very useful though… My only exception is the booklet
printing below, because that one seems to be rather common.</td></tr>
<tr><td class="label"><a class="fn-backref" href="#footnote-reference-2">[2]</a></td><td>See how this neatly puts the first-past-half page right after
the half of the stack? Awesome!</td></tr>
<tr><td class="label"><a class="fn-backref" href="#footnote-reference-3">[3]</a></td><td>Also, if you flip the page around the wrong edge, you can just
rotate the rest of the stack and end up with the correct orientation.</td></tr>
<tr><td class="label"><a class="fn-backref" href="#footnote-reference-4">[4]</a></td><td>A slight variation for which I can generate the order
with upstream <tt class="docutils literal">paperjam</tt> is using this order on small subsets of pages.
For example, if you only want to be able to see any two consecutive pages,
you can do this for just four pages – the order is then 1+3, 2+4, 5+7, 6+8,…
Since each sheet either contains two odd or two even pages, the following
page is on different sheet than the previous one. And you can do this
&quot;modulo 3&quot; to see three pages: 1+4, 2+5, 3+6, 7+10, … This &quot;simulates&quot;
multiple smaller Möbius bands, but will be probably harder to use.</td></tr>
</tbody>
</table>
</div>
</content><categoryterm="technology"></category><categoryterm="lifehack"></category><categoryterm="print"></category></entry><entry><title>How to convert CBZ to PDF</title><linkhref="https://blog.ledoian.cz/cbz-to-pdf.html"rel="alternate"></link><published>2024-02-17T16:55:00+01:00</published><updated>2024-02-17T16:55:00+01:00</updated><author><name>LEdoian</name></author><id>tag:blog.ledoian.cz,2024-02-17:/cbz-to-pdf.html</id><summarytype="html"><ol class="arabic simple">
<li>Extract the archive (cbz is just a zip, cbr is a rar, …)</li>
<li><dl class="first docutils">
<dt>Convert individual pictures to PDF using <tt class="docutils literal">img2pdf</tt></dt>
<dd><ul class="first last">
<li>Many other ways including <tt class="docutils literal">convert</tt> from ImageMagick tend to do weird stuff like breaking aspect ratios or adding margins</li>
</ul>
</dd>
</dl>
</li>
<li>Merge files into the single PDF, e.g. using <tt class="docutils literal">qpdf <span class="pre">--empty</span><span class="pre">--pages …</span></tt></li></ol></summary><contenttype="html"><ol class="arabic simple">
<li>Extract the archive (cbz is just a zip, cbr is a rar, …)</li>
<li><dl class="first docutils">
<dt>Convert individual pictures to PDF using <tt class="docutils literal">img2pdf</tt></dt>
<dd><ul class="first last">
<li>Many other ways including <tt class="docutils literal">convert</tt> from ImageMagick tend to do weird stuff like breaking aspect ratios or adding margins</li>
</ul>
</dd>
</dl>
</li>
<li>Merge files into the single PDF, e.g. using <tt class="docutils literal">qpdf <span class="pre">--empty</span><span class="pre">--pages</span> *.pdf <span class="pre">--</span> output.pdf</tt>.</li>
<p>My eBook reader (PocketBook Touch Lux) does not seem to be able to handle cbz.</p>
</div>
</content><categoryterm="til"></category><categoryterm="comics"></category><categoryterm="software"></category></entry><entry><title>Do not forget about IPv6 DNS</title><linkhref="https://blog.ledoian.cz/forgetting-dns6.html"rel="alternate"></link><published>2024-01-24T03:20:00+01:00</published><updated>2024-01-24T03:20:00+01:00</updated><author><name>LEdoian</name></author><id>tag:blog.ledoian.cz,2024-01-24:/forgetting-dns6.html</id><summarytype="html"><p>Do you think IPv6-only internet works OK? I am going to tell you that it does
not, but it is not immediately visible. TL;DR: The internet can be broken also
by forgetting to add AAAA records of the <em>nameservers</em>. This creates IPv4
requirement for the resolving even when the …</p></summary><contenttype="html"><p>Do you think IPv6-only internet works OK? I am going to tell you that it does
not, but it is not immediately visible. TL;DR: The internet can be broken also
by forgetting to add AAAA records of the <em>nameservers</em>. This creates IPv4
requirement for the resolving even when the target is reachable using IPv6.</p>
<div class="section" id="quick-recap">
<h2>Quick recap</h2>
<p>Connecting to a website is easy, right? You type in the name, you get the front page.</p>
<h3>Reaching IPv4 land from IPv6-only</h3>
<p>There are few^H^H^Hmany sites that still only support IPv4. To reach them, we
need someone who can reach both the IPv4- and IPv6-land to go there on our
behalf – a proxy. This proxy can be ad-hoc (I often use <tt class="docutils literal">ssh <span class="pre">-D</span></tt>) or there
are well-known protocols like NAT64 with DNS64 to do that in a standard and
<p class="caption">And now we can reach the whole internet.</p>
</div>
<p>You might already know that you need some workaround like this to reach GitHub.
What I think you might not know, you need similar workaround to reach the Wikipedia.</p>
<p>Disclaimer: I like Wikipedia and this is not meant to shame them, just use as
an example. I am aware of several other sites suffering from the same problem,
including at least one IPv6 test. <a class="footnote-reference" href="#test-aaaa" id="footnote-reference-2">[2]</a> (It would be nice if they added
the missing piece in the puzzle, though.)</p>
</div>
</div>
<div class="section" id="enter-dns">
<h2>Enter DNS</h2>
<p>Our picture has one unexplored magic box: the DNS. As per the definition (which
I just made up and was not bothered to even fully formulate):</p>
<blockquote>
yada yada distributed database of records attached to the strings – domain
names. The records hold various information about the domain depending on the type.</blockquote>
<p>There are three interesting types of records: A records give IPv4 addresses,
AAAA give IPv6 addresses and NS give names of servers who know about the
particular subtree of the database. And to actually resolve the final AAAA
record the (recursive) resolver starts at the <em>root zone</em> and tries to find
the answer. <a class="footnote-reference" href="#dns-simplification" id="footnote-reference-3">[3]</a> The resolution algorithm can be visualised like this:</p>
<p>So, what is the deal. We <em>just</em> need to have a dual-stack DNS resolver
somewhere, and that's it, no? Well, yes but actually yes.</p>
<p>There are two problems with this: First, this means that any new ISP needs to
have <em>at least some</em> IPv4 address, even if they intend to just use IPv6
services. IPv4 addresses are scarce, <a class="reference external" href="https://blog.apnic.net/2021/12/16/opinion-ipv4-address-markets/">expensive</a> and small
new ISP's and from overal routing's point of view. It also hinders IPv6
deployment and postpones IPv4 abandonment, needlessly.</p>
<p>The second issue is that this is not very visible. We are building IPv6 world,
but deep inside it still relies on IPv4, which might lead to great surprise
when we start cutting off IPv4 internet. And it might lead to false sense of
having IPv6 deployed, which is not true to the whole extent.</p>
<p>Insert &quot;It was DNS&quot; meme here.</p>
</div>
<div class="section" id="solution">
<h2>Solution</h2>
<p>The solution of this state is simple: get IPv6 connectivity to your
authoritative DNS server (or use another) and do not forget to add an AAAA
record for it in DNS. If the DNS server already has IPv6 it is probably just
a matter of adding a single line to the zone file (and a second one for the DNSSEC
signature), which should not be a big deal.</p>
<p>Unfortunately, this needs to be done for the whole DNS chain.
Especially domain names at universities are infamous for very nested domains.
A domain name may look like
<tt class="docutils literal"><span class="pre">machine.department.location.faculty.university.some-common.suffix</span></tt>. That
tree is deep and so is the resolution of this problem.</p>
<tr><td class="label"><a class="fn-backref" href="#footnote-reference-1">[1]</a></td><td>This is very much the same as when you try to reach the
IPv4-public-land from IPv4-private-land, that is, from a private range of IP
addresses. This is called either just NAT, or NAT44 to denote IPv4-to-IPv4 NAT.</td></tr>
<tr><td class="label"><a class="fn-backref" href="#footnote-reference-2">[2]</a></td><td>There are several more tests that do not even have the AAAA
<tr><td class="label"><a class="fn-backref" href="#footnote-reference-3">[3]</a></td><td>In my example, there is a single recursive DNS
resolver external to my machine in order not to complicate it too much.
The real deployment is often trickier.</td></tr>
<tr><td class="label"><a class="fn-backref" href="#footnote-reference-4">[4]</a></td><td>I have not yet tried to run a recursive DNS in a network
with DNS64 and NAT64. Could be fun :-D My wild guess is that I would need
CLAT (i.e. the full 464XLAT deployment) to make that work, since the
resolver is connecting directly to IPv4 addresses and would need to learn to
use NAT64 to resolve them. (The CLAT could be built right into the resolver,
though).</td></tr>
</tbody>
</table>
</div>
</content><categoryterm="networking"></category><categoryterm="ipv6-only"></category><categoryterm="dns"></category></entry><entry><title>About this blog</title><linkhref="https://blog.ledoian.cz/about-blog.html"rel="alternate"></link><published>2024-01-10T16:47:00+01:00</published><updated>2024-01-10T16:47:00+01:00</updated><author><name>LEdoian</name></author><id>tag:blog.ledoian.cz,2024-01-10:/about-blog.html</id><summarytype="html"><p>This is my blog and this article describes its setup and other details about my
intentions. The actual <a class="reference internal" href="#the-setup">setup</a> is probably the most
interesting tech-wise.</p>
<div class="section" id="what-is-this">
<h2>What is this?</h2>
<p>My own space on the internet where I can post whatever and link others to it.
It might end up containing rants …</p></div></summary><contenttype="html"><p>This is my blog and this article describes its setup and other details about my
intentions. The actual <a class="reference internal" href="#the-setup">setup</a> is probably the most
interesting tech-wise.</p>
<div class="section" id="what-is-this">
<h2>What is this?</h2>
<p>My own space on the internet where I can post whatever and link others to it.
It might end up containing rants, guides, ideas, or maybe nothing at all in the
end. Only the future will tell.</p>
<p>The blog might even serve as my personal web page/introduction. Maybe. Maybe not…</p>
<p>The main motivation is to have low-effort way to post random stuff. Which leads
to my requirements for this thing.</p>
</div>
<div class="section" id="requirements">
<h2>Requirements</h2>
<p>(The requirements are a bit too idealistic, so not all of them were satisfied…)</p>
<ul class="simple">
<li>low-effort, me-friendly, low-maintenance – I don't want to have to learn too
many new technologies to use this. This includes the required technologies:
<li>Technical and math content ~~friendly~~ compatible – I expect that to appear
here.</li>
<li>Static site – for security, coolness factor and control. Also static on the
front-end, because I don't like JavaScript and/or running untrusted code on
my machine (even when in a sandbox). The SSG should likely be aimed at
creating blogs, not documentation. Also, self-contained, as in not depending
on third-party sites.</li>
<li>No moving parts in the infrastructure (or as few as possible) – if it works
on my machine, it should just get mirrored to the public site with as few
modifications as possible.</li>
<li>Transparent – I should be able to understand it, maybe others could also use
it as a resource or take inspiration. (At one point, this deployment itself
started being interesting, so if I can share the background as well as the
final webpage, it would be cool.)</li>
<li>Followable – I know you internet guys like to ~~stalk~~ follow people :-)</li>
<li>Aligned with my values: minimalist, simple, extensible/hackable, FLOSS</li>
<li>If the platform could distinguish translations and do strikethroughs, it would
be nice, but that is not a hard requirement.</li>
</ul>
<p>There are several features of conventional blogs that I consider to be a
non-goals or even anti-goals. Mostly it is about interactivity – I don't aim
for having any kind of comments here, or really anything that would require
JavaScript or complex HTML/CSS. And appearance goes past me as well, I instead
try to let the browser decide how to display this page – more on that <a class="reference internal" href="#design-considerations">below</a>.</p>
<p>The workflow I wanted to achieve is something like: Write the content, git it,
build it (locally, no CI/CD), push it, done. Single write, single push, very
simple.</p>
<p>And I managed to achieve something like that, via learning (too much?) about
git.</p>
<!-- TODO: fix the worktree bug already! -->
</div>
<div class="section" id="the-setup">
<h2>The setup</h2>
<p>Naturally for a sysadmin/netadmin, the setup consists of 7 ~~ISO/OSI~~ layers:</p>
<ol class="arabic simple">
<li><strong>Physical layer</strong>: cheap Hetzner VPS. Not physical, but whatever.</li>
<li><strong>Persistence layer</strong>: <a class="reference external" href="https://gitea.ledoian.cz/LEdoian/blog">this git repo</a>. I will elaborate below why can
you see this both rendered here and in the source form in Forgejo.</li>
<li><strong>Content layer</strong>: Markdown or reStructuredText files.</li>
<li><strong>Business logic layer</strong>: <a class="reference external" href="https://getpelican.com">Pelican</a>. It's rather
popular and written in Python, I didn't look further.</li>
<li><strong>Presentation layer</strong>: I hacked my own theme, because I didn't like any in
the <a class="reference external" href="https://github.com/getpelican/pelican-themes">pelican-themes repo</a>.
I was a bit inspired by the layout of <a class="reference external" href="https://eev.ee/blog">eevee's blog</a>, but I wanted a dark theme. And as you can see, I
can't do quality frontend, so it ended up horrible… :-D</li>
<li><strong>Stalking layer</strong>: Pelican's built-in RSS and Atom feed generators. Not
linked from anywhere at the moment, but <a class="reference external" href="https://gitea.ledoian.cz/LEdoian/blog/src/branch/blog/output/feeds">the repo will tell you</a> what
hides under the <tt class="docutils literal">/feeds/</tt> path. Or you can utilize the repo (for personal
use – the content's license is not decided at the moment)…</li>
</ol>
<p>Most of this is straightforward, the fancy part is my repo. The repo contains
both source and rendered content, so that I can point Nginx right at a checkout
and have Git solve both persistence and deployment without additional moving
parts.</p>
<p>There are two tricks in the configuration of Git repositories: pushing to a
checked out repo is enabled by configuring <tt class="docutils literal">receive.denyCurrentBranch =
updateInstead</tt> in the target repository (which is just a normal repo, not a
bare one), and then I just told my source repositories <a class="footnote-reference" href="#multiple-src" id="footnote-reference-1">[1]</a> to use
two push targets for the remote (the first line <em>replaces</em> the original push
<p>The blog user is just a user with SSH access via authorized keys, no special
sauce there. Nginx is then pointed to serve <tt class="docutils literal">~blog_user/blog_dir/output/</tt> at
<tt class="docutils literal">blog.ledoian.cz</tt>. (The <tt class="docutils literal"><span class="pre">git-remote(1)</span></tt> manpage requires me to have both
repositories in sync, but as long as I configure all my repositories this way,
I should be safe, and I think I could get away with my blog checkout getting
<h2>My workflow and lots of drafts</h2>
<p>It's Git so it's only natural for me to use various branches and repositories
even for a dumb blog. There are in fact 4 stages an article may go through <a class="footnote-reference" href="#skipping-stages" id="footnote-reference-2">[2]</a>:</p>
<ol class="arabic">
<li><p class="first">A private draft: lives on a branch <tt class="docutils literal">priv/something</tt>, may contain private
infos (like when I would just copy-paste from terminal without redaction)
and this branch will probably never be merged to the main repo. Nothing
about these branches is guaranteed.</p>
</li>
<li><p class="first">A public WIP draft: uses a branch called <tt class="docutils literal">pub/something</tt> which is pushed
to Forgejo (and in fact also to the blog itself, but that is just an
implementation detail). The draft is either does not build or is very
incomplete and I expect to add stuff in a way that could break the build, so
I put it on a separate branch. The branch will be probably merged to the
main branch (called <tt class="docutils literal">blog</tt>) when it is ready.</p>
<p>The <tt class="docutils literal">pub/…</tt> branches can be created either manually or by cherry-picking
from the respective <tt class="docutils literal">priv/…</tt> branch, but that will likely not be
distinguishable. (I am too lazy to keep the references even in the commit
logs.)</p>
</li>
<li><p class="first">When a draft is almost ready (or the content has simple syntax), it gets
placed on the <tt class="docutils literal">blog</tt> branch. The only thing that designates it as a draft
is <tt class="docutils literal">status: draft</tt> in the frontmatter, which means that the article will
get rendered and put somewhere on the public blog, but not reachable from
the title page (&quot;unlisted&quot;).</p>
</li>
<li><p class="first">Of course, eventually (and hopefully) the article gets published for
everyone to see. At that point, it is complete (or at least that is what I
thought when marking it as published). Possibly it might be updated in the
future, but no such update is anticipated at the moment of publishing. <a class="footnote-reference" href="#update-this" id="footnote-reference-3">[3]</a></p>
</li>
</ol>
<p>I use Git to synchronize my private branches among machines, so there are
actually two &quot;server-side&quot; repositories (private and public one) and thus two
<p>As for the actual workflow, for the main branch it usually consists of: writing
content, committing it, building the web, checking it locally, committing the
built blog and pushing it. Sometimes I do the commits together, but I always
separate the rendering/building commits from the content-creating ones, so that
I can handle those differently if needed (i.e. there is no point in
cherry-picking the built content, I can generate it). <a class="footnote-reference" href="#git-purists" id="footnote-reference-5">[5]</a></p>
<p>For other branches I use some applicable subset of the steps above, probably.</p>
<p>The appearance of the blog is maybe not nice. That is for two reasons: I don't
have the right idea about how to make it much better and I want to have a
rather simple CSS for the web. The latter wish is because I tend to tweak
appearance of sites I visit using my own styles, so I would like you to be able
to do the same.</p>
<p>And for the former reason, if you have any ideas / improvements (including user
styles), hit me at <a class="reference external" href="mailto:blog&#64;pokemon.ledoian.cz">blog&#64;pokemon.ledoian.cz</a> :-)</p>
<p>My overall idea is a dark-by-default <a class="footnote-reference" href="#light-theme" id="footnote-reference-6">[6]</a> minimalist page with a single menu on the
right containig all the relevant links. The page should not dictate too much
but rather let the user agent decide the rendering (<a class="reference external" href="https://html.spec.whatwg.org/multipage/rendering.html#rendering">it does anyway…</a>).</p>
<p>I want my blog to render similarly in Gecko-, WebKit- and Blink-based browsers
(e.g. Firefox, Badwolf, Qutebrowser). Others should be usable.
Browser-/engine-specific styles are not welcome – let's keep it simple. And no
<tr><td class="label"><a class="fn-backref" href="#footnote-reference-1">[1]</a></td><td>I also use multiple machines on which I can write stuff.</td></tr>
<tr><td class="label"><a class="fn-backref" href="#footnote-reference-2">[2]</a></td><td><p class="first">I am lazy and chaotic (good), so the stages are optional
and non-linear, and sometimes involve paper. This article is a prime
example: parts of it were on two different private branches, but at the end
I wrote it from scratch directly on the main branch. And the requirements
were written on a paper originally.</p>
<p class="last">Nevertheless, the general idea still holds and may inspire others, so it
makes sense to keep this part in the article. (Also, this footnote might not
make sense before reading the definition of the stages, but I didn't find a
<tr><td class="label"><a class="fn-backref" href="#footnote-reference-3">[3]</a></td><td>Well, given this article contains some future plans, I
actually anticipate update of this one, but maybe not in the near future. So
the outline is not really correct, but I make the rules :-) (There
were some build breaks on the main branch, too :-D)</td></tr>
<tr><td class="label"><a class="fn-backref" href="#footnote-reference-4">[4]</a></td><td>I would love if my Forgejo could have &quot;private
branches&quot;, but I understand that the overhead for doing this is not nice,
since it would need to be able to decide for any object, whether it is
public or not (you can do <tt class="docutils literal">git fetch &lt;remote&gt; <span class="pre">&lt;object-hash&gt;</span></tt>) and somehow
keep track even with rebases, merges, force-pushes, many branches, … Having
a separate private repository is not a big problem in comparison.</td></tr>
<tr><td class="label"><a class="fn-backref" href="#footnote-reference-5">[5]</a></td><td>Git purists might want to tell me that committing build
artifacts is not good practice. I know and I explicitly don't care in case
of this repo, because here I prioritise my own comfort of being able to
check everything locally and then be reasonably sure the deployed version
will also work, all this with only a single push somewhere. Of course, one
could argue that with that there is no reason to create two commits, but it
does not really bother me to run something like <tt class="docutils literal">git commit <span class="pre">-m&quot;render&quot;</span>
output/</tt> when I am sure it works, and this keeps readable diffs separate
from the non-readable ones (i.e. the changes in generated HTML).</td></tr>
<tr><td class="label"><a class="fn-backref" href="#footnote-reference-6">[6]</a></td><td>Having the page be dark-by-default is my preference, but I
respect that others may prefer light sites. However, I have not yet
determined what colors should be used (probably still cyan / blue / maybe
purple-ish, but I don't know what shade) nor understood how to use
<tt class="docutils literal"><span class="pre">&#64;media(prefers-color-scheme)</span></tt> in a maintainable and simple way (in the
context of my theme). So naturally, this is postponed to the future…</td></tr>
</tbody>
</table>
</div>
</content><categoryterm="technology"></category><categoryterm="meta"></category><categoryterm="infrastructure"></category></entry><entry><title>Smršť 2023 (CZ)</title><linkhref="https://blog.ledoian.cz/smrst2023-cs.html"rel="alternate"></link><published>2023-12-02T18:00:00+01:00</published><updated>2023-12-02T18:00:00+01:00</updated><author><name>LEdoian</name></author><id>tag:blog.ledoian.cz,2023-12-02:/smrst2023-cs.html</id><contenttype="html"><p>Na <a class="reference external" href="https://ksp.mff.cuni.cz/akce/smrst/2023/">Smršti</a> jsem přednášel o distribuci SW a o technicky zajímavých železničních neštěstích.</p>
<li><a class="reference external" href="https://blog.ledoian.cz/static/talks/smrst2023/talk.pdf">Slidy ke přednášce o neštěstích</a></li>
</ul>
<p>(Pozn.: Možná se ještě změní adresa téhle stránky, protože je to celé WIP…)</p>
