Skip to content

Guide for translators

Jump to bottom
carmi cronje edited this page Mar 12, 2022 · 22 revisions

Guide for SuttaCentral translators using the Bilara translation app

Before you get started

Style guide

Before beginning translation, please read the SuttaCentral translation style guide, written by Bhante Sujato. Also read the Nilakkhana (markdown) guide.

Getting help

The SuttaCentral community is here to help! If you have any general questions, or require assistance with Bilara, or you are seeking a peer to review your work in progress, let the community know in the Bilara translators thread

Project setup

Once you have contacted SuttaCentral and discussed the texts you wish to translate with Bhante Sujato, a project will be set up for you in Bilara. Next steps:

  • Create a GitHub account (if you already have one proceed to next step)
  • Accept the GitHub invitation to join bilara-data (sent to email associated with account)
  • Authorize bilara-data

Working in Bilara

Table of Contents

Logging in
The home page
Your workspace
Customising your workspace
Search, find, and replace
Requesting peer review
Publishing translations
Updating published translations

Logging in

  • Log into Bilara at https://bilara.suttacentral.net/
  • The first time you will be prompted for your GitHub account details
  • The next time you log in you will be automatically authenticated

The home page

  • On Bilara's home page, take a moment to read the How to (top left)
  • Choose your preferred theme from the drop-down menu at the bottom of the page (e.g. mara for dark mode)
  • Click the bolded folder names to navigate to your project(s)

  • Select the translation you wish to work on

Your workspace

  • The root text and translation are displayed side-by-side
  • Click in the translation column to start editing
  • The Translation Memory will automatically display suggestions
  • Click a suggestion to use it, and modify as needed
  • Enter to save the entry and proceed to the next row (a green tick will appear confirming the entry has been saved)

Customising your workspace

  • Click the button (see screenshot) to add columns to your workspace e.g. comments, references, other translations
  • Rearrange the order of columns by clicking and dragging the column headings (when the cursor changes to a hand)

Search, find, and replace

  • Use the search tool to find all of the matching words in your project

  • If you wish to replace a word, enter the replacement word, then select REPLACE in the results where needed

Requesting peer review

The SuttaCentral community is here to help! If you are seeking a peer to review your work in progress, let the community know in the Bilara translators thread

Publishing translations

Note: The PUBLISH button will appear on the home page next to your project as soon as you begin a translation (regardless of the percentage completed).

  • Click PUBLISH when your work has been peer-reviewed, or you are satisfied it is completed
  • A dialog will be displayed confirming your request to move your translation to the published branch of bilara-data
  • The SuttaCentral publications manager will do a final check of the publication details before it is accepted and published to SuttaCentral (Note: The translation will progress through a series of steps. Updates to the website are approximately once a week.)

Updating published translations

Note: Authors retain access to their projects. The UPDATE button will appear on the home page next to your project once new text has been entered and saved.

  • Click UPDATE when your work has been peer-reviewed, or you are satisfied it is completed
  • A dialog will be displayed confirming your request to move your translation to the published branch of bilara-data
  • The SuttaCentral publications manager will do a final check of the publication details before it is accepted and published to SuttaCentral (Note: The translation will progress through a series of steps. Updates to the website are approximately once a week.)

Clone this wiki locally