1. I had to move most of the params in language sections to params sub-section. Actually, hugo serve warns about wrongly placed parameters, so it’s not a big problem.
2. I’ve removed taxonomyTerm from the outputs section in config. As I understood, it’s all merged with taxonomy now, so separate parameter doesn’t make sense.
3. I had to make category keys in theme to lower case. 0.123.3 has added the capitalizeListTitles option (i.e. font-patching became Font-Patching). For some people it’s conveinent, but for me it broke localization, since it was based on lowercased keys. In truth, making keys lowercased was a rushed decision, because I could just disable an option, but at some point there could be a problem when something somewhere will be in wrong case, and will break everything, so it’s for the better.

But now everything is generated with fresh Hugo 0.126.1, and works as expected. I think I’ll write a theme for Hugo sometime, but I think it won’t happen soon.

For app users

I’ll tell you right away: this way won’t be useful if the accent color is important to you.

Open Registry Editor and find HKEY_CURRENT_USER\SOFTWARE\Microsoft\Windows\DWM section. You’ll need the following parameters from it:

• ColorPrevalence: DWORD = 1
  This parameter allows to use accent color as title bar color.
• AccentColor and AccentColorInactive: DWORD = color in ABGR format (hexadecimal).
  Colors for active and inactive mode.

Here’s an example of registry file where color #000000 is used for active window title and #212121 is used for inactive one:

Windows Registry Editor Version 5.00

[HKEY_CURRENT_USER\SOFTWARE\Microsoft\Windows\DWM]
"ColorPrevalence"=dword:00000001
"AccentColor"=dword:ff000000
"AccentColorInactive"=dword:ff212121

For app coders

You’ll need DwmSetWindowAttribute function:

HRESULT DwmSetWindowAttribute(
       HWND    hwnd,        // window
       DWORD   dwAttribute, // attribute itself
  [in] LPCVOID pvAttribute, // value
       DWORD   cbAttribute  // value size in bytes
);

Attribute values are described by DWMWINDOWATTRIBUTE but we specifically interested in DWMWA_USE_IMMERSIVE_DARK_MODE. Documentation says it’s equal to 20, however until 20H1 version the value has been equal to 19 .

That’s how i’ve tried to implement autodetect of window frame theme in Ultimate++ :

  HRESULT (WINAPI *DwmSetWindowAttribute)(HWND hwnd, DWORD dwAttribute, LPCVOID pvAttribute, DWORD cbAttribute);
  DllFn(DwmSetWindowAttribute, "dwmapi.dll", "DwmSetWindowAttribute");
  if (DwmSetWindowAttribute) {
    BOOL useDarkTheme = IsDarkTheme(); 
    DwmSetWindowAttribute(
      top->hwnd, 20, /* 20 is DWMWINDOWATTRIBUTE::DWMWA_USE_IMMERSIVE_DARK_MODE */
      &useDarkTheme, sizeof(useDarkTheme));
  }

It seems that only thing left to me is to make yourself an editor or at least button to add/update posts. Still, it’s not convenient to do it through SFTP. Time and date are written manually as well.

Probably this is what’s stopping me to write here frequently, so when I’m starting to write, the posts become longer than I expect.

But with notes probably blog will be more lively. Articles won’t go anywhere though, you can subscribe to them by RSS separately. Or only to notes. Or to notes with tag.

I’m also thinking to make something for small posts, like self-hosting some ActivityPub server. In that case though it will be a small server, because there is not much RAM on this VPS. But that’s under question.

First, Hugo now natively supports plurals for many languages. All thanks to https://github.com/gohugoio/go-i18n module (fork of https://github.com/nicksnyder/go-i18n ). Usage is very simple: create reqired keys in localization file and translate them. Here’s current list for reference (with two-letter language codes): https://github.com/gohugoio/go-i18n/blob/main/v2/internal/plural/codegen/plurals.xml

Second, Hugo can now localize dates through time.Format DATE_FORMAT DATE. I’ve rewritten templates a little, and now places with dates from these:

{{- with .Site.Params.dateformat | default "2006-01-02" | .PublishDate.Format -}}

became these:

{{- with time.Format (.Site.Params.dateformat | default "2006-01-02") .PublishDate -}}

Category and meta tags localization I had to done on my own. They may not fully work with new section though, but I’ll fix it sometime.

What is it like? It’s something like my own simple microblog without any backend. It’s easier for me to make some small notes than to write full articles, and it suites these cases very well.

Of course the deployment like this affects social part, but I can duplicate posts somewhere if necessary. This way, there is the RSS feed (this button from top right), so you can subscribe in any RSS reader that is convenient to you.

Note

Even though there was a similiar font picked in Russian translation, it’s notably differs from original.

Original Griftlands font: Titillium.

Original uses Titillium font. Even though I’m not a fan of such fonts, it fits in the game pretty good.

Griftlands Russian translation font: Exo 2. There are some tests of translation abilities though, don’t mind them.

Russian translation uses Exo 2 , since original Titillium has no support for Cyrillic. Luckily, there is a version with Cyrillic glyphs from certain Daymarius. And this is the version I’m planning to port.

