How kush-singh-26/blogs works
Main Components
• Jekyll Engine & GitHub Pages: At the center is the Jekyll engine responsible for reading the source files and converting them into a static website that GitHub Pages serves.
• Content Sources:
• _posts: Contains the blog posts (Markdown files) that form the primary content. Each post uses Jekyll’s front matter to declare metadata.
• about.markdown, index.markdown, and tags.md: These are additional static pages.
• _data: Holds site data like tag configurations (e.g., tags.yml).
• _tags: Contains markdown files for specific tag pages.
• Templates:
• _layouts: Houses layout templates (such as tag_page.html) that determine the overall page structure.
• _includes: Contains partials like header, footer, and post tags to be embedded in pages.
• Plugins:
• _plugins: This folder includes Ruby scripts (e.g., tag_generator.rb) to extend Jekyll’s functionality – in this case, to auto-generate tag pages from the posts.
• Assets:
• assets: Contains the CSS stylesheets (custom, syntax, and tag styles) and possibly other static assets like JavaScript if needed.
• images: Likely holds the images used in posts or site design.
Relationships and Interactions
• The Jekyll engine processes the _posts, _data, _layouts, _includes, and _plugins to generate the final static website.
• The _posts folder feeds content into templates defined in _layouts and enriched by includes from _includes.
• The _plugins directory, with the tag generator, interacts with both metadata defined in posts and the content in _tags to produce dynamic tag pages.
• Configuration (_config.yml) ties these elements together by defining site settings, plugin usage, and build behaviors.
• Assets and images are referenced by generated HTML via linking, ensuring the site’s styling and media are rendered correctly.
Architectural Patterns and Design Principles
• Separation of Concerns: Notice how the project clearly separates content (posts, pages), presentation (layouts, includes, assets), and additional functionalities (plugins).
• Modular Design: The use of includes and data files promotes reusability and maintainability of components.
• Declarative Configuration: _config.yml manages configurations declaratively, which is core to static site generators.