Initial Translations for Chinese and Spanis

Author: DBojsen

README.md

@@ -50,12 +50,13 @@ swa start _site
 | `--serve` | Build and serve locally (English only, for development) |
 | `--skip-gen` | Skip running gen_redirects.py (use existing configs) |
 | `--no-api-copy` | Skip copying API docs to localized sites |
+| `--sync` | Sync English fallback for missing/outdated translations (for local dev) |
 
 ## What the Build Script Does
 
 1. **Generates DocFX configurations** - Runs `gen_redirects.py` to create `docfx.json` for each language
 2. **Generates language manifest** - Creates `metadata/languages.json` for runtime language switching
-3. **Syncs content** - Copies English source content; uses English as fallback for missing translations. Readds the english file if the file is modified in content or deleted in translation.
+3. **Syncs content** - Copies English source to `localizedContent/en/`. For other languages, only shared directories (assets, api) are synced by default since Crowdin manages translations. Use `--sync` to enable full English fallback for missing/outdated translations (useful for local development).
 4. **Builds documentation** - Runs DocFX for each requested language
 5. **Fixes API docs** - Patches xref links in generated API documentation
 6. **Copies API docs** - Shares English API docs with localized sites
@@ -101,7 +102,20 @@ TEDoc/
 4. Add a translated `_ui-strings.json` to the content subdirectory (see [Translating UI Strings](#translating-ui-strings) below). If no translation is provided, an automatic fallback will be generated.
 5. Run `python build-docs.py --all` to generate configs and build. Language will be added dynamically to language picker.
 
-> **Note:** English content from `content/` is automatically copied to `localizedContent/en/content/` during build. For other languages, English content is used as fallback for missing translations. This includes `_ui-strings.json` — if no translated version exists, English UI strings are used.
+> **Note:** English content from `content/` is automatically copied to `localizedContent/en/content/` during build. For other languages, Crowdin manages translations via PRs. Shared directories (assets, api) are always synced from English. To use English as fallback for missing/outdated translations during local development, add the `--sync` flag.
+
+# Bookmark Links and Translations
+
+When linking to a specific heading within a page (e.g., `#my-heading`), the anchor ID is auto-generated from the heading text. When headings are translated by Crowdin, the anchor changes, breaking bookmark links.
+
+To prevent this, add an `<a name="..."></a>` tag above any heading that is referenced by a bookmark link:
+
+```markdown
+<a name="my-heading"></a>
+## My Heading
+```
+
+Crowdin does not translate HTML `name` attributes, so the anchor remains stable across all languages. Only add these to headings that are actually linked to — there is no need to add them to every heading.
 
 # Translating UI Strings
 
@@ -137,4 +151,18 @@ If a key is missing from a language's file, or no `_ui-strings.json` exists at a
 | `footer.privacyPolicy` | `Privacy & Cookie policy` | Footer bottom link |
 | `footer.termsConditions` | `Terms & Conditions` | Footer bottom link |
 | `footer.licenseTerms` | `License terms` | Footer bottom link |
-
+| `appliesTo` | `Applies to: ` | "Applies to" label on article metadata |
+| `availableSince` | `Available since` | Version availability label (e.g., "Available since 3.5.0") |
+| `availableIn` | `Available in` | Version range label (e.g., "Available in 3.5.0–3.8.0") |
+| `inThisArticle` | `In this article` | Sidebar table of contents heading |
+| `searchResultsCount` | `{count} results for "{query}"` | Search results summary |
+| `searchNoResults` | `No results for "{query}"` | No search results message |
+| `tocFilter` | `Filter by title` | TOC filter input placeholder |
+| `nextArticle` | `Next` | Next article navigation |
+| `prevArticle` | `Previous` | Previous article navigation |
+| `themeLight` | `Light` | Theme picker option |
+| `themeDark` | `Dark` | Theme picker option |
+| `themeAuto` | `Auto` | Theme picker option |
+| `changeTheme` | `Change theme` | Theme picker label |
+| `copy` | `Copy` | Code block copy button |
+| `downloadPdf` | `Download PDF` | PDF download button |

build-docs.py

@@ -69,35 +69,44 @@ def get_available_languages() -> list[str]:
     ])
 
 
