Εγκατάσταση

Το πακέτο είναι available στο pypi.org και μπορεί να εγκατασταθεί μέσω pip εκτελώντας την παρακάτω εντολή:

pip install groupdocs-translation-cloud

Python SDK για Μετάφραση Εγγράφων Cloud

GroupDocs.Translation Cloud είναι το Cloud API για τη μετάφραση του Word (συμπεριλαμβανομένων των αρχείων RTF και TXT), του Excel (συμπεριλαμβανομένων των αρχείων CSV / TSV), PowerPoint, PDF, HTML, Markdown (συμπεριλαμβανομένου του Markdown με σύνταξη Hugo), OpenDocument, RESX, αρχείων SRT, εικόνων JPG, PNG, SVG, κειμένου BMP και SVG καθώς και σε μορφή απλού κειμένου σε μορφή PDF και GIF.

Για τη διευκόλυνση των πελατών μας Python, παρουσιάζουμε ένα απλό SDK που βοηθά στην προσθήκη μετάφρασης όλων των μορφών αρχείων εγγράφων και εικόνων που αναφέρονται παραπάνω και απλού κειμένου στην εφαρμογή σας με λίγες μόνο γραμμές κώδικα.

Αναλυτικά, είναι ένα σύνολο SDK για μετάφραση εγγράφων και απλού κειμένου στο Cloud μας. Υποστηρίζει μετάφραση των .doc, .docx, .docm, .xls, .xlsx, .xlsm, .ppt, .pptx, .pptm, .pdf, .html, .md, .odt, .ods, .odp, .csv, .tsv.,, .rtxt, .tsv., .rtxt. Αρχεία .png, .jpg, .svg, .bmp και .gif. Απλώς περάστε ένα συγκεκριμένο αρχείο ή κείμενο στο GroupDocs.Translation Cloud API και θα μεταφράσει και θα αποθηκεύσει το μεταφρασμένο αρχείο στο S3 ή θα επιστρέψει μεταφρασμένο κείμενο.

Είναι εύκολο να ξεκινήσετε με το GroupDocs.Translation Cloud και δεν υπάρχει τίποτα για εγκατάσταση. Δημιουργήστε έναν λογαριασμό στο GroupDocs Cloud και λάβετε τις πληροφορίες της εφαρμογής σας και, στη συνέχεια, είστε έτοιμοι να χρησιμοποιήσετε SDK.

Δυνατότητες μετάφρασης εγγράφων cloud

• Μετάφραση εγγράφων Microsoft Word®, Microsoft Excel® και Microsoft PowerPoint® -46 languages and 140 languages pairs support- Μετάφραση πινάκων, κεφαλίδων, υποσέλιδων, υποσημειώσεων/σημειώσεων τέλους, λεζάντες εικόνων σε έγγραφα του Word και αρχεία ODT
• Μετάφραση κελιών, γραφημάτων, πινάκων, συγκεντρωτικών πινάκων σε έγγραφα Excel και αρχεία ODS
• Μετάφραση πλαισίων κειμένου, πίνακες, κεφαλίδες, υποσέλιδα, γραφήματα, σχόλια σε παρουσιάσεις PowerPoint και αρχεία ODP
• Μετάφραση αρχείων PDF
• Μετάφραση αρχείων Markdown
• Μετάφραση της σύνταξης Hugo σε αρχεία Markdown
• Μετάφραση απλού κειμένου
• Μετάφραση πόρων .NET μορφής RESX
• Μετάφραση υποτίτλων σε μορφή SRT
• Η μετάφραση των εικόνων και των σαρωμένων αρχείων PDF αποκτά ως αποτέλεσμα απλό κείμενο ή PDF
• Η μετάφραση των σαρωμένων πινάκων λαμβάνει ως αποτέλεσμα το βιβλίο εργασίας του Excel
• Μετάφραση χειρόγραφου κειμένου

Υποστηριζόμενες μορφές μετάφρασης

Θα πρέπει να καθορίσετε τη μορφή του εγγράφου για μετάφραση, βάζοντας στο σώμα της αίτησης την κατάλληλη τιμή αριθμ.

Επιπλέον, ο χρήστης θα μπορούσε να αποκτήσει μεταφρασμένο αρχείο σε οποιαδήποτε άλλη μορφή διαθέσιμη για μετατροπή. Απλώς καθορίστε τη μορφή εξόδου του μεταφρασμένου εγγράφου τοποθετώντας την επέκταση αρχείου στο σώμα του αιτήματος:

• 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

Παρακαλώ επισκεφθείτε Supported Formats για λεπτομέρειες.

Υποστηριζόμενες γλώσσες μετάφρασης

• 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

Λεπτομέρειες αιτήματος JSON