But it’s not that simple. Even though Griftlands has mod system, where textures are loaded from PNG, fonts are still in TEX format, and you can’t load them from TGA or PNG. But I’ve managed to replace the font anyway.

Extracting original font

To understand how to replace the font, we need to identify original font format.

Fonts themselves can be found in Griftlands folder/data.zip/fonts. Luckily, it’s a simple .zip and it can be opened with any archiver.

Font folders in game archive.

Original uses the last one, Titillium. So, this the font we will extract.

Every font needs two files: font.fnt and font0.tex.

This screenshot spoilers a little that this file can be opened in Sublime Text. As you can guess, it’s a text file, or more specifically, XML.

File font.fnt.

But what to do with .tex file? Without thinking, I headed to Google search.

At first I’ve font .tex file tool for Don’t Starve . But sadly, a blank screen was shown when I’ve opened a file.

Opened font texture in TEXTool. No error, but no texture either.

Next thing I’ve found is the way to export textures to PNG. In forum reply a function code has been posted but info about how to call it I’ve found later . In short:

1. Enable debug mode. For that you’ll need to add --debug to game start parameters.
2. Open in-game console. It can be done by hitting Ctrl+~ (tilde).
3. Call function from there. I did it by copy-pasting from text editor because it’s faster and more convenient.

After that texture will be saved in Griftlands folder to в user folder/Appdata/Roaming/Klei/Griftlands/steam-***.

Font extraction code looked like this:

UIHelpers.SaveTextureAsPNG(
	engine.asset.Texture("fonts/titillium_sdf.zip/font0.tex"),
	"titillium")

One-line version

Formatting was added for readablity sake, but it probably won’t work in console, so if you want to test it in-game, it’s better to use this one-line version:

UIHelpers.SaveTextureAsPNG(engine.asset.Texture("fonts/titillium_sdf.zip/font0.tex"), "titillium")

Result came out… strange.

Extracted version of Titillum font texture in PNG.

Many questions arise momentarily:

• Why not symbols are here?
• Why the font is blurry?
• Why it’s rainbow-colored?

After that I’ve tried to extract Russian font. It defintely should contain more symbols. Extraction code wasn’t changed, only few arguments:

UIHelpers.SaveTextureAsPNG(
	engine.asset.Texture("fonts/exo_ru_sdf.zip/font0.tex"),
	"exo")

One-line version

Formatting was added for readablity sake, but it probably won’t work in console, so if you want to test it in-game, it’s better to use this one-line version:

UIHelpers.SaveTextureAsPNG(engine.asset.Texture("fonts/exo_ru_sdf.zip/font0.tex"), "exo")

But result was the empty picture:

Exracted version of Exo 2 font texture in PNG.

Right away it’s evident that something is lost during PNG export, so digging the format itself is required. That’s why i’ve opened it in hex editor and found an interesting thing.

Opened file font0.tex in hex editor.

First thing spotted is DDS. Could it really be DirectDraw Surface? Well, there is a simple way to check: just trim all bytes before it.

Cleaned font0.tex file from first few bytes.

And now is expectable question: how to open it? At first I’ve tried Paint.net:

Patched font0.tex file opened in Paint.net.

My guess was correct: it is DirectDraw Surface. But there are still questions left: if it’s the original DDS, then how it works?

I’ve decided to search how else this file can be opened, and I’ve found very unexpected option: Visual Studio.

Eveything is same if not counting green background instead of checkered. But this was the place where I’ve found out what’s happening here.

Some time ago, when I was fiddling with Source engine textures with VTFEdit, they had alpha channel enabled by default. And commonly part of texture was hidden behind the same alpha channel. That’s I’ve decided to try: maybe it’s the same story here? And disabled alpha channel.

Jackpot.

Now it’s all made clear: letters are packed in different channels.

It’s clear now why only some symbols were shown and why they were rainbow-colored.

After that I’ve easily managed to convert it to TGA: it can be done in the very same Visual Studio. Why TGA? Just because it .fnt file said that.

By the way, as I’ve found out later, Paint.net also can convert DDS to TGA. So it’s a possible alternative if you don’t want to to install Visual Studio. But I’m sure there are other ways to do it.

Converted TGA works perfectly in Adobe Photoshop.

Then I’ve got curious how in-game Exo 2 looks.

Mostly the same, but it uses bigger texture and about 1.3 of channel is used in total. But mostly it looks the same.

Well, I’ve found the way to extract, now I need to find to create my own and pack it.

But there is still one question left unsolved.

Replacing of extracted font

As you can see, texture font is… a bit blurry. Not sure what’s the glowing border around it.

But luckily there is a hint right in font names.

Yes, you’ve got it correctly, we’re talking about SDF.

Without thinking I’ve started to search any information about it. And i’ve found out this article: UTF-8 text rendering with SDF font (in Russian) .

Not sure if there is an equal material or a translation of it on English, but I’m not going to tell what’s the SDF here. But here are the things from it that helped me:

1. BMFont software. This app allows to generate bitmap font. Instruction in article wasn’t written for it, so I had to pick settings myself. Maybe UBFG would be easier, but I decided to avoid building.
2. ImageMagick command. To get the result I need I’ve played with paramters a little.