-def prepare_localized_content(lang: str) -> int:
+def prepare_localized_content(lang: str, sync: bool = False) -> int:
     """Run sync-localized-content.py for a language.
-    
-    For English: copies all source content
-    For other languages: syncs with translation tracking, 
-                         falls back to English for outdated/missing files
+
+    For English: always copies all source content (required for docfx)
+    For other languages:
+        sync=True:  full English fallback sync (hash comparison, copy missing/outdated)
+        sync=False: only sync shared directories (assets, api) — Crowdin manages translations
     """
     if lang == "en":
-        description = "Syncing English content from source"
+        # English always needs full sync
+        return run_command(
+            [sys.executable, "build_scripts/sync-localized-content.py", "--sync", "en"],
+            "Syncing English content from source"
+        )
+
+    if sync:
+        return run_command(
+            [sys.executable, "build_scripts/sync-localized-content.py", "--sync", lang],
+            f"Syncing {lang} content (fallback to English for outdated)"
+        )
     else:
-        description = f"Syncing {lang} content (fallback to English for outdated)"
-    
-    return run_command(
-        [sys.executable, "build_scripts/sync-localized-content.py", "--sync", lang],
-        description
-    )
+        return run_command(
+            [sys.executable, "build_scripts/sync-localized-content.py", "--shared-only", lang],
+            f"Syncing shared directories for {lang}"
+        )
 
 
-def build_language(lang: str) -> int:
+def build_language(lang: str, sync: bool = False) -> int:
     """Build documentation for a specific language."""
     config_path = f"localizedContent/{lang}/docfx.json"
-    
+
     if not os.path.exists(config_path):
         print(f"Error: Config file not found: {config_path}")
         print("Run 'python gen_redirects.py' first to generate configs.")
         return 1
-    
+
     # Prepare content (copy from source for en, or fallbacks for other langs)
-    result = prepare_localized_content(lang)
+    result = prepare_localized_content(lang, sync=sync)
     if result != 0:
         return result
 
@@ -213,6 +222,7 @@ def main() -> int:
     parser.add_argument("--serve", action="store_true", help="Build English and serve locally")
     parser.add_argument("--skip-gen", action="store_true", help="Skip gen_redirects.py")
     parser.add_argument("--no-api-copy", action="store_true", help="Skip copying API docs")
+    parser.add_argument("--sync", action="store_true", help="Sync English fallback for missing/outdated translations (for local dev)")
 
     args = parser.parse_args()
 
@@ -247,7 +257,7 @@ def main() -> int:
 
     if args.serve:
         # Build English only and serve
-        result = build_language("en")
+        result = build_language("en", sync=True)
         if result != 0:
             return result
 
@@ -286,7 +296,7 @@ def main() -> int:
 
     # Build all requested languages
     for lang in build_langs:
-        result = build_language(lang)
+        result = build_language(lang, sync=args.sync)
         if result != 0:
             return result
 

build_scripts/sync-localized-content.py

@@ -15,6 +15,7 @@
     python sync-localized-content.py --status              # Show all languages
     python sync-localized-content.py --status es           # Show Spanish details
     python sync-localized-content.py --sync es             # Sync Spanish content
+    python sync-localized-content.py --shared-only es      # Sync only shared dirs (assets, api)
     python sync-localized-content.py --init es             # Initialize tracking
     python sync-localized-content.py --mark-translated es  # Mark all as translated
     python sync-localized-content.py --json                # JSON output for CI
@@ -25,7 +26,6 @@
 import os
 import shutil
 import sys
-from datetime import datetime, timezone
 from pathlib import Path
 from typing import Any
 
