Merge branch 'master' into fix/admin/ai/llm2-stt_whisper2-no-gpu

Signed-off-by: Marcel Klehr <mklehr@gmx.net>

.github/workflows/block-merge-eol.yml

@@ -26,15 +26,15 @@ jobs:
     runs-on: ubuntu-latest-low
 
     steps:
-      - name: Download updater config
-        run: curl https://raw.githubusercontent.com/nextcloud/updater_server/production/config/config.php --output config.php
-
       - name: Set server major version environment
         run: |
           # retrieve version number from branch reference
           server_major=$(echo "${{ github.base_ref }}" | sed -En 's/stable//p')
           echo "server_major=$server_major" >> $GITHUB_ENV
+          echo "current_month=$(date +%Y-%m)" >> $GITHUB_ENV
 
       - name: Checking if ${{ env.server_major }} is EOL
         run: |
-          php -r 'echo json_encode(require_once "config.php");' | jq --arg version "${{ env.server_major }}" '.stable[$version]["100"].eol // .beta[$version]["100"].eol // "NotEOL"' | grep -q "NotEOL"
+          curl -s https://raw.githubusercontent.com/nextcloud-releases/updater_server/production/config/major_versions.json \
+            | jq '.["${{ env.server_major }}"]["eol"] // "9999-99" | . >= "${{ env.current_month }}"' \
+            | grep -q true

README.rst

@@ -109,14 +109,14 @@ Building
 Nightly Automated Build Steps
 =============================
 
-1. **Fetch sources**
-2. ``git clone https://github.com/nextcloud/documentation.git``
-3. ``cd documentation``
-4. ``git checkout <branch name>``
-5. **Install**
-6. ``npm install svgexport -g --unsafe-perm=true``
-7. ``pip3 install -r requirements.txt``
-8. ``make all``
+1.  **Fetch sources**
+   1.  ``git clone https://github.com/nextcloud/documentation.git``
+   2.  ``cd documentation``
+   3.  ``git checkout <branch name>``
+2.  **Install**
+   1.  ``npm install svgexport -g --unsafe-perm=true``
+   2.  ``pip3 install -r requirements.txt``
+   3.  ``make all``
 
 
 Building HTML

admin_manual/ai/app_assistant.rst

@@ -78,3 +78,83 @@ Context Chat
 In order to make use of our special Context Chat feature, offering in-context insights about your own data stored in Nextcloud, you will need the following apps:
 
 * :ref:`context_chat + context_chat_backend<ai-app-context_chat>` -  (Customer support available upon request)
+
+
+Configuration
+-------------
+
+The Assistant admin settings can be found under the "Artificial intelligence" section.
+You can disable the assistant top menu entry there. You can also disable the AI-related smart pickers.
+The occ commands to change the options are listed below.
+
+Assistant configuration
+~~~~~~~~~~~~~~~~~~~~~~~
+
+1. Top-right Assistant
+
+.. code-block::
+
+   occ config:app:set assistant assistant_enabled --value=1 --type=integer
+
+To enable/disable the assistant button from the top-right corner for all the users.
+
+2. AI text generation smart picker
+
+.. code-block::
+
+   occ config:app:set assistant free_prompt_picker_enabled --value=1 --type=integer
+
+To enable/disable the AI text generation smart picker for all the users.
+
+3. Text-to-image smart picker
+
+.. code-block::
+
+   occ config:app:set assistant text_to_image_picker_enabled --value=1 --type=integer
+
+To enable/disable the text-to-image smart picker for all the users.
+
+4. Speech-to-text smart picker
+
+.. code-block::
+
+   occ config:app:set assistant speech_to_text_picker_enabled --value=1 --type=integer
+
+To enable/disable the speech-to-text smart picker for all the users.
+
+Image storage
+~~~~~~~~~~~~~
+
+Days until generated images are deleted if they are not viewed.
+
+.. code-block::
+
+   occ config:app:set assistant max_image_generation_idle_time --value=90 --type=integer
+
+Chat with AI
+~~~~~~~~~~~~
+
+1. Chat User Instructions for Chat Completions
+
+.. code-block::
+
+   occ config:app:set assistant chat_user_instructions --value="hello world"
+
+The user instructions that are prepended before the chat messages for the AI model to understand the context of the block of text. This is a good place not only to instruct the AI model to be polite and kind but also to for example answer all the queries in a particular language or better yet, follow the user's language. The sky is the limit.
+
+2. Chat User Instructions for Title Generation
+
+.. code-block::
+
+   occ config:app:set assistant chat_user_instructions_title --value="hello title"
+
+This field is appended to the block of chat messages, i.e. attached after the messages. It is done this way to allow it to be used even with text completion models which could have the instructions as "The title for the above conversation could be \"".
+
+3. Last N messages to consider for chat completions
+
+.. code-block::
+
+   occ config:app:set assistant chat_last_n_messages --value=10
+
+The number of latest messages to consider for generating the next message. This does not include the user instructions, which is always considered in addition to this. This value should be adjusted in case you are hitting the token limit in your conversations too often.
+The AI text generation provider should ideally handle the max token limit case.

