Instalación

El paquete es available en pypi.org y se puede instalar a través de pip ejecutando el siguiente comando:

pip install groupdocs-translation-cloud

SDK para Python para traducir documentos en la nube

GroupDocs.Translation Cloud es Cloud API para traducir Word (incluidos archivos RTF y TXT), Excel (incluidos archivos CSV/TSV), PowerPoint, PDF, HTML, Markdown (incluido Markdown con sintaxis Hugo), OpenDocument, RESX, archivos SRT, imágenes de formatos JPG, PNG, SVG, BMP y GIF y archivos PDF escaneados, así como texto sin formato.

Para comodidad de nuestros clientes de Python, presentamos un SDK simple que ayuda a agregar traducción de todos los formatos de archivos de imágenes y documentos mencionados anteriormente y texto sin formato a su aplicación con solo unas pocas líneas de código.

En detalle, se trata de un conjunto de SDK para la traducción de documentos y texto plano en nuestra Nube. Admite traducción de .doc, .docx, .docm, .xls, .xlsx, .xlsm, .ppt, .pptx, .pptm, .pdf, .html, .md, .odt, .ods, .odp, .csv, .tsv, .rtf, .txt, .resx, .srt, .png, Archivos .jpg, .svg, .bmp y .gif. Simplemente pase un archivo o texto específico a la API de GroupDocs.Translation Cloud, y traducirá y guardará el archivo traducido en S3 o devolverá el texto traducido.

Es fácil comenzar con GroupDocs.Translation Cloud y no hay nada que instalar. Cree una cuenta en GroupDocs Cloud y obtenga la información de su aplicación; luego estará listo para usar los SDK.

Funciones de traducción de documentos en la nube

• Traducción de documentos de Microsoft Word®, Microsoft Excel® y Microsoft PowerPoint®
• 46 languages and 140 languages pairs support - Traducción de tablas, encabezados, pies de página, notas al pie/notas finales, títulos de imágenes en documentos de Word y archivos ODT
• Traducción de celdas, gráficos, tablas, tablas dinámicas en documentos de Excel y archivos ODS
• Traducción de marcos de texto, tablas, encabezados, pies de página, gráficos, comentarios en presentaciones de PowerPoint y archivos ODP.
• Traducción de archivos PDF
• Traducción de archivos Markdown
• Traducción de la sintaxis de Hugo en archivos Markdown
• Traducción de texto plano
• Traducción de recursos .NET de formato RESX
• Traducción de subtítulos en formato SRT
• Traducción de imágenes y archivos PDF escaneados obteniendo como resultado texto sin formato o PDF
• Traducción de tablas escaneadas obteniendo como resultado un libro de Excel.
• Traducción de texto escrito a mano.

Formatos de traducción admitidos

Debe especificar el formato del documento para traducir colocando en el cuerpo de la solicitud el valor de enumeración apropiado.

Además, el usuario puede obtener el archivo traducido en cualquier otro formato disponible para conversión. Simplemente especifique el formato de salida del documento traducido colocando la extensión del archivo en el cuerpo de la solicitud:

• doc, docx, odt, rtf — docx, rtf, html, odt, txt, md, pdf, tiff, svg, xps
• xls, xlsx, ods, csv, tsv — xlsx, xlsb, html, pdf, xps, ods, md, docx, pptx, tiff
• ppt, pptx, odp — pptx, pdf, tiff, html, xps, odp
• pdf — docx, pptx, html, svg, xps
• md — html, pdf, docx, tiff, xps
• html — md, pdf, docx, tiff, xps

Por favor visita Supported Formats para más detalles.

Idiomas de traducción admitidos