@@ -56,7 +56,6 @@ def load_translation_status(lang: str) -> dict[str, Any]:
     if not status_path.exists():
         return {
             "language": lang,
-            "lastSync": None,
             "sourceBaseline": str(CONTENT_DIR),
             "files": {},
             "summary": {
@@ -77,9 +76,6 @@ def save_translation_status(lang: str, status: dict[str, Any]) -> None:
     status_path = LOCALIZED_DIR / lang / STATUS_FILENAME
     status_path.parent.mkdir(parents=True, exist_ok=True)
 
-    # Update timestamp
-    status["lastSync"] = datetime.now(timezone.utc).isoformat()
-    
     # Recalculate summary
     files = status.get("files", {})
     translated = sum(1 for f in files.values() if f.get("status") == STATUS_TRANSLATED)
@@ -156,27 +152,21 @@ def check_translation_status(lang: str, source_files: dict[str, str]) -> dict[st
             new_files[rel_path] = {
                 "sourceHash": source_hash,
                 "status": STATUS_UNTRANSLATED,
-                "lastChecked": datetime.now(timezone.utc).isoformat()
             }
         else:
             stored_hash = file_info.get("sourceHash", "")
-            
+
             if stored_hash == source_hash:
                 # Source hasn't changed, translation is current
                 new_files[rel_path] = {
                     "sourceHash": source_hash,
                     "status": STATUS_TRANSLATED,
-                    "lastChecked": datetime.now(timezone.utc).isoformat(),
-                    "translatedAt": file_info.get("translatedAt", datetime.now(timezone.utc).isoformat())
                 }
             else:
                 # Source changed since translation was made
                 new_files[rel_path] = {
                     "sourceHash": source_hash,
                     "status": STATUS_OUTDATED,
-                    "previousHash": stored_hash,
-                    "lastChecked": datetime.now(timezone.utc).isoformat(),
-                    "translatedAt": file_info.get("translatedAt")
                 }
 
     status["files"] = new_files
@@ -208,7 +198,6 @@ def sync_language(lang: str, source_files: dict[str, str], dry_run: bool = False
                 shutil.copy2(source_file, dest_file)
                 # Update status to untranslated (since we replaced with English)
                 file_info["status"] = STATUS_UNTRANSLATED
-                file_info["replacedAt"] = datetime.now(timezone.utc).isoformat()
             counts["replaced"] += 1
             print(f"  Replaced (outdated): {rel_path}")
         elif file_status == STATUS_UNTRANSLATED:
@@ -289,6 +278,31 @@ def sync_english(dry_run: bool = False) -> dict[str, int]:
     return counts
 
 
+def sync_shared_only(lang: str, dry_run: bool = False) -> dict[str, int]:
+    """Sync only shared directories (assets, api) for a language.
+
+    Used when full translation sync is disabled (Crowdin manages translations).
+    Skips hash comparison and translation status tracking.
+    """
+    localized_content_dir = LOCALIZED_DIR / lang / "content"
+    counts = {"synced_dirs": 0}
+
+    if not dry_run:
+        localized_content_dir.mkdir(parents=True, exist_ok=True)
+
+    for dir_name in get_shared_directories():
+        src = CONTENT_DIR / dir_name
+        dest = localized_content_dir / dir_name
+        if src.exists() and not dry_run:
+            if dest.exists():
+                shutil.rmtree(dest)
+            shutil.copytree(src, dest)
+            print(f"  Synced shared: {dir_name}/")
+            counts["synced_dirs"] += 1
+
+    return counts
+
+
 def init_language(lang: str, source_files: dict[str, str]) -> None:
     """Initialize translation tracking for an existing language.
     
@@ -302,7 +316,6 @@ def init_language(lang: str, source_files: dict[str, str]) -> None:
 
     status = {
         "language": lang,
-        "lastSync": datetime.now(timezone.utc).isoformat(),
         "sourceBaseline": str(CONTENT_DIR),
         "files": {}
     }
@@ -315,15 +328,12 @@ def init_language(lang: str, source_files: dict[str, str]) -> None:
             status["files"][rel_path] = {
                 "sourceHash": source_hash,
                 "status": STATUS_TRANSLATED,
-                "lastChecked": datetime.now(timezone.utc).isoformat(),
-                "translatedAt": datetime.now(timezone.utc).isoformat()
             }
         else:
             # File missing - mark as untranslated
             status["files"][rel_path] = {
                 "sourceHash": source_hash,
                 "status": STATUS_UNTRANSLATED,
-                "lastChecked": datetime.now(timezone.utc).isoformat()
             }
 
     save_translation_status(lang, status)
@@ -340,20 +350,17 @@ def mark_translated(lang: str, file_paths: list[str] | None, source_files: dict[
     If file_paths is None, marks all files in the language.
     """
     status = load_translation_status(lang)
-    now = datetime.now(timezone.utc).isoformat()
-    
+
     if file_paths is None:
         # Mark all files
         file_paths = list(source_files.keys())
-    
+
     updated = 0
     for rel_path in file_paths:
         if rel_path in source_files:
             status["files"][rel_path] = {
                 "sourceHash": source_files[rel_path],
                 "status": STATUS_TRANSLATED,
-                "lastChecked": now,
-                "translatedAt": now
             }
             updated += 1
 
@@ -457,6 +464,11 @@ def main() -> int:
         metavar="LANG",
         help="Sync content for a language (use 'en' for English)"
     )
+    parser.add_argument(
+        "--shared-only",
+        metavar="LANG",
+        help="Sync only shared directories (assets, api) for a language"
+    )
     parser.add_argument(
         "--init",
         metavar="LANG",
@@ -484,10 +496,18 @@ def main() -> int:
     )
 
     args = parser.parse_args()
-    
+
+    # --shared-only doesn't need source file hashes, handle it early
+    if args.shared_only:
+        lang = args.shared_only
+        print(f"Syncing shared directories for '{lang}'...")
+        counts = sync_shared_only(lang, args.dry_run)
+        print(f"\nShared sync complete: {counts['synced_dirs']} directory(ies) synced")
+        return 0
+
     # Get source files (needed for most operations)
     source_files = get_source_files()
-    
+
     if args.status:
         if args.status == "__all__":
             print_status_summary(args.json)
@@ -498,7 +518,7 @@ def main() -> int:
     if args.sync:
         lang = args.sync
         print(f"Syncing content for '{lang}'...")
-        
+
         if lang == "en":
             counts = sync_english(args.dry_run)
             print(f"\nEnglish sync complete: {counts['copied']} files copied")
@@ -509,7 +529,7 @@ def main() -> int:
             print(f"  Replaced (outdated->English): {counts['replaced']}")
             print(f"  Copied (new->English): {counts['copied']}")
         return 0
-    
+
     if args.init:
         init_language(args.init, source_files)
         return 0

content/_ui-strings.json

@@ -20,5 +20,20 @@
   "footer.technicalSupport": "Technical Support",
   "footer.privacyPolicy": "Privacy & Cookie policy",
   "footer.termsConditions": "Terms & Conditions",
-  "footer.licenseTerms": "License terms"
+  "footer.licenseTerms": "License terms",
+  "appliesTo": "Applies to: ",
+  "availableSince": "Available since",
+  "availableIn": "Available in",
+  "inThisArticle": "In this article",
+  "searchResultsCount": "{count} results for \"{query}\"",
+  "searchNoResults": "No results for \"{query}\"",
+  "tocFilter": "Filter by title",
+  "nextArticle": "Next",
+  "prevArticle": "Previous",
+  "themeLight": "Light",
+  "themeDark": "Dark",
+  "themeAuto": "Auto",
+  "changeTheme": "Change theme",
+  "copy": "Copy",
+  "downloadPdf": "Download PDF"
 }

content/features/code-actions.md

@@ -74,6 +74,7 @@ In the screenshot below, for example, the **Prefix variable with '_'** action ca
 
 ![Code Action All Occurrences](~/content/assets/images/features/code-action-all-occurrences.png)
 
+<a name="list-of-code-actions"></a>
 ## List of Code Actions
 
 The table below lists all currently available Code Actions. You can toggle off Code Actions in the **Tools > Preferences** dialog under **Text Editors > DAX Editor > Code Actions** (a future update will let you toggle individual actions for a more customized experience). Some Code Actions also have additional configuration options, such as which prefix to use for variable names.

content/features/csharp-scripts.md

@@ -282,6 +282,7 @@ In addition, the following .NET Framework assemblies are loaded by default:
 - TabularEditor.Exe
 - Microsoft.AnalysisServices.Tabular.Dll
 
+<a name="accessing-environment-variables"></a>
 ## Accessing Environment Variables
 
 When running C# scripts via the Tabular Editor CLI (especially in CI/CD pipelines), you can pass parameters to your scripts using environment variables. This is the recommended approach, as C# scripts executed by Tabular Editor CLI don't support traditional command-line arguments.
@@ -362,6 +363,7 @@ foreach(var table in Model.Tables)
 Info($"Configured model for {environment} environment");
 ```
 
+<a name="compatibility"></a>
 ## Compatibility
 
 The scripting APIs for Tabular Editor 2 and Tabular Editor 3 are mostly compatible, however, there are cases where you want to conditionally compile code depending on which version you're using. For this, you can use preprocessor directives, which were introduced in Tabular Editor 3.10.0.