Skip to content

Commit

Permalink
docs: i18n
Browse files Browse the repository at this point in the history
  • Loading branch information
@dfguerrerom
dfguerrerom committed Aug 7, 2024
1 parent ec47d5e commit 155367d
Show file tree
Hide file tree
Showing 27 changed files with 4,464 additions and 1,234 deletions.
81 changes: 59 additions & 22 deletions docs/source/_locale/ar/LC_MESSAGES/cli/python.po
View file
Original file line number Diff line number Diff line change
@@ -1,22 +1,19 @@

msgid ""
msgstr ""
"Project-Id-Version: sepal-doc\n"
"Project-Id-Version: sepal-doc\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2024-03-07 09:39+0100\n"
"PO-Revision-Date: 2024-03-07 08:56\n"
"POT-Creation-Date: 2024-08-07 09:29+0200\n"
"PO-Revision-Date: 2024-03-07 08:56+0000\n"
"Last-Translator: \n"
"Language: ar_SA\n"
"Language-Team: Arabic\n"
"Plural-Forms: nplurals=6; plural=(n==0 ? 0 : n==1 ? 1 : n==2 ? 2 : "
"n%100>=3 && n%100<=10 ? 3 : n%100>=11 && n%100<=99 ? 4 : 5);\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Babel 2.14.0\n"
"Plural-Forms: nplurals=6; plural=(n==0 ? 0 : n==1 ? 1 : n==2 ? 2 : n%100>=3 && n%100<=10 ? 3 : n%100>=11 && n%100<=99 ? 4 : 5);\n"
"X-Crowdin-Project: sepal-doc\n"
"X-Crowdin-Project-ID: 562097\n"
"X-Crowdin-Language: ar\n"
"X-Crowdin-File: /main/docs/source/_locale/en/LC_MESSAGES/cli/python.po\n"
"X-Crowdin-File-ID: 55\n"
"Language: ar_SA\n"

#: ../../source/cli/python.rst:2
msgid "Python"
Expand All @@ -27,63 +24,94 @@ msgid "Usage"
msgstr ""

#: ../../source/cli/python.rst:7
msgid "SEPAL instances run on :code:`focal` Ubuntu machines and thus provide a fully functional :code:`Python 3.8` environment, which is accessible through Jupyter Notebook, JupyterLab or the terminal:"
msgid ""
"SEPAL instances run on :code:`focal` Ubuntu machines and thus provide a "
"fully functional :code:`Python 3.10.12` environment, which is accessible "
"through Jupyter Notebook, JupyterLab or the terminal:"
msgstr ""

#: ../../source/cli/python.rst:25
msgid "Description"
msgstr ""

#: ../../source/cli/python.rst:27
msgid "The SEPAL Python environment is not empty; there are numerous embedded libraries (see figure below)."
msgid ""
"The SEPAL Python environment is not empty; there are numerous embedded "
"libraries (see figure below)."
msgstr ""

#: ../../source/cli/python.rst:32
msgid "To check if it's already installed, run :code:`pip show <name of your lib>`."
msgid ""
"To check if it's already installed, run :code:`pip show <name of your "
"lib>`."
msgstr ""

#: ../../source/cli/python.rst:35
msgid "Customization"
msgstr ""

#: ../../source/cli/python.rst:37
msgid "The SEPAL environment can be customized to user needs using any third-party libraries and pip. By default, installation will be run in :code:`--user` mode and won't affect other SEPAL users."
msgid ""
"The SEPAL environment can be customized to user needs using any third-"
"party libraries and pip. By default, installation will be run in "
":code:`--user` mode and won't affect other SEPAL users."
msgstr ""

#: ../../source/cli/python.rst:44
msgid "If you face compatibility issues when customizing your SEPAL environment, let us know in the `Github issue tracker <https://github.com/openforis/sepal/issues/new/choose>`__."
msgid ""
"If you face compatibility issues when customizing your SEPAL environment,"
" let us know in the `Github issue tracker "
"<https://github.com/openforis/sepal/issues/new/choose>`__."
msgstr ""

#: ../../source/cli/python.rst:47
msgid "Virtual environment"
msgstr ""

