devlog

Welcome to my public developer log — a space where I document my daily progress, learning, and projects in software engineering, AI, and development tools.

You can visit the live site here: 🔗IntScription

---

✨ Features

• Dark/Light Mode Toggle — Instantly switch between beautiful dark and light themes with a single click (icon in the header).
• Live Typing Effect — The home screen welcome message is animated with a live typing effect for a modern, dynamic feel.
• Modern Navigation — Clean, always-visible navigation for Home and Archive, with a sticky header and responsive design.
• Beautiful Tables — All markdown tables are styled for clarity, contrast, and mobile-friendliness.
• Syntax Highlighting — Code blocks are colored by language, supporting both dark and light modes.
• Responsive & Accessible — Looks great on desktop, tablet, and mobile.
• Connect With Me — Footer links to GitHub and YouTube.

---

Folder Structure

devlog/
├─ _config.yml        # Jekyll configuration
├─ _layouts/          # Jekyll layout templates (default/note)
├─ _includes/         # Shared snippets (e.g., head-custom.html)
├─ assets/            # Static assets
│   ├─ css/main.scss  # All custom styles (theme, archive, etc.)
│   └─ js/            # JS for theme toggle + typing effect
├─ logs/              # Daily devlog entries (YYYY-MM-DD/index.md)
├─ archive.md         # Archive page (year dropdowns with month lists)
├─ index.md           # Main page (typing effect landing)
├─ scripts/           # Python helpers (front matter, nav, lint, wiki, recent)
└─ _site/             # Built output (generated by Jekyll; safe to ignore)

---

🛠 How I Work on This

• Written entirely in Neovim.
• Managed with git and lazygit.
• Hosted via GitHub Pages.

---

✍️ Writing a New Entry

Give each entry a real title: in its front matter, e.g.:

---
layout: default
permalink: /logs/2026-03-20/
title: Frontend Frameworks & Build Tools Explained
---

Without it, the title defaults to blank and both the homepage's "Recent Devlog Entries" list and the archive page fall back to the generic label "Devlog" — fine for one entry, useless once there are dozens of same-looking date links.

---

🚀 Quick Start (Local Dev)

bundle install
bundle exec jekyll serve

Then visit http://localhost:4000/devlog/ in your browser.

---

🔧 Automation Scripts

The scripts/ folder contains Python automation tools:

• fix_navigation.py — Fixes navigation links in all devlog entries
• update_recent.py — Refreshes the "Recent Devlog Entries" list on the homepage
• fix_markdownlint.py — Corrects markdownlint formatting errors (run manually; not wired into the pre-commit hook)
• convert_wikilinks.py — Converts Obsidian wiki links ([[Link]]) to standard Markdown
• add_front_matter.py — Adds Jekyll front matter to notes for proper rendering

fix_navigation.py and update_recent.py run automatically via the pre-commit Git hook. The other scripts are run manually as needed.