Skip to content

feat: add Vietnamese translation support for exercise instructions #18

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
vucongchien wants to merge 1 commit into
base: main
Choose a base branch
from
+13,026 −1,334
Open

feat: add Vietnamese translation support for exercise instructions #18

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 8 additions & 4 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

# 💪 Exercises Dataset

**A developer setup wizard + structured, multilingual exercise dataset — scaffold your own exercise app backend (DB schema, API code, LLM prompt) over 1,324 exercises with category, body-part, equipment, target and muscle-group data and step-by-step instructions in 6 languages (English, Spanish, Italian, Turkish, Russian, Chinese). Exercise media is not included.**
**A developer setup wizard + structured, multilingual exercise dataset — scaffold your own exercise app backend (DB schema, API code, LLM prompt) over 1,324 exercises with category, body-part, equipment, target and muscle-group data and step-by-step instructions in 7 languages (English, Spanish, Italian, Turkish, Russian, Chinese, Vietnamese). Exercise media is not included.**

[![Exercises](https://img.shields.io/badge/Exercises-1324-blue?style=flat-square)](data/exercises.json)
[![Languages](https://img.shields.io/badge/Languages-6-green?style=flat-square)](#-overview)
Expand Down Expand Up @@ -31,7 +31,7 @@ The associated **media (images & animation GIFs) is _not_ included** in this rep

**Added in this repository** on top of the base data:

- 🇪🇸 Spanish, 🇮🇹 Italian, 🇹🇷 Turkish, 🇷🇺 Russian, and 🇨🇳 Chinese translations of the instructions
- 🇪🇸 Spanish, 🇮🇹 Italian, 🇹🇷 Turkish, 🇷🇺 Russian, 🇨🇳 Chinese, and 🇻🇳 Vietnamese translations of the instructions
- the interactive browser (`index.html`) and developer setup guide (`setup.html`)
- formatting and cleanup

Expand Down Expand Up @@ -73,7 +73,7 @@ Each exercise entry contains:
| Muscle Group | Supporting / synergist muscles |
| Equipment | Equipment required (or `body weight` for bodyweight) |
| Instructions | Step-by-step instructions for each exercise |
| Available Languages | 🇬🇧 English · 🇪🇸 Spanish · 🇮🇹 Italian · 🇹🇷 Turkish · 🇷🇺 Russian · 🇨🇳 Chinese |
| Available Languages | 🇬🇧 English · 🇪🇸 Spanish · 🇮🇹 Italian · 🇹🇷 Turkish · 🇷🇺 Russian · 🇨🇳 Chinese · 🇻🇳 Vietnamese |
| Media ID | Reference id of the original ExerciseDB media (the media itself is **not** bundled — see [notice](#-notice--exercise-media-is-not-included)) |

---
Expand All @@ -90,7 +90,7 @@ A fully client-side exercise explorer with:
- Live search across all 1,324 exercises
- Filter by category, equipment, and target muscle
- Infinite scroll grid
- Click any card to see full details and instructions in English, Spanish, Italian, Turkish, Russian, or Chinese
- Click any card to see full details and instructions in English, Spanish, Italian, Turkish, Russian, Chinese, or Vietnamese

### `setup.html` — Developer Setup Guide

Expand Down Expand Up @@ -183,6 +183,7 @@ Each record in `data/exercises.json` follows this structure:
| `instructions.tr` | `string` | Full step-by-step instructions in Turkish |
| `instructions.ru` | `string` | Full step-by-step instructions in Russian |
| `instructions.zh` | `string` | Full step-by-step instructions in Chinese |
| `instructions.vi` | `string` | Full step-by-step instructions in Vietnamese |
| `muscle_group` | `string` | Primary synergist muscle group |
| `secondary_muscles` | `array[string]` | Additional muscles involved |
| `target` | `string` | Primary target muscle (e.g. `"biceps"`, `"pectoralis major"`) |
Expand Down Expand Up @@ -308,6 +309,7 @@ print(ex["instructions"]["it"]) # Italian
print(ex["instructions"]["tr"]) # Turkish
print(ex["instructions"]["ru"]) # Russian
print(ex["instructions"]["zh"]) # Chinese
print(ex["instructions"]["vi"]) # Vietnamese
```

### Python — Load with Pandas
Expand Down Expand Up @@ -356,6 +358,7 @@ console.log(ex.instructions.it); // Italian
console.log(ex.instructions.tr); // Turkish
console.log(ex.instructions.ru); // Russian
console.log(ex.instructions.zh); // Chinese
console.log(ex.instructions.vi); // Vietnamese
```

### TypeScript — Type-safe Usage
Expand All @@ -374,6 +377,7 @@ interface Exercise {
tr: string;
ru: string;
zh: string;
vi: string;
};
muscle_group: string;
secondary_muscles: string[];
Expand Down
Loading