BTT Writer for the Desktop: Importing a Project

BTT Writer for the Desktop

Watch the Video

Importing into BTT Writer

Introduction

The BTT Writer program enables you to import a project from various sources. To import a project:

  1. Navigate to the Home page.
  2. Click on the 3-dot icon at the bottom left of the window.
  3. Select Import from the menu.

There are four options to choose from when importing to BTT Writer.

Import from Server

This requires an Internet connection.

If you are logged into BTT Writer with a server account (either WA’s or Door43’s content server), choosing this option opens a screen with a list of all your server online projects.

You could also search for another user’s project:

  1. Remove your user name from the left search field.
  2. Type in the server user name of the user whose project you want to import.

Another possibility is to search for a project by the book name or language:

  1. Remove your user name from the left search field.
  2. Type in either the book abbreviation or the language code in the right field, or a combination of both (for example, fr_eph for French Ephesians).
  3. Optional: type in a user’s account in the User Name field to filter by the User.

Once you have located the project you wish to import:

  1. Click the desired file to import it, or click CANCEL to close the option and return to the Import Options menu.
  2. If you import the file, you receive a success message. Click CLOSE to close the window.

Import Project File

This process imports into the program a BTT Writer project from a file on the computer. These are files that have an extension of tstudio.

Follow this process to import a tstudio file:

  1. Click Import Project File to import a project from the hard drive of the computer.
  2. The program opens the file manager to the directory of the BTT Writer backups. Either choose one of the backup projects or navigate to the desired file. Hint: you will be able to view only the files that have an extension of tstudio.
  3. Click to select the desired .tstudio file, and then click Open.
  4. The import begins; when the import is completed a window displays a success message. Click CLOSE to close the window.

Import USFM File

This process imports a file that is formatted as a USFM document. Unified Standard Format Marker (USFM) is the international standard of Biblical text.

Follow this process to import a usfm file:

  1. Click Import USFM File to import a file from the hard drive of the computer.
  2. The program opens the file explorer to the BTT Writer backups folder. Navigate to find the desired file. Hint: you will be able to view only the files that have an extension of txt or usfm.
  3. Make note of the language code contained in the file name, because you may need it in the next step. Click the desired file, and then click Open.
  4. The USFM file itself may not contain the name of the target language. If not, you’ll need to tell BTT Writer what target language the project uses. On the ‘Choose a Target Language’ screen you can search for the language by typing its code in the search field. Use the language code that you made note of from the file name. Click the target language to select it.
  5. The remaining screens depend on what information is contained in the USFM file.
  • You may be asked to choose a category. Click the desired category to select it.
  • You may be asked to choose a book name. Click the desired book name to select it.
  • You may be asked to choose the project type. Click the desired type to select it.
  1. The import begins, and when the import is completed a window displays a success message. Click CLOSE to close the window.

Import Source Text

If you have a file containing source text that you want to use for a project, you can select this option to do so. Refer to the information on http://resource-container.readthedocs.io/en/latest/index.html to create your own source text file that can be imported into the BTT Writer program.

Making the choice to import source text opens the File Manager. Navigate to the desired source text file, click the file name, and click Open to import it.

Importing Duplicate Projects

If you are importing a project that is the same as a project already in the local program, you will receive a warning message that states:

  • For a USFM file:

    Overwrite?

    This target translation already exists.

    Overwrite?

  • For a project file:

    Project Already Exists

    This project already exists locally. How would you like to proceed?

The possible actions for dealing with importing duplicate projects are:

  • Cancel: Clicking Cancel closes the message and the project does not get imported.
  • Merge Projects
    • The importing process continues.
    • When the message that the import is complete shows, click Close.
    • Open the project.
    • If the imported translation has recent changes, they now show in the text.
  • Overwrite Project
    • Warning: Choosing to overwrite the project removes all information on the computer related to the previous local project and substitutes it with the information from the imported project.
    • We recommend that you do not choose this option if you have previously uploaded the project to the server.
    • If you run into difficulty you can always contact helpdesk@techadvancement.com for help or submit a ticket using the following link: https://www.techadvancement.com/submit-ticket/.

Merge Conflicts

Occasionally, there may be differences between the information in the program and the information that is in the imported project. This is known as a conflict. When this happens, you see this message:

Import Complete

Your project has been successfully imported. There are 2 chunks that contain new conflicts that need your attention.

Resolve the differences by following these steps:

  • Click Close to close the message window.
  • Open the project.
  • Observe that there is a triangle icon in the left column. Click the triangle icon to view only the chunks with a conflict.
    • The text that was in the translation before the import is in a green box.
    • The text that is new is in the blue box.
    • Choose the text that has the preferred translation by clicking on that box.
    • Click Confirm to use the selected text. Click Cancel to not select the text.
    • The text that you did not select disappears.

Repeat all the above steps until all the conflicts have been resolved by choosing the desired translations. If you run into difficulty you can always contact helpdesk@techadvancement.com for help or submit a ticket using the following link: https://www.techadvancement.com/submit-ticket/.

NOTE: resolve all conflicts before doing another export or import of the project.