Visitar URL original
WIP: Farsi translation of the Python documentation corpus by sepehr-rs · Pull Request #62 · python/python-docs-fa · GitHub
Skip to content

WIP: Farsi translation of the Python documentation corpus #62

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
sepehr-rs merged 13 commits into from
Sep 16, 2026
Merged

WIP: Farsi translation of the Python documentation corpus #62

Show file tree
Hide file tree
Changes from 1 commit
Commits
Show all changes
13 commits
Select commit Hold shift + click to select a range
883b0a5
FIx translation artifacts
sepehr-rs Aug 26, 2026
5014379
Translation chore
github-actions[bot] Aug 27, 2026
1ed7e5b
Translate all of Python documentation files
sepehr-rs Sep 5, 2026
f91afae
Merge branch '3.14' into cleaned/final-pr
sepehr-rs Sep 6, 2026
029c770
Update .readthedocs.yml
sepehr-rs Sep 6, 2026
b5a5148
Cleanup parentheses and improve translations
sepehr-rs Sep 6, 2026
9133240
Quality checks, pass 1
sepehr-rs Sep 12, 2026
6c14103
Quality checks, pass 2/2
sepehr-rs Sep 14, 2026
27a96e7
Final touches
sepehr-rs Sep 15, 2026
bc7a164
Policy changes and updates
sepehr-rs Sep 16, 2026
67b0c85
Merge branch '3.14' into cleaned/final-pr
sepehr-rs Sep 16, 2026
1926be3
Cleanup
sepehr-rs Sep 16, 2026
e025034
Cleanup part 2
sepehr-rs Sep 16, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Prev Previous commit
Next Next commit
Translation chore
  • Loading branch information
@github-actions @sepehr-rs
github-actions[bot] authored and sepehr-rs committed Sep 5, 2026
commit 5014379c16b362066e98f424ad9791e129b86928
2 changes: 1 addition & 1 deletion README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -45,5 +45,5 @@
<!-- STATS_START -->
### مشارکت‌های کاربران
![نمودار مشارکت‌های کاربران؛ Revisto 3984، sepehr-rs 2210، danialbehzadi 677، invincible627 358، khosro_o 63، ParhamF 41، Ariyan_Bolandi 37، nikovinix7878 13، thaghgoo 12، Ramiz_222 10](reports/contributor_stats_latest.png)
(به‌روزرسانی: 2026-08-26)
(به‌روزرسانی: 2026-09-05)
<!-- STATS_END -->
10 changes: 5 additions & 5 deletions STATUS.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
<!-- TRANSLATION_STATUS_START -->
### وضعیت ترجمه فایل‌ها
(به‌روزرسانی: 2026-08-26)
(به‌روزرسانی: 2026-09-05)

