الصفحات

صفحات Markdown

للصفحة المكتوبة بـ Markdown نسخة بكل لغة، مترجمة كاملة. هذه صفحات هذا الموقع، وما يتطلبه الأمر، مع الأسطر التي تقوم به.

صفحات هذا الموقع

docs/tour.md
en-USThe tourالأصل
ar-EGجولةtranslatedFrom: 379ae94ae71a
th-THทัวร์translatedFrom: 379ae94ae71a

ما يتطلبه الأمر

نسخة لكل لغة

تُكتب الصفحة مرة واحدة تحت pages/ ولغة المصدر، ولكل لغة نسختها في المسار نفسه داخل مجلدها، مترجمة كاملة: العناوين والنص والعنوان والوصف في رأس الملف (frontmatter).

pages/en-US/docs/tour.md
title: The tour
pages/ar-EG/docs/tour.md
title: جولة

الإبلاغ عمّا صار قديمًا

تسجّل كل نسخة إصدار الأصل الذي تُرجمت منه. وعندما يتغيّر الأصل، يُبلغ vp dev بأن النسخة قديمة ويترجمها من جديد، ويفشل vp build بسببها، كما سيُظهر العمود أعلاه.

packages/void-fbtee/src/check.ts
export const TRANSLATED_FROM = "translatedFrom";

تواريخ وأرقام لكل قارئ

لا يُكتب التاريخ أو الرقم في الصفحة نصًا: بل هو جزيرة (island) تنسّقه بـ Intl للقارئ. وكل جزيرة في سطر خاص بها، لأن HTML الصفحة يُقطع عند كل واحدة.

pages/en-US/docs/tour.md
import Fmt from "../../../src/docs/Fmt.tsx" with { island: "load" }
pages/en-US/docs/tour.md
<Fmt num="1234567.891" />

مستخدمة هنا، ومشروحة في صفحة المكونات: langAttrs وuseLocales.

المرجع الكامل في مهارة void-fbtee.