scratch-l10n/scripts/tx-pull-locale-articles.mts

Localization for the Scratch 3.0 components

#!/usr/bin/env tsx
/**
 * @file
 * Script to pull scratch-help translations from transifex and push to FreshDesk.
 */
import { getInputs, saveItem, localizeFolder, debugFolder } from './lib/help-utils.mts'

const args = process.argv.slice(2)
const usage = `
 Pull knowledge base articles from transifexfor debugging translation errors. Usage:
   node tx-pull-locale-articles.js -d locale-code
   NOTE:
   FRESHDESK_TOKEN environment variable needs to be set to a FreshDesk API key with
   access to the Knowledge Base.
   TX_TOKEN environment variable needs to be set with a Transifex API token. See
   the Localization page on the GUI wiki for information about setting up Transifex.
 `
// Fail immediately if the API tokens are not defined, or missing argument
if (!process.env.TX_TOKEN || !process.env.FRESHDESK_TOKEN || args.length === 0) {
  process.stdout.write(usage)
  process.exit(1)
}

let locale = args[0]
let debug = false
if (locale === '-d') {
  debug = true
  locale = args[1]
}
const saveFn = debug ? debugFolder : localizeFolder

const { folders } = await getInputs()
console.log('Processing articles pulled from Transifex')
await Promise.all(folders.map(item => saveItem(item, [locale], saveFn)))