How bhardwajabhi/myblogs works
Main Components
a. Content Layer:
• Markdown Content Storage (docs/posts directory)
• Assets Storage (docs/assets directory)
• Configuration (mkdocs.yml)
b. Template Layer:
• Theme Overrides (overrides directory)
• Partial Templates (overrides/partials)
• Custom Layouts (404.html, blog.html, main.html)
c. Build/Generation Layer:
• MkDocs Static Site Generator
• Output/Distribution Layer
d. Client-Side Components:
• JavaScript Functionality (extra.js, mathjax.js, view-bigimg.js)
• Styling (extra.css, view-bigimg.css)
Specific Elements
a. Content Management:
• Blog Posts Structure (mobile-security section)
• Tags System
• Assets Management
b. Template Components:
• Header Partial
• Navigation Partial
• Post Content Partial
• Tag Cloud
• Comments System (Disqus)
c. Client-Side Features:
• MathJax Integration
• Image Viewing Enhancement
• Custom JavaScript Functionality
┌─ Content Layer ─────┐ ┌─ Template Layer ──┐ ┌─ Build Process ─┐
• Markdown Posts │ -> │ - Main Template │ -> │ MkDocs │
• Assets │ │ - Partials │ │ Generation │
• Configuration │ │ - Overrides │ └────────────────┘
• ┘ └─────────────────┘ │
• ▼
• ┌─ Output Layer ──┐
• Static Website │
• ┘
Important Notes
• Modular nature of the template system
• How the tag system creates relationships between posts
• Where custom JavaScript and CSS integrate
• Responsive/mobile considerations
• Commenting system integration point