QuantEcon / QuantEcon/lecture-python-programming.fa

_admonition/gpu.md is present but untranslated (still English)

Đang mở Phù hợp với người mới
#138 0 bình luận 0 reaction 0 người được giao Xem trên GitHub

Chưa có ai nhận issue này.

Ngôn ngữ chính
Python
Star
1
Fork
1
Merge trung bình
10 giờ 5 phút
Pull request đã merge (30 ngày)
5

Mô tả

lectures/_admonition/gpu.md in this repo is byte-identical to the English source — it was seeded but never translated. It is included by three lectures (autodiff, jax_intro, numpy_vs_numba_vs_jax), so the English GPU admonition renders inside three otherwise-Persian pages.

For comparison, .zh-cn has a properly translated copy, and .fr was missing the file entirely (fixed in .fr#14).

Why this needs its own issue

A strict build will not catch it. The include resolves, so there is no warning and no error — -W (added to this repo's ci.yml in #137) only catches the missing-file case, not the untranslated-content case. Nothing in the current pipeline flags an asset that exists but was never translated.

That is worth noting beyond this one file: shared assets under lectures/_admonition/ sit outside the set that translation sync moves, so they are neither synced nor reviewed. See action-translation#117 for the same class on quant-econ.bib.

Fix

Translate the admonition body into Persian, keeping the directive header and :class: warning option line unchanged, and keeping the Google Colab URL and the literal UI label intact.

Current content:

:class: warning

This lecture was built using a machine with access to a GPU --- although it will also run without one.

[Google Colab](https://colab.research.google.com/) has a free tier with GPUs
that you can access as follows:

1. Click on the "play" icon top right
2. Select Colab
3. Set the runtime environment to include a GPU

Found while enabling strict builds across the programming trio (QuantEcon/project-translation#9).

Hướng dẫn đóng góp

Chưa lập chỉ mục được hướng dẫn đóng góp cho kho mã nguồn này

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Hướng nghiên cứu

Mở lectures/_admonition/gpu.md và so sánh tệp này với bản nguồn tiếng Anh và bản sao .zh-cn đã dịch. Dịch phần nội dung của admonition sang tiếng Ba Tư, giữ nguyên directive header, warning class, URL Google Colab và nhãn UI nguyên văn; xác minh rằng kết quả được render chính xác trong autodiff, jax_intro và numpy_vs_numba_vs_jax.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Đánh giá

Công nghệ
python
Lĩnh vực
documentation, localization
Loại issue
Tài liệu
Độ khó
2/5
Thời gian dự kiến
1-3 giờ
Mức độ hoạt động
Ít trao đổi
Độ rõ ràng
Đặc tả rõ ràng
Mức phù hợp với người mới
78/100

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.