Skip to content

Guide for translators

Jump to bottom
carmi cronje edited this page Mar 29, 2021 · 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.

Getting help

The SuttaCentral community is here to help!

Project setup

Once you have contacted SuttaCentral and discussed the texts you wish to translate, 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

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, contact [who, how]

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

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

Clone this wiki locally