Charticulator هي أداة رسم بياني جديدة تسمح لك بتصميم الرسوم البيانية عن طريق تحديد القيود بشكل تفاعلي.
دونغهاو رن
بونجشين لي
ماثيو بريمر
ناثان إيفانز
كيت ليتفينيتس
ديفيد تيتسورث
كريس تريفينو
اتبع الخطوات التالية لإعداد بيئة التطوير:
تثبيت العقدة 8.0+: https://nodejs.org/
تثبيت Yarnjs 1.7+: https://yarnpkg.com/
تثبيت وحدات العقدة:
غزل
انسخ ملف تكوين القالب وقم بتحرير محتوياته:
cp config.template.yml config.yml# (في نظام التشغيل Windows، استخدم نسخة بدلاً من cp)
قم بتشغيل الأمر التالي لإنشاء Charticulator، والذي سيؤدي إلى إنشاء حزمة مضمنة ذاتيًا في مجلد dist :
بناء الغزل
قم بتشغيل خادم ويب محلي لاختبار Charticulator:
# خدمة Charticulator على http://localhost:4000yarn server# خدمة Charticulator علنًا على http://0.0.0.0:4000# استخدم هذا إذا كنت تريد تمكين الوصول من كمبيوتر آخر public_server
بالنسبة لبيئة التطوير المباشرة، استمر في تشغيل الأمر التالي:
بداية الغزل
يراقب هذا الأمر أي تغيير في src/ و sass/ ويعيد ترجمة Charticulator تلقائيًا. بمجرد القيام بذلك، افتح http://localhost:4000/ لتشغيل Charticulator. الآن، عندما تقوم بتغيير كود المصدر، يمكن تحديث التطبيق ببساطة عن طريق تحديث صفحة المتصفح (قد تحتاج إلى تعطيل ذاكرة التخزين المؤقت للمتصفح).
في وضع التطوير، يوجد تطبيق اختبار لمكونات واجهة المستخدم، والذي يمكن الوصول إليه على http://localhost:4000/test.html.
لن يتم تحديث وضع الساعة عند تغيير ما يلي:
config.yml
THIRD_PARTY.yml
webpack.config.js
عند تحديث هذه، يرجى yarn build مرة أخرى.
يمكنك إضافة نماذج بيانات مخصصة يمكن استخدامها مع Charticulator. للقيام بذلك، أنشئ مجلد datasets في جذر المستودع (إذا لم يكن موجودًا)، وأضف ملف .csv (أو .tsv ) إلى هذا المجلد، وأخيرًا أنشئ ملف files.json في المجلد بما يلي محتويات:
[
{
"name": "<Your dataset display name>",
"description": "<Your dataset desription>",
"tables": [
{
"name": "<Your dataset file name without extension>",
"type": "<csv || tsv>",
"url": "<Your dataset file name with extension>"
}
]
}
]يشتمل Charticulator حاليًا على رمز اختبار بدائي:
اختبار الغزل
هناك حاجة إلى المزيد من حالات الاختبار.
يرحب هذا المشروع بالمساهمات والاقتراحات. تتطلب معظم المساهمات منك الموافقة على اتفاقية ترخيص المساهم (CLA) التي تعلن أن لديك الحق في منحنا حقوق استخدام مساهمتك، بل وتفعل ذلك بالفعل. لمزيد من التفاصيل، قم بزيارة https://cla.microsoft.com.
عند إرسال طلب سحب، سيحدد روبوت CLA تلقائيًا ما إذا كنت بحاجة إلى تقديم CLA وتزيين العلاقات العامة بشكل مناسب (على سبيل المثال، التسمية، التعليق). ما عليك سوى اتباع التعليمات التي يقدمها لك الروبوت. سوف تحتاج إلى القيام بذلك مرة واحدة فقط عبر جميع اتفاقيات إعادة الشراء باستخدام CLA الخاصة بنا.
اعتمد هذا المشروع قواعد السلوك الخاصة بشركة Microsoft مفتوحة المصدر. لمزيد من المعلومات، راجع الأسئلة الشائعة حول قواعد السلوك أو اتصل بـ [email protected] لطرح أي أسئلة أو تعليقات إضافية.
قم بتشغيل yarn typedoc لإنشاء صفحات التوثيق. ستكون الصفحة متاحة في ./docs/charticulator
نقطة بداية التوثيق هي صفحة الفهرس {@link "index"}
