Merge branch 'main' into issue#928

Author: ksen0

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

@@ -371,14 +371,15 @@ class GitHubCommitTracker {
     const englishFile = fileTranslations.englishFile;
     const outdatedLanguages = fileTranslations.outdatedLanguages;
     const missingLanguages = fileTranslations.missingLanguages;
+    const englishCommit = fileTranslations.englishCommit;
 
     let body = `## 🌍 Translation Update Needed
 
 **File**: \`${englishFile}\`
 **Branch**: \`${this.currentBranch}\`
 
 ### 📅 Timeline
-- **Latest English update**: ${fileTranslations.englishCommit.date.toLocaleDateString()} by ${fileTranslations.englishCommit.author}
+- **Latest English update**: ${englishCommit.date.toLocaleDateString()} by ${englishCommit.author}
 
 `;
 
@@ -420,7 +421,7 @@ class GitHubCommitTracker {
 - [ ] Ensure translation is accurate and culturally appropriate
 
 ### 📝 Summary of English File Changes
-**Last commit**: [${fileTranslations.englishCommit.message}](${fileTranslations.englishCommit.url})
+**Last commit**: [${englishCommit.message}](${englishCommit.url})
 
 ${outdatedLanguages.length > 0 || missingLanguages.length > 0 ? `**Change Type**: English file was updated. ${outdatedLanguages.length > 0 ? `${outdatedLanguages.map(l => this.getLanguageDisplayName(l.language)).join(', ')} translation${outdatedLanguages.length > 1 ? 's' : ''} may be outdated.` : ''} ${missingLanguages.length > 0 ? `${missingLanguages.map(l => this.getLanguageDisplayName(l.language)).join(', ')} translation${missingLanguages.length > 1 ? 's are' : ' is'} missing.` : ''}` : ''}
 
@@ -543,12 +544,22 @@ async function checkTranslationStatus(changedFiles, githubTracker = null, create
   const fileTranslationMap = translationStatus.fileTranslationMap;
 
   for (const englishFile of changedFiles) {
+    
+    let englishCommit = null;
+    if (githubTracker) {
+      englishCommit = await githubTracker.getLastCommit(englishFile);
+      if (!englishCommit) {
+        console.log(`⚠️ Skipping ${englishFile} - could not retrieve commit data`);
+        continue; 
+      }
+    }
+
     const fileTranslations = {
       englishFile,
       outdatedLanguages: [],
       missingLanguages: [],
       upToDateLanguages: [],
-      englishCommit: null
+      englishCommit
     };
 
     for (const language of SUPPORTED_LANGUAGES) {
@@ -569,17 +580,8 @@ async function checkTranslationStatus(changedFiles, githubTracker = null, create
 
 
       if (githubTracker) {
-        // Get English commit only once per file
-        if (!fileTranslations.englishCommit) {
-          fileTranslations.englishCommit = await githubTracker.getLastCommit(englishFile);
-        }
-        const englishCommit = fileTranslations.englishCommit;
         const translationCommit = await githubTracker.getLastCommit(translationPath);
 
-        if (!englishCommit) {
-          continue;
-        }
-
         if (!translationCommit) {
           const missingItem = {
             englishFile,

.github/workflows/translation-sync.yml

@@ -8,6 +8,11 @@ on:
       - 'src/content/tutorials/en/**'
   workflow_dispatch:
 
+permissions:
+  contents: read
+  issues: write
+  pull-requests: read
+
 jobs:
   track-translation-changes:
     runs-on: ubuntu-latest

astro.config.mjs

@@ -20,6 +20,9 @@ if (shouldSkipCompress) {
 export default defineConfig({
   site: 'https://p5js.org',
   compressHTML: false,
+  legacy: {
+    collections: true
+  },
   integrations: [
     mermaid({autoTheme: true}),
     preact({
@@ -78,7 +81,7 @@ export default defineConfig({
   },
   markdown: {
     shikiConfig: {
-      theme: 'github-light',
+      theme: 'github-light-high-contrast',
     },
   },
 });

docs/localization_hi.md

@@ -0,0 +1,123 @@
+# Hindi (हिन्दी) Localization Guide
+
+This document contains the standardized Hindi translations for technical and p5.js-specific terms used across the p5.js website. Translators should refer to this glossary to maintain consistency.
+
+For the general localization architecture, see [localization.md](./localization.md).
+
+## Programming-Specific Terms
+
+| English | Hindi (हिन्दी) |
+| --- | --- |
+| array | सरणी |
+| asynchronous | अतुल्यकालिक |
+| attribute | गुण |
+| blob tracking | बूँद ट्रैकिंग |
+| boolean | बूलियन |
+| byte | बाइट |
+| callback | कॉलबैक |
+| camera frustrum | कैमरा दृष्टिकोण |
+| changelog | परिवर्तन लॉग |
+| class | क्लास |
+| code editor | कोड संपादक |
+| color space | रंग स्थान |
+| command line | कमांड लाइन |
+| comment | टिप्पणी |
+| compile | संकलन |
+| component | अवयव |
+| conditionals | शर्तें |
+| console | कंसोल |
+| constant | स्थिरांक |
+| constructor function | कंस्ट्रक्टर फ़ंक्शन |
+| control statement | नियंत्रण कथन |
+| coordinate | निर्देशांक |
+| curly brace | घुंघराले कोष्ठक |
+| debug | डीबग |
+| default value | डिफ़ॉल्ट मान |
+| deprecated | पदावनत |
+| depth | गहराई |
+| error | गलती |
+| event | आयोजन |
+| fields | फील्ड |
+| file | दस्तावेज़ |
+| floating-point number | चल बिन्दु संख्या |
+| framework | रूपरेखा |
+| function | कार्य |
+| functional programming | कार्यात्मक कार्यरचना |
+| HTML | एचटीएमएल |
+| HTML tag | एचटीएमएल टैग |
+| indent | मांगपत्र |
+| index | अनुक्रमणिका |
+| iteration | पुनरावर्तन |
+| matrix | आव्यूह |
+| minify | छोटा करना |
+| modelview | मॉडलव्यू |
+| motion detection | गति का पता लगाना |
+| noise | शोर |
+| object | ऑब्जेक्ट |
+| object oriented programming | ऑब्जेक्ट ओरिएंटेड प्रोग्रामिंग |
+| operator | ऑपरेटर |
+| optimize | अनुकूलन |
+| optional argument | वैकल्पिक तर्क |
+| parameter/argument | पैरामीटर/तर्क |
+| parentheses | कोष्टक |
+| pixel | पिक्सेल |
+| programming library | प्रोग्रामिंग (कंप्यूटिंग) लाइब्रेरी |
+| radian | कांति |
+| raster | रेखापुंज |
+| recursion | प्रत्यावर्तन |
+| reference/documentation | संदर्भ/दस्तावेज़ीकरण |
+| render/rendering | प्रस्तुत करना/प्रतिपादन करना |
+| repository | कोष |
+| return | वापसी विवरण |
+| scope | दायरा |
+| screen | पर्दा |
+| server | सर्वर |
+| source code | स्रोत कोड |
+| square bracket | वर्गाकार ब्रैकेट |
+| string | स्ट्रिंग |
+| stylesheet | शैली पत्रक |
+| subclass | सब-क्लास |
+| superclass | सुपर-क्लास |
+| syntax | वाक्य - विन्यास |
+| test driven development | परीक्षण संचालित विकास |
+| transform | परिवर्तन |
+| unit testing | इकाई का परीक्षण |
+| variable | चर |
+| vector | वेक्टर |
+| vertex | शिखर |
+| video | वीडियो |
+
+## p5.js-Specific Terms
+
+| English | Hindi (हिन्दी) |
+| --- | --- |
+| access | पहुँच |
+| accessibility | उपलब्धता |
+| addon library | ऐडऑन लाइब्रेरी |
+| audio | आवाज़ |
+| bezier | बेइजेर |
+| brightness | चमक |
+| button | बटन |
+| canvas | कैनवास |
+| coding | कोडिंग (संकेतीकरण) |
+| community | समुदाय |
+| creative coding | रचनात्मक कोडिंग |
+| emulation | अनुकरण |
+| frame | फ्रेम |
+| gradient (color) | ग्रेडियेंट |
+| gradient (math) | क्रमिक |
+| graphics buffer | ग्राफ़िक्स बफ़र |
+| hue | रंग |
+| image | छवि |
+| input | इनपुट |
+| instance mode | उदाहरण मोड |
+| linear interpolation | रेखिक आंतरिक |
+| port | पोर्ट |
+| project | प्रोजैक्ट |
+| saturation | संतृप्ति |
+| sketch | स्केच |
+| sketchbook | स्केचबुक |
+| sound | आवाज़ |
+| stroke (outline) | रूपरेखा |
+| video | वीडियो |
+| webcam | वेबकैम |

docs/technical_overview.md

@@ -35,7 +35,8 @@ The website code is divided into a few main folders:
 - `src/content/` this is where almost all content authoring happens in the repo. These files contain the content that is used to generate the website.
 - `src/components/` holds UI elements that are rendered on different pages of the website. Things like basic buttons, as well as more specialized things like the top navigation menus are here.
 - `src/layouts/` this contains the basic visual structure of each page. If you are looking to edit a specific page of the website, finding the layout for it in this folder is a great place to start.
-- `src/pages/` these files are primarily used to create the routes (the different URLs) for the pages of the website and pull content from `src/content/`. Note that every route basically exists twice: once in `src/pages/` and again in `src/[locale]/pages/` to support localized urls. Read more about this in [./localization-architecture.md]
+
+- `src/pages/` these files are primarily used to create the routes (the different URLs) for the pages of the website and pull content from `src/content/`. Note that every route basically exists twice: once in `src/pages/` and again in `src/pages/[locale]/` to support localized urls. Read more about this in `[./localization.md]`
 - `src/api/` holds the logic for fetching information from the OpenProcessing API, where all the gallery sketches for this website are stored
 - `src/i18n/` holds the utilities and configuration for working with translations
 - `src/scripts/` contains utility scripts that update the files in `src/content/` with changes in the p5.js repo