• en-fr / fr-en — to translate from English to French or from French to English.
• en-de / de-en — to translate from English to German or from German to English.
• en-es / es-en — to translate from English to Spanish or from Spanish to English.
• en-it / it-en — to translate from English to Italian or from Italian to English.
• en-zh / zh-en — to translate from English to Chinese or from Chinese to English.
• en-ru / ru-en — to translate from English to Russian or from Russian to English
• en-ar / ar-en — to translate from English to Arabic or from Arabic to English
• en-pt / pt-en — to translate from English to Portuguese or from Portuguese to English
• en-pl / pl-en — to translate from English to Polish or from Polish to English
• en-uk / uk-en — to translate from English to Ukrainian or from Ukrainian to English
• en-vi / vi-en — to translate from English to Vietnamese or from Vietnamese to English
• en-id / id-en — to translate from English to Indonesian or from Indonesian to English
• en-hi / hi-en — to translate from English to Hindi or from Hindi to English
• en-el / el-en — to translate from English to Greek or from Greek to English
• en-nl / nl-en— to translate from English to Dutch or from Dutch to English
• en-hu / hu-en — to translate from English to Hunngarian or from Hungarian to English
• en-sv / sv-en — to translate from English to Swedish or from Swedish to English
• en-tr / tr-en — to translate from English to Turkish or from Turkish to English
• en-ja / ja-en — to translate from English to Japanese or from Japanese to English
• en-ko / ko-en — to translate from English to Korean or from Korean to English
• en-cs / cs-en — to translate from English to Czech or from Czech to English
• en-fi / fi-en — to translate from English to Finnish or from Finnish to English
• en-ga / ga-en — to translate from English to Irish or from Irish to English
• en-fa / fa-en — to translate from English to Farsi or from Farsi to English
• en-az / az-en — to translate from English to Azerbaijani or from Azerbaijani to English
• en-he / he-en — to translate from English to Hebrew or from Hebrew to English
• en-sk / sk-en — to translate from English to Slovak or from Slovak to English
• en-th / th-en — to translate from English to Thai or from Thai to English
• en-ro / ro-en — to translate from English to Romanian or from Romanian to English
• en-ms / ms-en — to translate from English to Malay or from Malay to English
• en-bg / bg-en — to translate from English to Bulgarian or from Bulgarian to English
• en-bn / bn-en — to translate from English to Bengali or from Bengali to English
• en-da / da-en — to translate from English to Danish or from Danish to English
• en-lt / lt-en — to translate from English to Lithuanian or from Lithuanian to English
• en-lv / lv-en — to translate from English to Latvian or from Latvian to English
• en-no / no-en — to translate from English to Norwegian or from Norwegian to English
• en-et / et-en — to translate from English to Estonian or from Estonian to English
• en-hy / hy-en — to translate from English to Armenian or from Armenian to English
• en-ca / ca-en — to translate from English to Catalan or from Catalan to English
• en-hr / hr-en — to translate from English to Croatian or from Croatian to English
• en-sr / sr-en — to translate from English to Serbian or from Serbian to English
• en-af / af-en — to translate from English to Afrikaans or from Afrikaans to English
• en-ur / ur-en — to translate from English to Urdu or from Urdu to English
• en-tl / tl-en — to translate from English to Tagalog or from Tagalog to English
• en-ka / ka-en — to translate from English to Georgian or from Georgian to English
• fr-de / de-fr — to translate from French to German or from German to French
• fr-it / it-fr — to translate from French to Italian or from Italian to French
• fr-ar / ar-fr — to translate from French to Arabic or from Arabic to French
• fr-es / es-fr — to translate from French to Spanish or from Spanish to French
• fr-id / id-fr — to translate from French to Indonesian or from Indonesian to French
• fr-ms / ms-fr — to translate from French to Malay or from Malay to French
• fr-pl / pl-fr — to translate from French to Polish or from Polish to French
• fr-ru / ru-fr — to translate from French to Russian or from Russian to French
• fr-ar / ar-fr — to translate from French to Arabic or from Arabic to French
• de-it / it-de — to translate from German to Italian or from Italian to German
• de-pl / pl-de — to translate from German to Polish or from Polish to German
• de-ar / ar-de — to translate from German to Arabic or from Arabic to German
• de-zh / zh-de — to translate from German to Chinese or from Chinese to German
• de-es / es-de — to translate from German to Spanish or from Spanish to German
• de-ms / ms-de — to translate from German to Malay or from Malay to German
• de-uk / uk-de — to translate from German to Ukrainian or from Ukrainian to German
• it-es / es-it — to translate from Italian to Spanish or from Spanish to Italian
• it-ar / ar-it — to translate from Italian to Arabic or from Arabic to Italian
• it-uk / uk-it — to translate from Italian to Ukrainian or from Ukrainian to Italian
• it-ms / ms-it — to translate from Italian to Malay or from Malay to Italian
• sv-zh / zh-sv — to translate from Swedish to Chinese or from Chinese to Swedish
• ar-es / es-ar — to translate from Arabic to Spanish or from Spaish to Arabic
• ar-tr / tr-ar — to translate from Arabic to Turkish or from Turkish to Arabic
• ar-pl / pl-ar — to translate from Arabic to Polish or from Polish to Arabic
• ru-es / es-ru — to translate from Russian to Spanish or from Spaish to Russian

