Skip to content

Commit ca8e121

Browse files
committed
translator: create new directory structure
1 parent f9f72a6 commit ca8e121

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

58 files changed

+606
-458
lines changed

articles/ai-foundry/toc.yml

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -304,17 +304,17 @@ items:
304304
- name: Translator
305305
items:
306306
- name: What is Azure AI Translator?
307-
href: ../ai-services/translator/translator-overview.md?context=/azure/ai-foundry/context/context
307+
href: ../ai-services/translator/overview.md?context=/azure/ai-foundry/context/context
308308
- name: Azure AI Translator language support
309309
href: ../ai-services/translator/language-support.md?context=/azure/ai-foundry/context/context
310310
- name: Text translation
311-
href: ../ai-services/translator/text-translation-overview.md?context=/azure/ai-foundry/context/context
311+
href: ../ai-services/translator/text-translation/overview.md?context=/azure/ai-foundry/context/context
312312
- name: Document translation
313313
href: ../ai-services/translator/document-translation/overview.md?context=/azure/ai-foundry/context/context
314314
- name: Custom Translator
315315
href: ../ai-services/translator/custom-translator/overview.md?context=/azure/ai-foundry/context/context
316316
- name: Prebuilt solutions
317-
href: ../ai-services/translator/solutions-overview.md?context=/azure/ai-foundry/context/context
317+
href: ../ai-services/translator/solutions/overview.md?context=/azure/ai-foundry/context/context
318318
- name: Vision
319319
items:
320320
- name: Azure Image Analysis

articles/ai-services/.openpublishing.redirection.ai-services.json