#: ../../source/cli/python.rst:51
msgid "SEPAL does not support conda environments. If you need to install compiled libraries, contact the SEPAL team via the `GitHub issue tracker <https://github.com/openforis/sepal/issues/new/choose>`__."
msgid ""
"SEPAL does not support conda environments. If you need to install "
"compiled libraries, contact the SEPAL team via the `GitHub issue tracker"
" <https://github.com/openforis/sepal/issues/new/choose>`__."
msgstr ""

#: ../../source/cli/python.rst:53
msgid "SEPAL supports Python venv creation. In this section, we'll explain how to create a venv and link it to Jupyter, so you can run your processes on the associated kernel."
msgid ""
"SEPAL supports Python venv creation. In this section, we'll explain how "
"to create a venv and link it to Jupyter, so you can run your processes on"
" the associated kernel."
msgstr ""

#: ../../source/cli/python.rst:55
msgid "By design, Jupyter is running on the Python Kernel described in the previous section. You can also use the kernel associated with our applications (they start with :code:`venv`). If your work relies on very specific version numbers, it might be good to run everything in a dedicated environment."
msgid ""
"By design, Jupyter is running on the Python Kernel described in the "
"previous section. You can also use the kernel associated with our "
"applications (they start with :code:`venv`). If your work relies on very "
"specific version numbers, it might be good to run everything in a "
"dedicated environment."
msgstr ""

#: ../../source/cli/python.rst:57
msgid "If not existing, create a directory to host your virtual environments. From the root directory, run the following line:"
msgid ""
"If not existing, create a directory to host your virtual environments. "
"From the root directory, run the following line:"
msgstr ""

#: ../../source/cli/python.rst:63
msgid "Then, copy and paste the following lines in your terminal:"
msgstr ""

#: ../../source/cli/python.rst:74
msgid "Now, this venv will be available as a kernel inside your Jupyter workspace. It will be automatically removed if you destroy the venv directory."
msgid ""
"Now, this venv will be available as a kernel inside your Jupyter "
"workspace. It will be automatically removed if you destroy the venv "
"directory."
msgstr ""

#: ../../source/cli/python.rst:76
msgid "Note that if you want to install libs inside of this venv, you first need to activate it:"
msgid ""
"Note that if you want to install libs inside of this venv, you first need"
" to activate it:"
msgstr ""

#~ msgid ""
Expand Down Expand Up @@ -226,3 +254,12 @@ msgstr ""
#~ "<https://github.com/openforis/sepal/issues/new/choose>`__."
#~ msgstr ""

#~ msgid ""
#~ "SEPAL instances run on :code:`focal` "
#~ "Ubuntu machines and thus provide a "
#~ "fully functional :code:`Python 3.8` "
#~ "environment, which is accessible through "
#~ "Jupyter Notebook, JupyterLab or the "
#~ "terminal:"
#~ msgstr ""

163 changes: 123 additions & 40 deletions docs/source/_locale/ar/LC_MESSAGES/setup/resource.po
View file
Original file line number Diff line number Diff line change
@@ -1,22 +1,19 @@

msgid ""
msgstr ""
"Project-Id-Version: sepal-doc\n"
"Project-Id-Version: sepal-doc\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2024-03-07 09:39+0100\n"
"PO-Revision-Date: 2024-03-07 08:56\n"
"POT-Creation-Date: 2024-08-07 09:29+0200\n"
"PO-Revision-Date: 2024-03-07 08:56+0000\n"
"Last-Translator: \n"
"Language: ar_SA\n"
"Language-Team: Arabic\n"
"Plural-Forms: nplurals=6; plural=(n==0 ? 0 : n==1 ? 1 : n==2 ? 2 : "
"n%100>=3 && n%100<=10 ? 3 : n%100>=11 && n%100<=99 ? 4 : 5);\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Babel 2.14.0\n"
"Plural-Forms: nplurals=6; plural=(n==0 ? 0 : n==1 ? 1 : n==2 ? 2 : n%100>=3 && n%100<=10 ? 3 : n%100>=11 && n%100<=99 ? 4 : 5);\n"
"X-Crowdin-Project: sepal-doc\n"
"X-Crowdin-Project-ID: 562097\n"
"X-Crowdin-Language: ar\n"
"X-Crowdin-File: /main/docs/source/_locale/en/LC_MESSAGES/setup/resource.po\n"
"X-Crowdin-File-ID: 103\n"
"Language: ar_SA\n"