| فایل | ترجمه‌شده | مبهم | تعداد ترجمه‌شده | تعداد ترجمه‌نشده |
|:-----|:-----------:|:-----------:|:-----------:|:-----------:|
Expand Down Expand Up @@ -179,7 +179,7 @@
| library/archiving.po | 0.0% | 0.0% | 0 | 2 |
| library/argparse.po | 0.0% | 0.0% | 0 | 408 |
| library/array.po | 0.0% | 0.0% | 0 | 89 |
| library/ast.po | 0.0% | 0.0% | 0 | 339 |
| library/ast.po | 0.0% | 0.0% | 0 | 338 |
| library/asynchat.po | 0.0% | 0.0% | 0 | 4 |
| library/asyncio-api-index.po | 0.0% | 0.0% | 0 | 100 |
| library/asyncio-dev.po | 0.0% | 0.0% | 0 | 84 |
Expand Down Expand Up @@ -280,7 +280,7 @@
| library/ensurepip.po | 0.0% | 0.0% | 0 | 40 |
| library/enum.po | 0.0% | 0.0% | 0 | 257 |
| library/errno.po | 0.0% | 0.0% | 0 | 161 |
| library/exceptions.po | 0.0% | 0.0% | 0 | 204 |
| library/exceptions.po | 0.0% | 0.0% | 0 | 203 |
| library/faulthandler.po | 0.0% | 0.0% | 0 | 53 |
| library/fcntl.po | 0.0% | 0.0% | 0 | 54 |
| library/filecmp.po | 0.0% | 0.0% | 0 | 42 |
Expand Down Expand Up @@ -500,7 +500,7 @@
| reference/datamodel.po | 0.0% | 0.0% | 0 | 913 |
| reference/executionmodel.po | 0.0% | 0.0% | 0 | 145 |
| reference/expressions.po | 0.0% | 0.0% | 0 | 595 |
| reference/grammar.po | 0.0% | 0.0% | 0 | 7 |
| reference/grammar.po | 0.0% | 0.0% | 0 | 6 |
| reference/import.po | 0.0% | 0.0% | 0 | 202 |
| reference/index.po | 0.0% | 0.0% | 0 | 2 |
| reference/introduction.po | 0.0% | 0.0% | 0 | 56 |
Expand Down Expand Up @@ -541,5 +541,5 @@
| whatsnew/3.9.po | 0.0% | 0.0% | 0 | 380 |
| whatsnew/changelog.po | 0.0% | 0.0% | 0 | 1 |
| whatsnew/index.po | 0.0% | 0.0% | 0 | 3 |
| **مجموع** | **3.9%** | **0.0%** | **2706** | **67536** |
| **مجموع** | **3.9%** | **0.0%** | **2706** | **67533** |
<!-- TRANSLATION_STATUS_END -->
159 changes: 1 addition & 158 deletions library/ast.po
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@ msgid ""
msgstr ""
"Project-Id-Version: Python 3.14\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2026-08-26 07:47+0330\n"
"POT-Creation-Date: 2026-08-27 14:53+0000\n"
"PO-Revision-Date: 2021-06-28 00:54+0000\n"
"Last-Translator: Sepehr Rasouli <sepehrrasouli06@gmail.com>, 2026\n"
"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n"
Expand Down Expand Up @@ -41,163 +41,6 @@ msgstr ""
msgid "The abstract grammar is currently defined as follows:"
msgstr ""