admin_manual/ai/app_context_chat.rst

@@ -13,6 +13,8 @@ Together they provide the ContextChat text processing tasks accessible via the :
 
 The *context_chat* and *context_chat_backend* apps run only open source models and do so entirely on-premises. Nextcloud can provide customer support upon request, please talk to your account manager for the possibilities.
 
+This app supports input and output in languages other than English if the language model supports the language.
+
 Requirements
 ------------
 
@@ -71,6 +73,7 @@ Nextcloud customers should file bugs directly with our Customer Support.
 Known Limitations
 -----------------
 
+* The underlying language model used by Context Chat cannot be changed
 * We currently only support the English language
 * Language models are likely to generate false information and should thus only be used in situations that are not critical. It's recommended to only use AI at the beginning of a creation process and not at the end, so that outputs of AI serve as a draft for example and not as final product. Always check the output of language models before using it.
 * Make sure to test this app for whether it meets your use-case's quality requirements

admin_manual/ai/app_llm2.rst

@@ -4,17 +4,19 @@ App: Local large language model (llm2)
 
 .. _ai-app-llm2:
 
-The *llm2* app is one of the apps that provide text processing functionality using Large language models in Nextcloud and act as a text processing backend for the :ref:`Nextcloud Assistant app<ai-app-assistant>`, the *mail* app and :ref:`other apps making use of the core Translation API<tp-consumer-apps>`. The *llm2* app specifically runs only open source models and does so entirely on-premises. Nextcloud can provide customer support upon request, please talk to your account manager for the possibilities.
+The *llm2* app is one of the apps that provide text processing functionality using Large language models in Nextcloud and act as a text processing backend for the :ref:`Nextcloud Assistant app<ai-app-assistant>`, the *mail* app and :ref:`other apps making use of the core Text Processing API<tp-consumer-apps>`. The *llm2* app specifically runs only open source models and does so entirely on-premises. Nextcloud can provide customer support upon request, please talk to your account manager for the possibilities.
 
 This app uses `ctransformers <https://github.com/marella/ctransformers>`_ under the hood and is thus compatible with any model in *gguf* format. Output quality will differ depending on which model you use, we recommend the following models:
 
-* `Llama2 7b Chat <https://huggingface.co/TheBloke/Llama-2-7B-Chat-GGUF>`_ (Slightly older; good quality; good acclaim)
-* `NeuralBeagle14 7B <https://huggingface.co/mlabonne/NeuralBeagle14-7B-GGUF>`_ (Newer; good quality; less well known)
+* `Llama3 8b Instruct <https://huggingface.co/QuantFactory/Meta-Llama-3-8B-Instruct-GGUF>`_ (reasonable quality; fast; good acclaim; multilingual output may not be optimal)
+* `Llama3 70B Instruct <https://huggingface.co/QuantFactory/Meta-Llama-3-70B-Instruct-GGUF>`_ (good quality; good acclaim; good multilingual output)
+
+This app supports input and output in languages other than English if the underlying model supports the language.
 
 Requirements
 ------------
 
-* This app is built as an External App and thus depends on AppAPI v2.3.0
+* This app is built as an External App and thus depends on AppAPI v2.3.0 or higher
 * Nextcloud AIO is supported
 * Using GPU is currently not supported
 
