python / python/python-docs-pt-br

Melhorar mensagem enviada para Telegram com erro encontrado em arquivo .po pelo linter

未關閉
#294 1 則留言 0 個 reaction 已指派 0 人 在 GitHub 檢視

還沒有人認領這個 Issue。

主要語言
Python
星號
164
分支
42
平均合併
14 小時 32 分鐘
30 天內合併 PR
4

描述

Atualmente, quando o linter encontra um erro no .po, é enviada uma mensagem para o Telegram semelhante a essa

Image

O problema disso é que a linha 1280, deste exemplo, do arquivo não é encontrável pelo Transifex.

Então, seria útil que nessa mensagem viesse a URL para a linha no repositório. No caso, seria

https://github.com/python/python-docs-pt-br/blob/3.14/library/string.po#L1280

Ou com o link permanente:

https://github.com/python/python-docs-pt-br/blob/3dfcdb8c00c002f8667d7478a4aa1625fc9eea1d/library/string.po#L1280

Adicionalmente, talvez ficasse mais claro se a mensagem/link fosse para a linha com a msgstr e não a msgid. E talvez com mais algum texto explicativo.

Adicionalmente 2, enviar um URL para pesquisar no TX por uma strings com o texto da string alvo. Para o exemplo seria:

https://app.transifex.com/python-doc/python-newest/translate/#pt_BR/library--string/592013921?q=text%3A'%3E%3E%3E%20\'{0}%2C%20{1}%2C%20{2}\'.format(\'a\'%2C%20\'b\'%2C%20\'c\')'

Note que foi necessário remover o \n da URL.

貢獻指南

這個儲存庫沒有索引到貢獻指南

從這裡開始

  1. 先讀完整個 Issue,再讀專案的貢獻指南。
  2. 在 Issue 下留言說明你要接手 —— 這能避免兩個人做同樣的事。
  3. Fork 儲存庫,在一個分支上完成修改。
  4. 送出 Pull Request,並在描述裡引用這個 Issue 編號。

研究方向

找出用於格式化 .po 檔案中 linter 錯誤之 Telegram 通知的程式碼,然後檢查所回報的檔案和行如何取得。當訊息連結至相關的 repository 行,最好是 msgstr,並提供目標字串的 Transifex 搜尋 URL 時,工作即告完成。

由索引模型根據 Issue 內容生成。

評估

技術堆疊
python
領域
documentation, localization
Issue 類型
功能
難度
3/5
預估耗時
1-2 天
活躍度
冷清
描述清晰度
基本清楚
新手友好度
52/100

把新 issue 寄到你的電子郵件信箱

精選適合新手參與的 GitHub issue 摘要。