Presentation Title

This repository contains a presentation built with reveal.js.

🚀 Quick Start

Option 1: Using as a Template (Recommended)

1. Click "Use this template" button at the top of this repository
2. Create your new repository
3. Clone your new repository
4. Run the setup script to customize:
5. The script will:
   • Update the README with your repository name
   • Update index.html with your presentation title
   • Rename the markdown file to match your repo name
   • Update package.json
   • Self-delete when done

Option 2: Manual Setup

1. Clone this repository
2. Manually update:
   • README.md: Replace placeholders with your values
   • index.html: Update title and markdown file reference
   • slides/presentation.md: Rename to your preferred name
   • package.json: Update the name field

🎯 View the Presentation

👉 View Live Presentation

After setup, this link will automatically point to your GitHub Pages deployment.

📝 Editing Your Presentation

The presentation is written in Markdown. Edit the file in the slides/ directory.

• Use --- to separate slides
• Use -- for vertical slides
• Add images to the images/ directory
• Customize styling in css/custom.css

🧪 Local Development

To preview your presentation locally:

This will start a local server at http://localhost:8000

🌐 Deploy to GitHub Pages

Step 1: Enable GitHub Actions Workflow Permissions

1. Go to your repository Settings > Actions > General
2. Scroll down to Workflow permissions
3. Select Read and write permissions
4. Check Allow GitHub Actions to create and approve pull requests
5. Click Save

Step 2: Enable GitHub Pages

1. Go to your repository Settings > Pages
2. Under Source, select GitHub Actions from the dropdown
3. Click Save

Step 3: Deploy

1. Push your changes to the main branch:

   git add .
   git commit -m "Initial presentation"
   git push

2. The GitHub Actions workflow will automatically build and deploy your presentation
3. Check the Actions tab to monitor the deployment
4. Once complete, your presentation will be available at https://YOUR-USERNAME.github.io/YOUR-REPO-NAME/

Note: The first deployment may take a few minutes. Subsequent updates deploy automatically when you push to main.

🎨 Customization

• Styling: Edit css/custom.css for custom styles
• Images: Add images to the images/ directory
• Theme: Change the reveal.js theme in index.html
• Configuration: Modify reveal.js settings in index.html

📚 Resources

• reveal.js Documentation
• Markdown Guide
• GitHub Pages Documentation