Charticulator هي أداة رسم بياني جديدة تسمح لك بتصميم الرسوم البيانية عن طريق تحديد القيود بشكل تفاعلي.
اتبع الخطوات التالية لإعداد بيئة التطوير:
تثبيت وحدات العقدة:
yarn
انسخ ملف تكوين القالب وقم بتحرير محتوياته:
cp config.template.yml config.yml
# (on windows, use copy instead of cp)
قم بتشغيل الأمر التالي لإنشاء Charticulator، والذي سيؤدي إلى إنشاء حزمة مضمنة ذاتيًا في مجلد dist
:
yarn build
قم بتشغيل خادم ويب محلي لاختبار Charticulator:
# Serve Charticulator at http://localhost:4000
yarn server
# Serve Charticulator publicly at http://0.0.0.0:4000
# Use this if you want to enable access from another computer
yarn public_server
بالنسبة لبيئة التطوير المباشرة، استمر في تشغيل الأمر التالي:
yarn start
يراقب هذا الأمر أي تغيير في src/
و sass/
ويعيد ترجمة Charticulator تلقائيًا. بمجرد القيام بذلك، افتح http://localhost:4000/ لتشغيل Charticulator. الآن، عندما تقوم بتغيير كود المصدر، يمكن تحديث التطبيق ببساطة عن طريق تحديث صفحة المتصفح (قد تحتاج إلى تعطيل ذاكرة التخزين المؤقت للمتصفح).
في وضع التطوير، يوجد تطبيق اختبار لمكونات واجهة المستخدم، والذي يمكن الوصول إليه على http://localhost:4000/test.html.
لن يتم تحديث وضع الساعة عند تغيير ما يلي:
عند تحديث هذه، يرجى yarn build
مرة أخرى.
يمكنك إضافة نماذج بيانات مخصصة يمكن استخدامها مع Charticulator. للقيام بذلك، أنشئ مجلد datasets
في جذر المستودع (إذا لم يكن موجودًا)، وأضف ملف .csv
(أو .tsv
) إلى هذا المجلد، وأخيرًا أنشئ ملف files.json
في المجلد بما يلي محتويات:
[
{
"name": "",
"description": "",
"tables": [
{
"name": "",
"type": "",
"url": ""
}
]
}
]
يشتمل Charticulator حاليًا على رمز اختبار بدائي:
yarn test
هناك حاجة إلى المزيد من حالات الاختبار.
يرحب هذا المشروع بالمساهمات والاقتراحات. تتطلب معظم المساهمات منك الموافقة على اتفاقية ترخيص المساهم (CLA) التي تعلن أن لديك الحق في منحنا حقوق استخدام مساهمتك، بل وتفعل ذلك بالفعل. لمزيد من التفاصيل، قم بزيارة https://cla.microsoft.com.
عند إرسال طلب سحب، سيحدد روبوت CLA تلقائيًا ما إذا كنت بحاجة إلى تقديم CLA وتزيين العلاقات العامة بشكل مناسب (على سبيل المثال، التسمية، التعليق). ما عليك سوى اتباع التعليمات التي يقدمها لك الروبوت. سوف تحتاج إلى القيام بذلك مرة واحدة فقط عبر جميع اتفاقيات إعادة الشراء باستخدام CLA الخاصة بنا.
اعتمد هذا المشروع قواعد السلوك الخاصة بشركة Microsoft مفتوحة المصدر. لمزيد من المعلومات، راجع الأسئلة الشائعة حول قواعد السلوك أو اتصل بـ [email protected] لطرح أي أسئلة أو تعليقات إضافية.
قم بتشغيل yarn typedoc
لإنشاء صفحات التوثيق. ستكون الصفحة متاحة في ./docs/charticulator
نقطة بداية التوثيق هي صفحة الفهرس {@link "index"}