234 lines
7.1 KiB
Plaintext
234 lines
7.1 KiB
Plaintext
# LANGUAGE translation of FILENAME.pot
|
|
# Copyright (C) 2018-2022 Savoir-faire Linux Inc. and contributors
|
|
# This file is distributed under the same license as the Jami documentation.
|
|
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
|
|
#
|
|
#, fuzzy
|
|
msgid ""
|
|
msgstr ""
|
|
"Project-Id-Version: Jami\n"
|
|
"Report-Msgid-Bugs-To: https://git.jami.net/savoirfairelinux/jami-docs/-/issues\n"
|
|
"POT-Creation-Date: 2023-02-28 03:52+0000\n"
|
|
"PO-Revision-Date: 2022-09-14 17:52+0000\n"
|
|
"Language-Team: Persian (https://www.transifex.com/savoirfairelinux/teams/49466/fa/)\n"
|
|
"MIME-Version: 1.0\n"
|
|
"Content-Type: text/plain; charset=UTF-8\n"
|
|
"Content-Transfer-Encoding: 8bit\n"
|
|
"Language: fa\n"
|
|
"Plural-Forms: nplurals=2; plural=(n > 1);\n"
|
|
|
|
#: ../../../contribute.rst:3
|
|
msgid "Contribute to Jami"
|
|
msgstr ""
|
|
|
|
#: ../../../contribute.rst:5
|
|
msgid ""
|
|
"Contributions to Jami are always welcome and are much appreciated. There are"
|
|
" many ways to contribute to Jami, including reporting bugs and issues, "
|
|
"contributing code, helping package and maintain Jami for your GNU/Linux "
|
|
"distribution or other operating system, as well as contributing to these "
|
|
"very docs themselves."
|
|
msgstr ""
|
|
|
|
#: ../../../contribute.rst:11
|
|
msgid "Please see below for how to get started contributing to Jami!"
|
|
msgstr ""
|
|
|
|
#: ../../../contribute.rst:18
|
|
msgid "Reporting bugs and issues"
|
|
msgstr ""
|
|
|
|
#: ../../../contribute.rst:20
|
|
msgid ""
|
|
"Please see the :doc:`user/bug-report-guide` for step-by-step instructions on"
|
|
" how to report bugs and issues you encounter in Jami."
|
|
msgstr ""
|
|
|
|
#: ../../../contribute.rst:24
|
|
msgid "Contributing code"
|
|
msgstr ""
|
|
|
|
#: ../../../contribute.rst:26 ../../../contribute.rst:31
|
|
msgid "TODO"
|
|
msgstr ""
|
|
|
|
#: ../../../contribute.rst:29
|
|
msgid "Packaging Jami"
|
|
msgstr ""
|
|
|
|
#: ../../../contribute.rst:34
|
|
msgid "Contributing to this documentation"
|
|
msgstr ""
|
|
|
|
#: ../../../contribute.rst:36
|
|
msgid ""
|
|
"Contributions to these docs are always welcome and appreciated, from small "
|
|
"corrections to whole new chapters."
|
|
msgstr ""
|
|
|
|
#: ../../../contribute.rst:39
|
|
msgid ""
|
|
"This page will walk through the steps to create a new page or submit a "
|
|
"correction. The patch review process is the same as :doc:`for any other "
|
|
"Jami project <how-to-submit-a-patch>`, so we will not explain every command."
|
|
msgstr ""
|
|
|
|
#: ../../../contribute.rst:44
|
|
msgid ""
|
|
"By contributing to this documentation, you agree to make your contributions "
|
|
"available under the :doc:`fdl`, Version 1.3 or any later version published "
|
|
"by the Free Software Foundation; with no Invariant Sections, no Front-Cover "
|
|
"Texts, and no Back-Cover Texts."
|
|
msgstr ""
|
|
|
|
#: ../../../contribute.rst:50
|
|
msgid ""
|
|
"You are also promising that you are the author of your changes, or that you "
|
|
"copied them from a work in the public domain or a work released under a free"
|
|
" license that is compatible with the :doc:`fdl`. DO NOT SUBMIT COPYRIGHTED "
|
|
"WORK WITHOUT PERMISSION."
|
|
msgstr ""
|
|
|
|
#: ../../../contribute.rst:56
|
|
msgid "**TODO: internationalization**"
|
|
msgstr ""
|
|
|
|
#: ../../../contribute.rst:59
|
|
msgid "Dependencies"
|
|
msgstr ""
|
|
|
|
#: ../../../contribute.rst:61
|
|
msgid ""
|
|
"You will need Git installed and configured to use your SSH keypair, and an "
|
|
"account on the `Jami Gerrit <https://review.jami.net>`_, where you would "
|
|
"send your patches for review. If you need help with this, see :doc:`the "
|
|
"beginning of our patch submission guide <how-to-submit-a-patch>` (TODO)."
|
|
msgstr ""
|
|
|
|
#: ../../../contribute.rst:67
|
|
msgid ""
|
|
"If you want to preview your changes locally in your web browser, you need to"
|
|
" install `Sphinx <https://www.sphinx-doc.org>`_, the `Read the Docs Sphinx "
|
|
"theme <https://sphinx-rtd-theme.readthedocs.io/en/stable/>`_, and the `MyST "
|
|
"Markdown parser <https://myst-parser.readthedocs.io/en/latest/index.html>`_."
|
|
msgstr ""
|
|
|
|
#: ../../../contribute.rst:78
|
|
msgid ""
|
|
"If you want to use the auto-build and auto-refresh feature, also install "
|
|
"`sphinx-autobuild <https://github.com/executablebooks/sphinx-autobuild>`_."
|
|
msgstr ""
|
|
|
|
#: ../../../contribute.rst:86
|
|
msgid "Cloning the repository"
|
|
msgstr ""
|
|
|
|
#: ../../../contribute.rst:88
|
|
msgid "Clone the repository and configure the push settings like this:"
|
|
msgstr ""
|
|
|
|
#: ../../../contribute.rst:96
|
|
msgid ""
|
|
"You may want to checkout a new branch for each contribution/change before "
|
|
"you make any change to the files, so that you could easily ``git pull`` any "
|
|
"future changes from upstream into your main local branch:"
|
|
msgstr ""
|
|
|
|
#: ../../../contribute.rst:106
|
|
msgid "Editing a page"
|
|
msgstr ""
|
|
|
|
#: ../../../contribute.rst:108
|
|
msgid ""
|
|
"Pages are written in either markdown or `reStructuredText "
|
|
"<https://www.sphinx-doc.org/en/master/usage/restructuredtext/basics.html>`_."
|
|
" You can click \"View page source\" at the top of any page to open the raw "
|
|
"source of the page and see how it was written."
|
|
msgstr ""
|
|
|
|
#: ../../../contribute.rst:113
|
|
msgid "Go ahead and make your changes to the ``.rst`` or ``.md`` files."
|
|
msgstr ""
|
|
|
|
#: ../../../contribute.rst:116
|
|
msgid "Previewing your work"
|
|
msgstr ""
|
|
|
|
#: ../../../contribute.rst:118
|
|
msgid "From the base of the repository, run:"
|
|
msgstr ""
|
|
|
|
#: ../../../contribute.rst:124
|
|
msgid ""
|
|
"You should now be able to view the documentation in your web browser. The "
|
|
"homepage is at ``_build/html/index.html``."
|
|
msgstr ""
|
|
|
|
#: ../../../contribute.rst:127
|
|
msgid ""
|
|
"To automatically build the documentation and refresh your web browser "
|
|
"whenever you save changes, run:"
|
|
msgstr ""
|
|
|
|
#: ../../../contribute.rst:134
|
|
msgid ""
|
|
"Keep this running in the background, then navigate to http://127.0.0.1:8000 "
|
|
"(*not* the local .html file)."
|
|
msgstr ""
|
|
|
|
#: ../../../contribute.rst:138
|
|
msgid "Saving your work"
|
|
msgstr ""
|
|
|
|
#: ../../../contribute.rst:145
|
|
msgid "Your commit message should look something like this:"
|
|
msgstr ""
|
|
|
|
#: ../../../contribute.rst:155
|
|
msgid "For example:"
|
|
msgstr ""
|
|
|
|
#: ../../../contribute.rst:168
|
|
msgid "Submitting a change"
|
|
msgstr ""
|
|
|
|
#: ../../../contribute.rst:170
|
|
msgid ""
|
|
"The first time you try to push your changes, Gerrit will complain that you "
|
|
"don't have a Change-Id in your commit, and provide an ``scp`` command to "
|
|
"install the commit hook. After running the command, you should be able to "
|
|
"recommit and push your change:"
|
|
msgstr ""
|
|
|
|
#: ../../../contribute.rst:182
|
|
msgid "Modifying your work"
|
|
msgstr ""
|
|
|
|
#: ../../../contribute.rst:184
|
|
msgid ""
|
|
"A reviewer may ask you to make changes to your patch before merging it. "
|
|
"This is no problem! Simply make the changes, ``git add`` them, and run "
|
|
"``git commit --amend`` to modify the patch. Note the ``--amend`` switch, "
|
|
"which is needed to tell git to *amend*/tweak the existing newest commit "
|
|
"rather than making a new commit. This is the workflow for updating a "
|
|
"proposed change when using Gerrit."
|
|
msgstr ""
|
|
|
|
#: ../../../contribute.rst:192
|
|
msgid "Adding a page"
|
|
msgstr ""
|
|
|
|
#: ../../../contribute.rst:194
|
|
msgid ""
|
|
"If you decide to add a whole new page to the documentation, you must also "
|
|
"add it to the ``toctree`` directive of that chapter."
|
|
msgstr ""
|
|
|
|
#: ../../../contribute.rst:197
|
|
msgid ""
|
|
"For instance, if you added a new page called ``hosting-jams-on-aws-"
|
|
"guide.md`` to the Jami user manual in the ``user`` folder, you should add it"
|
|
" in the ``toctree`` directive of ``user/index.rst``, *without* the file "
|
|
"extension:"
|
|
msgstr ""
|