This PR builds on #441 (and includes the history in that branch) to extend the internationalization features and to expose the configuration options to the user for customization at a per-tutorial basis.

The usage and new format of the language option is outlined in the updated multilang vignette. There are quite a few different possibilities for the YAML options, ranging from simply changing the base language of the tutorial

language: fr

to overriding the display text for a specific language

# customize English display text for specific elements
language:
  default: en
  custom:
    button:
      runcode: Run!
    text:
      areyousure: Are you certain?

or to override the display text for multiple languages

language:
  default: en
  custom:
    - language: en
      button:
        runcode: Run!
    - language: es
      button:
        runcode: Ejecutar

or to provide the customizations in a JSON file

language:
  default: en
  custom: custom-language.json

Technical Changes

I've made a few changes compared with the approach in #441 that I'll outline briefly.

The first is that complete translations are now in R in tutorial_i18n_translations(). I think this will make it easier for R users to contribute more translations.

tutorial_i18n_lang() now receives the entire language list item from learnr::tutorial(), which is processed into a resources list as expected by i18next in tutorial_i18n_process_language_options() and written into the .js file containing the initialization code by tutorial_i18n_prepare_language_file(). Finally tutorial_i18n_lang() returns the htmlDependency() for the i18next initialization which contains the user's customizations.

Previously, a small amount of work was done to not re-create the initialization dependency file. Because that file can now depend on another external file (the custom-language.json file), I didn't really see any performance benefit to avoiding re-writing the file, so we now just write it on every render.

Users now have the multilang vignette and the documentation from tutorial_i18n_custom_language() to learn about language customization options. The latter is exported to facilitate creating the JSON file and to perform minimal validation of the custom language options.

Because the translations have been moved into R functions, the function documentation and the vignette both update automatically, so new translations can be added by updating tutorial_i18n_translations() without needing to update documentation in multiple locations.