@@ -60,7 +62,8 @@ Nextcloud customers should file bugs directly with our Support system.
 Known Limitations
 -----------------
 
-* We currently only support the English language
+* We currently only support languages that the underlying model supports; correctness of language use in languages other than English may be poor depending on the language's coverage in the model's training data (We recommended model Llama 3 or other models explicitly trained on multiple languages)
+* Language models can be bad at reasoning tasks
 * Language models are likely to generate false information and should thus only be used in situations that are not critical. It's recommended to only use AI at the beginning of a creation process and not at the end, so that outputs of AI serve as a draft for example and not as final product. Always check the output of language models before using it.
 * Make sure to test the language model you are using it for whether it meets the use-case's quality requirements
 * Language models notoriously have a high energy consumption, if you want to reduce load on your server you can choose smaller models or quantized models in excahnge for lower accuracy

admin_manual/ai/app_stt_whisper2.rst

@@ -6,10 +6,12 @@ App: Local Whisper Speech-To-Text (stt_whisper2)
 
 The *stt_whisper2* app is one of the apps that provide Speech-To-Text functionality in Nextcloud and act as a media transcription backend for the :ref:`Nextcloud Assistant app<ai-app-assistant>`, the *talk* app and :ref:`other apps making use of the core Translation API<stt-consumer-apps>`. The *stt_whisper2* app specifically runs only open source models and does so entirely on-premises. Nextcloud can provide customer support upon request, please talk to your account manager for the possibilities.
 
+This app supports input and output in languages other than English if the underlying model supports the language.
+
 This app uses `faster-whisper <https://github.com/SYSTRAN/faster-whisper>`_ under the hood. Output quality will differ depending on which model you use, we recommend the following models:
 
- * OpenAI Whisper large-v2 or v3
- * OpenAI Whisper medium.en
+ * OpenAI Whisper large-v2 or v3 (multilingual)
+ * OpenAI Whisper medium.en (English only)
 
 Requirements
 ------------
@@ -34,7 +36,7 @@ Installation
 Supplying alternate models
 ~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-This app allows supplying alternate LLM models as *gguf* files in the ``/nc_app_llm2_data`` directory of the docker container. You can use any `*faster-whisper* model by Systran on hugging face <https://huggingface.co/Systran>`_ by simply
+This app allows supplying alternate models in the ``/nc_app_llm2_data`` directory of the docker container. You can use any `*faster-whisper* model by Systran on hugging face <https://huggingface.co/Systran>`_ in the following way:
 
 1. git cloning the respective repository
 2. Copying the folder with the git repository to ``/nc_app_llm2_data`` inside the docker container.

admin_manual/ai/overview.rst

@@ -164,3 +164,15 @@ Backend apps
 ~~~~~~~~~~~~
 
 * :ref:`context_chat + context_chat_backend<ai-app-context_chat>` -  (Customer support available upon request)
+
+
+Frequently Asked Questions
+--------------------------
+
+Why is my prompt slow?
+^^^^^^^^^^^^^^^^^^^^^^
+
+Reasons for slow performance from a user perspective can be
+
+ * Using CPU processing instead of GPU (sometimes this limit is imposed by the used app)
+ * High user demand for the feature: User prompts and AI tasks are usually processed in the order they are received, which can cause delays when a lot of users access these features at the same time.

admin_manual/configuration_server/bruteforce_configuration.rst

@@ -121,22 +121,31 @@ Troubleshooting
 Overview
 ~~~~~~~~
 
-On most setups Nextcloud will work out of the box without any issues. If you
-run into a situation where logging in or connecting is often very slow for multiple users, the first
-step is to check your Nextcloud Server logs to see what IP addresses are being detected (you may need 
-adjust your logging to INFO level temporarily to do so). 
+On most setups Nextcloud will work out of the box without any issues. If you run into a situation where 
+logging in or connecting is often very slow for multiple users, the first step is to check your Nextcloud 
+Server logs to see what IP addresses are being detected (you will need to adjust your ``loglevel`` to ``1`` 
+temporarily to do so).
+
+Look for entries that start with any of the following:
+
+- `Bruteforce attempt from` [...]
+- `IP address throttled` [...]
+- `IP address blocked` [...]
 
 If all clients appear to be coming from the same IP address and that IP address happens to be your 
