jupyterlab/jupyterlab

View and render markdown content based on locale

Open

#12,375 建立於 2022年4月7日

在 GitHub 查看
 (5 留言) (1 反應) (0 負責人)TypeScript (13,454 star) (2,937 fork)batch import
enhancementfeaturehelp wanted

描述

Problem

Currently, it is hard to view/render markdown content based on the language/locale (English/French, en-US, fr-FR, ...).

Take, for example, if I want to create Jupyter notebooks in multiple languages (English, French, ...), currently I create two notebooks: one in English and one in French. Even though I use the same code for English and French, I use different markdown text for English and French. The problem with this approach is the management of multiple notebooks with redundant code. If I make modifications in one notebook, I need to copy the changes in the other.

Users who wish to share their Jupyter notebooks in multiple languages may encounter this issue.

Proposed Solution

One possible solution could be to let the users specify the language using something similar

# Explanation
{{{en-US}}}
Text in English
{{{en-US}}}

{{{fr-FR}}}
Le texte en français
{{{fr-FR}}}

Additional context

Associatated JupyterLab packages

Some similar issues:

貢獻者指南

技術棧
typescriptjavascript
領域
frontendlocalizationinternationalization
議題類型
feature
難度面向新貢獻者的預計實作難度，1 表示很小改動，5 表示專家級工作。
3
預計時間有經驗貢獻者完成調查、實作、測試並準備 pull request 的粗略時間範圍。
1-2 days
活動狀態議題目前的可參與程度：新鮮、活躍、陳舊、阻塞或等待維護者輸入。
fresh
清晰度議題是否清楚說明預期改動、驗收標準和下一步。
mostly clear
前置要求
familiarity with JupyterLab's markdown viewer extensionbasic knowledge of localizationexperience in TypeScript/JavaScript
新手友善度1-100 的估計分數，表示該議題對首次貢獻者的友善程度。
40
研究方向
Investigate the @jupyterlab/markdownviewer package (see packages/markdownviewer) to understand how markdown content is currently rendered. Look at how JupyterLab handles i18n to see if there is existing infrastructure for locale specific content. Check related issue #8668 for context. The proposed solution involves parsing custom syntax like {{{en US}}}...{{{en US}}} in markdown cells; consider implementing a markdown it plugin or similar to replace content based on the user's locale. Review the markdownviewer extension package to see how to hook into the rendering pipeline.