Add bilingual presentation pages

.github/workflows/ci.yml

@@ -30,12 +30,18 @@ jobs:
 
       - name: Validate Marp presentation
         run: |
-          mkdir -p site
+          mkdir -p site/ko site/en
           npx --yes @marp-team/marp-cli@4 \
-            ai-agent-sandboxing.md \
+            ai-agent-sandboxing-ko.md \
             --html \
             --allow-local-files \
-            -o site/index.html
+            -o site/ko/index.html
+          npx --yes @marp-team/marp-cli@4 \
+            ai-agent-sandboxing-en.md \
+            --html \
+            --allow-local-files \
+            -o site/en/index.html
+          cp index.html site/index.html
           cp -R assets site/assets
 
       - name: Validate PowerShell syntax

.gitignore

@@ -21,13 +21,13 @@
 !.github/**
 
 # Presentation source and referenced assets.
-!ai-agent-sandboxing.md
+!ai-agent-sandboxing-*.md
 !assets/**
 !docs/
 !docs/**
 
-# Generated GitHub Pages entrypoint.
-index.html
+# GitHub Pages language redirect.
+!index.html
 
 # PowerShell scripts and modules.
 !*.ps1

CONTRIBUTING.md

@@ -1,37 +1,47 @@
 # Contributing
 
-Thank you for improving the presentation materials, demo scripts, and
-infrastructure definitions in this repository.
+Thank you for improving the presentation materials, demo scripts, and infrastructure definitions in this repository.
 
 ## Development prerequisites
 
 - Git
 - Node.js 22 or later for Marp rendering
-- PowerShell 7 for PowerShell scripts
-- Bash for shell scripts
+- PowerShell 7 for PowerShell scripts (Only for Windows users)
+- Bash for shell scripts (Only for non-Windows users)
 - Azure CLI with Bicep support for infrastructure validation
 
 ## Make a change
 
 1. Create a branch using `feat/`, `fix/`, or `docs/`.
-2. Keep generated HTML, PDF, PowerPoint, speaker-note exports, and previews
-   out of commits.
+2. Keep generated HTML, PDF, PowerPoint, speaker-note exports, and previews out of commits.
 3. Update `CHANGELOG.md` when a change affects users of the materials.
-4. Use [Conventional Commits](https://www.conventionalcommits.org/) for commit
-   messages.
+4. Use [Conventional Commits](https://www.conventionalcommits.org/) for commit messages.
 
 ## Validate presentation changes
 
 ```bash
+# For English
+mkdir -p en/assets
+cp -R assets/. en/assets/
 npx --yes @marp-team/marp-cli@4 \
-  ai-agent-sandboxing.md \
+   ai-agent-sandboxing-en.md \
   --html \
   --allow-local-files \
-  -o index.html
+   -o en/index.html
 ```
 
-Review the generated presentation for overflow, broken image links, and
-readability.
+```bash
+# For Korean
+mkdir -p ko/assets
+cp -R assets/. ko/assets/
+npx --yes @marp-team/marp-cli@4 \
+   ai-agent-sandboxing-ko.md \
+  --html \
+  --allow-local-files \
+   -o ko/index.html
+```
+
+Review the generated presentation for overflow, broken image links, and readability.
 
 ## Validate scripts
 

README.md

@@ -10,9 +10,10 @@ The primary presentation was prepared for various conferences and meetups, and c
 .
 ├── .github/
 ├── assets/
-├── ai-agent-sandboxing.md      # Marp presentation source
+├── ai-agent-sandboxing-ko.md   # Korean Marp presentation source
+├── ai-agent-sandboxing-en.md   # English Marp presentation source
 ├── docs/                       # Demo setup, runbooks, and recovery guides
-├── index.html                  # Generated presentation (ignored)
+├── index.html                  # Redirect to the Korean presentation
 ├── LICENSE
 └── README.md
 ```
@@ -29,29 +30,64 @@ The [demo documentation index](docs/README.md) provides two complete, sequential
 
 ## Preview the presentation
 
-1. Install Node.js 22 or later, then generate an HTML presentation:
+> [!NOTE]
+> To preview the presentation, you'll need 3 terminals.
+
+1. Install Node.js 22 or later
+
+1. Generate an HTML presentation for English in Terminal A:
+
+    ```bash
+    # zsh/bash
+    mkdir -p en/assets
+    cp -R assets/. en/assets/
+    npx --yes @marp-team/marp-cli@4 \
+      --watch \
+      ai-agent-sandboxing-en.md \
+      --html \
+      --allow-local-files \
+      -o en/index.html
+    ```
+
+    ```powershell
+    # PowerShell
+    New-Item -ItemType Directory -Force en/assets
+    Copy-Item -Recurse -Force assets/* en/assets/
+    npx --yes @marp-team/marp-cli@4 `
+      --watch `
+      ai-agent-sandboxing-en.md `
+      --html `
+      --allow-local-files `
+      -o en/index.html
+    ```
+
+1. Generate an HTML presentation for Korean in Terminal B:
 
     ```bash
     # zsh/bash
+    mkdir -p ko/assets
+    cp -R assets/. ko/assets/
     npx --yes @marp-team/marp-cli@4 \
       --watch \
-      ai-agent-sandboxing.md \
+      ai-agent-sandboxing-ko.md \
       --html \
       --allow-local-files \
-      -o index.html
+      -o ko/index.html
     ```
 
     ```powershell
     # PowerShell
+    New-Item -ItemType Directory -Force ko/assets
+    Copy-Item -Recurse -Force assets/* ko/assets/
     npx --yes @marp-team/marp-cli@4 `
       --watch `
-      ai-agent-sandboxing.md `
+      ai-agent-sandboxing-ko.md `
       --html `
       --allow-local-files `
-      -o index.html
+      -o ko/index.html
     ```
 
-1. Run local web server:
+1. Run local web server in Terminal C:
 
     ```bash
     npx serve .