-proxy, you need to review your ``trusted_proxies`` configuration. If it is a common connection point,
-such as a multi-user office location, it is possible whitelisting is appropriate.
+proxy, you need to review your ``trusted_proxies`` configuration. 
+
+If the IP address is a common connection point, such as a multi-user office location, it can be an option to whitelist it,
+with the draw back that users have to be trust-worthy.
 
 For testing purposes you want want to whitelist your own IP address to see if the problem disappears.
 If it does - and assuming your proxy configuration is correct - you may have a client/device in your
 network that is misbehaving and generating invalid login attempts from your IP address.
 
-For detailed troubleshooting, you may wish to inspect the `bruteforce_attempts` database table. There 
-you can see which IP addresses are throttled and any other metadata stored about their attempts to 
-connect.
+You can use the `occ security:bruteforce:attempts` command to check the realtime status for a given IP address. 
+
+.. note:: The `bruteforce_attempts` database table will be empty if you're using a distributed memory 
+  cache since the database backend is no longer used unless it is the only option available.
 
 Excluding IP addresses from brute force protection
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

admin_manual/configuration_server/text_configuration.rst

@@ -30,3 +30,13 @@ Rich text editing can be turned off globally to always open markdown files in th
 ::
 
  occ config:app:set text rich_editing_enabled --value=0
+
+
+ File encodings
+ --------------
+
+ Text can automatically detect encodings of files and will convert them to UTF-8 when saving. Due to the variety of encodings, not all of them can be detected, however you can configure a list of encodings and in which priority they should be detected using the php ``mbstring.detect_order`` setting in your php.ini:
+
+::
+
+    mbstring.detect_order         = ASCII,JIS,UTF-8,SJIS,EUC-JP

admin_manual/file_workflows/retention.rst

@@ -9,7 +9,7 @@ Example
 -------
 
 After installing the Retention app as described in :doc:`../apps_management`
-navigate to the configuration and locate the Workflow settings.
+navigate to Administration settings and then to Flow.
 
     .. figure:: images/retention_sample.png
        :alt: Sample rule to delete files after 14 days after creation.

admin_manual/installation/php_configuration.rst

@@ -44,7 +44,7 @@ Database connectors (pick the one for your database):
 
 * PHP module intl (increases language translation performance and fixes sorting
   of non-ASCII characters)
-* PHP module sodium (for Argon2 for password hashing. bcrypt is used as fallback, but if passwords were hashed with Argon2 already and the module is missing, your users can't log in.)
+* PHP module sodium (for Argon2 for password hashing. bcrypt is used as fallback, but if passwords were hashed with Argon2 already and the module is missing, your users can't log in. Included with PHP >= 7.2)
 
 Required for specific apps:
 

admin_manual/release_notes/upgrade_to_28.rst

@@ -12,6 +12,11 @@ Web server configuration
 ------------------------
 
 * The recommended :ref:`nginx configuration<nginx-config>` changed as Nextcloud Talk now serves audio files with ``.ogg`` / ``.flac`` extension, make sure to add these extensions to the list of static files.
+* As some core app now make use of JavaScript modules, make sure your web server is not rewriting requests to ``.mjs`` files, but serves them with ``text/javascript`` MIME type and proper ``Cache-Control`` header, like ``.js`` and other static file extensions.
+
+  * When using Apache with ``.htaccess`` configuration, this will be done automatically.
+  * For Nginx, please refer to our recommended :ref:`Nginx configuration<nginx-config>`.
+  * For other setups, make sure to add ``.mjs`` to the list of static file extensions in web server configs and in case define its MIME type in ``/etc/mime.types``.
 
 Monitoring
 ----------

admin_manual/release_notes/upgrade_to_30.rst

@@ -7,3 +7,4 @@ System requirements
 
 * PHP 8.1 is now deprecated but still supported.
 * PHP 8.0 is no longer supported.
+* PostgreSQL 9.4 is no longer supported.

developer_manual/client_apis/OCS/ocs-openapi.rst

@@ -185,10 +185,10 @@ If you are working with an existing API where you can not break compatibility, y
             return DataResponse([]);
         }
 
-DO NOT throw exceptions
-^^^^^^^^^^^^^^^^^^^^^^^
+DO NOT throw non-OCS*Exceptions
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-Return valid responses with an error message instead.
+Only use OCS*Exceptions as any other Exceptions do not produce JSON responses.
 
 .. collapse:: Examples
 
@@ -196,22 +196,22 @@ Return valid responses with an error message instead.
         :caption: Bad
 
         /**
-         * @throws OCSBadRequestException
+         * @throws BadRequestException
          */
         public function someControllerMethod() {
             ...
-            throw new OCSBadRequestException("some message");
+            throw new BadRequestException([]);
         }
 
     .. code-block:: php
         :caption: Good
 
         /**
-         * @return DataResponse<Http::STATUS_BAD_REQUEST, array{message: string}, array{}>
+         * @throws OCSBadRequestException
          */
         public function someControllerMethod() {
             ...
-            return DataResponse(["message" => "some message"], Http::STATUS_BAD_REQUEST);
+            throw new OCSBadRequestException("some message");
         }
 
 DO use the same data structures for the same group of responses
@@ -643,7 +643,6 @@ How to handle exceptions
 ------------------------
 
 Sometimes you want to end with an exception instead of returning a response.
-It is better to not do it, but when migrating existing APIs you might have to deal with exceptions.
 For this example our ``update`` will throw an exception when the ETag does not match:
 
 .. code-block:: php
@@ -673,8 +672,7 @@ Adding the correct annotation works like this:
     }
 
 The description after the exception class name works exactly like the description for the status codes we added earlier.
