الحصول على الكود
استنسخ مستودع corex-ui/soonex_i18n:
git clone https://github.com/corex-ui/soonex_i18n.git cd soonex_i18n لموقع بلغة واحدة بدون بادئة مسار لكل لغة، استخدم corex-ui/soonex.
التشغيل الأول
mix deps.get ثم mix setup (أو أوامر localize المناسبة)، ثم npm install داخل assets/، ثم mix assets.build وmix tableau.build أو mix tableau.server.
تغيير اسم المشروع
من جذر المستودع، اختر اسماً لـ OTP بصيغة snake_case (أحرف صغيرة وأرقام و_). التزم بتفرع أو commit أولاً, لا يوجد تراجع.
mix project.rename acme المهمة تحدّث lib/ وconfig/ وtest/ وpriv/ وmix.exs وبعض ملفات npm، ثم تعيد تسمية المجلدات lib/soonex_i18n/ وlib/soonex_i18n_web/ (وما يقابلهما في test/ إن وُجد). بعدها نفّذ mix format و**mix compile**.
ملفات _posts/ وREADME لا تُعدّل تلقائياً حتى تبقى روابط المستودعات كما هي؛ عدّل النصوص يدوياً عند الحاجة.
اللغة الافتراضة واللغات المتاحة
في lib/soonex_i18n/gettext.ex: default_locale وallowed_locales. اضبط :localize في config/config.exs (supported_locales وdefault_locale صريح مثل "en" حتى لا يعتمد البناء على متغير LANG في بيئات CI). كل منشور Markdown يحتاج permalink خاص به لكل لغة (مثل /en/docs/ و/ar/docs/).
السمة والوضع
السمات في lib/soonex_i18n/theme.ex واستيرادات CSS. الوضع الفاتح/الداكن عبر data-mode وlib/soonex_i18n/mode.ex.
إزالة السمة أو الوضع
في lib/layouts/root/demo.ex احذف كتلة <.select> للسمة أو <.toggle> للوضع أو الاثنين مع الإبقاء على مبدّل اللغة إن رغبت.
تلميح: بعد
mix tableau.buildراجع_site/ar/docs/index.html.