diff --git a/manual/api/authentication.md b/manual/api/authentication.md index cd6c93d..ba5b49d 100644 --- a/manual/api/authentication.md +++ b/manual/api/authentication.md @@ -23,7 +23,7 @@ set ZINC_FIRST_ADMIN_USER=admin set ZINC_FIRST_ADMIN_PASSWORD=Complexpass#123 ``` !!! tip -In most scenarios, you can use the administrator account to provide access for applications. Only when you need to integrate multiple applications with different permissions, you should create regular users. + In most scenarios, you can use the administrator account to provide access for applications. Only when you need to integrate multiple applications with different permissions, you should create regular users. ## Regular Users diff --git a/manual/api/document_operation.md b/manual/api/document_operation.md index e0f89bb..52f259f 100644 --- a/manual/api/document_operation.md +++ b/manual/api/document_operation.md @@ -2,7 +2,7 @@ An index stores multiple documents. Users can perform CRUD operations (Create, Read, Update, Delete) on documents via the API. In SeaSearch, each document has a unique ID. !!! tip -Due to architectural design, SeaSearch’s performance for single document CRUD operations is much lower than that of ElasticSearch. Therefore, we recommend using batch operations whenever possible. + Due to architectural design, SeaSearch’s performance for single document CRUD operations is much lower than that of ElasticSearch. Therefore, we recommend using batch operations whenever possible. ElasticSearch Document APIs contain many additional parameters that are not meaningful to SeaSearch and are not supported. All query parameters are unsupported. diff --git a/manual/config/README.md b/manual/config/README.md index de5cc59..2de0d17 100644 --- a/manual/config/README.md +++ b/manual/config/README.md @@ -40,67 +40,67 @@ These configurations are only effective when `SS_STORAGE_TYPE=s3`. ### Enabling S3 as Storage Backend === "AWS" -``` sh - ZINC_FIRST_ADMIN_USER=admin - ZINC_FIRST_ADMIN_PASSWORD=password - SS_DATA_PATH=./data - SS_STORAGE_TYPE=s3 - SS_S3_ACCESS_ID= - SS_S3_ACCESS_SECRET= - SS_S3_BUCKET= - SS_S3_REGION=us-east-1 - SS_S3_USE_HTTPS=true - SS_S3_USE_V4_SIGNATURE=true -``` + ``` sh + ZINC_FIRST_ADMIN_USER=admin + ZINC_FIRST_ADMIN_PASSWORD=password + SS_DATA_PATH=./data + SS_STORAGE_TYPE=s3 + SS_S3_ACCESS_ID= + SS_S3_ACCESS_SECRET= + SS_S3_BUCKET= + SS_S3_REGION=us-east-1 + SS_S3_USE_HTTPS=true + SS_S3_USE_V4_SIGNATURE=true + ``` === "Exoscale" -``` sh - ZINC_FIRST_ADMIN_USER=admin - ZINC_FIRST_ADMIN_PASSWORD=password - SS_DATA_PATH=./data - SS_STORAGE_TYPE=s3 - SS_S3_ACCESS_ID= - SS_S3_ACCESS_SECRET= - SS_S3_BUCKET= - SS_S3_ENDPOINT=sos-de-fra-1.exo.io - SS_S3_PATH_STYLE_REQUEST=true -``` + ``` sh + ZINC_FIRST_ADMIN_USER=admin + ZINC_FIRST_ADMIN_PASSWORD=password + SS_DATA_PATH=./data + SS_STORAGE_TYPE=s3 + SS_S3_ACCESS_ID= + SS_S3_ACCESS_SECRET= + SS_S3_BUCKET= + SS_S3_ENDPOINT=sos-de-fra-1.exo.io + SS_S3_PATH_STYLE_REQUEST=true + ``` === "Hetzner" -``` sh - ZINC_FIRST_ADMIN_USER=admin - ZINC_FIRST_ADMIN_PASSWORD=password - SS_DATA_PATH=./data - SS_STORAGE_TYPE=s3 - SS_S3_ACCESS_ID= - SS_S3_ACCESS_SECRET= - SS_S3_BUCKET= - SS_S3_ENDPOINT=fsn1.your-objectstorage.com - SS_S3_PATH_STYLE_REQUEST=true - SS_S3_USE_HTTPS=true -``` + ``` sh + ZINC_FIRST_ADMIN_USER=admin + ZINC_FIRST_ADMIN_PASSWORD=password + SS_DATA_PATH=./data + SS_STORAGE_TYPE=s3 + SS_S3_ACCESS_ID= + SS_S3_ACCESS_SECRET= + SS_S3_BUCKET= + SS_S3_ENDPOINT=fsn1.your-objectstorage.com + SS_S3_PATH_STYLE_REQUEST=true + SS_S3_USE_HTTPS=true + ``` === "Other Public Hosted S3 Storag" -```sh - ZINC_FIRST_ADMIN_USER=admin - ZINC_FIRST_ADMIN_PASSWORD=password - SS_DATA_PATH=./data - SS_STORAGE_TYPE=s3 - SS_S3_ACCESS_ID= - SS_S3_ACCESS_SECRET= - SS_S3_BUCKET= - SS_S3_ENDPOINT= - SS_S3_REGION= - SS_S3_USE_HTTPS=true -``` + ```sh + ZINC_FIRST_ADMIN_USER=admin + ZINC_FIRST_ADMIN_PASSWORD=password + SS_DATA_PATH=./data + SS_STORAGE_TYPE=s3 + SS_S3_ACCESS_ID= + SS_S3_ACCESS_SECRET= + SS_S3_BUCKET= + SS_S3_ENDPOINT= + SS_S3_REGION= + SS_S3_USE_HTTPS=true + ``` === "Self-hosted S3 Storage" -```sh - ZINC_FIRST_ADMIN_USER=admin - ZINC_FIRST_ADMIN_PASSWORD=password - SS_DATA_PATH=./data - SS_STORAGE_TYPE=s3 - SS_S3_ACCESS_ID= - SS_S3_ACCESS_SECRET= - SS_S3_BUCKET= - SS_S3_ENDPOINT=: - SS_S3_USE_HTTPS=true - SS_S3_PATH_STYLE_REQUEST=true - SS_S3_USE_HTTPS=true -``` + ```sh + ZINC_FIRST_ADMIN_USER=admin + ZINC_FIRST_ADMIN_PASSWORD=password + SS_DATA_PATH=./data + SS_STORAGE_TYPE=s3 + SS_S3_ACCESS_ID= + SS_S3_ACCESS_SECRET= + SS_S3_BUCKET= + SS_S3_ENDPOINT=: + SS_S3_USE_HTTPS=true + SS_S3_PATH_STYLE_REQUEST=true + SS_S3_USE_HTTPS=true + ``` diff --git a/mkdocs.yml b/mkdocs.yml index a7a476b..023a052 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -42,6 +42,8 @@ markdown_extensions: - markdown.extensions.toc: permalink: true toc_depth: "1-4" + - pymdownx.tabbed: + alternate_style: true # Page tree nav: