💾 Archived View for rawtext.club › ~hut › inlineswap.gmi captured on 2023-12-28 at 16:49:46. Gemini links have been rewritten to link to archived content

-=-=-=-=-=-=-

Inlineswap

Seems like every programmer on earth wrote a static HTML generator ;). So here's mine: inlineswap, which is currently used by the website of ranger.

website of ranger

inlineswap

What's special about it? The main idea is that it will look for commands in your HTML files and put the result of those commands right back into the HTML file. This would be an example of the "run" command:

<!-- run echo '# Hello World' | markdown -->
<!-- /run -->

which will be substituted in-place to:

<!-- run echo '# Hello World' | markdown -->
<h1>Hello World</h1>
<!-- /run -->

As a result, the source file is also the output file, which is a nice property that I only found in inlineswap so far.

Other commands

There's 2 more commands, documented => https://github.com/hut/inlineswap/blob/master/inlineswap in the comments of the executable file.

With "get" you can automatically copy&paste parts from other HTML files, so you can e.g. change the website header in 1 file and auto-update it in the other files.
With the "relative" command you can fix relative links that would otherwise break if you "get" a part from a HTML file that is in another directory.

Real-life example

A real-life example is the changelog page of the ranger website. It contains the following commands:

changelog page of the ranger website

<!-- get head from index.html -->
<!-- run markdown CHANGELOG | sed 's/h1>/h2>/g' -->
<!-- get foot from index.html -->

The index.html defines the "head" and "foot" parts with simple `` and `` comments.

index.html

Should I use it?

Probably not. Learn something more useful.

Navigation panel