Refactor Codebase and Migrate to Static Site Builder (e.g. Jekyll) #13
Description
To improve maintainability, performance, and content organization for baskon.ir, I propose refactoring the current codebase and rebuilding the site using a static site generator like https://jekyllrb.com.
💡 Motivation:
- Current setup may be getting a bit bulky or harder to scale.
- Jekyll offers great support for content-heavy, topic-based sites like Baskon.
- Using Markdown + frontmatter makes it super simple to add or update topics.
- Better separation of content vs. presentation.
- Easier to host (e.g. GitHub Pages has built-in support for Jekyll).
🛠 Suggested Steps:
- Audit existing structure and extract reusable content (posts, topics, layouts).
- Create a basic Jekyll setup with folders like
_topics,_layouts,_includes. - Port existing HTML/CSS into proper templates and includes.
- Rewrite posts/topics in Markdown with proper frontmatter.
- Test locally and configure for GitHub Pages deployment.
✅ Acceptance Criteria:
- Jekyll site builds successfully and matches current visual design.
- Topics and posts are organized under a clean, scalable structure.
- Documentation is updated to reflect new build and contribution process.