[GSOC 2025]: Github action for translation tracker #895

Divyansh013 · 2025-07-06T18:53:54Z

test-local file detects local changes
index.js does manual triggering for issue creation
action works on all "push" events
outdated banner addition on missing translation pages

…sting

- Updated translation-sync workflow for examples instead of reference - Added Week 3 test change to Shape Primitives description - Should trigger automated issue creation for outdated translations

- Added workflow_dispatch with scan_all and create_issues options - Can now manually trigger action from GitHub UI - Supports both normal and full-scan modes

- Modified description.mdx to test translation tracker - Should now detect 1 English example file change

- test-local.js: Only shows changed files from predefined test files - index.js: Production mode with minimal console output - Removed verbose logging and repository exploration - Clear distinction: test mode vs production mode with GitHub token

- SCAN_ALL=true environment variable to check all 61 example files - Simplified GitHub Actions workflow - Default: checks only changed files - Manual trigger: option to scan all files

ksen0 · 2025-07-15T07:44:18Z

Hi @Divyansh013 , this is looking great!

Based on checking the current issue created by this (Divyansh013#11) I have a couple of minor suggestions:

Move 🔍 Compare changes to the Quick Links section, because it's not file-specific.
Potentially: next to this one link to "Compare changes", could add a note like: ℹ️ You can see the changes in a specific file by going the the "Compare changes" link above, clicking on the "Files changed" tab, and navigating to the specific file.
Move "Change Type: English file was updated. Spanish (Español), Hindi (हिन्दी), Korean (한국어), Chinese Simplified (简体中文) translations may be outdated." into the Timeline - right now this is very far separated, but seems related?

lirenjie95 · 2025-07-17T02:05:23Z

.github/actions/translation-tracker/index.js

+      ? 'git diff --name-only HEAD~1 HEAD'
+      : 'git diff --name-only HEAD~1 HEAD';


Two options are actually the same. Maybe typo here?

indeed. What was originally intended here:

'git diff --name-only origin/main...HEAD' // Compare with base branch for PRs : 'git diff --name-only HEAD~1 HEAD'; // and with last commir for pushes

thoughts about this?

lirenjie95 · 2025-07-17T02:09:36Z

.github/actions/translation-tracker/index.js

+
+      return null;
+    } catch (error) {
+      // Fallback to main branch if current branch fails


I'm wondering what will happen if the main branch also fails?

in that case we can log out the error ? or is there something I am missing out?

lirenjie95 · 2025-07-17T02:10:34Z

.github/actions/translation-tracker/index.js

+  try {
+    return fs.statSync(filePath).mtime;
+  } catch (error) {
+    return null;


Add log here might be helpful for debugging.

lirenjie95 · 2025-07-17T02:14:06Z

.github/actions/translation-tracker/index.js

+   * Format the issue body with helpful information
+   */
+  formatIssueBody(englishFile, language, commitInfo) {
+    const translationPath = englishFile.replace('/en/', `/${language}/`);


If the directory structure changes or there are multiple occurrences of ·/en/· in the path (correct me if there are any situations that I didn't catch), this could lead to errors or unintended behavior.

Divyansh013 · 2025-08-18T05:11:24Z

@ksen0 requesting your review here

lirenjie95 · 2025-08-18T08:41:47Z

src/components/OutdatedTranslationBanner/index.astro

+  'zh-Hans': {
+    title: '此翻译可能已过期',
+    message: '与英文版本相比，此页面不是最新的。',
+    viewEnglish: '查看英文页面',
+    contribute: '参与翻译',
+  },


The Chinese translation here is pretty good. I will take a look of the remaining GitHub Actions related stuff when I have time.

ksen0 · 2025-08-19T20:06:21Z

.github/actions/translation-tracker/README.md

@@ -0,0 +1,266 @@
+# p5.js Translation Tracker
+
+A comprehensive GitHub Action and command-line tool to track translation status across multiple languages in the p5.js website examples.


(Edited - see below)

Actually, if this is for GSoC documentation, please feel free to keep the log, but maybe at the top of the file have a very short README of the tool? Just keeping separate the description of the action (for future maintenance) and the GSoC documentation would be great. For example, I think a good place to start this readme is to describe the overall flow, the format of the translation-status files, how they are produced/used.. The log you can of course keep as you have, it's just important to also have the summary for the tool over all 🙏

ksen0 · 2025-08-19T20:07:23Z

.github/actions/translation-tracker/README.md

+### ✅ Week 1 Features (File-based tracking)
+- Git-based change detection for English example files
+- File modification time comparison
+- Support for all languages: Spanish (es), Hindi (hi), Korean (ko), Chinese Simplified (zh-Hans)


Minor: a shorter README is easier to maintain, so please remove the duplicated info. (The supported languages are listed below already in a very readable format)

ksen0 · 2025-08-19T20:08:43Z

.github/actions/translation-tracker/README.md

+
+### ✅ Week 3 Features (Multi-language & refinement)
+- **Single issue per file**: Creates one issue covering all affected languages instead of separate issues per language
+- **Enhanced labeling**: Uses "needs translation" base label + specific language labels (e.g., "lang-es", "lang-ko")


(Edited - see above - mainly a very practical intro would be great in this README)

ksen0 · 2025-08-19T20:10:19Z

.github/actions/translation-tracker/README.md

+
+```javascript
+{
+  enableWeek2: boolean,      // Force Week 2 mode


That seems probably not applicable anymore

ksen0 · 2025-08-19T20:20:26Z

src/components/OutdatedTranslationBanner/index.astro

+    contribute: 'Contribuir a la traducción',
+  },
+  'ko': {
+    title: '이 번역은 오래되었을 수 있습니다',


Hi @hana-cho! When you have time, another set of Korean translations for your review. Thanks so much!

ksen0 · 2025-08-19T20:21:04Z

src/components/OutdatedTranslationBanner/index.astro

+    contribute: 'अनुवाद में योगदान दें',
+  },
+  'es': {
+    title: 'Esta traducción podría estar desactualizada',


Hi @marioguzzzman! If/when you have time, could you check these Spanish translations please? Thanks so much!

lirenjie95 · 2025-08-21T09:38:07Z

src/layouts/ExampleLayout.astro

+let englishUrl = Astro.url.pathname;
+if (currentLocale !== 'en') {
+  // Replace /{locale}/ with / to get English URL
+  englishUrl = englishUrl.replace(`/${currentLocale}/`, '/');


Question here: have you tried using zh-Hans? It is a different use case from es, hi and ko. I’m wondering if the replace operation will succeed.
PS: Please check all places with currentLocale and replace()

Yes have checked zh-Hans and it is working in expected way. I will check in all places

Divyansh013 added 17 commits June 10, 2025 01:03

Test: Add documentation line to circle.mdx for translation tracker te…

46edaf0

…sting

Add Week 1 translation tracker implementation

ba9b4ee

Test: Modify triangle.mdx for translation testing

cd94f24

Test: Modify accelerationX.mdx to test missing translation detection

ddebbf3

removed testing logs

1e13287

small fix

875a77c

post review changes

5170eb6

Week 2: Translation tracker with GitHub API and Hindi focus

56abeec

Test: Update English example for translation tracker testing

d9c98c6

Fix: Add automatic branch detection to translation tracker

1976d9d

week 2 complete

71e7049

Week 3: Test automated translation tracking

94159c8

- Updated translation-sync workflow for examples instead of reference - Added Week 3 test change to Shape Primitives description - Should trigger automated issue creation for outdated translations

Add manual trigger support to translation tracker workflow

f03b60d

- Added workflow_dispatch with scan_all and create_issues options - Can now manually trigger action from GitHub UI - Supports both normal and full-scan modes

Test: Manual trigger detection test

dea5e7c

- Modified description.mdx to test translation tracker - Should now detect 1 English example file change

Add scan all files option to index.js

63753de

- SCAN_ALL=true environment variable to check all 61 example files - Simplified GitHub Actions workflow - Default: checks only changed files - Manual trigger: option to scan all files

final fix

9f63c9d

lirenjie95 reviewed Jul 17, 2025

View reviewed changes

Divyansh013 added 2 commits August 11, 2025 21:35

temp commit

8de0a67

basic version complete

18bd739

Divyansh013 marked this pull request as ready for review August 18, 2025 05:10

Divyansh013 changed the title ~~Basic functionality of translation tracker~~ [GSOC 2025]: Github actions for translation tracker Aug 18, 2025

Divyansh013 changed the title ~~[GSOC 2025]: Github actions for translation tracker~~ [GSOC 2025]: Github action for translation tracker Aug 18, 2025

lirenjie95 reviewed Aug 18, 2025

View reviewed changes

ksen0 reviewed Aug 19, 2025

View reviewed changes

lirenjie95 reviewed Aug 21, 2025

View reviewed changes

readme updated and simplified scanning

7fb683c

Divyansh013 requested a review from ksen0 August 21, 2025 16:37

		? 'git diff --name-only HEAD~1 HEAD'
		: 'git diff --name-only HEAD~1 HEAD';

		@@ -0,0 +1,266 @@
		# p5.js Translation Tracker

		A comprehensive GitHub Action and command-line tool to track translation status across multiple languages in the p5.js website examples.

[GSOC 2025]: Github action for translation tracker #895

Are you sure you want to change the base?

[GSOC 2025]: Github action for translation tracker #895

Uh oh!

Conversation

Divyansh013 commented Jul 6, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

ksen0 commented Jul 15, 2025

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Divyansh013 Jul 20, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Divyansh013 commented Aug 18, 2025

Uh oh!

Choose a reason for hiding this comment

Uh oh!

ksen0 Aug 19, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

ksen0 Aug 19, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Divyansh013 commented Jul 6, 2025 •

edited

Loading

Divyansh013 Jul 20, 2025 •

edited

Loading

ksen0 Aug 19, 2025 •

edited

Loading

ksen0 Aug 19, 2025 •

edited

Loading