Detalles de la solicitud JSON

Puede colocar la siguiente información en el cuerpo de la solicitud para traducir un documento:

• formato — formato del archivo a traducir
• outputFormat — formato del archivo traducido (por ejemplo, pdf)
• sourceLanguage — idioma del documento original (por ejemplo, en)
• targetLanguages — idiomas de traducción como lista (por ejemplo, [fr, de])
• archivo — archivo para traducir en forma de matriz de bytes
• url: enlace al archivo a traducir; se debe proporcionar el archivo o la URL
• originalFileName — nombre original del archivo a traducir, si se utilizará una identificación de solicitud nula o vacía
• masters: si las diapositivas master deben traducirse (solo para presentaciones, pase verdadero o falso)
• elementos — páginas de diapositivas para traducir (solo para presentaciones, pase la lista vacía para traducir la presentación completa)
• separador — delimitador para archivos CSV
• rangos - diccionario de rangos en el libro de Excel
• shortcodedict — diccionario de sintaxis de códigos cortos en Hugo para traducir, donde la clave es un índice de códigos cortos basado en cero y el valor es una lista de nombres de parámetros que requieren traducción
• frontmatterdict — diccionario de sintaxis inicial en Hugo para traducir, donde la clave es un índice inicial basado en cero y el valor es una lista de rutas a valores que requieren traducción, cada ruta también es una lista.

Para traducir texto sin formato, se debe incluir la siguiente información en el cuerpo de la solicitud:

• sourceLanguage — idioma del texto original (por ejemplo, en)
• targetLanguages — idiomas de traducción como lista (por ejemplo, [fr, de])
• textos — lista de textos para traducir (por ejemplo, [hola mundo])
• contains-markdown: verdadero si el texto contiene sintaxis de rebajas

¿Cómo utilizar el SDK?

Nuestra API es completamente independiente de su sistema operativo, sistema de base de datos o lenguaje de desarrollo. Puede utilizar cualquier idioma y plataforma que admita HTTP para interactuar con nuestra API. Sin embargo, escribir código de cliente manualmente puede resultar difícil, propenso a errores y llevar mucho tiempo. Por lo tanto, hemos brindado y apoyado SDKs en muchos lenguajes de desarrollo para facilitar la integración de sus aplicaciones en la nube con nosotros.

Inicio rápido

1. Obtenga claves API si aún no las tiene

Crea una cuenta personal en GroupDocs Cloud Dashboard y haga clic en Obtener claves. Estas claves son útiles para todos los productos GroupDocs Cloud. Si tienes algún problema, mira esto. detailed manual. Una vez recibidas sus claves, siga esto article para probar GroupDocs.Translation Cloud o familiarizarse con Developer guide para más detalles.

2. Instalar el SDK

Instalar groupdocs-translation-cloudcon PIP de PyPI by:

pip install groupdocs-translation-cloud

O clonar el repositorio e instalarlo a través de Setuptools:

python setup.py install

3. Ejecutar demostración

• Consulte el SDK o consígalo desde PiPy
  • Configure su client_id y client_secret
  • Ejecute el cuaderno Jupyter demo.ipynb

Estructura

Este proyecto incluye:

• Módulo “groupdocstranslationcloud”, este es SDK. Puedes integrarlo en tu aplicación. Contiene API de traducción y almacenamiento.
• Módulo “test”, pruebas unitarias. Puede echarles un vistazo para ver varios ejemplos de código.
• “Demostración” del cuaderno Jupyter. Cuaderno de demostración de muestra.

Dependencias

• Ver requisitos.txt

Soporte de versiones

Python :: 2.7, Python :: 3, Python :: 3.4, Python :: 3.5, Python :: 3.6, Python :: 3.7, Python :: 3.8