msgid ""
"-- ASDL's 4 builtin types are:\n"
"-- identifier, int, string, constant\n"
"\n"
"module Python\n"
"{\n"
" mod = Module(stmt* body, type_ignore* type_ignores)\n"
" | Interactive(stmt* body)\n"
" | Expression(expr body)\n"
" | FunctionType(expr* argtypes, expr returns)\n"
"\n"
" stmt = FunctionDef(identifier name, arguments args,\n"
" stmt* body, expr* decorator_list, expr? returns,\n"
" string? type_comment, type_param* type_params)\n"
" | AsyncFunctionDef(identifier name, arguments args,\n"
" stmt* body, expr* decorator_list, expr? returns,\n"
" string? type_comment, type_param* type_params)\n"
"\n"
" | ClassDef(identifier name,\n"
" expr* bases,\n"
" keyword* keywords,\n"
" stmt* body,\n"
" expr* decorator_list,\n"
" type_param* type_params)\n"
" | Return(expr? value)\n"
"\n"
" | Delete(expr* targets)\n"
" | Assign(expr* targets, expr value, string? type_comment)\n"
" | TypeAlias(expr name, type_param* type_params, expr value)\n"
" | AugAssign(expr target, operator op, expr value)\n"
" -- 'simple' indicates that we annotate simple name without parens\n"
" | AnnAssign(expr target, expr annotation, expr? value, int simple)\n"
"\n"
" -- use 'orelse' because else is a keyword in target languages\n"
" | For(expr target, expr iter, stmt* body, stmt* orelse, string? type_comment)\n"
" | AsyncFor(expr target, expr iter, stmt* body, stmt* orelse, string? type_comment)\n"
" | While(expr test, stmt* body, stmt* orelse)\n"
" | If(expr test, stmt* body, stmt* orelse)\n"
" | With(withitem* items, stmt* body, string? type_comment)\n"
" | AsyncWith(withitem* items, stmt* body, string? type_comment)\n"
"\n"
" | Match(expr subject, match_case* cases)\n"
"\n"
" | Raise(expr? exc, expr? cause)\n"
" | Try(stmt* body, excepthandler* handlers, stmt* orelse, stmt* finalbody)\n"
" | TryStar(stmt* body, excepthandler* handlers, stmt* orelse, stmt* finalbody)\n"
" | Assert(expr test, expr? msg)\n"
"\n"
" | Import(alias* names)\n"
" | ImportFrom(identifier? module, alias* names, int? level)\n"
"\n"
" | Global(identifier* names)\n"
" | Nonlocal(identifier* names)\n"
" | Expr(expr value)\n"
" | Pass | Break | Continue\n"
"\n"
" -- col_offset is the byte offset in the utf8 string the parser uses\n"
" attributes (int lineno, int col_offset, int? end_lineno, int? end_col_offset)\n"
"\n"
" -- BoolOp() can use left & right?\n"
" expr = BoolOp(boolop op, expr* values)\n"
" | NamedExpr(expr target, expr value)\n"
" | BinOp(expr left, operator op, expr right)\n"
" | UnaryOp(unaryop op, expr operand)\n"
" | Lambda(arguments args, expr body)\n"
" | IfExp(expr test, expr body, expr orelse)\n"
" | Dict(expr?* keys, expr* values)\n"
" | Set(expr* elts)\n"
" | ListComp(expr elt, comprehension* generators)\n"
" | SetComp(expr elt, comprehension* generators)\n"
" | DictComp(expr key, expr value, comprehension* generators)\n"
" | GeneratorExp(expr elt, comprehension* generators)\n"
" -- the grammar constrains where yield expressions can occur\n"
" | Await(expr value)\n"
" | Yield(expr? value)\n"
" | YieldFrom(expr value)\n"
" -- need sequences for compare to distinguish between\n"
" -- x < 4 < 3 and (x < 4) < 3\n"
" | Compare(expr left, cmpop* ops, expr* comparators)\n"
" | Call(expr func, expr* args, keyword* keywords)\n"
" | FormattedValue(expr value, int conversion, expr? format_spec)\n"
" | Interpolation(expr value, constant str, int conversion, expr? format_spec)\n"
" | JoinedStr(expr* values)\n"
" | TemplateStr(expr* values)\n"
" | Constant(constant value, string? kind)\n"
"\n"
" -- the following expression can appear in assignment context\n"
" | Attribute(expr value, identifier attr, expr_context ctx)\n"
" | Subscript(expr value, expr slice, expr_context ctx)\n"
" | Starred(expr value, expr_context ctx)\n"
" | Name(identifier id, expr_context ctx)\n"
" | List(expr* elts, expr_context ctx)\n"
" | Tuple(expr* elts, expr_context ctx)\n"
"\n"
" -- can appear only in Subscript\n"
" | Slice(expr? lower, expr? upper, expr? step)\n"
"\n"
" -- col_offset is the byte offset in the utf8 string the parser uses\n"
" attributes (int lineno, int col_offset, int? end_lineno, int? end_col_offset)\n"
"\n"
" expr_context = Load | Store | Del\n"
"\n"
" boolop = And | Or\n"
"\n"
" operator = Add | Sub | Mult | MatMult | Div | Mod | Pow | LShift\n"
" | RShift | BitOr | BitXor | BitAnd | FloorDiv\n"
"\n"
" unaryop = Invert | Not | UAdd | USub\n"
"\n"
" cmpop = Eq | NotEq | Lt | LtE | Gt | GtE | Is | IsNot | In | NotIn\n"
"\n"
" comprehension = (expr target, expr iter, expr* ifs, int is_async)\n"
"\n"
" excepthandler = ExceptHandler(expr? type, identifier? name, stmt* body)\n"
" attributes (int lineno, int col_offset, int? end_lineno, int? end_col_offset)\n"
"\n"
" arguments = (arg* posonlyargs, arg* args, arg? vararg, arg* kwonlyargs,\n"
" expr?* kw_defaults, arg? kwarg, expr* defaults)\n"
"\n"
" arg = (identifier arg, expr? annotation, string? type_comment)\n"
" attributes (int lineno, int col_offset, int? end_lineno, int? end_col_offset)\n"
"\n"
" -- keyword arguments supplied to call (NULL identifier for **kwargs)\n"
" keyword = (identifier? arg, expr value)\n"
" attributes (int lineno, int col_offset, int? end_lineno, int? end_col_offset)\n"
"\n"
" -- import name with optional 'as' alias.\n"
" alias = (identifier name, identifier? asname)\n"
" attributes (int lineno, int col_offset, int? end_lineno, int? end_col_offset)\n"
"\n"
" withitem = (expr context_expr, expr? optional_vars)\n"
"\n"
" match_case = (pattern pattern, expr? guard, stmt* body)\n"
"\n"
" pattern = MatchValue(expr value)\n"
" | MatchSingleton(constant value)\n"
" | MatchSequence(pattern* patterns)\n"
" | MatchMapping(expr* keys, pattern* patterns, identifier? rest)\n"
" | MatchClass(expr cls, pattern* patterns, identifier* kwd_attrs, pattern* kwd_patterns)\n"
"\n"
" | MatchStar(identifier? name)\n"
" -- The optional \"rest\" MatchMapping parameter handles capturing extra mapping keys\n"
"\n"
" | MatchAs(pattern? pattern, identifier? name)\n"
" | MatchOr(pattern* patterns)\n"
"\n"
" attributes (int lineno, int col_offset, int end_lineno, int end_col_offset)\n"
"\n"
" type_ignore = TypeIgnore(int lineno, string tag)\n"
"\n"
" type_param = TypeVar(identifier name, expr? bound, expr? default_value)\n"
" | ParamSpec(identifier name, expr? default_value)\n"
" | TypeVarTuple(identifier name, expr? default_value)\n"
" attributes (int lineno, int col_offset, int end_lineno, int end_col_offset)\n"
"}\n"
msgstr ""

