How hyperzsb/natalia-theme works
Project type and purpose
• “natalia-theme” is an open-source Jekyll & Bootstrap theme for building a static portfolio + blog.
• It provides layouts, includes, styles, scripts, and configuration so that a user can drop in their content (Markdown posts, project pages, personal data in _config.yaml) and generate a fully functional static site.
File structure
• Top-level directories:
• _layouts: HTML templates (default, post, project)
• _includes: reusable fragments (header, footer, TOC, loading, anchor headings)
• _pages: standalone pages (home, posts listing, projects listing, contact, 404)
• _posts & _projects: Markdown content for blog posts and project details
• _sass: SCSS partials for theming
• assets: compiled CSS (via SCSS), JavaScript (dark mode toggle, email form logic, Gitalk init, utils), images
• Configuration files:
• Gemfile / Gemfile.lock: Ruby gem dependencies (Jekyll core + plugins)
• _config.yaml: site metadata, plugin settings (Gitalk, EmailJS, Clarity), deploy settings (url, baseUrl)
• Build / deploy files:
• GitHub Actions workflow for GitHub Pages deployment (inferred by badge)
• Standard Jekyll build output in _site/
Key architectural notes from README
• Static-site generation pipeline using Jekyll + Liquid + Sass
• JavaScript enhancements for: comments (Gitalk/Preact), email (EmailJS), syntax highlighting (HighlightJS), math rendering (MathJax), analytics (Microsoft Clarity), dark mode
• Users customize via _config.yaml; sensitive values (clientSecret, service IDs) are recommended to be injected via environment variables in CI/hosting