ManualChapter 5 of 7

Translation

A package's page is written in its author's language. With Auto Translate on, that page opens in your language. Either way, the Translate menu switches one page at a time between the original and the translation, and lets you choose the languages.

Auto Translate

  1. Open the Dashboard tab and tap the gear at the top right. Settings opens.
  2. Find the Packages group. Auto Translate is its first row.
  3. Turn the switch on.
The Settings page with the Packages group, where the Auto Translate switch is the first row and is turned on The Settings page with the Packages group, where the Auto Translate switch is the first row and is turned on
Auto Translate is the first row under Packages.

When you turn the switch on, it returns to off for a moment while Irisin asks your device whether it can translate into your system's language. The switch comes on only when the check passes. If the check fails, the switch stays off and an alert titled Unable to Translate gives the reason: This device does not offer system translation. or System translation does not support this language. Tap Dismiss to close it. Turning the switch off needs no check and takes effect at once.

With Auto Translate on, a package's page appears as its author wrote it, then the translation fades in over it. A line under the banner reports the progress. It shows a spinner and Translating…, then either This page is translated. or Unable to translate this page. The line is a note, not a button: tapping it does nothing.

  1. Translating…the author's page, first
  2. The system's translatorasked the way it prefers
  3. The on-device modelasked when that fails
  4. This page is translated.the translation fades in

If both fail, the page stays as written:
Unable to translate this page.

What Irisin tries with Auto Translate on, and what the page shows when both attempts fail.

The system's own translator does the work, not a service run by Irisin. Irisin first asks it the way the system prefers, which may be Apple's server, and asks the on-device model when that fails. Irisin sends the text nowhere else.

A page already in your language stays as it is: the line goes away and no alert appears. A failure shows the Unable to Translate alert once each time you launch Irisin. After that, on this package or any other, only the line under the banner tells you that a page could not be translated.

Irisin remembers the translations of the last fifty packages you read, so returning to a page, or switching how it reads, shows the translation at once. Those translations last only while Irisin is running: nothing is saved, and the next launch starts with none.

The Translate Menu

  1. Open a package's page.
  2. Tap the … button in the navigation bar, or touch and hold the button in the banner. The package's menu opens.
  3. Tap Translate. It comes after the Choose Version section and before Advanced.
  4. Choose Original, Translated, or Compared. The way the page reads now is checked.
The Translate menu open on a package's page: Original, Translated, and Compared with one of them checked, then Source Language and Target Language with their current values The Translate menu open on a package's page: Original, Translated, and Compared with one of them checked, then Source Language and Target Language with their current values
The Translate menu: how to read the page, then the two languages.

The menu works whether Auto Translate is on or off. With it on, every page opens set to Translated; with it off, every page opens set to Original. Translate appears only on a package's page: the same menu opened from a package's row in a list leaves it out, and so does the page's menu on a device with no system translation. The rest of that menu is in A Package's Page.

Original shows the page exactly as its author wrote it, the name in the banner included, and takes effect at once. Compared keeps each paragraph and each list item as written and puts its translation under it.

A package's page set to Compared, where each paragraph appears as written with its translation directly under it A package's page set to Compared, where each paragraph appears as written with its translation directly under it
Compared puts each translation under its original.

A translation you ask for from the menu shows a card titled Translating… while it runs. The card reads The system is translating this page. and has one button, Cancel. Cancel stops the translation and puts everything back: the page reads as it did, the checkmark returns to its earlier row, and a language you had just chosen goes back to the previous one. The checkmark moves only after the page reads the new way, so a translation that fails also leaves it where it was. A page translated earlier shows at once, with no card.

With Auto Translate off there is no line under the banner, even for a translation you asked for from the menu. The page itself shows the result, and an alert appears when there is something to report.

Source and Target Language

Below the three ways to read the page, the Translate menu has two more rows, Source Language and Target Language. Each shows its current value under its name and opens a list of languages. Each list comes from the system, read when you open it and sorted by each language's name as your device spells it. The source list holds exactly the languages the system can translate from, and the target list exactly the languages it can translate into.

Source Language is the language the page is written in. It starts at Detect Language, the item above the list, which lets the system identify the language. Your choice belongs to the page you are on: it is not saved, and the next page you open starts at Detect Language again. Name the language when detection gets it wrong.

Target Language is the language you read in, and it has no Detect Language item. Once you choose one on any package's page, it is kept for every page, Auto Translate included. Until you choose one, pages translate into your system's language, and follow that language if you change it.

Choosing a language translates the page again at once when the page shows Translated or Compared. When the page shows Original, the choice is only remembered, and it is used the next time the page shows a translation.

What Is Translated

Irisin translates the prose of a page and nothing else: its text, headings, labels, the titles of reviews, the names of its tabs, and the package's name in the banner. The name in the banner goes with the page, so it reads as written when the page shows Original. The title in the navigation bar always stays as written.

A translated package page: the line under the banner reads This page is translated., the name in the banner is translated, and the title in the navigation bar is as written A translated package page: the line under the banner reads This page is translated., the name in the banner is translated, and the title in the navigation bar is as written
A translated page. The banner's name is translated; the title in the bar is not.

These parts are never translated and come back exactly as written:

  • links and web addresses;
  • code, whether a few words inside a sentence or a whole block;
  • a line with no letters in it, such as a version number;
  • the rows of a page's table, such as Version, Author, and Maintainer;
  • buttons.

A translated line loses its bold and italics, and its strikethrough. Translation moves those markers away from the words they belonged to, and they would show as stray asterisks, so Irisin drops them.

A piece the system leaves untranslated stays in its own language. The rest of the page still changes, so one paragraph in the original language among translated ones is not an error.

When It Cannot Translate

Irisin answers with one of these alerts.

TitleMessageWhat It Means
Nothing to TranslateThis page is already in the target language.The page reads in your language already. The same alert appears when the system was not sure what language the page is in, or gave the text back unchanged. Name the Source Language and try again. You see this alert only for a translation you asked for from the menu.
Unable to TranslateSystem translation does not support this language.The system has no way from the page's language to yours. Try another Target Language, or name the Source Language if detection may have picked the wrong one.
Unable to TranslateThis device does not offer system translation.Irisin found no system translation it can use on this device, or the system did not answer within twenty seconds. Pages stay as written.
Unable to TranslateAny other message from the systemThe system's translator refused the page, and the message is its own reason.

After a failure the page stays as it read before and the checkmark in the menu goes back. A translation you asked for from the menu shows its alert every time, not once per launch, but only while the package's page is on screen with no other alert or sheet over it. With Auto Translate on, the line Unable to translate this page. under the banner still tells you.

A page with no prose has nothing to translate. It stays as written and shows no line.

Every failure is written to the app log, whether or not an alert appeared. To read it, see The Logs.