Lines changed: 171 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -867,6 +867,176 @@
867867
"redirect_url": "/azure/ai-services/what-are-ai-services",
868868
"redirect_document_id": false
869869
},
870+
{
871+
"source_path_from_root": "/articles/ai-services/translator/text-translation-overview.md",
872+
"redirect_url": "/azure/ai-services/translator/text-translation/overview",
873+
"redirect_document_id": true
874+
},
875+
{
876+
"source_path_from_root": "/articles/ai-services/translator/translator-overview.md",
877+
"redirect_url": "/azure/ai-services/translator/overview",
878+
"redirect_document_id": true
879+
},
880+
{
881+
"source_path_from_root": "/articles/ai-services/translator/create-translator-resource.md",
882+
"redirect_url": "/azure/ai-services/translator/how-to/create-translator-resource",
883+
"redirect_document_id": true
884+
},
885+
{
886+
"source_path_from_root": "/articles/ai-services/translator/dynamic-dictionary.md",
887+
"redirect_url": "/azure/ai-services/translator/text-translation/how-to/use-dynamic-dictionary",
888+
"redirect_document_id": true
889+
},
890+
{
891+
"source_path_from_root": "/articles/ai-services/translator/encrypt-data-at-rest.md",
892+
"redirect_url": "/azure/ai-services/translator/custom-translator/concepts/encrypt-data-at-rest",
893+
"redirect_document_id": true
894+
},
895+
{
896+
"source_path_from_root": "/articles/ai-services/translator/quickstart-text-rest-api.md",
897+
"redirect_url": "/azure/ai-services/translator/text-translation/quickstart/rest-api",
898+
"redirect_document_id": true
899+
},
900+
{
901+
"source_path_from_root": "/articles/ai-services/translator/quickstart-text-sdk.md",
902+
"redirect_url": "/azure/ai-services/translator/text-translation/quickstart/client-library-sdk",
903+
"redirect_document_id": true
904+
},
905+
{
906+
"source_path_from_root": "/articles/ai-services/translator/text-sdk-overview.md",
907+
"redirect_url": "/azure/ai-services/translator/text-translation/sdk-overview",
908+
"redirect_document_id": true
909+
},
910+
{
911+
"source_path_from_root": "/articles/ai-services/translator/translator-text-apis.md",
912+
"redirect_url": "/azure/ai-services/translator/text-translation/how-to/use-rest-api",
913+
"redirect_document_id": true
914+
},
915+
{
916+
"source_path_from_root": "/articles/ai-services/translator/firewalls.md",
917+
"redirect_url": "/azure/ai-services/translator/how-to/use-firewalls",
918+
"redirect_document_id": true
919+
},
920+
{
921+
"source_path_from_root": "/articles/ai-services/translator/modifications-deprecations.md",
922+
"redirect_url": "/azure/ai-services/translator/reference/release-history",
923+
"redirect_document_id": true
924+
},
925+
{
926+
"source_path_from_root": "/articles/ai-services/translator/neural-dictionary.md",
927+
"redirect_url": "/azure/ai-services/translator/text-translation/how-to/use-neural-dictionary",
928+
"redirect_document_id": true
929+
},
930+
{
931+
"source_path_from_root": "/articles/ai-services/translator/prevent-translation.md",
932+
"redirect_url": "/azure/ai-services/translator/text-translation/how-to/prevent-translation",
933+
"redirect_document_id": true
934+
},
935+
{
936+
"source_path_from_root": "/articles/ai-services/translator/profanity-filtering.md",
937+
"redirect_url": "/azure/ai-services/translator/text-translation/how-to/use-profanity-filtering",
938+
"redirect_document_id": true
939+
},
940+
{
941+
"source_path_from_root": "/articles/ai-services/translator/translator-pro/faq.yml",
942+
"redirect_url": "/azure/ai-services/translator/solutions/translator-pro/faq",
943+
"redirect_document_id": true
944+
},
945+
{
946+
"source_path_from_root": "/articles/ai-services/translator/translator-pro/language-support.md",
947+
"redirect_url": "/azure/ai-services/translator/solutions/translator-pro/language-support",
948+
"redirect_document_id": true
949+
},
950+
{
951+
"source_path_from_root": "/articles/ai-services/translator/translator-pro/overview.md",
952+
"redirect_url": "/azure/ai-services/translator/solutions/translator-pro/overview",
953+
"redirect_document_id": true
954+
},
955+
{
956+
"source_path_from_root": "/articles/ai-services/translator/solutions-overview.md",
957+
"redirect_url": "/azure/ai-services/translator/solutions/overview",
958+
"redirect_document_id": true
959+
},
960+
{
961+
"source_path_from_root": "/articles/ai-services/translator/translator-faq.md",
962+
"redirect_url": "/azure/ai-services/translator/faq",
963+
"redirect_document_id": true
964+
},
965+
{
966+
"source_path_from_root": "/articles/ai-services/translator/word-alignment.md",
967+
"redirect_url": "/azure/ai-services/translator/text-translation/how-to/word-alignment",
968+
"redirect_document_id": true
969+
},
970+
{
971+
"source_path_from_root": "/articles/ai-services/translator/migrate-to-v3.md",
972+
"redirect_url": "/azure/ai-services/translator/text-translation/how-to/migrate-to-v3",
973+
"redirect_document_id": true
974+
},
975+
{
976+
"source_path_from_root": "/articles/ai-services/translator/reference/known-issues.md",
977+
"redirect_url": "/azure/ai-services/translator/text-translation/reference/known-issues",
978+
"redirect_document_id": true
979+
},
980+
{
981+
"source_path_from_root": "/articles/ai-services/translator/reference/release-history.md",
982+
"redirect_url": "/azure/ai-services/translator/text-translation/reference/release-history",
983+
"redirect_document_id": true
984+
},
985+
{
986+
"source_path_from_root": "/articles/ai-services/translator/reference/rest-api-guide.md",
987+
"redirect_url": "/azure/ai-services/translator/text-translation/reference/rest-api-guide",
988+
"redirect_document_id": true
989+
},
990+
{
991+
"source_path_from_root": "/articles/ai-services/translator/reference/v3-0-break-sentence.md",
992+
"redirect_url": "/azure/ai-services/translator/text-translation/reference/v3/break-sentence",
993+
"redirect_document_id": true
994+
},
995+
{
996+
"source_path_from_root": "/articles/ai-services/translator/reference/v3-0-detect.md",
997+
"redirect_url": "/azure/ai-services/translator/text-translation/reference/v3/detect",
998+
"redirect_document_id": true
999+
},
1000+
{
1001+
"source_path_from_root": "/articles/ai-services/translator/reference/v3-0-dictionary-examples.md",
1002+
"redirect_url": "/azure/ai-services/translator/text-translation/reference/v3/dictionary-examples",
1003+
"redirect_document_id": true
1004+
},
1005+
{
1006+
"source_path_from_root": "/articles/ai-services/translator/reference/v3-0-dictionary-lookup.md",
1007+
"redirect_url": "/azure/ai-services/translator/text-translation/reference/v3/dictionary-lookup",
1008+
"redirect_document_id": true
1009+
},
1010+
{
1011+
"source_path_from_root": "/articles/ai-services/translator/reference/v3-0-languages.md",
1012+
"redirect_url": "/azure/ai-services/translator/text-translation/reference/v3/languages",
1013+
"redirect_document_id": true
1014+
},
1015+
{
1016+
"source_path_from_root": "/articles/ai-services/translator/reference/v3-0-reference.md",
1017+
"redirect_url": "/azure/ai-services/translator/text-translation/reference/v3/reference",
1018+
"redirect_document_id": true
1019+
},
1020+
{
1021+
"source_path_from_root": "/articles/ai-services/translator/reference/v3-0-translate.md",
1022+
"redirect_url": "/azure/ai-services/translator/text-translation/reference/v3/translate",
1023+
"redirect_document_id": true
1024+
},
1025+
{
1026+
"source_path_from_root": "/articles/ai-services/translator/reference/v3-0-transliterate.md",
1027+
"redirect_url": "/azure/ai-services/translator/text-translation/reference/v3/transliterate",
1028+
"redirect_document_id": true
1029+
},
1030+
{
1031+
"source_path_from_root": "/articles/ai-services/translator/connector/document-translation-flow.md",
1032+
"redirect_url": "/azure/ai-services/translator/solutions/connector/document-translation-flow",
1033+
"redirect_document_id": true
1034+
},
1035+
{
1036+
"source_path_from_root": "/articles/ai-services/translator/connector/text-translator-flow.md",
1037+
"redirect_url": "/azure/ai-services/translator/solutions/connector/text-translator-flow",
1038+
"redirect_document_id": true
1039+
},
8701040
{
8711041
"source_path_from_root": "/articles/ai-services/language-service/personally-identifiable-information/how-to-call.md",
8721042
"redirect_url": "/azure/ai-services/language-service/personally-identifiable-information/how-to/redact-text-pii",
@@ -883,4 +1053,4 @@
8831053
"redirect_document_id": true
8841054
}
8851055
]
886-
}
1056+
}

