![](/assets/images/image-default.png)
Script For Front Matter Update
I decided that if front matter data is provided explicitly, then that should not be overwritten by the ruby scripts that run during the build. What is explicitly written manually should be “respected” by the scripts as “the guide to follow”.
Previously I added a ruby script to assign the categories
based on the folder name. The way I approached it first, the previous categories
would be overwritten. The way it will work now is that the automated assignment will happen only if the categories
haven’t been explicitly set in the post file. Code below:
# _plugins/assign_categories.rb
Jekyll::Hooks.register :posts, :pre_render do |post, payload|
# Extract the category from the post's directory
dirname = File.basename(File.dirname(post.path))
# Assign the category to the post's front matter
if dirname != "_posts" && (post.data['categories'].nil? || post.data['categories'].empty?)
post.data['categories'] = [dirname]
puts "Categories assigned to post #{post.data['title']}: #{dirname}"
end
end
Atm I am working with only one category, and using the
categories
key. If the amount of posts keeps growing, I might modify the approach (I could think of more than one category for each post, and maybe appending categories based on dir name and parent - for the current status of the site, the approach explained in this post suffices).
The task I had left after this was to remove all the categories
front matter from the existing posts. I adapted a Python script I used previously to perform this task in an automated way:
import os
import re
import logging
import tempfile
import shutil
DIR = "/path/to/folder/_posts"
PREFIX = "categories:"
def log_config():
"""performs a logging basic setup"""
handler_to_file = logging.FileHandler("log.log", "w")
handler_to_file.setLevel(logging.DEBUG)
handler_to_console = logging.StreamHandler()
handler_to_console.setLevel(logging.ERROR)
logging.basicConfig(
handlers=[
handler_to_file,
handler_to_console,
],
format="%(asctime)s: %(levelname)s %(filename)s %(lineno)s: %(message)s",
level=logging.DEBUG,
)
def is_text_file(filepath):
"""Check if a file is a text file."""
try:
with open(filepath, 'tr') as check_file: # open in text mode to read
check_file.read(1024) # Read the first 1024 bytes
logging.debug(f"file is readable: {filepath}")
return True
except: # If an error occurs, it's likely not a text file.
logging.error(f"File is NOT readable: {filepath}")
return False
def delete_first_line_starting_with(file_path, prefix):
# Create a temporary file
temp_fd, temp_path = tempfile.mkstemp()
with os.fdopen(temp_fd, 'w', encoding='utf-8') as temp_file:
with open(file_path, 'r', encoding='utf-8') as f:
line_already_skipped = False
for line in f:
if line_already_skipped:
temp_file.write(line)
elif not line.startswith(prefix):
temp_file.write(line)
elif line.startswith(prefix):
line_already_skipped = True
# Replace the original file with the temporary file
os.remove(file_path)
shutil.copy(temp_path, file_path)
def process_directory(root_dir, search_text):
"""Walk through the directory and its subdirectories to find and replace text in files."""
for root, dirs, files in os.walk(root_dir):
for filename in files:
if re.match(r'\d{4}-\d{2}-\d{2}', filename) and is_text_file(os.path.join(root, filename)):
logging.debug(f"file found: '{filename}'")
delete_first_line_starting_with(os.path.join(root, filename), search_text)
else:
logging.debug(f"file doesn't match pattern: '{filename}'")
if __name__ == "__main__":
log_config()
logging.debug("script started")
directory_path = DIR
search_text = PREFIX
process_directory(directory_path, search_text)