-Note that the resulting response will be in plain text and no longer in JSON.
-Therefore it is not recommended to use exceptions to return errors.
+Note that you should only used OCS*Exceptions, as any other Exception will result in a plain text body instead of JSON.
 
 How to ignore certain endpoints
 -------------------------------

developer_manual/design/foundations.rst

@@ -160,9 +160,9 @@ Icons
 .. image:: ../images/material-icons.png
    :alt: Material icons
 
-Icons can be used to communicate the intent of an action, or to provide visual interest to the screen. We use monochrome icons on all platforms: `Material Design icons (20 px default filled) <https://fonts.google.com/icons?icon.style=Filled&icon.set=Material+Icons>`_ for web, Android, Windows and Linux, and `SF Symbols (default weight, scale and variant) <https://developer.apple.com/sf-symbols/>`_ for iOS and macOS.
+Icons can be used to communicate the intent of an action, or to provide visual interest to the screen. We use monochrome icons on all platforms: `Material Symbols (not Material Icons, and 20 px default filled) <https://fonts.google.com/icons?icon.set=Material+Symbols&selected=Material+Symbols+Outlined:search:FILL@1;wght@400;GRAD@0;opsz@20&icon.size=20>`_ for web, Android, Windows and Linux, and `SF Symbols (default weight, scale and variant) <https://developer.apple.com/sf-symbols/>`_ for iOS and macOS.
 
-This is except for the icon of the app itself, which can be a custom icon.
+This is except for the icon of the app itself, which can be a custom icon. Most use an app icon from Material Symbols as well though to keep consistency.
 
 Make sure to:
 

user_manual/locale/zh_CN/LC_MESSAGES/files/quota.pot

@@ -1,20 +1,21 @@
 # SOME DESCRIPTIVE TITLE.
-# Copyright (C) 2021 Nextcloud GmbH
+# Copyright (C) 2023 Nextcloud GmbH
 # This file is distributed under the same license as the Nextcloud latest User Manual package.
 # FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
 # 
 # Translators:
 # 翌家人 <sbydpuww@gmail.com>, 2021
+# tea.tall, 2024
 # 
 #, fuzzy
 msgid ""
 msgstr ""
 "Project-Id-Version: Nextcloud latest User Manual latest\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2021-05-03 13:19+0000\n"
+"POT-Creation-Date: 2023-03-01 16:07+0000\n"
 "PO-Revision-Date: 2019-11-07 20:29+0000\n"
