Skip to content

Commit 621db4a

Browse files
sepehr-rssepehr-rs
authored
Cleanup repository structure and maintenance workflows
- Add CONTRIBUTING.md and improve README documentation - Add workflows for updating PO headers and generating contribution plots - Remove obsolete Transifex files and links - Clean up unused scripts and repository metadata - Fix Sphinx linting issues and update translation files
2 parents 6de5617 + e1e63f8 commit 621db4a

549 files changed

Lines changed: 1885 additions & 6317 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

‎.github/ISSUE_TEMPLATE/config.yml‎

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,5 @@
1+
blank_issues_enabled: true
2+
contact_links:
3+
- name: راهنمای مشارکت (CONTRIBUTING.md)
4+
url: https://github.com/revisto/python-docs-fa/blob/3.14/CONTRIBUTING.md
5+
about: پیش از ثبت issue، لطفاً راهنمای مشارکت و README را مطالعه کنید

‎.github/ISSUE_TEMPLATE/page_request.md‎

Lines changed: 22 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,22 @@
1+
---
2+
name: درخواست ترجمهٔ صفحه
3+
about: درخواست ترجمه یا اولویت‌دادن به ترجمهٔ یک صفحهٔ خاص
4+
title: "[ترجمه] "
5+
labels: enhancement
6+
assignees: ''
7+
---
8+
9+
## صفحه
10+
11+
<!-- نام صفحه، مثلاً tutorial/classes -->
12+
13+
## لینک به مستندات اصلی
14+
15+
<!-- https://docs.python.org/3.14/tutorial/classes.html -->
16+
17+
## اولویت
18+
19+
<!-- آیا این صفحه برای فعال‌سازی فارسی در تغییردهندهٔ زبان (language switcher) لازم است؟ -->
20+
21+
- [ ] بله، از فایل‌های ضروری است
22+
- [ ] خیر

‎.github/ISSUE_TEMPLATE/question.md‎

Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,19 @@
1+
---
2+
name: پرسش یا پیشنهاد واژه‌نامه
3+
about: سؤال دربارهٔ قواعد ترجمه یا پیشنهاد اصطلاح برای واژه‌نامه
4+
title: ""
5+
labels: question
6+
assignees: ''
7+
---
8+
9+
## پرسش / پیشنهاد
10+
11+
<!-- توضیح سؤال یا پیشنهاد خود -->
12+
13+
## اصطلاح (در صورت پیشنهاد برای واژه‌نامه)
14+
15+
<!-- انگلیسی و ترجمهٔ فارسی پیشنهادی -->
16+
17+
## منابع
18+
19+
<!-- در صورت وجود، لینک مستندات مرجع یا نمونهٔ استفاده -->

‎.github/ISSUE_TEMPLATE/translation_bug.md‎

Lines changed: 33 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,33 @@
1+
---
2+
name: اشکال در ترجمه
3+
about: گزارش نادرستی یا خطا در ترجمه‌ی یک صفحه
4+
title: "[ترجمه] "
5+
labels: bug
6+
assignees: ''
7+
---
8+
9+
## صفحه / فایل
10+
11+
<!-- مسیر فایل .po یا لینک صفحهٔ فارسی -->
12+
13+
## متن اصلی (msgid)
14+
15+
```
16+
17+
```
18+
19+
## ترجمهٔ فعلی (msgstr)
20+
21+
```
22+
23+
```
24+
25+
## ترجمهٔ پیشنهادی
26+
27+
```
28+
29+
```
30+
31+
## دلیل / توضیح
32+
33+
<!-- چرا ترجمهٔ فعلی نادرست است؟ در صورت امکان به واژه‌نامه یا منبع معتبر ارجاع دهید. -->

‎.github/PULL_REQUEST_TEMPLATE.md‎

Lines changed: 25 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,25 @@
1+
## خلاصه
2+
3+
<!-- خلاصهای از ترجمه یا تغییری که انجام دادهاید بنویسید. -->
4+
5+
## فایل‌های تغییر یافته
6+
7+
<!-- فایل‌های .po که ترجمه/ویرایش شده‌اند را فهرست کنید، مثلاً:
8+
- `library/functions.po`
9+
- `tutorial/controlflow.po`
10+
-->
11+
12+
## تغییرات خاص
13+
14+
<!-- اگر نکته‌ی خاصی وجود داشته (مثلاً کنار گذاشتن یک رشته، تغییر در واژه‌نامه، ترجمه‌ی اصطلاح) اینجا توضیح دهید. -->
15+
16+
## چک‌لیست
17+
<!-- در هر براکتی که انجام شده، یک x قرار دهید.-->
18+
- [ ] `msgfmt --check` روی فایل‌های تغییر یافته با موفقیت اجرا شده است
19+
- [ ] `python3 scripts/check_markup.py` روی فایل‌های تغییر یافته اجرا شده است
20+
- [ ] نشانه‌گذاری‌های Sphinx (`:class:`، `:func:`، کد درون‌خطی) و جای‌گذارها (`%s`، `{name}`) دست‌نخورده مانده‌اند
21+
- [ ] ترجمه‌ها با [واژه‌نامه (GLOSSARY.md)](GLOSSARY.md) هماهنگ است
22+
- [ ] رشته‌های `fuzzy` بررسی و در صورت لزوم بازنویسی شده‌اند
23+
- [ ] فایل [CONTRIBUTING.md](CONTRIBUTING.md) با دقت خوانده شده است.
24+
25+
<!-- یادآوری: بررسی‌های خودکار (sphinx-lint ،msgfmt ،check_markup و ساخت کامل) در GitHub Actions روی پول‌ریکوئست اجرا می‌شوند. -->

‎.github/workflows/maintenance.yml‎

Lines changed: 50 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,50 @@
1+
name: Scheduled Maintenance
2+
3+
on:
4+
schedule:
5+
- cron: '30 3 * * *'
6+
workflow_dispatch: {}
7+
8+
permissions:
9+
contents: write
10+
11+
concurrency:
12+
group: maintenance
13+
cancel-in-progress: false
14+
15+
jobs:
16+
maintenance:
17+
runs-on: ubuntu-latest
18+
steps:
19+
- uses: actions/checkout@v4
20+
with:
21+
fetch-depth: 0
22+
23+
- name: Set up Python
24+
uses: actions/setup-python@v4
25+
with:
26+
python-version: '3.12'
27+
28+
- name: Install dependencies
29+
run: pip install polib matplotlib
30+
31+
- name: Update translation status table
32+
run: python3 scripts/generate_status_table.py
33+
34+
- name: Update PO file headers
35+
run: python3 scripts/update_po_headers.py --merge
36+
37+
- name: Update TEAM.md contributor counts
38+
run: python3 scripts/team_stats.py --update-teammd
39+
40+
- name: Update contributor chart and README stats block
41+
run: python3 scripts/contributor_chart.py
42+
43+
- name: Commit if changed
44+
run: |
45+
git config user.name "github-actions[bot]"
46+
git config user.email "github-actions[bot]@users.noreply.github.com"
47+
git add --all
48+
git diff --staged --quiet && echo "No changes to commit" && exit 0
49+
git commit -m "chore: update translation status, PO headers, team credits, and contributor chart"
50+
git push

‎.github/workflows/sync.yml.disabled‎

Lines changed: 0 additions & 60 deletions
This file was deleted.

‎.github/workflows/translation-status.yml‎

Lines changed: 0 additions & 33 deletions
This file was deleted.

‎.github/workflows/update-translation-stats.yml.disabled‎

Lines changed: 0 additions & 30 deletions
This file was deleted.

0 commit comments

Comments
 (0)