#: ../../source/setup/resource.rst:2
msgid "Manage your resources"
Expand All @@ -43,7 +40,12 @@ msgid "request resources"
msgstr ""

#: ../../source/setup/resource.rst:11
msgid "SEPAL provides free access to computation resources that are shared among registered users. To prevent exportation mistakes, new users are granted few resources that are sufficient for discovering the functionalities and running subregional analyses. By default, instances are closed automatically when they are not being used."
msgid ""
"SEPAL provides free access to computation resources that are shared among"
" registered users. To prevent exportation mistakes, new users are granted"
" few resources that are sufficient for discovering the functionalities "
"and running subregional analyses. By default, instances are closed "
"automatically when they are not being used."
msgstr ""

#: ../../source/setup/resource.rst:15
Expand All @@ -63,79 +65,152 @@ msgid "0 GB of storage"
msgstr ""

#: ../../source/setup/resource.rst:21
msgid "Some actions or projects may require more storage to perform analysis at the province or country level; other actions or projects may require more instances to perform heavier computation processes. If you need more storage or instances, you can submit a quota request to the SEPAL team by following the instructions below."
msgid ""
"Some actions or projects may require more storage to perform analysis at "
"the province or country level; other actions or projects may require more"
" instances to perform heavier computation processes. If you need more "
"storage or instances, you can submit a quota request to the SEPAL team by"
" following the instructions below."
msgstr ""

#: ../../source/setup/resource.rst:25
msgid "Since quota requests are reviewed on a case-by-case basis, response times may vary."
msgstr ""

#: ../../source/setup/resource.rst:28
msgid "User report"
msgid ""
"Since quota requests are reviewed on a case-by-case basis, response times"
" may vary."
msgstr ""

#: ../../source/setup/resource.rst:30
msgid "In **Terminal**, **Apps** or **Process**, select **User report** in the lower-right corner to see your current instance consumption: :btn:`<fa-solid fa-dollar-sign> x.xx/h`."
msgid "User report"
msgstr ""

#: ../../source/setup/resource.rst:47
msgid "After selecting this button, the **Resource management** pop-up window will appear, displaying the current consumption of all your **Resources** – expressed in percentages (see **1** in figure below) (a full bar indicates that you have reached one of your monthly quotas) – as well as **Instances** that are currently running (**2**)."
#: ../../source/setup/resource.rst:32
msgid ""
"In **Terminal**, **Apps** or **Process**, select **User report** in the "
"lower-right corner to see your current instance consumption: :btn:`<fa-"
"solid fa-dollar-sign> x.xx/h`."
msgstr ""

#: ../../source/setup/resource.rst:49
msgid "You can request additional resources by selecting the green button."
msgid ""
"After selecting this button, the **Resource management** pop-up window "
"will appear, displaying the current consumption of all your **Resources**"
" – expressed in percentages (see **1** in figure below) (a full bar "
"indicates that you have reached one of your monthly quotas) – as well as "
"**Instances** that are currently running (**2**)."
msgstr ""

#: ../../source/setup/resource.rst:56
msgid "Manage instances"
#: ../../source/setup/resource.rst:51
msgid "You can request additional resources by selecting the green button."
msgstr ""

#: ../../source/setup/resource.rst:58
msgid "Amazon Web Services (AWS) instances can be managed from this interface as well."
msgid "Manage instances"
msgstr ""

#: ../../source/setup/resource.rst:60
msgid "In the **User report** pop-up window, each line represents a different instance, where you can see their technical features and hourly quota consumption."
msgid ""
"Amazon Web Services (AWS) instances can be managed from this interface as"
" well."
msgstr ""

#: ../../source/setup/resource.rst:62
msgid "You can select the **Trashcan** icon to stop an instance."
msgid ""
"In the **User report** pop-up window, each line represents a different "
"instance, where you can see their technical features and hourly quota "
"consumption."
msgstr ""

#: ../../source/setup/resource.rst:68
msgid "If the process you launched is a long computation (e.g. the **BFAST application** or any **Change detection algorithm**) and you want to close the SEPAL window, you can run the process in the background."
#: ../../source/setup/resource.rst:64
msgid "You can select the **Trashcan** icon to stop an instance."
msgstr ""

