Lingo.dev + .md/.mdx (التوثيق)

تقوم واجهة سطر أوامر Lingo.dev بترجمة وثائق Markdown وMDX والمدونات والمحتوى مع الحفاظ على التنسيق وكتل الشفرة والروابط ومكونات React والعناصر التفاعلية. تستخدم واجهة سطر الأوامر مجموعة mdx كتكوين موصى به لكل من ملفات .md و.mdx، مما يحمي كتل الشفرة والشفرة المضمنة من الترجمة، ويحافظ على عناوين URL مع ترجمة الأوصاف، والحفاظ على بيانات frontmatter، والحفاظ على مكونات React والاستيرادات سليمة، وترجمة خصائص JSX بذكاء، والعمل بسلاسة مع Next.js وGatsby وأدوات MDX.

الإعداد السريع

قم بالتكوين باستخدام مجموعة mdx لكل من ملفات Markdown وMDX:

{
  "locale": {
    "source": "en",
    "targets": ["es", "fr", "de"]
  },
  "buckets": {
    "mdx": {
      "include": ["docs/[locale]/*.md", "content/[locale]/*.mdx"]
    }
  }
}

تذكير: [locale] هو عنصر نائب يجب أن يبقى في التكوين حرفيًا، حيث يتم استبداله باللغة الفعلية أثناء تشغيل واجهة سطر الأوامر.

ترجمة التوثيق

npx lingo.dev@latest i18n

تترجم المحتوى مع الحفاظ على جميع تنسيقات Markdown ومكونات React في MDX.

معالجة محتوى Markdown

الحفاظ على كتل الشفرة

```javascript
const message = "Hello, world!";
console.log(message);
```

تبقى الشفرة دون ترجمة بينما تتم ترجمة الشروحات المحيطة.

معالجة الروابط والمراجع

Visit [our website](https://example.com) for more details.

See the [configuration guide](./config.md) for setup instructions.

تبقى عناوين URL والمسارات النسبية سليمة بينما تتم ترجمة نص الرابط.

حماية Frontmatter

---

title: "Getting Started"
date: 2024-01-15
tags: ["tutorial", "beginner"]

---

# البدء

يبدأ المحتوى الخاص بك هنا...

تبقى بيانات YAML frontmatter دون تغيير بينما تتم ترجمة المحتوى.

ميزات مكونات MDX

كتل مكونات React

import { Alert } from "@components/Alert";

# دليل الترحيب

<Alert type="info">هذه معلومات مهمة للمستخدمين.</Alert>

يتم ترجمة محتوى الماركداون العادي هنا.

تظل استيرادات المكونات و JSX سليمة بينما تتم ترجمة المحتوى النصي.

عناصر JSX المضمنة

إليك زر <Button variant="primary">ابدأ الآن</Button> في النص.

يبقى المكون كما هو، ولكن تتم ترجمة "ابدأ الآن".

خصائص ذات محتوى قابل للترجمة

<VideoPlayer
  title="فيديو تعريفي"
  description="تعلم الأساسيات في 5 دقائق"
  src="/videos/intro.mp4"
/>

تتم ترجمة خصائص النصوص بينما تبقى الخصائص التقنية دون تغيير.

عبارات التصدير

export const title = "دليل المستخدم";
export const published = "2024-01-15";

# {title}

يبدأ المحتوى هنا...

تتم ترجمة الصادرات المسماة ذات المحتوى القابل للترجمة.

المقدمة الأمامية مع المكونات

---

title: "البدء"
components:
  - Alert
  - CodeBlock

---

import { Alert, CodeBlock } from "@components";

<Alert>مرحبًا بك في منصتنا!</Alert>

الإعدادات المتقدمة

دلائل محتوى متعددة

"mdx": {
  "include": [
    "docs/[locale]/*.md",
    "content/[locale]/*.mdx",
    "blog/[locale]/*.{md,mdx}"
  ]
}

ملاحظة: لا يتم دعم النجمتين المزدوجتين (**) في أنماط glob. استخدم النجمة الواحدة (*) لمطابقة الملفات داخل الدلائل.

استبعاد ملفات محددة

"mdx": {
  "include": ["docs/[locale]/*.{md,mdx}"],
  "exclude": ["docs/[locale]/drafts/*.{md,mdx}"]
}

قفل خصائص المكونات

"mdx": {
  "include": ["content/[locale]/*.{md,mdx}"],
  "lockedKeys": ["src", "href", "id", "className"]
}