A GitHub Pages site for publishing AI conversation transcripts and technical discussions in Markdown format.

1. Go to GitHub and create a new repository named ai-transcripts
2. Do NOT initialize with README, .gitignore, or license (we've already created these locally)

# Add GitHub remote (replace YOUR_USERNAME with your GitHub username)
git remote add origin https://github.com/YOUR_USERNAME/ai-transcripts.git

# Add and commit files
git add .
git commit -m "Initial commit: Set up AI transcripts site"

# Push to GitHub
git branch -M main
git push -u origin main

1. Go to your repository on GitHub
2. Click on Settings tab
3. Scroll down to Pages section
4. Under Source, select Deploy from a branch
5. Under Branch, select main and /docs folder
6. Click Save

Your site will be available at: https://YOUR_USERNAME.github.io/ai-transcripts/

Note: It may take a few minutes for the site to become available.

ai-transcripts/
├── docs/                    # GitHub Pages source
│   ├── _config.yml         # Jekyll configuration
│   ├── _posts/             # Blog posts / transcripts
│   │   ├── 2025-01-10-welcome-to-ai-transcripts.md
│   │   └── 2025-01-10-sample-technical-discussion.md
│   ├── assets/             # Images and other assets
│   │   └── images/
│   ├── Gemfile             # Ruby dependencies
│   └── index.md            # Homepage
├── .gitignore              # Git ignore rules
└── README.md               # This file

1. Create a new file in docs/_posts/
2. Name it: YYYY-MM-DD-title-of-transcript.md
3. Add Jekyll front matter:

---
layout: post
title: "Your Title Here"
date: YYYY-MM-DD
categories: [category1, category2]
tags: [tag1, tag2]
---

Your content here...

4. Commit and push to GitHub:

git add docs/_posts/your-new-file.md
git commit -m "Add new transcript: Your Title"
git push

To preview your site locally before pushing:

cd docs
bundle install
bundle exec jekyll serve

Then visit http://localhost:4000/ai-transcripts/

• Theme: Edit theme in docs/_config.yml (current: minima)
• Site Info: Update title, description, author in docs/_config.yml
• Homepage: Edit docs/index.md
• Styling: Add custom CSS in docs/assets/css/

• Headers (# ## ###)
• Bold and italic text
• Links
• Code blocks with syntax highlighting
• Lists (ordered and unordered)
• Tables
• Blockquotes
• Images: ![alt text](/ai-transcripts/assets/images/image.png)

• Keep transcripts organized by date and category
• Use descriptive filenames
• Add relevant tags for better navigation
• Include code examples where applicable
• Regular commits help track conversation history

• GitHub Pages Documentation
• Jekyll Documentation
• Markdown Guide
• Minima Theme

Your content, your license. Consider adding a LICENSE file if needed.

Built with Jekyll and GitHub Pages