Traducir texto sin formato

# Load the gem
import groupdocs_translation_cloud
# Get Client Id and Client Secret from https://dashboard.groupdocs.cloud
my_client_id = ""
my_client_secret = ""

# Create instance of the API
configuration = Configuration(apiKey=my_client_secret, appSid=my_client_id)
api = TranslationApi(configuration)

#document translation
pair = "en-fr"
_format = "docx"
storage = "First Storage"
name = "test.docx"
folder = ""
savepath = ""
savefile = "test_python.docx"  
masters = False
elements = []
translator = TranslateDocument(pair, _format, storage, name, folder, savepath, savefile, masters, elements)
request = translator.to_string()
res_doc = api.post_translate_document(request)
print(res_doc.message)

Documentación para puntos finales API

Todos los URI son relativos ahttps://api.groupdocs.cloud/v2.0/translation

Clase |         | Método | Solicitud HTTP | Descripción ———— |-| ————- | ————- | ————-TranslationApi|         | autoPost| CORREO/auto| Traduce cualquier archivo compatibleTranslationApi|         | csvPost| CORREO/csv| Traducir archivos CSV y TSVTranslationApi|         | documentPost| CORREO/document| Traducir documentos de Microsoft Word, rtf, txt, odtTranslationApi|         | documentRequestIdGet| CONSEGUIR/document/{requestId}| Estado de traducción del documento de devolución. También devolverá URL para descargar el documento traducido si la traducción se realizó correctamente.TranslationApi|         | documentTrialPost| CORREO/document/trial| Traduce de prueba documentos de Microsoft Word, rtf, txt, odt sin conversación. Traduce solo la primera página o 1000 símbolos.TranslationApi|         | hcGet| CONSEGUIR/hc| Control de salud de todos los servicios.TranslationApi|         | htmlPost| CORREO/html| Traducir archivos HTMLTranslationApi|         | hugoGet| CONSEGUIR/hugo| Obtenga la estructura de sintaxis de hugo del archivo de rebajasTranslationApi|         | hugoPost| CORREO/hugo| Ejecute el análisis de la estructura de sintaxis de hugo desde el archivo de rebajasTranslationApi|         | imageToFilePost| CORREO/image-to-file| Traducir imagen o pdf escaneado y devolver archivoTranslationApi|         | imageToTextPost| CORREO/image-to-text| Traducir texto en imagen o pdf escaneadoTranslationApi|         | languagesGet| CONSEGUIR/languages| Lista de retorno de pares de idiomas disponiblesTranslationApi|         | markdownPost| CORREO/markdown| Traducir archivos MarkdownTranslationApi|         | pdfPost| CORREO/pdf| Traducir archivos pdfTranslationApi|         | pdfTrialPost| CORREO/pdf/trial| Traducción de prueba en pdf. Traduce solo la primera página sin convertir a otro formato.TranslationApi|         | presentationPost| CORREO/presentation| Traducir presentaciones de Microsoft PowerPoint, odpTranslationApi|         | resxPost| CORREO/resx| Traducir archivos RESXTranslationApi|         | spreadsheetPost| CORREO/spreadsheet| Traducir libros de trabajo de Microsoft Excel, odsTranslationApi|         | textPost| CORREO/text| Traducir textoTranslationApi|         | textRequestIdGet| CONSEGUIR/text/{requestId}| Devolver el estado de traducción del texto. También devolverá el texto traducido si la traducción fue exitosaTranslationApi|         | textTrialPost| CORREO/text/trial| Traducción de texto de prueba. Traduce sólo 1000 símbolos.

Documentación para modelos

CloudFileResponse, CloudHugoResponse, CloudTextResponse, CsvFileRequest, FileRequest, HealthCheckStatus, HtmlFileRequest, HttpStatusCode, HugoRequest, ImageToFileRequest, ImageToTextRequest, LanguagePairData, MarkdownFileRequest, PdfFileRequest, PresentationFileRequest, ResxFileRequest, SpreadsheetFileRequest, StatusResponse, StringStringTuple, TextDocumentFileRequest, TextRequest, UrlFileInfo, WorksheetData

SKD de GroupDocs.Translation Cloud

GitHub

Administrador de paquetes