msgid "Node classes"
msgstr ""

Expand Down
73 changes: 1 addition & 72 deletions library/exceptions.po
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ msgid ""
msgstr ""
"Project-Id-Version: Python 3.14\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2026-08-26 07:47+0330\n"
"POT-Creation-Date: 2026-08-27 14:53+0000\n"
"PO-Revision-Date: 2021-06-28 01:05+0000\n"
"Last-Translator: Sepehr Rasouli <sepehrrasouli06@gmail.com>, 2026\n"
"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n"
Expand Down Expand Up @@ -630,77 +630,6 @@ msgstr ""
msgid "The class hierarchy for built-in exceptions is:"
msgstr ""

msgid ""
"BaseException\n"
" ├── BaseExceptionGroup\n"
" ├── GeneratorExit\n"
" ├── KeyboardInterrupt\n"
" ├── SystemExit\n"
" └── Exception\n"
" ├── ArithmeticError\n"
" │ ├── FloatingPointError\n"
" │ ├── OverflowError\n"
" │ └── ZeroDivisionError\n"
" ├── AssertionError\n"
" ├── AttributeError\n"
" ├── BufferError\n"
" ├── EOFError\n"
" ├── ExceptionGroup [BaseExceptionGroup]\n"
" ├── ImportError\n"
" │ └── ModuleNotFoundError\n"
" ├── LookupError\n"
" │ ├── IndexError\n"
" │ └── KeyError\n"
" ├── MemoryError\n"
" ├── NameError\n"
" │ └── UnboundLocalError\n"
" ├── OSError\n"
" │ ├── BlockingIOError\n"
" │ ├── ChildProcessError\n"
" │ ├── ConnectionError\n"
" │ │ ├── BrokenPipeError\n"
" │ │ ├── ConnectionAbortedError\n"
" │ │ ├── ConnectionRefusedError\n"
" │ │ └── ConnectionResetError\n"
" │ ├── FileExistsError\n"
" │ ├── FileNotFoundError\n"
" │ ├── InterruptedError\n"
" │ ├── IsADirectoryError\n"
" │ ├── NotADirectoryError\n"
" │ ├── PermissionError\n"
" │ ├── ProcessLookupError\n"
" │ └── TimeoutError\n"
" ├── ReferenceError\n"
" ├── RuntimeError\n"
" │ ├── NotImplementedError\n"
" │ ├── PythonFinalizationError\n"
" │ └── RecursionError\n"
" ├── StopAsyncIteration\n"
" ├── StopIteration\n"
" ├── SyntaxError\n"
" │ └── IndentationError\n"
" │ └── TabError\n"
" ├── SystemError\n"
" ├── TypeError\n"
" ├── ValueError\n"
" │ └── UnicodeError\n"
" │ ├── UnicodeDecodeError\n"
" │ ├── UnicodeEncodeError\n"
" │ └── UnicodeTranslateError\n"
" └── Warning\n"
" ├── BytesWarning\n"
" ├── DeprecationWarning\n"
" ├── EncodingWarning\n"
" ├── FutureWarning\n"
" ├── ImportWarning\n"
" ├── PendingDeprecationWarning\n"
" ├── ResourceWarning\n"
" ├── RuntimeWarning\n"
" ├── SyntaxWarning\n"
" ├── UnicodeWarning\n"
" └── UserWarning\n"
msgstr ""

msgid "statement"
msgstr ""

Expand Down
Loading