{"id":22026109,"url":"https://github.com/curiouslearner/python-docs-hi-in","last_synced_at":"2026-05-02T14:49:51.100Z","repository":{"id":81377567,"uuid":"185246859","full_name":"CuriousLearner/python-docs-hi-in","owner":"CuriousLearner","description":"Hindi Translations for the Python Documentation","archived":false,"fork":false,"pushed_at":"2023-07-09T15:52:22.000Z","size":6603,"stargazers_count":1,"open_issues_count":2,"forks_count":2,"subscribers_count":3,"default_branch":"3.7","last_synced_at":"2024-04-14T00:59:16.796Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"http://docs.python.org","language":"Makefile","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/CuriousLearner.png","metadata":{"files":{"readme":"README.rst","changelog":null,"contributing":null,"funding":null,"license":"license.po","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2019-05-06T18:04:08.000Z","updated_at":"2019-05-06T20:02:17.000Z","dependencies_parsed_at":null,"dependency_job_id":"c568f128-1763-415d-ba01-ab15d345e19c","html_url":"https://github.com/CuriousLearner/python-docs-hi-in","commit_stats":{"total_commits":7,"total_committers":2,"mean_commits":3.5,"dds":0.4285714285714286,"last_synced_commit":"68315d29661914f9d071c9108c23e425816b9dee"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CuriousLearner%2Fpython-docs-hi-in","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CuriousLearner%2Fpython-docs-hi-in/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CuriousLearner%2Fpython-docs-hi-in/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CuriousLearner%2Fpython-docs-hi-in/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/CuriousLearner","download_url":"https://codeload.github.com/CuriousLearner/python-docs-hi-in/tar.gz/refs/heads/3.7","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245090874,"owners_count":20559298,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-30T07:25:18.777Z","updated_at":"2026-05-02T14:49:50.928Z","avatar_url":"https://github.com/CuriousLearner.png","language":"Makefile","funding_links":[],"categories":[],"sub_categories":[],"readme":"Translation of the Python Documentation — Hindi\n===============================================\n\n.. image:: https://travis-ci.org/CuriousLearner/python-docs-hi-in.svg?branch=3.7\n  :target: https://travis-ci.org/CuriousLearner/python-docs-hi-in\n\n\nDocumentation Contribution Agreement\n------------------------------------\n\nNOTE REGARDING THE LICENSE FOR TRANSLATIONS: Python's documentation is\nmaintained using a global network of volunteers. By posting this\nproject on Transifex, Github, and other public places, and inviting\nyou to participate, we are proposing an agreement that you will\nprovide your improvements to Python's documentation or the translation\nof Python's documentation for the PSF's use under the CC0 license\n(available at\nhttps://creativecommons.org/publicdomain/zero/1.0/legalcode). In\nreturn, you may publicly claim credit for the portion of the\ntranslation you contributed and if your translation is accepted by the\nPSF, you may (but are not required to) submit a patch including an\nappropriate annotation in the Misc/ACKS or TRANSLATORS file. Although\nnothing in this Documentation Contribution Agreement obligates the PSF\nto incorporate your textual contribution, your participation in the\nPython community is welcomed and appreciated.\n\nYou signify acceptance of this agreement by submitting your work to\nthe PSF for inclusion in the documentation.\n\n\nContributing to the Translation\n-------------------------------\n\nHow to Contribute\n~~~~~~~~~~~~~~~~~\n\nYou can contribute using:\n\n- Github\n- `transifex \u003chttps://www.transifex.com/python-doc/public/\u003e`_\n- Or just by opening `an issue on github \u003chttps://github.com/python/python-docs-hi-infr/issues\u003e`_\n\n\nContributing using Github\n~~~~~~~~~~~~~~~~~~~~~~~~~\n\nPrerequisites:\n\n- A `github account \u003chttps://github.com/join\u003e`_.\n- ``git`` `installed \u003chttps://help.github.com/articles/set-up-git/\u003e`_ (for windows, see\n  https://gitforwindows.org/).\n- A ``.po`` file editor (Use `poedit \u003chttps://poedit.net/\u003e`_\n  if you don't already have one).\n\n\nLet's start:\n\nYou'll need to fork the `python-docs-hi-in\n\u003chttps://github.com/python/python-docs-hi-in\u003e`_ clicking its ``Fork``\nbutton. This creates a copy of the whole project on your github\naccount: a place where you have the rights to do modifications.\n\nStep by step:\n\n.. code-block:: bash\n\n    # Git clone your github fork using ssh (replace JulienPalard):\n    git clone git@github.com:JulienPalard/python-docs-hi-in.git\n\n    # Go to the cloned directory:\n    cd python-docs-hi-in/\n\n    # Add the upstream (the public repository) using HTTPS (won't ask for password):\n    git remote add upstream https://github.com/python/python-docs-hi-in.git\n\nAll the translations must be made on the latest release.\nWe never translate on an oldest version, by example, the latest python release\nis python 3.7, we don't want to translate directly on the python 3.5 release.\nIf needed translations would be backported on the oldest versions by the\n`documentation team \u003chttps://www.python.org/dev/peps/pep-8015/#documentation-team\u003e`.\n\nNow you're ready to start a work session, each time you'll start a new task, start here:\n\n.. code-block:: bash\n\n    # To work, we'll need a branch, based on an up-to-date (freshly fetched)\n    # upstream/3.7 branch, let's say we'll work on glossary so we name\n    # the branch \"glossary\":\n    git fetch upstream\n    git checkout -b glossary upstream/3.7\n\n    # You can now work on the file, typically using poedit,\n    poedit directory/file.po\n\n    # When everything is clear (syntax errors from Sphinx, html rendering,\n    # semantics, typography),\n    # you can commit your work with a nice explicit message:\n    git commit -a -m \"Working on glossary.\"\n\n    # Then push your modifications to your github clone,\n    # as they are ephemeral branches, let's not configure git to track them all,\n    # \"origin HEAD\" is a \"special\" syntax to say \"Push on origin,\n    # on a branch with the same name as the local one\",\n    # it's nice as it's exactly what we want:\n    git push origin HEAD\n\n    # The previous command will print you a link to open a PR on github.\n    # If you missed it, just go to\n    # https://github.com/python/python-docs-hi-in/ and a nice \"Compare \u0026 pull request\"\n    # button should appear after a few seconds telling you can ask for a pull request.\n\n    # Now someone is reviewing your modifications, and you'll want to fix their\n    # findings, get back to your branch\n    # (in case you started something else on another branch):\n    git checkout glossary\n    # Fix the issues, then commit again:\n    git commit -a -m \"glossary: small fixes.\"\n    git push origin HEAD\n\n\nYou may have noted that this looks like a triangle, with a missing segment:\n\n- You're fetching from upstream (public common repo on github)\n- You're pushing to origin (your clone on github)\n\nSo yes it's the work of someone to add the last segment, from your\norigin to the public upstream, to \"close the loop\", that's the role of\nthe people who merges pull requests after proofreading them.\n\nYou may also have noted you never ever commit on a version branch\n(``3.6``, ``3.7``, ...), only pull from them, consider them read-only\nyou'll avoid problems.\n\n\nWhat to translate\n~~~~~~~~~~~~~~~~~\n\nYou can start with easy tasks like reviewing fuzzy entries to help\nkeeping the documentation up to date (find them using ``make fuzzy``).\n\nYou can also proofread already translated entries, and finally\ntranslate untranslated ones (find them using ``make todo``)..\n\n- Do not translate content of ``:ref:...`` and ``:term:...``\n- Put english words, if you have to use them, in *italics* (surrounded\n  by stars).\n- If you translate a link title, please translate the link too\n  (typically if it's Wikipedia and the article has a translation). If\n  no translation of the target exists, do not translate the\n  title.\n\n\nWhere to get help\n~~~~~~~~~~~~~~~~~\n\n\nTranslation Resources\n---------------------\n\n\nGlossary\n--------\n\nFor consistency in our translations, here are some propositions and\nreminders for frequent terms you'll have to translate, don't hesitate\nto open an issue if you disagree.\n\nTo easily find how a term is already translated in our documentation,\nyou may use\n`find_in_po.py \u003chttps://gist.github.com/JulienPalard/c430ac23446da2081060ab17bf006ac1\u003e`_.\n\n========================== ===========================================\nTerm                       Proposed Translation\n========================== ===========================================\n-like\nabstract data type\nargument\nbackslash\nbound\nbug\nbuilt-in\ncall stack\ndebugging\ndeep copy\ndouble quote\ne.g.\ngarbage collector\nidentifier\nimmutable\ninstaller\ninterpreter\nlibrary\nlist comprehension\nlittle-endian, big-endian\nmutable\nnamespace\nparameter\nprompt\nraise\nregular expression\nreturn\nsimple quote\nsocket\nstatement\nsubprocess\nthread\nunderscore\nexpression\n========================== ===========================================\n\n\nSimplify git diffs\n------------------\n\nGit diffs are often crowded with useless line number changes, like:\n\n.. code-block:: diff\n\n    -#: ../Doc/library/signal.rst:406\n    +#: ../Doc/library/signal.rst:408\n\nTo tell git they are not usefull information, you can do the following\nafter ensuring ``~/.local/bin/`` is in your ``PATH``.\n\n.. code-block:: bash\n\n    cat \u003c\u003cEOF \u003e ~/.local/bin/podiff\n    #!/bin/sh\n    grep -v '^#:' \"\\$1\"\n    EOF\n\n    chmod a+x ~/.local/bin/podiff\n\n    git config diff.podiff.textconv podiff\n\n\nMaintenance\n-----------\n\nAll those snippets are to run from the root of a ``python-docs-hi-in``\nclone, and some expect to find an up-to-date CPython clone near to it,\nlike:\n\n.. code-block:: bash\n\n  ~/\n  ├── python-docs-hi-in/\n  └── cpython/\n\nTo clone CPython you may use:\n\n.. code-block:: bash\n\n  git clone --depth 1 --no-single-branch https://github.com/python/cpython.git\n\nThis avoids to download the whole history (not usefull to build\ndocumentation) but still fetches all branches.\n\n\nMerge pot files from CPython\n~~~~~~~~~~~~~~~~~~~~~~~~~~~~\n\n.. code-block:: bash\n\n  make merge\n\n\nFind fuzzy strings\n~~~~~~~~~~~~~~~~~~\n\n.. code-block:: bash\n\n  make fuzzy\n\n\nRun a test build locally\n~~~~~~~~~~~~~~~~~~~~~~~~\n\n.. code-block:: bash\n\n  make\n\n\nSynchronize translation with Transifex\n~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\n\nYou'll need the ``transifex-client`` and ``powrap``\nfrom Pypi.\n\nYou'll need to configure ``tx`` via ``tx init`` if not already done.\n\n.. code-block:: bash\n\n   pomerge --from-files **/*.po\n   tx pull -f\n   pomerge --to-files **/*.po\n   pomerge --from-files **/*.po\n   git checkout -- .\n   pomerge --to-files **/*.po\n   powrap --modified\n   git commit -m \"tx pull\"\n   tx push -t -f\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcuriouslearner%2Fpython-docs-hi-in","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcuriouslearner%2Fpython-docs-hi-in","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcuriouslearner%2Fpython-docs-hi-in/lists"}