استوديو

scribe studio            # http://127.0.0.1:3600
scribe studio --port 4000

الاستوديو أداة تطوير محلية: HTML مصير على الخادم ولا يحتاج إلى خطوة بناء ولا مصادقة ويقرأ شجرة عملك الحية. يقوم الوكلاء والبشر بتحرير الملفات؛ والاستوديو هو المكان الذي يقوم فيه البشر برؤية والتحقق من كل ما يديره Scribe: تصفح المجموعات وفحص الإدخالات بعلاقات محلولة ومعاينات الأصول واكتشاف الصور السيئة أو المفقودة والإجابة على "ما الذي يستخدم هذا؟" قبل تغيير أي شيء. كما أنه يحمل لوحة معلومات الترجمة الحالية (التغطية وقائمة العمل واللقطات لكل مستند؛ راجع الترجمة).

متصفح المجموعات

على /types/:typeId، يسرد الشريط الجانبي كل نوع محتوى مع عدد الإدخالات وشارة مشكلة إجمالية. يعرض جدول الإدخال كل اسم لطيف وتحديد حقول رئيسية مشتق من المخطط (التعدادات والعلاقات كشرائح) ونقاط حالة الترجمة وشارات التحقق لكل إدخال.

مرشحات الحقول مشتقة من الاستبطان للمخطط وتعيش في معلمات الاستعلام (بحيث يمكن مشاركة عناوين URL وتصييرها على الخادم): تصبح حقول التعداد تحديدًا وتصبح حقول العلاقة تحديدًا للأسماء اللطيفة المستهدفة وتصبح القيم المنطقية مفتاح تبديل وتصبح السلاسل تطابق يحتوي على.

يمكن لأي نوع يحتوي على حقل أصل واحد على الأقل تبديل الجدول إلى شبكة بطاقات معرض؛ كل بطاقة هي صورة الأصل الأساسية بالإضافة إلى الاسم اللطيف والحقول الرئيسية والشارات. تطبق المرشحات بشكل مماثل. هذا هو جدار ضمان الجودة للصور المنشأة.

فاحص الإدخالات

/types/:typeId/:enSlug يصيّر الحقول حسب نوعها المستنبط:

• قابل للترجمة: القيمة مع مبدل اللغة (بيانات من المتجر)؛ يتم تمييز الخيار البديل باللغة الإنجليزية بوضوح عندما لا توجد ترجمة للغة.
• هيكلي: القيمة العادية.
• علاقة: رابط قابل للنقر إلى الإدخال المستهدف؛ تظهر المراجع المتدلية شارة حمراء.
• أصل: معاينة صورة مع عنوان URL محلول وحجم الملف وأبعاده؛ يظهر الملف المفقود شارة حمراء.
• مستخدم بواسطة: قسم مرجعي عكسي يسرد كل إدخال (أي نوع) تشير علاقاته إلى هنا.
• نص: تبديل بين خام / معاينة (?body=preview). تصيّر المعاينة Markdown و GFM بشكل صحيح وتظهر مكونات JSX غير المعروفة كصناديق مسماة مع خصائصها؛ تصبح رموز العلاقة روابط قابلة للنقر (تكون الرموز المتدلية مكسورة بشكل واضح) وتصيّر رموز الأصول كصور حقيقية. يظهر رابط "عرض على الموقع" للأنواع القابلة للتوجيه.

تتنقل مفاتيح الأسهم بين الإدخالات: ينتقل ArrowLeft / ArrowRight إلى الإدخال السابق / التالي من نفس النوع بالترتيب الافتراضي للمجموعة (بدون التفاف) مع الحفاظ على اللغة الحالية ومعلمات استعلام عرض النص. يتم تجاهل المفاتيح أثناء وجود التركيز في إدخال.

متصفح الأصول

/assets يعرض شبكة صور مصغرة واحدة لكل جذر مدار. يسرد كل أصل معاينته ومساره وحجمه وأبعاده وقائمة مشار إليه بواسطة لكل إدخال وحقل يشير إليه ومحسوب حيًا من وقت التشغيل في الذاكرة. تحدد الشارات غير المشار إليه (مرشح يتيم) والمفقود ولكنه مشار إليه وذو الحجم الزائد (يتجاوز الحقل maxKB) وانحراف التنسيق. راجع الأصول لنظام الحقول الأساسي.

البحث الشامل

/search?q= يشغل تطابق سلسلة فرعية غير حساس لحالة الأحرف على الأسماء اللطيفة الإنجليزية وكل قيمة في المقدمة ونصوص MDX الخام. يوجد نموذج بحث في كل صفحة؛ يتم تجميع النتائج حسب النوع مع مقتطف مظلل وتقتصر على 20 نتيجة لكل نوع.

حذف الإدخالات

يحتوي شريط أدوات الفاحص على زر حذف مصمم بشكل خطر. يفتح صفحة تأكيد تصيّر خطة الحذف الكاملة في أقسام (تتتاليات وفصل وأصول متأثرة وعدد المتجر لكل لغة وأي حواجز) ثم زر تأكيد أحمر (أو للحواجز عدم تأكيد لخطة محظورة). ينفذ التأكيد الخطة بالضبط: الملف المصدر وأصوله والترجمات واللقطات المخزنة وأي إعادة كتابة فصل ولا شيء آخر. يقود وضع onTargetDelete للعلاقة (restrict أو detach أو cascade) ووضع onDelete للأصل ما تفعله الخطة؛ نفس الخطة متاحة على سطر الأوامر عبر scribe delete. هذا هو الطريق الوحيد المتغير للاستوديو ويبقى أداة للمضيف المحلي فقط.

ما لا يفعله الاستوديو

لا يوجد تحرير للمحتوى أو تشغيل ترجمة أو تحميل صور أو مصادقة أو تصيير حقيقي لمكون MDX. يبقى التحرير في محرر الخاص بك و git؛ الاستوديو للمراجعة.