cdecl99-1.3 bash-5 hotfix

Turns out that prior to release the package was not tested on any
systems where /bin/sh is bash-5, and the configure script hits a
parser bug in this shell regarding for loops in case statements.

A workaround is to set CONFIG_SHELL environment variable to some
other shell without this bug.  But if that's not possible, this
patch can be applied to avoid the bug.

Fix display of updated date.

Looks like the updated date was never actually written to the output, so
the template to display it never did anything.  Furthermore, let's not
bother displaying the updated date if it's the same as the publish date.

More eclipse photos

2024-04-08 initial eclipse photos.

weblog-update: Work around breakage in new ruby versions.

Apparently we now have to supply a whitelist of permitted classes
to the load method.

Release cdecl99-1.3.

This is a maintenance release with a lot of improvements over the
last couple years.

Release rarpd-dx-1.

Initial bundle with a minimum of changes compared to iputils-20211215.

Add new rarpd-dx project.

If the iputils folks don't want to package this anymore, I guess I can.

Fix compiled_content filter on Ruby 3.

It is apparently now required to use ** when passing a hash to a
function that takes keyword arguments.

Update css_darkmode to handle media queries under @supports.

This filter currently does not "see" anything within a @supports block,
so the hoisting of dark-mode media queries inside such a block is not
properly done.

Fix this by restructuring the filter to recurse down into these blocks.

Move whitespace handling templates into a separate file.

This is pretty independent of anything else so we can use an
xsl:include to pull it in.  Also remove duplicate definition of
f:ends-with which is in the same area.

Update rrace README.

M48T59Y battery replacement

Add project page for rrace

Lunar eclipse 2022-05-15

Apply background colour to the html element.

Older versions of Mozilla do not colour the entire window when
the style is applied to the body element.  Using the html element
instead seems to do the job.

Make archive file icon shadows visible in dark mode.

On a black background, the black icon shadows are invisible.  This is
not a huge problem but we can use CSS rules to make them visible again.

To do this, the SVG embedding is adjusted to automatically add classes
based on the filename in order to differentiate between the various
images, and additional classes are added to the icons to enable
selectors to match the shadows.

The results seem OK.

Implement dark mode without using CSS variables.

Instead of using CSS variables, we can just directly change colours
with appropriate media queries.

Moreover, implement a small postprocessor which consolidates all the
dark mode rules together at the end of the stylesheet, which makes
it a svery imple matter to also link an alternate stylesheet which
is selectable in older browsers.

Automatically adjust colour scheme for "dark mode".

Playing around a bit, let's try to respect "dark" mode in firefox and
support automatically switching colour scheme accordingly.

We convert all colour references in the stylesheet to new SASS mixins
that will generate rules to adapt to the correct colour scheme.  The
selection is done using CSS variables that should gracefully degrade
to the original (light) colours.

Attempt to improve focus ring styles in modern browsers.

It seeems new browsers use a rather different focus ring style by
default from how it used to be.  This means the focus rings in the
clicky table headers (which are made by CSS rules) don't look anything
like the focus rings on links.

To try and fix this, let's explicitly style all the focus rings to
be more like how they look by default in new browsers.

Release cdecl99-1.2.

Maintenance release with fixes for portability issues and other
minor improvements.

Compress all output files for a rep.

An item rep may be written to multiple places, and currently only
one of them gets compressed by the gzip rule.

Unfortunately while nanoc maintains a complete output list internally,
it is not exposed in the documented API.  But it's not too hard to pull
out the guts and get the full list in order to compress everything.

Suggest keyserver (again) for retrievng public keys.

The keyserver protocol is super simple and just consists of HTTP
requests, so we can self-host this option pretty easily too.  This is
probably more widely supported than the very new Web Key Directory.

I also prefer how the retrieval instructions specify an explicit key
ID rather than just an email address.

Ensure ASCII-armoured keyrings are text items.

The gzip postprocess rule only applies to text items, so the
ASCII-armoured keyring is not compressed.

It does not seem possible to produce both binary and text items from a
filter depending on options, so we split the filter into two: one for
the binary export required by WKD and the other for the armoured export
for manual download.

Update GPG instructions for packages.

It seems the keys.gnupg.net keyserver has been dead for some time, so
it is not a viable option for public key distribution.

The new-ish Web Key Directory gives similar functionality but unlike
third party keyservers is self-hosted.

Simplify footer text when everything is identical.

When all images have an identical copyright and license to the main
document, there is no reason to mention this in the footer.

Use a denser style for gallery images.

Let's try some fancy modern grid styles to get more on the
screen when possible.

