AI Tools Collection

A comprehensive collection of AI-related tools, prompts, instructions, and documentation for personal use.

This guide walks you through setting up Jekyll for GitHub Pages, allowing you to create a modern documentation site that automatically deploys when you push changes.

Prerequisites

Before starting, ensure you have:

Installation Steps

1. Install Jekyll and Bundler

gem install jekyll bundler

2. Create a New Jekyll Site

jekyll new my-ai-tools-site
cd my-ai-tools-site

3. Configure for GitHub Pages

Create or update your Gemfile:

source "https://rubygems.org"
gem "github-pages", group: :jekyll_plugins

group :jekyll_plugins do
  gem "jekyll-feed"
  gem "jekyll-sitemap"
  gem "jekyll-seo-tag"
end

4. Update _config.yml

title: Your AI Tools
description: Your AI tools collection
baseurl: "/repository-name"
url: "https://username.github.io"

markdown: kramdown
highlighter: rouge
theme: minima

plugins:
  - jekyll-feed
  - jekyll-sitemap
  - jekyll-seo-tag

5. Install Dependencies

bundle install

6. Test Locally

bundle exec jekyll serve

Visit http://localhost:4000 to see your site.

7. Deploy to GitHub Pages

  1. Create a new repository on GitHub
  2. Push your Jekyll site to the repository:
git init
git add .
git commit -m "Initial Jekyll site"
git branch -M main
git remote add origin https://github.com/username/repository-name.git
git push -u origin main
  1. Enable GitHub Pages in repository settings:
    • Go to Settings → Pages
    • Select “Deploy from a branch”
    • Choose “main” branch and “/ (root)” folder
    • Click Save

Configuration Tips

Custom Domain (Optional)

Add a CNAME file with your domain name if using a custom domain.

Security

Performance

Troubleshooting

Common Issues

Build fails with dependency errors:

bundle update
bundle exec jekyll serve

GitHub Pages not updating:

Local site not matching GitHub Pages:

Getting Help