Modüller, uygulamaların Crowdin Enterprise kullanıcı arayüzünü genişletmesini, harici hizmetler ile bütünleştirmeler oluşturmasını, vb. sağlar.
Yakında daha fazla Crowdin Uygulamalarının modülleri geliyor.
Bütünleştirmeler modülü, Crowdin Enterprise projesi içinde yeni bir bütünleştirme oluşturmayı ve eklemeyi sağlar. Bunu Bütünleştirmeler > Özel içinde bulabilirsiniz. Bu modül, yönetici izinlerine (veya daha yüksek) sahip proje üyeleri tarafından kullanılabilir.
Bütünleştirme modülü yapısı:
{
"integrations": [
{
"key": modül-anahtarınız",
"name": "Modül adı",
"description": "Modül açıklaması",
"logo": "/logo.png",
"url": "/bütünleştirme-sayfası"
}
]
}
Özellikler:
key | Tür: Zorunlu: evet Açıklama: Crowdin uygulaması içindeki modül tanımlayıcısı. |
name | Tür: Zorunlu: evet Açıklama: Modülün okunabilir adı. |
description | Tür: Açıklama: Modülün ne yaptığının okunabilir açıklaması. |
logo | Tür: Zorunlu: evet Açıklama: Crowdin Enterprise kullanıcı arayüzünde görüntülenecek olan bütünleştirmenin logosu için göreceli URL. |
url | Tür: Zorunlu: evet Açıklama: Crowdin Enterprise kullanıcı arayüzüne bütünleştirilecek modülün içerik sayfası için göreceli URL. |
environments | Tür: İzin verilen değerler: Açıklama: Bir modülün yüklenebildiği ortamlar kümesi. |
Kitle kaynağı-panelleri modülü projenin kitle kaynak kullanımı ortak sayfasında ek sekmeler oluşturmayı sağlar. Bu modülle çalışmak için projenizin aşağıdaki gereksinimleri karşıladığından emin olun:
Bu modül tüm yetkili kullanıcılar tarafından kullanılabilir.
Kitle kaynağı-paneli modülü yapısı:
{
"crowdsource-panels": [
{
"key": "modül-anahtarınız",
"name": "Modül adı",
"url": "/kitlekaynak-sayfası"
}
]
}
Özellikler:
key | Tür: Zorunlu: evet Açıklama: Crowdin uygulaması içindeki modül tanımlayıcısı. |
name | Tür: Zorunlu: evet Açıklama: Modülün okunabilir adı. |
url | Tür: Zorunlu: evet Açıklama: Crowdin Enterprise kullanıcı arayüzüne bütünleştirilecek modülün içerik sayfası için göreceli URL. |
Düzenleyici-panelleri modülü, Düzenleyicide ek paneller oluşturmayı sağlar. Bu modülü Crowdin uygulamanızda kullanırken, ek sekmelerin görüntülenmesini istediğiniz Düzenleyici kipini seçebilirsiniz. Düzenleyici-panelleri modülü, sadece Düzenleyiciye erişimi olan proje üyeleri tarafından kullanılabilir.
Düzenleyici-panel modülü yapısı:
{
"editor-panels": [
{
"key": "modül-anahtarınız",
"position": "right",
"name": "Modül adı",
"modes": ["translate", "proofread"],
"url": "/düzenleyici-sayfası"
}
]
}
Özellikler:
key | Tür: Zorunlu: evet Açıklama: Crowdin uygulaması içindeki modül tanımlayıcısı. |
position | Tür: Zorunlu: evet İzin verilen değerler: Açıklama: Modülün yerleştirileceği konum. |
name | Tür: Zorunlu: evet Açıklama: Modülün okunabilir adı. |
modes | Tür: Zorunlu: evet İzin verilen değerler: Açıklama: Modülün kullanılabileceği Düzenleyicinin kip listesi. |
url | Tür: Zorunlu: evet Açıklama: Crowdin Enterprise kullanıcı arayüzüne bütünleştirilecek modülün içerik sayfası için göreceli URL. |
environments | Tür: İzin verilen değerler: Açıklama: Bir modülün yüklenebildiği ortamlar kümesi. |
Kuruluş menüsü modülü, Çalışma alanı ana sayfasının sol panelinde yeni bir bölüm oluşturmayı sağlar. Bu modül sadece kuruluş yöneticileri tarafından kullanılabilir.
Kuruluş menüsü modülü yapısı:
{
"organization-menu": [
{
"key": "modül-anahtarınız",
"name": "Modül adı",
"url": "/kuruluş-sayfası"
"icon": "/images/icon.png"
}
]
}
Özellikler:
key | Tür: Zorunlu: evet Açıklama: Crowdin uygulaması içindeki modül tanımlayıcısı. |
name | Tür: Zorunlu: evet Açıklama: Modülün okunabilir adı. |
url | Tür: Zorunlu: evet Açıklama: Crowdin Enterprise kullanıcı arayüzüne bütünleştirilecek modülün içerik sayfası için göreceli URL. |
icon | Tür: Zorunlu: evet Açıklama: Crowdin Enterprise kullanıcı arayüzünde görüntülenecek olan yeni bölümün simgesi için göreceli URL. |
Proje menüsü modülü, proje ana sayfasının sol panelinde yeni bir bölüm oluşturmayı sağlar. Bu modül seçilen proje rollari için kullanılabilir.
Proje menüsü modülü yapısı:
{
"project-menu": [
{
"key": "modül-anahtarınız",
"name": "Modül adı",
"url": "/proje-sayfası"
}
]
}
Özellikler:
key | Tür: Zorunlu: evet Açıklama: Crowdin uygulaması içindeki modül tanımlayıcısı. |
name | Tür: Zorunlu: evet Açıklama: Modülün okunabilir adı. |
url | Tür: Zorunlu: evet Açıklama: Crowdin Enterprise kullanıcı arayüzüne bütünleştirilecek modülün içerik sayfası için göreceli URL. |
environments | Tür: İzin verilen değerler: Açıklama: Bir modülün yüklenebildiği ortamlar kümesi. |
Bu modül, Crowdin tarafından henüz desteklenmeyen makine çeviri motorlarını bağlamanıza yardımcı olur. Bu tür bir uygulama oluşturduktan sonra, içeriğinizi bağlı MÇ ile ön çevirisini yapabilir veya bunun tarafından yapılan çeviri önerilerinin çevirmenler için Düzenleyicide gösterilmesini sağlayabilirsiniz.
Özel MÇ modülü yapısı:
{
"custom-mt": [
{
"key": "özel-mç",
"name": "Özel MÇ",
"url": "/translate"
}
]
}
Özellikler:
key | Tür: Zorunlu: evet Açıklama: Crowdin uygulaması içindeki modül tanımlayıcısı. |
name | Tür: Zorunlu: evet Açıklama: Modülün okunabilir adı. |
url | Tür: Zorunlu: evet Açıklama: Crowdin ile bütünleştirilecek modülün içerik sayfası için göreceli URL. |
environments | Tür: İzin verilen değerler: Açıklama: Bir modülün yüklenebildiği ortamlar kümesi. |
Araçlar modülü, Crowdin Enterprise projesi içinde yeni bir araç sayfası oluşturmayı ve eklemeyi sağlar. Bunu Araçlar bölümünde bulabilirsiniz. Bu modül, yönetici izinlerine (veya daha yüksek) sahip proje üyeleri tarafından kullanılabilir.
Araçlar modülü yapısı:
{
"tools": [
{
"key": modül-anahtarınız",
"name": "Modül adı",
"description": "Modül açıklaması",
"logo": "/logo.png",
"url": "/araçlar-sayfası"
}
]
}
Özellikler:
key | Tür: Zorunlu: evet Açıklama: Crowdin uygulaması içindeki modül tanımlayıcısı. |
name | Tür: Zorunlu: evet Açıklama: Modülün okunabilir adı. |
description | Tür: Açıklama: Modülün ne yaptığının okunabilir açıklaması. |
logo | Tür: Zorunlu: evet Açıklama: Crowdin Enterprise kullanıcı arayüzünde görüntülenecek olan aracın logosu için göreceli URL. |
url | Tür: Zorunlu: evet Açıklama: Crowdin Enterprise kullanıcı arayüzüne bütünleştirilecek modülün içerik sayfası için göreceli URL. |
environments | Tür: İzin verilen değerler: Açıklama: Bir modülün yüklenebildiği ortamlar kümesi. |
Raporlar modülü, Crowdin Enterprise projesi içinde yeni bir rapor oluşturmayı ve eklemeyi sağlar. Bunu Çeviriler > Raporlar içinde bulabilirsiniz. Bu modül, yönetici izinlerine (veya daha yüksek) sahip proje üyeleri tarafından kullanılabilir.
Raporlar modülü yapısı:
{
"reports": [
{
"key": modül-anahtarınız",
"name": "Modül adı",
"description": "Modül açıklaması",
"logo": "/logo.png",
"url": "/raprolar-sayfası"
}
]
}
Özellikler:
key | Tür: Zorunlu: evet Açıklama: Crowdin uygulaması içindeki modül tanımlayıcısı. |
name | Tür: Zorunlu: evet Açıklama: Modülün okunabilir adı. |
description | Tür: Açıklama: Modülün ne yaptığının okunabilir açıklaması. |
logo | Tür: Zorunlu: evet Açıklama: Crowdin Enterprise kullanıcı arayüzünde görüntülenecek olan aracın logosu için göreceli URL. |
url | Tür: Zorunlu: evet Açıklama: Crowdin Enterprise kullanıcı arayüzüne bütünleştirilecek modülün içerik sayfası için göreceli URL. |
environments | Tür: İzin verilen değerler: Açıklama: Bir modülün yüklenebildiği ortamlar kümesi. |
Yeni özel dosya biçimlerinin desteğini eklemek için bu modülü kullanın. Özel bir dosya biçimi modülüne sahip bir uygulamaya ayrıştırma, kaynak dosya temsilen geçirilerek uygulanır. Çeviriler tamamlandığında Crowdin Enterprise, çeviri dosyaları oluşturma için Özel dosya biçimi uygulamasına çevirileri olan bir kaynak dosya ve dizgi dizilimi geçirir. Bu modül, yönetici izinlerine (veya daha yüksek) sahip proje üyeleri tarafından kullanılabilir.
Özel Dosya Biçimi modül yapısı:
{
"custom-file-format": [
{
"key": "modül-anahtar-türünüz-xyz",
"type": "tür-xyz",
"url": "/process",
"multilingual": true,
"signaturePatterns": {
"fileName": "^.+\\.xyz$",
"fileContent": "<properties>\\s*<property\\s+name=.*value=.*/>"
}
}
]
}
Özellikler:
key | Tür: Zorunlu: evet Açıklama: Crowdin uygulaması içindeki modül tanımlayıcısı. |
type | Tür: Zorunlu: evet Açıklama: Özel dosya biçimi tanımlayıcısı. Özel dosya biçimi uygulaması tarafından dosyaların işlenmesini zorlamak için API’de kullanılabilir. Eğer API’de |
url | Tür: Zorunlu: evet Açıklama: Dosya içe aktarma, güncelleme, çeviri yükleme ve dışa aktarmada tetiklenen göreceli URL. |
multilingual | Tür: Zorunlu: hayır İzin verilen değerler: Açıklama: Bu parametre, Crowdin Enterprise projenizde çevirileri yüklerken ve indirirken birden çok dilin içeriğini tek bir istekte birleştirmek için kullanılır. |
signaturePatterns | Tür: Açıklama: Kullanıcı arayüzü (veya belirtilen Not: fileContent düzenli ifadesi, dosya içeriğinin sadece ilk 64 KB’ını denetler. |
İlk dosya içe aktarma işleminde, sistem signaturePatterns
veya type
parametrelerini kullanarak özel dosya biçimini algılar ve daha fazla işlem için uygulamanın URL’sine ($baseUrl . $url
) bir HTTP isteğinde bulunur. Ardından uygulama dosyayı özel bir biçimde işler ve sisteme yanıt verir. Özel dosya biçimi uygulamalarına gelen ve uygulamalardan gelen istek ve yanıtların iki dakikalık zaman aşımı vardır. En büyük istek ve yanıt yükü boyutu 5 MB ile sınırlıdır.
İstek yükü örneği:
// en fazla istek yükü - 5 MB
// bekleme zaman aşımı - 2 dakika
{
"jobType": "parse-file | build-file",
"organization": {
"id": 1,
"domain": "{domain}",
"baseUrl": "https://{domain}.crowdin.com",
"apiBaseUrl": "https://{domain}.api.crowdin.com"
},
"project": {
"id": 1,
"identifier": "proje-tanımlayıcınız",
"name": "Proje Adınız"
},
"file": {
"id": 1,
"name": "dosya.xml",
"content": "VGhpcyBpcyBmaWxlIGNvbnRlbnQ=", // base64 kodlanmış kaynak dosya içeriği
"contentUrl": "https://crowdin-tmp.downloads.crowdin.com/1/dosya.xml?aws-signature=..." // source file public URL
},
"sourceLanguage": {
"id": "tr",
"name": "Turkish",
"editorCode": "tr",
"twoLettersCode": "tr",
"threeLettersCode": "tur",
"locale": "tr-TR",
"androidCode": "tr-rTR",
"osxCode": "tr.lproj",
"osxLocale": "tr",
"pluralCategoryNames": ["one"],
"pluralRules": "(n != 1)"
},
"targetLanguages": [{
// sourceLanguage ile aynı yapı, yeni bir kaynak dosya yüklerken boş, import_translations ve export için bir öğe, çokdilli dosyalar için daha fazla olabilir
}],
"strings": [...], // yapı dosyası işleri için parça dizilimi
"stringsUrl": "https://tmp.downloads.crowdin.com/strings.ndjson", // yapı dosyası işleri için, parçaların olduğu dosya, yeni satırla ayrılmış json biçiminde
}
Özellikler:
jobType | Tür: Olası değerler: Açıklama: Uygulama tarafından yürütülmesi gereken eylemi belirtir. |
file.content , file.contentUrl | Tür: Açıklama: Base64 kodlanmış kaynak dosya içeriğini ( |
strings , stringsUrl | Tür(strings): Tür(stringsUrl) Açıklama: Çevirileri indirmek için kullanılan parametreler (sadece |
Yanıt yükü örneği:
// en fazla yanıt yükü - 5 MB
// bekleme zaman aşımı - 2 dakika
{
"data": {
"strings": [...], // parçaların dizilimi
"stringsUrl": "https://app.ornek.com/jKe8ujs7a-parcalar.ndjson", // ayrıştırılmış dizgileri olan yeni satırla ayrılmış json dosyası
"preview": "VGhpbmdzIGFyZSBvbmx5IGltcG9zc2libGUgdW50aWwgdGhleSdyZSBub3Qu", // isteğe bağlı, base64 kodlanmış önizleme html dosyası içeriği, çoğul dizgiler varsa desteklenmez
"previewUrl": "https://app.ornek.com/LN3km2K6M-preview.html", // isteğe bağlı, önizleme html dosyasının URL’si, çoğul dizgiler varsa desteklenmez
},
"error": {
"message": "Hata iletiniz"
}
}
Özellikler:
data.strings , data.stringsUrl | Tür(data.strings): Tür(data.stringsUrl) Açıklama: Ayrıştırılmış dizgiler içeriğini geçirmek için kullanılan parametreler. |
preview , previewUrl | Tür(preview): Tür(previewUrl) Açıklama: Uygulama tarafından oluşturulabilen ayrıştırılmış dizgiler içeriğinin isteğe bağlı HTML önizlemesini geçirmek için kullanılan parametreler. Oluşturulan HTML önizlemesi Düzenleyicide görüntülenecektir. HTML Önizleme dosyası örneğine bakın. Not: Uygulama çoğul olan dizgileri geçirirse HTML önizlemesi Crowdin Düzenleyicisi’nde görüntülenmeyecektir. |
error.message | Tür: Açıklama: Uygulamadan Crowdin Enterprise’a geçirilebilen ve kullanıcı arayüzündeki bir kullanıcı tarafından görülebilecek bir hata iletisi. |
Yanıt yükü örneği:
// en fazla yanıt yükü - 5 MB
// bekleme zaman aşımı - 2 dakika
{
"data": {
"content": "TWF5IHRoZSBGb3JjZSBiZSB3aXRoIHlvdS4=", // base64 kodlanmış çeviri dosyası içeriği
"contentUrl": "https://app.ornek.com/p5uLEpq8p-result.xml", // çeviri dosyası ortak URL’si
},
"error": {
"message": "Hata iletiniz"
}
}
Özellikler:
data.content , data.contentUrl | Tür(data.content) Tür(data.contentUrl) Açıklama: Base64 kodlanmış çeviri dosyası içeriğini ( |
error.message | Tür: Açıklama: Uygulamadan Crowdin Enterprise’a geçirilebilen ve kullanıcı arayüzündeki bir kullanıcı tarafından görülebilecek bir hata iletisi. |
Aşağıda, parse-file
iş türü için uygulamadan beklenen ve build-file
iş türü için uygulamaya geçirilen dizgilerin yapısının bir örneğini görebilirsiniz.
Yük örneği:
// dizgiler URL tarafından geçirildiyse "yeni satırla ayrılmış json" biçiminde olmalıdır
[{ // çoğul olmayan dizgi
"previewId": 1, // sadece "parse-file" jobType için, dosyanın HTML önizlemesi oluşturulduğunda gereklidir
"id": 1, // sadece "build-file" jobType için
"identifier": "string-key-1", // zorunlu
"context": "Bazı içerik", // isteğe bağlı
"customData": "en fazla 4 KB özel veri", // isteğe bağlı
"maxLength": 10, // isteğe bağlı, varsayılan null
"isHidden": false, // isteğe bağlı, varsayılan false
"hasPlurals": false, // isteğe bağlı, varsayılan false
"labels": ["label-one", "label-two"], // isteğe bağlı, varsayılan []
"text": "Dizgi kaynak metni", // zorunlu
"translations": { // isteğe bağlı
"tr": { // targetLanguage.id
"text": "Çeviri yazısı", // zorunlu
"status": "untranslated | translated | approved" // isteğe bağlı, varsayılan "translated"
},
// çok dilli için diğer diller olabilir, istek yükünde "targetLanguages" parametresini gözden geçirin
}
},
{ // çoğul dizgi
"previewId": 2,
"id": 2,
"identifier": "string-key-2",
"context": "Bazı isteğe bağlı bağlamlar",
"customData": "en fazla 4 KB özel veri",
"maxLength": 15,
"isHidden": false,
"hasPlurals": true,
"labels": [],
"text": { // sourceLanguage.pluralCategoryNames parametresinden gelen anahtarlar
"one": "One file",
"other": "%d files",
},
"translations": {
"tr": {
"text": { // targetLanguage.pluralCategoryNames parametresinden gelen anahtarlar
"one": "Bir dosya",
"few": "%d dosya",
"many": "%d dosya",
},
"status": {
"one": "untranslated",
"few": "translated",
"many": "approved",
}
}
}
}]
Özellikler:
previewId | Tür: Zorunlu: evet (sadece dosyanın HTML önizlemesi oluşturulduğunda Açıklama: HTML Önizleme dosyasındaki dizginin sayısal tanımlayıcısı. Sadece |
id | Tür: Açıklama: Crowdin Enterprise projenizde dizginin sayısal tanımlayıcısı. Sadece |
identifier | Tür: Açıklama: Dosya içinde benzersiz dizgi anahtarı. |
customData | Tür: Açıklama: Dizgiye bağlantılanması gereken tüm özel veriler. Eklenen özel veriler, çeviri dışa aktarmada karşılık gelen dizgiler boyunca dışa aktarılacaktır. |
Dosyanın HTML Önizlemesi
Dosyanın HTML Önizlemesi örneği:
<html lang="en">
<head>
<title>İsteğe Bağlı Başlık</title>
<style>
table, th, td { border: 1px solid #aaa; }
</style>
</head>
<body>
<h1 style="text-align: center">Dosyanın HTML önizlemesi</h1>
<table style="width: 100%">
<tr>
<th>Anahtar:</th>
<th>Metin:</th>
</tr>
<tr>
<td>Anahtar 1</td>
<td><span id="string_preview_id_1">Kaynak Metin 1</span></td> <!-- 1, dizgilerin json içindeki previewId’dir -->
</tr>
<tr>
<td>Anahtar 2</td>
<td><span id="string_preview_id_2">Kaynak Metin 2</span></td> <!-- 2, dizgilerin json içindeki previewId’dir -->
</tr>
</table>
</body>
</html>
Bağlam menüsü modülü, öğenin mümkün olduğu yerde bağlam menüsünde oluşturulmasına izin verir. Şu anda modül aşağıdaki bağlam menülerine eklenebilir:
Ayrıca, bu modül aşağıdaki eylem türlerini gerçekleştirebilir:
Bu modül tüm yetkili kullanıcılar tarafından kullanılabilir.
Bağlam menüsü modülü yapısı:
{
"context-menu": [
{
"key": modül-anahtarınız",
"name": "Modül adı",
"description": "Modül açıklaması",
"options": {
"location": "/modal",
"type": "modal"
}
}
]
}
Özellikler:
key | Tür: Zorunlu: evet Açıklama: Crowdin uygulaması içindeki modül tanımlayıcısı. |
name | Tür: Zorunlu: evet Açıklama: Modülün okunabilir adı. Bağlam menüsü metni olarak kullanır |
description | Tür: Açıklama: Modülün ne yaptığının okunabilir açıklaması. |
options.location | Tür: Zorunlu: evet İzin verilen değerler: Açıklama: Kullanıcı arayüzünde bağlam menüsünün eklenebileceği konum. |
options.type | Tür: Zorunlu: evet İzin verilen değerler: Açıklama: Bu modülün gerçekleştireceği eylem türü. |
environments | Tür: İzin verilen değerler: Açıklama: Bir modülün yüklenebildiği ortamlar kümesi. |
Modal modülü, yeni bir kalıcı ileti öğesi oluşturmaya izin verir. Şu anki modül, sadece onu açan Bağlam menüsü modülüyle çalışır.
Modal modülü yapısı:
{
"context-menu": [
{
"key": "modül-anahtarınız",
"name": "Modül adı",
"url": "/module-url"
}
]
}
Özellikler:
key | Tür: Zorunlu: evet Açıklama: Crowdin uygulaması içindeki modül tanımlayıcısı. |
name | Tür: Zorunlu: evet Açıklama: Modülün okunabilir adı. Bağlam menüsü metni olarak kullanır |
url | Tür: Zorunlu: evet Açıklama: Kullanıcı arayüzüne bütünleştirilecek modülün içerik sayfası için göreceli URL’si. |
environments | Tür: İzin verilen değerler: Açıklama: Modülün çalışacağı ortamı tanımlayın. |
Uygulamanızda bir modül kullanmak için gerekli özellikler de dahil olmak üzere modülü, modüller altındaki Uygulama Tanımlayıcısı dosyanızda tanımlayın. Dahil ettiğiniz özellikler modülünüzün özelleştirme seçeneklerini denetler.
Temel modül yapısı:
{
"{module_type}": [
{
"key": "modül-anahtarınız",
"name": "Modül Adı",
}
]
}
Özellikler:
{module_type} | Tür: Zorunlu: evet İzin verilen değerler: Açıklama: Crowdin uygulamasının kullandığı modül türü. |
key | Tür: Zorunlu: evet Açıklama: Crowdin uygulaması içindeki modül tanımlayıcısı. |
name | Tür: Zorunlu: evet Açıklama: Modülün okunabilir adı. |