Refactor: Split monolithic files into modular flashcard system!

Author: Anass Rach

CONTRIBUTING.md

@@ -0,0 +1,35 @@
+# Contributing to Java 21 OCP Flashcards
+
+Thank you for your interest in contributing!
+
+## Adding New Flashcards
+
+1. Choose the appropriate category directory under `_flashcards/`
+2. Create a new file using the naming convention: `##-descriptive-name.md`
+3. Use the template in `_templates/flashcard-template.md`
+4. Test locally with `bundle exec jekyll serve`
+
+## Adding Quiz Questions
+
+Add questions to `_data/quiz/questions.yml` following the existing format:
+
+```yaml
+- question: "Your question text?"
+  options:
+    - "Option A"
+    - "Option B"
+    - "Option C"
+    - "Option D"
+  correct: 1  # 0-based index
+  explanation: "Explanation of the correct answer"
+  category: "Category Name"
+```
+
+## Guidelines
+
+- Use clear, practical examples
+- Include explanations for all concepts
+- Follow existing formatting patterns
+- Test code examples before submitting
+
+See the full contribution guide for detailed instructions.

Gemfile.lock

@@ -13,11 +13,15 @@ GEM
       http_parser.rb (~> 0)
     eventmachine (1.2.7)
     ffi (1.17.1-arm64-darwin)
+    ffi (1.17.1-x64-mingw-ucrt)
     ffi (1.17.1-x86_64-linux-gnu)
     forwardable-extended (2.6.0)
     google-protobuf (4.29.3-arm64-darwin)
       bigdecimal
       rake (>= 13)
+    google-protobuf (4.29.3-x64-mingw-ucrt)
+      bigdecimal
+      rake (>= 13)
     google-protobuf (4.29.3-x86_64-linux)
       bigdecimal
       rake (>= 13)
@@ -45,6 +49,11 @@ GEM
       webrick (~> 1.7)
     jekyll-include-cache (0.2.1)
       jekyll (>= 3.7, < 5.0)
+    jekyll-remote-theme (0.4.3)
+      addressable (~> 2.0)
+      jekyll (>= 3.5, < 5.0)
+      jekyll-sass-converter (>= 1.0, <= 3.0.0, != 2.0.0)
+      rubyzip (>= 1.3.0, < 3.0)
     jekyll-sass-converter (3.0.0)
       sass-embedded (~> 1.54)
     jekyll-seo-tag (2.8.0)
@@ -75,9 +84,12 @@ GEM
       ffi (~> 1.0)
     rexml (3.4.0)
     rouge (4.5.1)
+    rubyzip (2.4.1)
     safe_yaml (1.0.5)
     sass-embedded (1.83.4-arm64-darwin)
       google-protobuf (~> 4.29)
+    sass-embedded (1.83.4-x64-mingw-ucrt)
+      google-protobuf (~> 4.29)
     sass-embedded (1.83.4-x86_64-linux-gnu)
       google-protobuf (~> 4.29)
     terminal-table (3.0.2)
@@ -87,10 +99,12 @@ GEM
 
 PLATFORMS
   arm64-darwin
+  x64-mingw-ucrt
   x86_64-linux-gnu
 
 DEPENDENCIES
   jekyll (~> 4.4.1)
+  jekyll-remote-theme
   just-the-docs (= 0.10.1)
 
 BUNDLED WITH

_config.yml

@@ -2,8 +2,37 @@ title: Java 21 OCP Flashcards
 description: A Structured collection of flashcards to help you prepare for the Oracle Certified Professional (OCP) Java 21 exam.
 remote_theme: just-the-docs/just-the-docs
 url: https://anasss.github.io
-baseurl: /java21docCards  # Add this line!
+baseurl: /java21docCards
 nav_enabled: true
 back_to_top: true
+
 plugins:
   - jekyll-remote-theme
+
+# Collections configuration
+collections:
+  flashcards:
+    output: true
+    permalink: /:collection/:name/
+    sort_by: order
+
+# Default front matter
+defaults:
+  - scope:
+      path: ""
+      type: "flashcards"
+    values:
+      layout: "flashcard"
+      parent: "Java 21 OCP Flashcards"
+
+# Just the Docs configuration
+search_enabled: true
+aux_links:
+  "GitHub Repository":
+    - "https://github.com/Anasss/java21docCards"
+
+# Quiz configuration
+quiz:
+  title: "Java 21 OCP Quiz"
+  description: "Test your knowledge of Java 21 OCP exam topics"
+  total_questions: 32