articles/ai-services/authentication.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -32,7 +32,7 @@ Let's quickly review the authentication headers available for use with Azure AI
3232
| Header | Description |
3333
|--------|-------------|
3434
| Ocp-Apim-Subscription-Key | Use this header to authenticate with a resource key for a specific service or a multi-service resource key. |
35-
| Ocp-Apim-Subscription-Region | This header is only required when using a multi-service resource key with the [Azure AI Translator service](./Translator/reference/v3-0-reference.md). Use this header to specify the resource region. |
35+
| Ocp-Apim-Subscription-Region | This header is only required when using a multi-service resource key with the [Azure AI Translator service](translator/text-translation/reference/v3/reference.md). Use this header to specify the resource region. |
3636
| Authorization | Use this header if you are using an access token. The steps to perform a token exchange are detailed in the following sections. The value provided follows this format: `Bearer <TOKEN>`. |
3737

3838
## Authenticate with a single-service resource key

articles/ai-services/translator/containers/translate-text-parameters.md

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ manager: nitinme
77

88
ms.service: azure-ai-translator
99
ms.topic: reference
10-
ms.date: 08/14/2024
10+
ms.date: 03/07/2025
1111
ms.author: lajanuar
1212
---
1313

@@ -58,7 +58,7 @@ Request parameters passed on the query string are:
5858
| from |Specifies the language of the input text.|*Required parameter*|
5959
| to |Specifies the language of the output text. For example, use `to=de` to translate to German.<br>It's possible to translate to multiple languages simultaneously by repeating the parameter in the query string. For example, use `to=de&to=it` to translate to German and Italian. |*Required parameter*|
6060

