Files
SnapOtter/apps/docs/ar/tools/files/convert-document.md
T
SnapOtterandGitHub 4963ab3bbd feat(docs-i18n): translate all documentation into 20 languages
All 181 docs markdown files translated into 20 languages (apps/docs/<locale>/**). Companion to the i18n code PR; admin-merged because the file count exceeds GitHub's per-PR CI trigger limit. Validated by pnpm i18n:check (all surfaces, 0 stale/missing) and a clean all-locale docs build.
2026-07-11 13:52:47 +08:00

1.8 KiB

description, i18n_source_hash, i18n_provenance, i18n_output_hash
description i18n_source_hash i18n_provenance i18n_output_hash
التحويل بين تنسيقات Word وOpenDocument وRTF والنص العادي. 89771292569d human 947adc8e36b8

تحويل المستند

حوِّل المستندات بين تنسيقات Word (DOCX) وOpenDocument (ODT) وRTF والنص العادي باستخدام LibreOffice.

نقطة نهاية API

POST /api/v1/tools/files/convert-document

يقبل بيانات نموذج متعدد الأجزاء تحتوي على ملف Word/ODT/RTF/TXT وحقل JSON بصيغة settings.

المعاملات

المعامل النوع مطلوب الافتراضي الوصف
format string نعم - تنسيق الخرج: docx، odt، rtf، txt

مثال على الطلب

curl -X POST http://localhost:1349/api/v1/tools/files/convert-document \
  -H "Authorization: Bearer si_your-api-key" \
  -F "file=@report.docx" \
  -F 'settings={"format": "odt"}'

مثال على الاستجابة

يُرجع 202 Accepted. تابع التقدم عبر SSE على /api/v1/jobs/{jobId}/progress.

{
  "jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "async": true
}

ملاحظات

  • تنسيقات الدخل المقبولة: .docx، .doc، .odt، .rtf، .txt.
  • يتولّى LibreOffice المعالجة أثناء تشغيله بلا واجهة رسومية على الخادم.
  • قد لا يصمد التنسيق المعقّد (وحدات الماكرو، الكائنات المضمّنة) أثناء التحويل بين التنسيقات.
  • يجب أن يختلف تنسيق الخرج عن تنسيق الدخل.