Solar Eclipse in Ottawa on 2021-06-10.

Release slotifier-1.2.

Bug-fix release.

Release cdecl99-1.1.

Bug-fix release.

Release cdecl99-1.

Almost a decade since I originally put this application together,
this is long overdue.

Use special SCSS comments for source and copyright info.

SCSS will preserve comments that begin with /*! even when writing
out compressed CSS.  While I'm not sure if I want to actually do this,
let's write out such comments for the source and copyright info which
should not be omitted.

Convert cdecl99 project page to use bundled README.md.

Try to allow word wrapping to occur in email addresses.

Consolidate some clicky table label styles.

There is a section of label styles that are the same for all headings,
and we can use a common class to avoid having to replicate the styles
for each column.

Add separator rows to the sorted part of clicky tables.

Normally these rows are hidden, but if styles are not applied, then
they will help visually separate the default-ordered table from the
jumble of rows representing all other orderings.

Embed SVG icons directly into output.

Inlining SVGs directly in the markup seems to interoperate somewhat
better than linking SVGs in img elements, and we can fairly easily
create fallback markup that degrades to a raster image.

Currently this is only applicable to the file listings because the
fallback markup is hardcoded to the icons on these pages.  This will
need to be expanded in the future.

The results seem pretty good, although nothing I do in old Mozilla
versions seems to be able to get the stylesheet sizes to properly
apply to SVG elements, so the icons are rendered correctly but at
the wrong scale.  SVG support can be disabled in this browser and
the fallback works properly.  More work may be required.

Merge the remove_wj filter into xhtml_compat.

Both these filters are used together and in every relevant compilation
rule.  The remove_wj filter is just one line and can be easily added
to xhtml_compat.

Add filter to shrink SVG icons using scour.

This reduces the uncompressed size of these images by about 2/3, and
the compressed size by about half, which seems pretty significant.

Improve styling of command examples.

These example commands are kind of like quotations so wrap the
paragraphs in blockquote tags.  This gives better results in most
browsers when styles are not used.

Then improve the styling overall to be more responsive: the results
are bad when linebreaks are placed in the middle of program options
or filenames, so try to prevent that by only allowing line breaks
where there are spaces.

Then, indent all but the first line to try and visually convey that
this is a continuation of the previous line.

Improve clicky table generation.

Disentangle the CSS rules for clicky tables from the file listing table
type, and eliminate all id selectors in favour of class selectors.

Then, move all the support markup out of the eruby program and into a
dedicated XSLT program which will perform the necessary transformation
based on a couple attributes added to the table elements.  The inputs,
labels, and the links between them are now automatically generated.

While it's more code overall, hopefully this reduces the complexity
of the implementation by clearly separating the various different parts.
Additionally, this should (if ever needed) make it easy to add clicky
headers to other tables, as well as supporting more than one clicky
table on a page.

Improve script hack compatibility.

Old versions of Netscape will actually try and execute these
definitely-not-javascript hacks as Javascript.  So let's try to
avoid that from happening by making the contents look like one
big Javascript comment.

We might need an additional workaround if any of the contents
contains a literal */.  We'll cross that bridge when we get to it.

Implement sortable file listing tables.

Just for fun, let's add clickable headers to sort the file listings by
name, modification time, and file size, both in forward and reverse,
entirely implemented using XHTML and CSS.

Implement version-aware sorting of file listings.

Based on glibc strverscmp, except with better awareness of version
components.  Now slotifier-1.1.tar.gz will appear after slotifier-1,
as expected.

Release slotifier-1.1.

Welp, not even a day and we already need to hotfix the release!
Let's just call it practicing our new release preparation systems...

Release slotifier-1.

Mostly a trial to see if we can get all the infrastructure in place
to release tarballs tarballs on the website.  Newly introduced is
an "archive" directory, which provides for browseable file listings,
as well as the ability to link to the most recent tar file in the
generated project descriptions.

Work around git-annex breakage.

Seems new versions of git annex just bail out when run in a "bare"
repository, (at least when git config core.bare return true).

Problem is, you can create work trees from bare repositories and then
the result is not really "bare" even though git config core.bare will
return "true".  Since site deployment does this, and then tries to run
git annex, we get pointless failures.

Simple enough to just manually set core.bare to false when running
git annex, which seems sufficient to make things work again.

Generate slotifier project page from bundled README.md.

Instead of keeping this information on the website, move most of
the contents of the slotifier project page to that package's README.

Then, use some scripts to pull the contents back into the website
via a git submodule.

Fix media queries that disable justification.

It seems at some point the rules to disable justification on narrow
displays stopped working (or maybe they never worked) due to the main
CSS selectors having higher specificity.

