Add complete Jekyll site structure with documentation

.github/workflows/blank.yml

@@ -1,6 +1,5 @@
-# This is a basic workflow to help you get started with Actions
-
-name: CI
+# Jekyll site CI workflow
+name: Jekyll CI
 
 # Controls when the workflow will run
 on:
@@ -25,12 +24,17 @@ jobs:
       # Checks-out your repository under $GITHUB_WORKSPACE, so your job can access it
       - uses: actions/checkout@v4
 
-      # Runs a single command using the runners shell
-      - name: Run a one-line script
-        run: echo Hello, world!
+      # Set up Ruby for Jekyll
+      - name: Set up Ruby
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: '3.1'
+          bundler-cache: true
+
+      # Build the Jekyll site
+      - name: Build Jekyll site
+        run: bundle exec jekyll build
 
-      # Runs a set of commands using the runners shell
-      - name: Run a multi-line script
-        run: |git@github.com:Abdullah9990/Aa12.git
-          echo Add other actions to build,
-          echo test, and deploy your project.
+      # Run Jekyll doctor to check for issues
+      - name: Check Jekyll site
+        run: bundle exec jekyll doctor

Gemfile

@@ -0,0 +1,30 @@
+source "https://rubygems.org"
+
+# Jekyll version
+gem "jekyll", "~> 4.3.0"
+
+# Default theme for new Jekyll sites
+gem "minima", "~> 2.5"
+
+# GitHub Pages gem (optional, but recommended for GitHub Pages deployment)
+gem "github-pages", group: :jekyll_plugins
+
+# Jekyll plugins
+group :jekyll_plugins do
+  gem "jekyll-feed", "~> 0.12"
+  gem "jekyll-seo-tag", "~> 2.8"
+end
+
+# Windows and JRuby does not include zoneinfo files, so bundle the tzinfo-data gem
+# and associated library.
+platforms :mingw, :x64_mingw, :mswin, :jruby do
+  gem "tzinfo", ">= 1", "< 3"
+  gem "tzinfo-data"
+end
+
+# Performance-booster for watching directories on Windows
+gem "wdm", "~> 0.1", :platforms => [:mingw, :x64_mingw, :mswin]
+
+# Lock `http_parser.rb` gem to `v0.6.x` on JRuby builds since newer versions of the gem
+# do not have a Java counterpart.
+gem "http_parser.rb", "~> 0.6.0", :platforms => [:jruby]

README.md

@@ -1,2 +1,80 @@
 # Aa12
-Aa12
+
+A simple Jekyll-based GitHub Pages site demonstrating static site generation and deployment.
+
+## About
+
+Aa12 is a demonstration repository that showcases how to set up a basic Jekyll site with GitHub Pages. It includes:
+
+- Jekyll static site generator configuration
+- GitHub Actions CI/CD workflow
+- Minima theme
+- Sample blog post
+- Apache 2.0 License
+
+## Features
+
+- **Static Site Generation**: Built with Jekyll for fast, secure static websites
+- **GitHub Pages**: Automatically deployed through GitHub Pages
+- **Continuous Integration**: Configured with GitHub Actions for automated testing
+- **Markdown Support**: Write content in simple Markdown format
+- **Blog-Ready**: Includes sample blog post structure
+
+## Getting Started
+
+### Prerequisites
+
+- Ruby (version 2.7 or higher)
+- Bundler gem
+
+### Local Development
+
+1. Clone the repository:
+   ```bash
+   git clone https://github.com/Abdullah9990/Aa12.git
+   cd Aa12
+   ```
+
+2. Install dependencies:
+   ```bash
+   bundle install
+   ```
+
+3. Run the Jekyll server:
+   ```bash
+   bundle exec jekyll serve
+   ```
+
+4. Visit `http://localhost:4000` in your browser
+
+### Deployment
+
+This site is automatically deployed to GitHub Pages when changes are pushed to the main branch.
+
+## Project Structure
+
+```
+Aa12/
+├── _config.yml          # Jekyll configuration
+├── _posts/              # Blog posts directory
+├── index.md             # Homepage
+├── Gemfile              # Ruby dependencies
+├── README.md            # Project documentation
+├── LICENSE              # Apache 2.0 License
+└── .github/
+    └── workflows/       # GitHub Actions workflows
+```
+
+## Contributing
+
+Contributions are welcome! Feel free to open issues or submit pull requests.
+
+## License
+
+This project is licensed under the Apache License 2.0 - see the [LICENSE](LICENSE) file for details.
+
+## Resources
+
+- [Jekyll Documentation](https://jekyllrb.com/docs/)
+- [GitHub Pages Documentation](https://docs.github.com/en/pages)
+- [Minima Theme](https://github.com/jekyll/minima)

_config.yml

@@ -0,0 +1,19 @@
+# Site settings
+title: Aa12
+description: A simple Jekyll-based GitHub Pages site
+baseurl: "" # the subpath of your site, e.g. /blog
+url: "https://abdullah9990.github.io/Aa12" # the base hostname & protocol for your site
+
+# Build settings
+markdown: kramdown
+theme: minima
+
+# Exclude from processing
+exclude:
+  - Gemfile
+  - Gemfile.lock
+  - node_modules
+  - vendor/bundle/
+  - vendor/cache/
+  - vendor/gems/
+  - vendor/ruby/

_posts/2026-03-08-welcome-to-aa12.md

@@ -0,0 +1,28 @@
+---
+layout: post
+title: "Welcome to Aa12!"
+date: 2026-03-08 01:00:00 +0000
+categories: introduction
+---
+
+Welcome to the Aa12 GitHub Pages site!
+
+This is a sample blog post to demonstrate the Jekyll blogging functionality. Jekyll is a static site generator that transforms your plain text into beautiful static web sites and blogs.
+
+## What is Jekyll?
+
+Jekyll is a simple, blog-aware, static site generator perfect for personal, project, or organization sites. Think of it like a file-based CMS, without all the complexity.
+
+## Features
+
+- No database required
+- Markdown support
+- Liquid templating
+- GitHub Pages integration
+- Fast and secure
+
+## Getting Started
+
+Check out the [Jekyll documentation](https://jekyllrb.com/docs/) for more information about how to use Jekyll and create your own posts.
+
+Happy blogging!

index.md

@@ -0,0 +1,34 @@
+---
+layout: default
+title: Home
+---
+
+# Welcome to Aa12
+
+This is a simple Jekyll-based GitHub Pages site.
+
+## About
+
+Aa12 is a demonstration repository showcasing how to set up a basic Jekyll site with GitHub Pages.
+
+## Features
+
+- Built with Jekyll
+- Hosted on GitHub Pages
+- Uses the Minima theme
+- Automatic CI/CD with GitHub Actions
+
+## Getting Started
+
+To run this site locally:
+
+```bash
+bundle install
+bundle exec jekyll serve
+```
+
+Then visit `http://localhost:4000` in your browser.
+
+## License
+
+This project is licensed under the Apache License 2.0 - see the [LICENSE](LICENSE) file for details.