The reason was simple: I wasn’t aware it existed. Upon investigation, I discovered that html.unescape() would indeed convert HTML entities like   to actual non-breaking space characters.

We ultimately decided against implementing this method right now. Currently, we’re replacing   with a regular space character rather than a non-breaking space character, and using html.unescape() would change how text is rendered wherever we use this function. Before making such a change, we would need spend a little more time investigating to ensure it would benefit our users without introducing unexpected side effects.

Additionally, looking at the source code it seems like there are lots of HTML entities that would be converted to Unicode characters. I asked Claude AI and he said there are 2,125 entities defined. So it seems like it would be prudent to thoroughly evaluate all these potential conversions before implementing such a change.

To enable images, all I needed to do was add an image key to the front matter of my posts. Here’s an example:

image:
  path: /assets/images/post-image.webp
  alt: "Post Image Alt Text"

If you want a default image to be used when no image is specified, you can set it in the _config.yml file:

defaults:
  -
    scope:
      path: "" # an empty string here means all files in the project
    values:
      image:
        path: /assets/images/default-social-share-image.png
        alt: "Epicserve Logo"

1. With uv tool run, you can run commands to test things without the need to install them. Example, uv tool run pycowsay "hi". This will run the pycowsay command with the argument hi. I was curious if the python package was cached and if so, how it was cached. So I asked, and @charliermarsh said the package is cached and updated frequently.
2. Is uv tool run pycowsay "hi" too long to type? UV has you covered with the uvx alias, you can use uvx pycowsay "hi" instead.
3. Do you have a tool you use all the time and want it installed in its own isolated environment? You can use uv tool install to install it. Example, uv tool install ruff. Curious where it was installed to? You can use uv tool dir to find out.
4. Want to upgrade a tool or all tools? You can use uv tool upgrade ruff to upgrade the ruff tool or uv tool upgrade --all to upgrade all tools.

Want more details? Check out UV’s documentation.

It used to be that if you wanted to read and write to a file, you would do something like this:

with open("example.txt", "r") as f:
    text = f.read()

with open("example.txt", "w") as f:
    f.write(text + " (updated)")

But with pathlib, you can do this instead:

from pathlib import Path

path = Path("example.txt")
text = path.read_text()
path.write_text(text + " (updated)")

Using pathlib is not only more concise but also handles file opening and closing for you, ensuring proper resource management.

Behind the Scenes

From the pathlib source code, you can see that read_text and write_text methods using context managers to open and close the files, so you don’t have to worry about it:

def read_text(self, encoding=None, errors=None, newline=None):
    """
    Open the file in text mode, read it, and close the file.
    """
    with self.open(mode='r', encoding=encoding, errors=errors, newline=newline) as f:
        return f.read()

def write_text(self, data, encoding=None, errors=None, newline=None):
    """
    Open the file in text mode, write to it, and close the file.
    """
    if not isinstance(data, str):
        raise TypeError('data must be str, not %s' % data.__class__.__name__)
    with self.open(mode='w', encoding=encoding, errors=errors, newline=newline) as f:
        return f.write(data)