SCSS has a neat trick to expand the media query with matching selectors
which solves this problem nicely.  So let's use that.

Don't regenerate smaller images so often.

It is a bit annoying how nanoc always runs the rule to regenerate
resized images, even if none of the inputs are changed at all.

Since the imgresize filter is quite expensive to run, let's try hacking
around the problem by passing in the final output filename and just
re-using that if it exists and its mtime is newer than the source image.

This is definitely not the most accurate as it will not automatically
regenerate images if the rules change, but I expect any problems due to
this will waste less of my time than regenerating dozens of redundant
images every single time the site is compiled.

Let's start a blog!

Since I wrote this diatribe on fancy styles for HTML tables maybe it's
about time I actually went ahead and pushed it to the actual website.

Improve source references for binary items.

Since we binary items are probably annexed it is not particularly
helpful to provide direct links to the symlink in the repository,
as this contains basically zero helpful information.

Instead, let's link to the metadata file when available as that should
at least contain _something_ interesting.

First stab at images and git-annex.

Let's add a photo and some filters to produce a handy little image
information page.

It's not so nice to store these (relatively) huge files in git, so we'll
store them in git-annex and update the deployment scripts to handle it.

Nothing links to this image yet as this is pushed mainly to validate the
git-annex deployment, but it will be accessible by direct URI.

The intention is that the site should still compile with missing annexed
components, just that those items will be missing.  In the future we could
perhaps replace them with stubs (so at least the description part of the
info page would work) but we'll save that activity for another day.

Fix symlink handling in content directory.

In preparation to use git-annex for tracking large binary files, we
need to solve some problems related to its symlinks.  Most importantly
is that the nanoc "filesystem" data source really doesn't like broken
symlinks, so we modify that to avoid major problems.

Next we filter out all missing annex items in a preprocess rule.
Ideally we would replace them with stubs but just dropping them is
acceptable for now.

Finally, for binary items, passthrough rules end up copying the symlink
literally from the content to the output directory.  In the case of symlinks
to the annex directory this is not going to deploy correctly, so we need
a dummy filter to break the link.

Adjust whitespace preservation rules.

We don't generally want to delete whitespace between span elements.

An exception is made if all sibling text nodes are whitespace, in
which case they should all be removed to allow indentation.

Make permalinks in section headers optional.

These permalinks seem useful for licenses but maybe not so much
in general.  Let's make that controllable per-document by adding a
parameter to the XSL layout to select whether or not they will
be generated.

Convert stylesheet to SCSS and preprocess with SASS.

This CSS preprocessing tool seems pretty helpful for reducing repetition
in stylesheets.  While it does not make much difference now I hope to
make more use of its features in the future.

Add spaces in self-closing XML tags.

Some very old browsers that do not implement XHTML get confused by
tags like <hr/> but have no problem with <hr />.  This is very easy
to accomodate so let's do it.

Add project page for picard plugins.

Update gob-dx feature list.

Add a project page for gob-dx.

Remove dead definition list cruft.

The definition lists for the creative commons text never worked
quite right, and was committed as a comment; don't need that...

Tweak the footer styles a bit.

Shrink the footer margins too when the header collapses,
and remove a redundant footer style.

Put some actual material on the site.

Add an initial projects list and create description pages for
cdecl99 and slotifier.  Introduce a simple navigation mechanism
to these sub-pages.

Tweak whitespace-preserving templates.

We don't want to add whitespace to span-level elements which were
empty to start with, which is normal for e.g. img elements.

Also, if an element contains _only_ whitespace, it was probably put
there on purpose so let's preserve it.

Add an "icon" link with empty data URI.

This appears to stop pointless requests to /favicon.ico,
at least in some browsers.

Add a postprocess hook to gzip output text items.

This enables the use of nginx gzip_static functionality, reducing
per-request processing.  This is only done if GZIP_SITE is set to
a nonempty value in the environment so it can be run only when
publishing to avoid noise when authoring.

Strip leading and trailing whitespace from all <p> tags.

This should be harmless and improves the pretty-printed output a lot.

Work around Nokogiri pretty-print issues.

In general, pretty-printing XHTML will change its meaning because
whitespace added or removed can affect the results.  Instead of using
the xsl:strip-space functionality which is quite limited, use a normal
template to remove unwanted whitespace-only text nodes which can be
manually tweaked as required.

Then we explicitly add dummy nodes to prevent Nokogiri from reindenting
problematic cases, and finally clean those out just before publishing
(after all XSLT processing is finished).

Add copyright license information.

Add links from generated pages to source code on gitweb.

Initial commit