-"Last-Translator: 翌家人 <sbydpuww@gmail.com>, 2021\n"
-"Language-Team: Chinese (China) (https://www.transifex.com/nextcloud/teams/64236/zh_CN/)\n"
+"Last-Translator: tea.tall, 2024\n"
+"Language-Team: Chinese (China) (https://app.transifex.com/nextcloud/teams/64236/zh_CN/)\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
@@ -27,10 +28,10 @@ msgstr "存储配额"
 
 #: ../../files/quota.rst:5
 msgid ""
-"Your Nextcloud admin has the option to set a storage quota on users. Look at"
-" your the Personal page to see what your quota is, and how much you have "
-"used."
-msgstr "Nextcloud管理员可以选择为用户设置一个存储配额。查看您的个人页，看看您的配额是多少，以及您已经使用了多少。"
+"Your Nextcloud administrator has the option to set a storage quota on users."
+" Look at your the Personal page to see what your quota is, and how much you "
+"have used."
+msgstr "Nextcloud管理员可以设置用户可以使用的空间配额。请打开个人页面查看配额大小以及使用情况"
 
 #: ../../files/quota.rst:10
 msgid "It may be helpful to understand how your quota is calculated."
@@ -73,18 +74,21 @@ msgstr ""
 #: ../../files/quota.rst:31
 msgid ""
 "Your administrator may have configured the trash bin retention period to "
-"override the storage space management. See `admin documentation "
-"<https://docs.nextcloud.com/server/latest/admin_manual/configuration_server/config_sample_php_parameters.html"
-"#deleted-items-trash-bin>`_ for more details."
-msgstr "你的管理员可能已经配置了垃圾箱的保留期来覆盖存储空间管理。更多细节请参见“管理员文档 ”。"
+"override the storage space management. See `administrator documentation "
+"<https://docs.nextcloud.com/server/latest/admin_manual/configuration_server/config_sample_php_parameters.html#deleted-"
+"items-trash-bin>`_ for more details."
+msgstr ""
+"你的管理员可能已经配置了垃圾箱的保留期来覆盖存储空间管理。更多细节请参见`管理员文档 "
+"<https://docs.nextcloud.com/server/latest/admin_manual/configuration_server/config_sample_php_parameters.html#deleted-"
+"items-trash-bin>`_。"
 
-#: ../../files/quota.rst:34
+#: ../../files/quota.rst:36
 msgid ""
 "When version control is enabled, the older file versions are not counted "
 "against quotas."
 msgstr "当版本控制被启用时，旧的文件版本不会被计入配额。"
 
-#: ../../files/quota.rst:37
+#: ../../files/quota.rst:39
 msgid ""
 "If you create a public share via URL and allow uploads, any uploaded files "
 "count against your quota."

user_manual/locale/zh_CN/LC_MESSAGES/files/version_control.pot