First I’ve installed the font (since loading from file didn’t work) and opened it in BMFont. Also I’ve immediately selected all symbol groups that were there.

Font settings turned out to be easy: changed only the font itself and size. Font size was adjusted to approximate texture size though.

But export settings were a little pain, but in the end I’ve chosen something like this:

Important things here:

• Padding sets the padding from from symbol. It should be big enough since SDF border is not taken into account when generating.
• Texture width and texture height. I’ve tried to pick the size that will be not too big but can fit all symbols. Moreover, I’ve tried to not touch alpha channel.
• Pack chars into multiple channels. It allows to generate same font textures like in the game: packed in different channels.
• Chnl and Value. Here I’ve decided to pick the same values like in original: encoded glyph & outline is 2 (set for alpha channel in original font) and glyph is 0 (set for other channels).

But here’s the problem. The thing is that if Pack into multiple channels is checked then you can change either preset or alpha channel. In this case you can do the following:

1. Choose in Presets “White text on black (no alpha)”.
2. Set alpha channel to encoded glyph & outline instead of one.

And of course I’ve set Targa without RLE compression as type and XML as Font Descriptor.

Note

You can pick different settings that could be even better. For example, on my second try I’ve noticed that it has direct extraction to DDS. But after the export I’ve caught a new problem so testing is required.

You can see the resulted font in Options > Visualize beforehand, but since the color is too eye-hurting (it’s bright red!), I’ll better show export result:

Now only thing left is to make it an SDF. For that I’ve used the following command from the article:

convert font.png ^
	-filter Jinc ^
	( +clone -negate -morphology Distance Euclidean -level 50%,-50% ) ^
	-morphology Distance Euclidean ^
	-compose Plus ^
	-composite ^
	-level 43%,57% ^
	-resize 12.5% ^
	font.png

I’ve used newer version of ImageMagick and adjusted some values, so it’s ended like this:

magick font.png ^
	-filter Jinc ^
	( +clone -negate -morphology Distance Euclidean -level 50%,-50% ) ^
	-morphology Distance Euclidean ^
	-compose Plus ^
	-composite ^
	-level 42%,58% ^
	font.png

Few words about formatting

I’ve split the command to multiple lines for readability sake and since all things from article were done on Windows, its command line splitting is used. However, there is nothing specific for Windows’ command line, so it can be easily adapted to Bash by simply replacing ^ to \:

convert font.png \
	-filter Jinc \
	( +clone -negate -morphology Distance Euclidean -level 50%,-50% ) \
	-morphology Distance Euclidean \
	-compose Plus \
	-composite \
	-level 43%,57% \
	-resize 12.5% \
	font.png

magick font.png \
	-filter Jinc \
	( +clone -negate -morphology Distance Euclidean -level 50%,-50% ) \
	-morphology Distance Euclidean \
	-compose Plus \
	-composite \
	-level 42%,58% \
	font.png

Or it can be written in one line which should work in both shells:

convert font.png -filter Jinc ( +clone -negate -morphology Distance Euclidean -level 50%,-50% ) -morphology Distance Euclidean -compose Plus -composite -level 43%,57% -resize 12.5% font.png

magick font.png -filter Jinc ( +clone -negate -morphology Distance Euclidean -level 50%,-50% ) -morphology Distance Euclidean -compose Plus -composite -level 42%,58% font.png

But if you’ll try to convert TGA that way, the result will be an empty file. The thing is that filter must be applied to each channel seprately. I haven’t understood how to apply filter to channel in ImageMagick yet, but before it’s done it’s easier to save channels manually and process them, and then glue them back together.

That was the result:

Just what I needed. Now I need to convert to TEX, but how?

As I wrote eariler, TEX is a DDS with its own header. So I just need to convert TGA to DDS and add necessary bytes.

Update

By pure accident I figured out that neither TEX bytes nor DDS conversion aren’t needed. Renaming TGA file to font0.tex and putting in right folder is enough.

All done, now you can include the font in mod and test it in-game. But there was a surprise waiting for me.

A small note: this screenshot is from old version when I was experimenting with texture sizes, so it was packed in other way. With current settings it could look different but the point still stands.

Most of the text became totally unreadable. But some letters are shown correctly. What’s wrong?

As it turned out, only green channel was shown correctly. After swapping red and blue channels and re-packing everything started to work as expected.

Few closing words

It’s kinda hard to change the font in Griftlands currently. Maybe there will be people that will write specialized programs for that. I’m planning to write a proper guide with better commands and easier generation options.

Regarding Russian translation, I’ve planned to fix its mistakes because they weren’t fixed after Griftlands left the early access. But nobody knows when that happen. Even me. But I hope it will.

By the way, you can use the font in-game through this mod:

Titillium (Russian)

This mod adds Russian version of Titillium font.

Steam Workshop | Griftlands

Note that to get it to work, you need the Font Switcher:

Font Switcher

This mod allows to change font for game texts. It doesn't add new fonts, and just uses ones the game already have.

Steam Workshop | Griftlands