Files
SnapOtter/apps/docs/ar/tools/files/html-to-pdf.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.6 KiB

description, i18n_source_hash, i18n_provenance, i18n_output_hash
description i18n_source_hash i18n_provenance i18n_output_hash
تحويل ملف HTML إلى PDF. 20b9ae147db5 human b2aca2c04399

HTML إلى PDF

حوِّل ملف HTML إلى مستند PDF منسّق. تُعطَّل الموارد البعيدة (الصور وأوراق الأنماط والنصوص البرمجية الخارجية) للحفاظ على الخصوصية.

نقطة نهاية API

POST /api/v1/tools/files/html-to-pdf

يقبل بيانات نموذج متعدد الأجزاء تحتوي على ملف HTML.

المعاملات

ليس لهذه الأداة معاملات قابلة للتهيئة. ارفع ملف HTML وسيُحوَّل إلى PDF.

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

curl -X POST http://localhost:1349/api/v1/tools/files/html-to-pdf \
  -H "Authorization: Bearer si_your-api-key" \
  -F "file=@page.html"

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

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

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

ملاحظات

  • تنسيقات الدخل المقبولة: .html، .htm.
  • لا تُجلب الموارد البعيدة (الصور وأوراق الأنماط والنصوص البرمجية المشار إليها عبر روابط URL) حفاظًا على الخصوصية والأمان.
  • تُحفَظ الأنماط المضمّنة والصور المدمجة (روابط data URI).
  • يتولّى WeasyPrint المعالجة على الخادم.