Tumindak Penerjemah Markdown

Terjemahan README

Tindakan GitHub kanggo nerjemahake MARKDOWN/READMEs menyang basa apa wae

Terjemahake file MARKDOWN menyang macem-macem basa liyane, ndhukung macem-macem file lan subdirektori.

Setup

Tambah file alur kerjamenyang proyek sampeyan (contone..github/workflows/translate-readme.yml):

name: Translate README

on:
  push:
    branches:
      - main
      - master
jobs:
  build:
    runs-on: ubuntu-latest
    permissions:
      contents: write
    steps:
      - uses: actions/checkout@v4
      - name: Setup Node.js
        uses: actions/setup-node@v4
        with:
          node-version: 24.x
      # ISO Language Codes: https://cloud.google.com/translate/docs/languages
      - name: Adding README - Chinese Simplified
        uses: ikhsan3adi/markdown-translator@v3
        with:
          LANG: zh-CN
          FILES: |-
            README.md
            OTHER-README.md
            sub/dir/README.md
            very/deep/sub/directories/FOO.md
            /very/deep/sub/directories/BAR.md
            docs/**/*.md
            notes/*.txt

      - name: Adding README translations
        uses: ikhsan3adi/markdown-translator@v3
        with:
          LANG: |- # multiple languages
            zh-CN
            zh-TW
            ja
          FILES: |-
            README.md
            docs/**/*.md

Dhukungan Glob: FILESnampa pola glob -docs/**/*.mdnerjemahake saben file markdown ing ngisor ikidocs/rekursif tanpa dhaftar mau siji-siji, lannotes/*.txtnuduhake file teks biasa uga. Path nested literal dianggo kanthi cara sing padha:sub/dir/README.mdlanvery/deep/sub/directories/FOO.mdora perlu globbing. Nyampur globs lan jalur harfiah bebas; ngilangi dalan karoIGNORE(contonedocs/external/**). File wis dijenengi kaya<name>.<lang>.<ext>(terjemahan sing wis ana) tansah dilewati.

Ijin nulis dibutuhake:proyek kudu ngumumakepermissions: contents: write(ditampilake ing ndhuwur) utawa push bali menyang repo sampeyan ditolak karo 403. Luwih seneng langkah review? SetPULL_REQUEST: truekanggo push cabang lan mbukak PR tinimbang (perlupermissions: pull-requests: writeugi).

Tambahan kanthi gawan:mung file sing sumber diganti sing diterjemahake maneh, ngirit kuota terjemahan. Owah-owahan dilacak liwat akomentar header ditulis ing saben file terjemahan. Terjemahan sing wis ana tanpa header iki diterjemahake maneh sapisan.

Markdown vs teks biasa:file markdown (.md,.markdown,.mdx,.mdown,.mkd) diterjemahake markdown-aware - rentang kode, pamblokiran pager, frontmatter lan URL tetep ora kena. File liyane (contone..txt) diterjemahake baris kanthi baris, njaga garis kosong lan pungkasan baris.

garpu

⚠️ Ojo lali mlayunpm run buildsadurunge nindakake

Konfigurasi

Pilihan

Sampeyan bisa ngonfigurasi tumindak luwih lanjut kanthi pilihan ing ngisor iki:

LANG: Dhaptar basa sing dipisahake karo baris anyar sing pengin diterjemahake readme sampeyan. Standar kasebut yaiku Cina Sederhana. Basa sing didhukung bisa ditemokake ing ngisor iki. (standar:zh-CN) (dibutuhake:false)
FILES: File sing dipisahake baris anyar kanggo diterjemahake. Ndhukung pola glob (contone.docs/**/*.md) lan jalur nested literal (contone.sub/dir/README.md). File Markdown diterjemahake markdown-aware (kode span, frontmatter, pamblokiran pager lan URL sing ora disentuh); file liyane (contone..txt) diterjemahake baris kanthi baris, njaga garis kosong lan pungkasan baris. (standar:[README.md]) (dibutuhake:false)
IGNORE: Pola glob sing dipisahake baris anyar kanggo ngilangi kapanFILESnggunakake globbing. (standar: ``) (dibutuhake:false)
IGNORE_PATTERN: Pola regex sing dipisahake karo baris anyar. Teks apa wae sing cocog karo pola ora diterjemahake - migunani kanggo kode, output printah utawa tembung sing tepat. (standar: ``) (dibutuhake:false)
COMMIT: Apa arep nindakake terjemahan sing digawe. Setel kanggofalsekanggo dry-run sing mung nulis file terjemahan. (standar:true) (dibutuhake:false)
PUSH: Apa kanggo push commits bali menyang repositori. (standar:true) (dibutuhake:false)
PULL_REQUEST: Push menyang cabang lan mbukak panjalukan narik tinimbang nindakake kanggo cabang saiki. (standar:false) (dibutuhake:false)
INCREMENTAL: Mung nerjemahake maneh file sing sumbere diganti. Hash sumber dilacak ing komentar header file terjemahan, dadi terjemahan sing wis ana bakal dilewati nalika ora diganti - ngirit kuota terjemahan. (standar:true) (dibutuhake:false)

Output

FILES_CREATED: Dhaptar file terjemahan sing dipisahake karo baris anyar sing digawe.

Tuladha: panyuwunan narik tinimbang push langsung

- name: Adding README translations as a PR
  uses: ikhsan3adi/markdown-translator@master
  with:
    LANG: zh-CN
    FILES: README.md
    PULL_REQUEST: true
    PUSH: true

Tuladha: dry-run (tulis file, ora commit/push)

- name: Generate README translations locally
  uses: ikhsan3adi/markdown-translator@master
  with:
    LANG: zh-CN
    FILES: README.md
    COMMIT: false

Conto: glob ing direktori docs

- name: Translate all docs
  uses: ikhsan3adi/markdown-translator@master
  with:
    LANG: ja
    FILES: |-
      README.md
      docs/**/*.md
    IGNORE: |-
      docs/external/**/*.md

Mlaku lokal

npm startnganggo logika sing padha saka terminal lan standar sampeyanCOMMIT/PUSHkanggofalse, dadi mung nulis file terjemahan - ora commit, ora push. Gendéra nggambarake input tumindak (kebab-case), dipisahake dening,:

npm install

# translate README.md to Indonesian, dry-run only
npm start -- --lang id --files README.md

# multiple languages and glob patterns
npm start -- --lang "id,ja" --files "README.md,docs/**/*.md" --ignore "docs/external/**"

# skip text matching a regex
npm start -- --lang zh-CN --files README.md --ignore-pattern "^\|.*\|$"

# translate plain text files too
npm start -- --lang id --files notes.txt

# full local run with commit + push
npm start -- --lang id --files README.md --commit --push

npm start -- --help

Basa sing Didhukung

Basa sing didhukung bisa ditemokake ing kene https://cloud.google.com/translate/docs/languages

Pangembangan

Saran lan kontribusi tansah ditampa!

LISENSI

KARO

FilesExpand file tree

README.jw.md

Latest commit

History