شغّلوا الشيفرة بـ 25 لغة، داخل الصفحة مباشرةً.

شيفرة تعيش في صفحاتكم

اكتبوا كتلة شيفرة مسوّرة مع اسم لغة، كما تفعلون على GitHub أو في Obsidian. في عرض القراءة أو العرض المقسوم تصبح خلية فيها زر «تشغيل». تبقى الشيفرة في نص Markdown الخاص بالصفحة، فتبقى الصفحات قابلة للنقل؛ وما تطبعه الخلية، والجداول التي تُرجعها، والرسوم البيانية التي ترسمها تُحفظ مع الصفحة وتعود عندما تفتحونها مجددًا.

```python
import pandas as pd
runs = pd.DataFrame({"month": ["Jan", "Feb", "Mar"], "km": [42, 51, 63]})
runs.describe()
```

25 لغة، على جهازكم

JavaScript, TypeScript, Python, SQL, Lua, Shell (emulated), Ruby, PHP, R, Perl, Go, Rust, C, C++, OCaml, Haskell, Zig, C#, F#, Java, Clojure, Elixir, Erlang, Scheme, Prolog.

تُنزَّل كل لغة في أول مرة تشغّلونها (من بضع مئات من الكيلوبايتات للغة Lua أو JavaScript إلى بضع عشرات من الميغابايتات للغة Rust)، ثم تعمل دون اتصال. ومن الإعدادات ← بيئات تشغيل الشيفرة يمكن تنزيلها مسبقًا، استعدادًا للطائرات والقطارات.

تعمل الشيفرة في إطار معزول مع عامل (worker) واحد لكل صفحة ولغة. لا يمكنها قراءة التطبيق ولا صفحاتكم الأخرى ولا الوصول إلى الشبكة: لا وصول للخلايا إلى الشبكة إلا إذا سمحتم بذلك لتلك الصفحة.

اعملوا كما في الدفاتر البرمجية

• تشغيل الكل، وتشغيل الخلايا أعلاه أو أدناه، وإعادة تشغيل بيئات التشغيل وتشغيل كل شيء من جديد، ومسح المخرجات.
• إدراج الخلايا ونقلها وحذفها من قائمة الخلية، وكل منها خطوة واحدة يمكن التراجع عنها. وتتبع المخرجات خليتها عند نقلها.
• الإيقاف يقاطع الخلية الجارية ويحتفظ بمتغيراتها؛ وإذا لم تتوقف الشيفرة خلال 3 ثوانٍ، يُعاد تشغيل بيئة التشغيل. ولكل تشغيل حدّ زمني.
• المتغيرات تعرض كل قيمة أنشأتها شيفرتكم، مع نوعها وملخص عنها.
• الشرح والإصلاح: يشرح المساعد الاختياري على الجهاز الخلية أو يقترح إصلاحًا تقبلونه أو ترفضونه كفروقات (diff).

مشاركة البيانات بين اللغات

يمكن لخلايا الصفحة الواحدة تمرير البيانات فيما بينها عبر اللغات: share(name, value) في خلية، وuse(name) في أخرى. وتصل الجداول جداولَ: شاركوا صفوفًا من JavaScript، ثم استعلموا عنها بـ SQL.

```js
share("runs", [{ month: "Jan", n: 4 }, { month: "Feb", n: 7 }])
```

```sql
select sum(n) as total from runs;
```

الإدخال والملفات والحزم

• يمكن للخلايا طلب إدخال (input()، prompt()، readline) وانتظار إجابتكم في الصفحة.
• الملفات المرفقة بالصفحة متاحة بأسمائها: pd.read_csv("sales.csv"). والملفات التي تكتبها الخلية يمكن حفظها في الصفحة أو تنزيلها.
• يأتي Python مع NumPy وpandas وSciPy وscikit-learn وmatplotlib وAltair وDuckDB وغيرها، دون اتصال؛ ويضيف %pip install حزمًا أخرى بعد أن تسمحوا بالشبكة لتلك الصفحة.

شغّلوا أول خلية برمجية في Vellum

1. افتحوا صفحة

   أنشئوا صفحة، أو افتحوا أي صفحة لديكم.

2. اكتبوا كتلة شيفرة

   اكتبوا ثلاث علامات backtick واسم لغة، مثل ```python، ثم شيفرتكم، ثم ثلاث علامات backtick لإغلاقها.

3. شغّلوها

   انتقلوا إلى عرض القراءة أو العرض المقسوم واضغطوا «تشغيل» على الخلية (أو Shift+Enter في محرر الخلية). تُنزَّل اللغة في المرة الأولى.

4. احتفظوا بالنتيجة

   تُحفظ المخرجات مع الصفحة. افتحوا قائمة الخلية لتجدوا «تشغيل الكل» و«المتغيرات» وأوامر الدفتر الأخرى.

في التطبيق

• تشغيل الشيفرة في صفحة Python و JavaScript و R و SQL وأكثر من 20 لغة أخرى، على هذا الجهاز.
• المتغيرات شاهدوا كل قيمة أنشأتها شيفرتكم.
• المشاركة بين اللغات شاركوا جدولًا بـ share() في JavaScript، واستعلموا عنه في SQL.
• الإدخال والملفات والرسوم البيانية تطرح الخلايا أسئلة، وتقرأ ملفاتكم، وترسم رسومًا بيانية.
• الشبكة والحزم لا تصل الخلايا إلى الويب ولا تثبّت الحزم إلا إذا سمحتم.
• العمل كدفتر تشغيل الكل أو ما فوق الخلية أو ما تحتها، ونقل الخلايا وإعادة تشغيلها.
• الشرح والإصلاح يشرح المساعد على الجهاز الشيفرة ويقترح إصلاحات.
• اللغات دون اتصال نزّلوا اللغات مسبقًا، للطائرات والقطارات.

أسئلة