Edit Scripture After it is Aligned

[pjoakes]

Overview

This document provides a couple ways to edit a Scripture translation after it has been aligned, keeping the master copy on DCS up to date. This follows the general procedure outlined in Protected Branch Workflow - Door43 - Door43 Forum but provides a specific workflow for editing the text in translationCore.

Using A Web Browser

1. Go to the master repository for the translation, for English that would be either ULT or the UST.
2. Click the “Download this repository” button:
3. Select ZIP and save the file somewhere on your computer.
4. Unzip the file on your computer.
5. In tC, click the floating action button in the bottom right on the Projects screen and select “Import Local Project”:
6. Find and select the USFM file from your downloaded bundle that you want to edit.
7. Make your edits in tC as needed.
8. Fix the broken alignments caused by your edits.
9. Export the file from tC, on the Projects screen click on the three dot menu on the project’s card and select “Export to USFM”:
10. Select USFM 3 in the Alert box and click Export:
    
11. Save the file somewhere on your computer.
12. Open up your web browser and navigate back to the master repository (for English that would be either ULT or the UST).
13. Click on the “Upload file” button:
14. Either drag and drop or click the area with the blue dashed line to browse and select the USFM3 file that you exported in steps 10-11:
    
15. Enter in a short description of your edits where it says “Upload files to”
16. Enter in a short name for the branch you will be creating where it says “New branch name…”
17. Click “Commit Changes”

Now, follow the steps in Protected Branch Workflow - Door43 - Door43 Forum beginning at “Create a Pull Request”.

Using Git

1. Go to the master repository for the translation, for English that would be either ULT or the UST.
2. Copy the HTTPS or SSH URL and clone the repository to your computer.
3. In tC, click the floating action button in the bottom right on the Projects screen and select “Import Local Project”:
4. Find and select the USFM file from your local copy of the repository that you want to edit.
5. Make your edits in tC as needed.
6. Fix the broken alignments caused by your edits.
7. Export the file from tC, on the Projects screen click on the three dot menu on the project’s card and select “Export to USFM”:
8. Select USFM 3 in the Alert box and click Export:
   
9. Overwrite the file in your local copy of the repository.
10. Create a new branch in your local repository
11. Commit your changes and push them to the DCS server.

Now, follow the steps in Protected Branch Workflow - Door43 - Door43 Forum beginning at “Create a Pull Request”.