@@ -0,0 +1,127 @@
+# SOME DESCRIPTIVE TITLE.
+# Copyright (C) 2023 Nextcloud GmbH
+# This file is distributed under the same license as the Nextcloud latest User Manual package.
+# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
+# 
+# Translators:
+# 禹隆 冯 <08172951@cumt.edu.cn>, 2023
+# Shiyun Zhu, 2024
+# 
+#, fuzzy
+msgid ""
+msgstr ""
+"Project-Id-Version: Nextcloud latest User Manual latest\n"
+"Report-Msgid-Bugs-To: \n"
+"POT-Creation-Date: 2023-04-17 10:07+0000\n"
+"PO-Revision-Date: 2019-11-07 20:29+0000\n"
+"Last-Translator: Shiyun Zhu, 2024\n"
+"Language-Team: Chinese (China) (https://app.transifex.com/nextcloud/teams/64236/zh_CN/)\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"Language: zh_CN\n"
+"Plural-Forms: nplurals=1; plural=0;\n"
+
+#: ../../files/version_control.rst:3
+msgid "Version control"
+msgstr "版本控制"
+
+#: ../../files/version_control.rst:5
+msgid ""
+"Nextcloud supports simple version control system for files. Versioning "
+"creates backups of files which are accessible via the Versions tab on the "
+"Details sidebar. This tab contains the history of the file where you can "
+"roll back a file to any previous version. Changes made at intervals greater "
+"than two minutes are saved in **data/[user]/files_versions**."
+msgstr ""
+"Nextcloud支持简单的文件版本控制系统。版本化创建文件的备份，这些文件可以通过详细信息侧边栏上的Versions选项卡访问。此选项卡包含文件的历史记录，您可以将文件回滚到任何以前的版本。每两分钟以上的修改保存在**data/[user]/files_versions**中。"
+
+#: ../../files/version_control.rst:13
+msgid ""
+"To restore a specific version of a file, click the circular arrow to the "
+"right. Click on the timestamp to download it."
+msgstr "若要恢复文件的特定版本，请单击右侧的圆形箭头。点击时间戳下载它。"
+
+#: ../../files/version_control.rst:16
+msgid ""
+"The versioning app expires old versions automatically to make sure that the "
+"user doesn't run out of space. This pattern is used to delete old versions:"
+msgstr "版本控制应用程序会自动过期旧版本，以确保用户不会耗尽空间。这种模式用于删除旧版本:"
+
+#: ../../files/version_control.rst:20
+msgid "For the first second we keep one version"
+msgstr "第一秒，我们保留一个版本"
+
+#: ../../files/version_control.rst:21
+msgid "For the first 10 seconds Nextcloud keeps one version every 2 seconds"
+msgstr "在前10秒内，Nextcloud每2秒保留一个版本"
+
+#: ../../files/version_control.rst:22
+msgid "For the first minute Nextcloud keeps one version every 10 seconds"
+msgstr "在第一分钟内，Nextcloud每10秒保存一个版本"
+
+#: ../../files/version_control.rst:23
+msgid "For the first hour Nextcloud keeps one version every minute"
+msgstr "在第一个小时内，Nextcloud每分钟保存一个版本"
+
+#: ../../files/version_control.rst:24
+msgid "For the first 24 hours Nextcloud keeps one version every hour"
+msgstr "在最初的24小时内，Nextcloud每小时保留一个版本"
+
+#: ../../files/version_control.rst:25
+msgid "For the first 30 days Nextcloud keeps one version every day"
+msgstr "在最初的30天里，Nextcloud每天保留一个版本"
+
+#: ../../files/version_control.rst:26
+msgid "After the first 30 days Nextcloud keeps one version every week"
+msgstr "在第一个30天之后，Nextcloud会每周保留一个版本"
+
+#: ../../files/version_control.rst:28
+msgid ""
+"The versions are adjusted along this pattern every time a new version gets "
+"created."
+msgstr "每次创建新版本时，版本号都会按照这个模式进行调整。"
+
+#: ../../files/version_control.rst:31
+msgid ""
+"The version app never uses more than 50% of the user's currently available "
+"free space. If the stored versions exceed this limit, Nextcloud deletes the "
+"oldest versions until it meets the disk space limit again."
+msgstr ""
+"版本应用程序从不使用超过50%的用户当前可用的空闲空间。如果存储的版本超过这个限制，Nextcloud会删除最旧的版本，直到再次满足磁盘空间限制。"
+
+#: ../../files/version_control.rst:37
+msgid "Naming a version"
+msgstr "命名一个版本"
+
+#: ../../files/version_control.rst:39
+msgid ""
+"Naming a version is currently not available when the group folders or S3 "
+"versioning apps are enabled."
+msgstr "当组文件夹或S3版本应用程序被启用时，命名版本目前是不可用的。"
+
+#: ../../files/version_control.rst:41
+msgid "You can give a name to a version."
+msgstr "你可以给一个版本命名"
+
+#: ../../files/version_control.rst:46
+msgid ""
+"When a version has a name, it will be excluded from the automatic expiration"
+" process."
+msgstr "当一个版本有一个名称时，它将被排除在自动过期过程之外。"
+
+#: ../../files/version_control.rst:49
+msgid "Deleting a version"
+msgstr "删除一个版本"
+
+#: ../../files/version_control.rst:51
+msgid ""
+"Deleting a version is currently not available when the group folders or S3 "
+"versioning apps are enabled."
+msgstr "当组文件夹或S3版本应用程序被启用时，删除版本目前是不可用的。"
+
+#: ../../files/version_control.rst:53
+msgid ""
+"You can also manually delete a version without waiting for the automatic "
+"expiration process."
+msgstr "您也可以手动删除版本，而无需等待自动过期过程。"