61-
* You can query the service for `translation` scope [supported languages](../reference/v3-0-languages.md).
61+
* You can query the service for `translation` scope [supported languages](../text-translation/reference/v3/languages.md).
6262
* *See also* [Language support for transliteration](../language-support.md#translation).
6363

6464
### Optional parameters
@@ -72,7 +72,7 @@ Request parameters passed on the query string are:
7272

7373
| Headers | Description |Condition|
7474
| --- | --- |---|
75-
| Authentication headers |*See* [available options for authentication](../reference/v3-0-reference.md#authentication). |*Required request header*|
75+
| Authentication headers |*See* [available options for authentication](../text-translation/reference/v3/reference.md#authentication). |*Required request header*|
7676
| Content-Type |Specifies the content type of the payload. <br>Accepted value is `application/json; charset=UTF-8`. |*Required request header*|
7777
| Content-Length |The length of the request body. |*Optional*|
7878
| X-ClientTraceId | A client-generated GUID to uniquely identify the request. You can omit this header if you include the trace ID in the query string using a query parameter named `ClientTraceId`. |*Optional*|
@@ -121,15 +121,15 @@ A successful response is a JSON array with one result for each string in the inp
121121

122122
## Response status codes
123123

124-
If an error occurs, the request returns a JSON error response. The error code is a 6-digit number combining the 3-digit HTTP status code followed by a 3-digit number to further categorize the error. Common error codes can be found on the [v3 Translator reference page](../reference/v3-0-reference.md#errors).
124+
If an error occurs, the request returns a JSON error response. The error code is a 6-digit number combining the 3-digit HTTP status code followed by a 3-digit number to further categorize the error. Common error codes can be found on the [v3 Translator reference page](../text-translation/reference/v3/reference.md#errors).
125125

126126
## Code samples: translate text
127127

128128
> [!NOTE]
129129
>
130130
> * Each sample runs on the `localhost` that you specified with the `docker run` command.
131131
> * While your container is running, `localhost` points to the container itself.
132-
> * You don't have to use `localhost:5000`. You can use any port that is not already in use in your host environment.
132+
> * You don't have to use `localhost:5000`. You can use any port that isn't already in use in your host environment.
133133
134134

135135
### Translate a single input
@@ -164,7 +164,7 @@ Here's an example cURL HTTP request using localhost:5000 that you specified with
164164
```
165165

166166
> [!NOTE]
167-
> If you attempt the cURL POST request before the container is ready, you'll end up getting a *Service is temporarily unavailable* response. Wait until the container is ready, then try again.
167+
> If you attempt the cURL POST request before the container is ready, you receive a *Service is temporarily unavailable* response. Wait until the container is ready, then try again.
168168
169169
### Translate text using Swagger API
170170

@@ -388,7 +388,7 @@ The following table lists array element and character limits for the Translator
388388
|:----|:----|:----|:----|
389389
| translate | 10,000 | 100 | 50,000 |
390390

391-
## Use docker compose: Translator with supporting containers
391+
## Use the docker compose command for supporting containers
392392

393393
Docker compose is a tool enables you to configure multi-container applications using a single YAML file typically named `compose.yaml`. Use the `docker compose up` command to start your container application and the `docker compose down` command to stop and remove your containers.
394394

@@ -469,7 +469,7 @@ The Azure AI services container images can be found in the [**Microsoft Artifact
469469
> * `docker compose pause` pauses running containers.
470470
> * `docker compose unpause {your-container-name}` unpauses paused containers.
471471
> * `docker compose restart` restarts all stopped and running container with all its previous changes intact. If you make changes to your `compose.yaml` configuration, these changes aren't updated with the `docker compose restart` command. You have to use the `docker compose up` command to reflect updates and changes in the `compose.yaml` file.
472-
> * `docker compose ps -a` lists all containers, including those that are stopped.
472+
> * `docker compose ps -a` lists all containers, including ones that are stopped.
473473
> * `docker compose exec` enables you to execute commands to *detach* or *set environment variables* in a running container.
474474
>
475475
> For more information, *see* [docker CLI reference](https://docs.docker.com/engine/reference/commandline/docker/).

articles/ai-services/translator/containers/transliterate-text-parameters.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ manager: nitinme
88

99
ms.service: azure-ai-translator
1010
ms.topic: reference
11-
ms.date: 04/29/2024
11+
ms.date: 03/07/2025
1212
ms.author: lajanuar
1313
---
1414

@@ -25,7 +25,7 @@ Convert characters or letters of a source language to the corresponding characte
2525
2626
```
2727

28-
*See* [**Virtual Network Support**](../reference/v3-0-reference.md#virtual-network-support) for Translator service selected network and private endpoint configuration and support.
28+
*See* [**Virtual Network Support**](../text-translation/reference/v3/reference.md#virtual-network-support) for Translator service selected network and private endpoint configuration and support.
2929

3030
## Request parameters
3131

@@ -38,14 +38,14 @@ Request parameters passed on the query string are:
3838
| fromScript | Specifies the script used by the input text. |*Required parameter*|
3939
| toScript |Specifies the output script.|*Required parameter*|
4040

41-
* You can query the service for `transliteration` scope [supported languages](../reference/v3-0-languages.md).
41+
* You can query the service for `transliteration` scope [supported languages](../text-translation/reference/v3/languages.md).
4242
* *See also* [Language support for transliteration](../language-support.md#transliteration).
4343

4444
## Request headers
4545

4646
| Headers | Description |Condition|
4747
| --- | --- | ---|
48-
| Authentication headers | *See* [available options for authentication](../reference/v3-0-reference.md#authentication)|*Required request header*|
48+
| Authentication headers | *See* [available options for authentication](../text-translation/reference/v3/reference.md#authentication)|*Required request header*|
4949
| Content-Type | Specifies the content type of the payload. Possible value: `application/json` |*Required request header*|
5050
| Content-Length |The length of the request body. |*Optional*|
5151
| X-ClientTraceId |A client-generated GUID to uniquely identify the request. You can omit this header if you include the trace ID in the query string using a query parameter named `ClientTraceId`. |*Optional*|
@@ -106,7 +106,7 @@ The following limitations apply:
106106
>
107107
> * Each sample runs on the `localhost` that you specified with the `docker run` command.
108108
> * While your container is running, `localhost` points to the container itself.
109-
> * You don't have to use `localhost:5000`. You can use any port that is not already in use in your host environment.
109+
> * You don't have to use `localhost:5000`. You can use any port that isn't already in use in your host environment.
110110
111111
### Transliterate with REST API
112112

@@ -119,4 +119,4 @@ The following limitations apply:
119119
## Next Steps
120120

121121
> [!div class="nextstepaction"]
122-
> [Learn more about text transliteration](../translator-text-apis.md#transliterate-text)
122+
> [Learn more about text transliteration](../text-translation/reference/v3/transliterate.md)

0 commit comments

Comments
 (0)