Skip to content

TRANSLATION.md

Latest commit

 

History

History
112 lines (63 loc) · 3.06 KB

TRANSLATION.md

File metadata and controls

112 lines (63 loc) · 3.06 KB

Translation Workflow

How to translate user-guide content.

Setup - one-time

https://github.com/SuperOfficeDocs/superoffice-docs.git

VSCode Clone Repo

  • Choose target folder to contain superoffice-docs folder. c:\git
  • Files and branches are now cloned locally. When you open the target folder c:\git\superoffice-docs in VSCode, it will automatically connect to Github. It remembers where it came from.

Translation Workflow

  1. Someone at SuperOffice runs the Create-translations-branch flow on Github.

  2. This creates a new branch called Translate-Xxx-date and a ZIP file containing the changed english files.

  3. Go to Actions tab on GitHub to find artifact

    https://github.com/SuperOfficeDocs/superoffice-docs/actions/workflows/build-translations.yml

  4. Click on the run to access the artifacts

GitHub Action runs

  1. Download the changes zip:

Github artifact

  1. Unzip the changes and send them in for translations.

Translations happen.

Time passes...

French, Swedish, etc translations come back.

  1. Open VSCode
  2. Open the target folder C:\git\superoffice-docs

VSCode Folder view

  1. Click the SYNC button in the footer. This ensures that the list of branches is up to date, and contains the translation branch that was created when the ZIP file was generated.

VSCode Sync button in footer

  1. Click the MAIN branch in the footer to switch to the translate_xxx branch.

VSCode Branch footer

  1. Choose the origin/Translate_xxx branch from the list of branches

VSCode Branch list

  1. Wait for the new branch to be copied.

VSCode Branch footer

  1. Click the SYNC button just to make sure everything is up to date.
  2. Drag/Drop to copy the translated files to the corresponding language folders in the target folder:

Explorer Folder view

  1. Go back to VSCode - should now show changed files

VSCode Git Changes

  1. Double check you are on the right branch - check the footer

VSCode Branch Footer

  1. Enter a commit message Oversettelser

  2. Click COMMIT button.

  3. Click SYNC button

VSCode Sync Changes

  1. Open Github

    https://github.com/SuperOfficeDocs/superoffice-docs

  2. Pick the translate branch on GitHub:

GitHub Branch picker

  1. Click the CREATE PR button (should appear automatically):

Github Create PR

  1. Finished!

The changes committed to the branch can now be reviewed and merged back to main.

You can continue to make changes to the branch and push them to Github after you have created the PR.