Cline rules

1# Project Context for AI (Cline)
2 
3This file documents key configurations and setups within the `vaibhavdeokar-portfolio` repository for future reference, particularly regarding complex integrations.
4 
5## External Repository Integration (e.g., `cpp-notes`)
6 
7This project integrates content from external Git repositories (like `cpp-notes`) into the Jekyll build process managed by Netlify.
8 
9**Mechanism:**
10 
111.  **Netlify Build Script (`netlify-build.sh`):**
12    *   Located in the repository root.
13    *   Executed by Netlify as the primary build command (configured in `netlify.toml`).
14    *   **Clones** external repositories (e.g., `git clone https://github.com/dev-ai-kar/cpp-notes.git _cpp_notes`).
15    *   **Adds Front Matter:** Uses `find ... -exec sed ...` to inject empty YAML front matter (`---\n---`) into all `.md` files within the cloned directories. This is necessary if the source repositories don't include front matter, which Jekyll requires for collection processing.
16    *   Runs the standard Jekyll build (`bundle exec jekyll build`).
17    *   Designed to be extensible for adding more repositories.
18 
192.  **Netlify Configuration (`netlify.toml`):**
20    *   The `[build].command` is set to `./netlify-build.sh`.
21    *   The `[build].publish` directory is `_site/`.
22 
233.  **Jekyll Configuration (`_config.yml`):**
24    *   Each cloned external repository directory (e.g., `_cpp_notes`) is defined as a Jekyll **collection**.
25    *   Example:
26```yaml
27        collections:
28          cpp_notes:
29            output: true
30            permalink: /notes/cpp/:path.html
31```
32    *   This tells Jekyll to process the files within these directories and generate pages according to the specified `permalink`.
33 
344.  **Automation Trigger (GitHub Action):**
35    *   Each *external* repository (e.g., `cpp-notes`) contains a GitHub Action workflow (`.github/workflows/trigger_netlify_build.yml`).
36    *   This workflow triggers on `push` events to the external repository's main branch.
37    *   It sends a POST request to a **Netlify Build Hook URL** specific to the main portfolio site.
38    *   The build hook URL is stored securely as a **GitHub Secret** (e.g., `NETLIFY_BUILD_HOOK_URL`) within the external repository's settings.
39    *   This triggers a new build of the main portfolio site on Netlify, ensuring the latest content from the external repository is included.
40 
41**Workflow Summary:**
42 
43Push to external repo -> GitHub Action triggers -> Sends request to Netlify Build Hook -> Netlify starts build for main portfolio -> `netlify-build.sh` runs (clones external repo, adds front matter) -> Jekyll builds site including external content -> Netlify deploys.
44 
45## General Project Conventions (from README.md)
46 
47*   **Blog Post Categories:** Use a single, broad category (e.g., `AI`, `Web Development`, `Personal`).
48*   **Blog Post Tags:** Use multiple, specific tags to describe the post's topics (e.g., `Neo4j`, `RAG`, `Jekyll`, `React`).
49*   **Commit Messages:** Follow the [Conventional Commits](https://www.conventionalcommits.org/) specification for Git commit messages (e.g., `feat:`, `fix:`, `docs:`, `style:`, `refactor:`, `test:`, `chore:`). This helps maintain a clear and automated commit history.
50 
51## Common Jekyll Front Matter Variables (Posts)
52 
53*   `layout:` (Required) Layout file from `_layouts` (e.g., `post`).
54*   `title:` (Required) Post title.
55*   `date:` (Required for `_posts`) Publication date (e.g., `YYYY-MM-DD` or full timestamp). Must match filename date format.
56*   `categories:` (Optional) Single string or list for broad topic (e.g., `AI`).
57*   `tags:` (Optional) List or string of specific keywords (e.g., `[Jekyll, Netlify]`).
58*   `description:` (Recommended) Short summary for SEO and social previews.
59*   `author:` (Optional) Author name.
60*   `image:` (Recommended) Path to featured image for social previews (e.g., `/images/my-image.jpg`).
61*   `published:` (Optional) Set to `false` to prevent publishing (defaults to `true`).
62*   _(Custom variables can also be added as needed by the layout)._
63