Μπορείτε να βάλετε τις ακόλουθες πληροφορίες στο σώμα αιτημάτων για τη μετάφραση ενός εγγράφου:

• μορφή — μορφή αρχείου για μετάφραση
• outputFormat — μορφή μεταφρασμένου αρχείου (π.χ. pdf)
• sourceLanguage — γλώσσα του αρχικού εγγράφου (π.χ. en)
• targetLanguages — γλώσσες μετάφρασης ως λίστα (π.χ. [fr, de])
• αρχείο — αρχείο για μετάφραση σε μορφή πίνακα byte
• url — σύνδεσμος προς αρχείο για μετάφραση, θα πρέπει να παρέχεται είτε αρχείο είτε url
• originalFileName — το αρχικό όνομα του αρχείου προς μετάφραση, εάν θα χρησιμοποιηθεί μηδενικό ή κενό αναγνωριστικό αιτήματος
• master — εάν οι κύριες διαφάνειες πρέπει να μεταφραστούν (μόνο για παρουσιάσεις, περάστε true ή false)
• στοιχεία — σύρετε σελίδες για μετάφραση (μόνο για παρουσιάσεις, περάστε την κενή λίστα για να μεταφράσετε ολόκληρη την παρουσίαση)
• διαχωριστής — οριοθέτης για αρχεία CSV
• εύρη - λεξικό περιοχών στο βιβλίο εργασίας του Excel
• shortcodedict — λεξικό σύνταξης σύντομου κώδικα στο Hugo για μετάφραση, όπου το κλειδί είναι μηδενικός δείκτης σύντομου κώδικα και η τιμή είναι μια λίστα ονομάτων παραμέτρων που απαιτούν μετάφραση
• frontmatterdict — λεξικό σύνταξης μπροστινού θέματος στο Hugo για μετάφραση, όπου το κλειδί είναι ο μηδενικός δείκτης μπροστινής ύλης και η τιμή είναι λίστα διαδρομών προς τιμές που απαιτούν μετάφραση, κάθε διαδρομή είναι επίσης μια λίστα.

Για τη μετάφραση απλού κειμένου οι ακόλουθες πληροφορίες θα πρέπει να τοποθετηθούν στο σώμα των αιτημάτων:

• sourceLanguage — γλώσσα του αρχικού κειμένου (π.χ. en)
• targetLanguages — γλώσσες μετάφρασης ως λίστα (π.χ. [fr, de])
• κείμενα — λίστα κειμένων προς μετάφραση (π.χ. [γεια κόσμο])
• contains-markdown — αληθές εάν το κείμενο περιέχει σύνταξη σήμανσης

Πώς να χρησιμοποιήσετε το SDK;

Το API μας είναι εντελώς ανεξάρτητο από το λειτουργικό σας σύστημα, το σύστημα βάσης δεδομένων ή τη γλώσσα ανάπτυξης. Μπορείτε να χρησιμοποιήσετε οποιαδήποτε γλώσσα και πλατφόρμα που υποστηρίζει HTTP για να αλληλεπιδράσετε με το API μας. Ωστόσο, η μη αυτόματη εγγραφή κώδικα πελάτη μπορεί να είναι δύσκολη, επιρρεπής σε σφάλματα και χρονοβόρα. Ως εκ τούτου, παρέχουμε και υποστηρίζουμε SDKs σε πολλές γλώσσες ανάπτυξης για να διευκολύνουμε τις Εφαρμογές σας στο Cloud να ενσωματωθούν μαζί μας.

Γρήγορη εκκίνηση

1. Λάβετε κλειδιά API εάν δεν έχετε

Δημιουργήστε έναν προσωπικό λογαριασμό στο GroupDocs Cloud Dashboard και κάντε κλικ στο Get Keys. Αυτά τα κλειδιά είναι χρήσιμα για όλα τα προϊόντα GroupDocs Cloud. Αν έχετε κάποιο πρόβλημα, δείτε αυτό detailed manual. Μόλις λάβετε τα κλειδιά σας, ακολουθήστε αυτό article για να δοκιμάσετε το GroupDocs.Translation Cloud ή να εξοικειωθείτε με Developer guide για περισσότερες λεπτομέρειες.

2. Εγκαταστήστε το SDK

Εγκαθιστώ groupdocs-translation-cloud με PIP από PyPI by:

pip install groupdocs-translation-cloud

Ή κλωνοποιήστε το αποθετήριο και εγκαταστήστε το μέσω Setuptools:

python setup.py install

3. Εκτέλεση επίδειξης

• Ελέγξτε το SDK ή λάβετε από το PiPy
  • Ορίστε τον πελάτη_id & client_secret
  • Εκτελέστε το σημειωματάριο Jupyterdemo.ipynb

Δομή

Αυτό το έργο περιλαμβάνει:

• Ενότητα “groupdocstranslationcloud”, αυτό είναι το SDK. Μπορείτε να το ενσωματώσετε στην εφαρμογή σας. Περιέχει και το API μετάφρασης και αποθήκευσης
• Ενότητα “δοκιμή”, δοκιμές μονάδας. Μπορείτε να τους ρίξετε μια ματιά για να δείτε διάφορα παραδείγματα κώδικα.
• “Demo” σημειωματάριο Jupyter. Δείγμα δοκιμαστικού σημειωματάριου.

Εξαρτήσεις

• Δείτε τις απαιτήσεις.txt

Υποστήριξη εκδόσεων

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

Μετάφραση απλού κειμένου

# 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)

Τεκμηρίωση για τερματικά σημεία API

Όλα τα URI σχετίζονται με https://api.groupdocs.cloud/v2.0/translation

Τάξη |         | Μέθοδος | Αίτημα HTTP | Περιγραφή ———— |-| ————- | ————- | ————–TranslationApi|         |autoPost| ΘΕΣΗ/auto| Μεταφράστε οποιοδήποτε υποστηριζόμενο αρχείο TranslationApi|         |csvPost| ΘΕΣΗ/csv| Μετάφραση αρχείων CSV και TSVTranslationApi|         |documentPost| ΘΕΣΗ/document| Μετάφραση εγγράφων Microsoft Word, rtf, txt, odtTranslationApi|         |documentRequestIdGet| ΠΑΙΡΝΩ/document/{requestId}| Κατάσταση μετάφρασης του εγγράφου επιστροφής. Επιστρέψτε επίσης διευθύνσεις URL για τη λήψη του μεταφρασμένου εγγράφου εάν η μετάφραση ήταν επιτυχής TranslationApi|         |documentTrialPost| ΘΕΣΗ/document/trial| Δοκιμαστική μετάφραση εγγράφων Microsoft Word, rtf, txt, odt χωρίς συνομιλία. Μεταφράστε μόνο την πρώτη σελίδα ή 1000 σύμβολα.TranslationApi|         |hcGet| ΠΑΙΡΝΩ/hc| Έλεγχος υγείας για όλες τις υπηρεσίες.TranslationApi|         |htmlPost| ΘΕΣΗ/html| Μετάφραση αρχείων HTMLTranslationApi|         |hugoGet| ΠΑΙΡΝΩ/hugo| Λάβετε τη δομή σύνταξης hugo από το αρχείο markdownTranslationApi|         |hugoPost| ΘΕΣΗ/hugo| Εκτελέστε τη δομή σύνταξης hugo που αναλύει από το αρχείο markdownTranslationApi|         |imageToFilePost| ΘΕΣΗ/image-to-file| Μετάφραση εικόνας ή σαρωμένου pdf και επιστροφή αρχείου TranslationApi|         |imageToTextPost| ΘΕΣΗ/image-to-text| Μετάφραση κειμένου σε εικόνα ή σαρωμένο pdfTranslationApi|         |languagesGet| ΠΑΙΡΝΩ/languages| Επιστροφή λίστας διαθέσιμων ζευγών γλωσσών TranslationApi|         |markdownPost| ΘΕΣΗ/markdown| Μετάφραση αρχείων MarkdownTranslationApi|         |pdfPost| ΘΕΣΗ/pdf| Μετάφραση αρχείων pdfTranslationApi|         |pdfTrialPost| ΘΕΣΗ/pdf/trial| Δοκιμαστική μετάφραση pdf. Μεταφράστε μόνο την πρώτη σελίδα χωρίς μετατροπή σε άλλη μορφή.TranslationApi|         |presentationPost| ΘΕΣΗ/presentation| Μετάφραση παρουσιάσεων Microsoft PowerPoint, odpTranslationApi|         |resxPost| ΘΕΣΗ/resx| Μετάφραση αρχείων RESXTranslationApi|         |spreadsheetPost| ΘΕΣΗ/spreadsheet| Μετάφραση βιβλίων εργασίας του Microsoft Excel, odsTranslationApi|         |textPost| ΘΕΣΗ/text| Μετάφραση κειμένου TranslationApi|         |textRequestIdGet| ΠΑΙΡΝΩ/text/{requestId}| Επιστροφή κατάστασης μετάφρασης κειμένου. Επιστρέψτε επίσης μεταφρασμένο κείμενο εάν η μετάφραση ήταν επιτυχής TranslationApi|         |textTrialPost| ΘΕΣΗ/text/trial| Δοκιμαστική μετάφραση κειμένου. Μεταφράστε μόνο 1000 σύμβολα.

Τεκμηρίωση για μοντέλα

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

GroupDocs.Translation Cloud SKD

GitHub

Διαχειριστής πακέτων