Skip to content

IntScription/devlog

Repository files navigation

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.

🚀 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
  • fix_markdownlint.py — Automatically corrects markdownlint formatting errors
  • convert_wikilinks.py — Converts Obsidian wiki links ([[Link]]) to standard Markdown
  • add_front_matter.py — Adds Jekyll front matter to notes for proper rendering

These scripts run automatically via Git hooks to maintain code quality.