#: ../../source/setup/resource.rst:70
msgid "Select **Edit** to open the **Instance** pop-up window, where the slider bar displays the amount of time remaining before your instance will be shut down. Increase this value for the estimated duration of your process and you can then safely close the SEPAL browser tab."
msgid ""
"If the process you launched is a long computation (e.g. the **BFAST "
"application** or any **Change detection algorithm**) and you want to "
"close the SEPAL window, you can run the process in the background."
msgstr ""

#: ../../source/setup/resource.rst:72
msgid ""
"Select **Edit** to open the **Instance** pop-up window, where the slider "
"bar displays the amount of time remaining before your instance will be "
"shut down. Increase this value for the estimated duration of your process"
" and you can then safely close the SEPAL browser tab."
msgstr ""

#: ../../source/setup/resource.rst:75
msgid "Extending Your Instance Duration"
msgstr ""

#: ../../source/setup/resource.rst:74
msgid "If you increase the lifespan of your instance, it will continue to consume your quota. Check regularly that your process is running effectively to avoid losing resources."
#: ../../source/setup/resource.rst:77
msgid ""
"To optimize your resources, your instance may shut down depending on its "
"type. To extend the duration of your instance in a single session, follow"
" these steps:"
msgstr ""

#: ../../source/setup/resource.rst:79
msgid ""
"Access the Instance Management Panel: Click the :ref:`user-report` button"
" :btn:`<fa-solid fa-dollar-sign> x.xx/h`."
msgstr ""

#: ../../source/setup/resource.rst:80
msgid ""
"Modify Instance Settings: Click the Edit button :btn:`<fa-solid fa-pen-"
"to-square>` in the panel to open the Instance configuration pop-up."
msgstr ""

#: ../../source/setup/resource.rst:81
msgid "Request resources"
msgid ""
"Adjust the Lifespan: Use the slider in the pop-up to set the desired "
"duration for your instance."
msgstr ""

#: ../../source/setup/resource.rst:83
msgid ""
"By adjusting the slider, you can extend the active time of your instance "
"to suit your session needs."
msgstr ""

#: ../../source/setup/resource.rst:91
msgid ""
"Do not forget to close the instance when you are done with your analysis "
"to avoid unnecessary consumption of resources."
msgstr ""

#: ../../source/setup/resource.rst:94
msgid "Request resources"
msgstr ""

#: ../../source/setup/resource.rst:96
msgid "From the **Resource manager**, select **Request additional resources**."
msgstr ""

#: ../../source/setup/resource.rst:85
#: ../../source/setup/resource.rst:98
msgid "In order for your request to be considered, you must:"
msgstr ""

#: ../../source/setup/resource.rst:87
msgid "change the quota to values that meet your needs (e.g. more storage and fewer instances; the values entered are suggestions that the administrator will be able to change, if needed [**1**]); and"
#: ../../source/setup/resource.rst:100
msgid ""
"change the quota to values that meet your needs (e.g. more storage and "
"fewer instances; the values entered are suggestions that the "
"administrator will be able to change, if needed [**1**]); and"
msgstr ""

#: ../../source/setup/resource.rst:88
msgid "provide an extensive explanation for why you need these resources, as well as the project name, the type of analysis and the area of interest (AOI) (**2**)."
#: ../../source/setup/resource.rst:101
msgid ""
"provide an extensive explanation for why you need these resources, as "
"well as the project name, the type of analysis and the area of interest "
"(AOI) (**2**)."
msgstr ""

#: ../../source/setup/resource.rst:94
msgid "Once validated, the request is sent to the SEPAL team, who will take measures in the coming days to update your profile, which may include contacting you directly if they need any extra details."
#: ../../source/setup/resource.rst:107
msgid ""
"Once validated, the request is sent to the SEPAL team, who will take "
"measures in the coming days to update your profile, which may include "
"contacting you directly if they need any extra details."
msgstr ""

#~ msgid ""
Expand Down Expand Up @@ -249,3 +324,11 @@ msgstr ""
#~ "interest (AOI). (2)"
#~ msgstr ""

#~ msgid ""
#~ "If you increase the lifespan of "
#~ "your instance, it will continue to "
#~ "consume your quota. Check regularly that"
#~ " your process is running effectively "
#~ "to avoid losing resources."
#~ msgstr ""

Loading

0 comments on commit 155367d

Please sign in to comment.