تخطي إلى المحتوى
دليل Varlig
صفحة Varlig الرئيسية

مشاركة القيم بين الملاحظات

من المفيد جمع المعدلات والأسعار والصيغ التي تعتمد عليها في مكان واحد. ضعها في ملاحظة، ويمكن لأي ملاحظة أخرى استيرادها بسطر واحد، فينعكس تعديل المصدر على كل ملاحظة تستخدمه.

استخدم قيم ملاحظة أخرى

اكتب use و رابط الملاحظة، في سطر منفصل داخل كتلة الحساب:

calcتعتمد النتائج على تاريخ اليوم أو البيانات المباشرة
use [[Assumptions]] الناتج 2 values and 1 function from Assumptions

توضح النتيجة ما استُورد. وتعمل جميع الأسماء التي تعرّفها الملاحظة الأخرى كما لو كنت قد كتبتها هنا:

calcتعتمد النتائج على تاريخ اليوم أو البيانات المباشرة
use [[Assumptions]] الناتج 2 values and 1 function from Assumptions
margin($80) الناتج $100.00
$100 * rate الناتج $108.00

مع ملاحظة باسم Assumptions تحتوي على:

calc
rate = 1.08 الناتج 1.08
markup = 25% الناتج 25%
margin(cost) = cost + markup الناتج

تتوفر الأسماء المستوردة في جميع أجزاء الملاحظة التي تستخدمها، وليس فقط أسفل سطر use. تكون الأولوية للاسم الذي تعرّفه الملاحظة نفسها بدءًا من سطر تعريفه.

استيراد الأسماء التي تحتاجها فقط

اذكر الأسماء قبل from لاستيرادها وحدها:

calcتعتمد النتائج على تاريخ اليوم أو البيانات المباشرة
use margin, rate from [[Assumptions]] الناتج margin, rate from Assumptions, with markup that it reads

بهذا لا يمكن لأسماء المصدر الأخرى، مثل total إن كان معرّفًا فيه، أن تحل محل أسماء هذه الملاحظة. افصل الأسماء بفواصل؛ ويمكن أن يحتوي الاسم على مسافات، كما في use monthly rent, fee from [[Budget]]. تجلب الدالة القيم التي تعتمد عليها أيضًا، لتعطي النتيجة نفسها التي تعطيها في ملاحظتها الأصلية، ويوضح السطر تلك القيم.

إذا لم يعرّف المصدر اسمًا طلبته، بسبب خطأ كتابي أو تغيير اسمه هناك، يظهر خطأ ولا يُستورد أي شيء:

calcتعتمد النتائج على تاريخ اليوم أو البيانات المباشرة
use margn from [[Assumptions]] الناتج Error: No value or function named “margn” in Assumptions

كتابة السطر

  • يمكن كتابة use بحرف أول كبير (Use [[Rates 2026]])، ويمكن أن يتبعها تعليق يبدأ بـ// أو# .
  • لا يمكن وضع شيء آخر على السطر: لا تُعد use [[Assumptions]] * 2 عبارة استيراد.
  • يجب أن يكون السطر داخل كتلة حسابية. خارجها، يبقى نصًا عاديًا.
  • يمكن للملاحظة المصدر استخدام ملاحظة ثالثة، بعمق يصل إلى ثمانية مستويات من الملاحظات.

عندما لا يكون المصدر متاحا

لا يُبقي الاستيراد قيمة قديمة مطلقًا. إذا تعذرت قراءة المصدر، يوضح السطر ذلك وتظل الأسماء غير معرّفة:

حالة المصدر رسالة السطر
غير موجود Error: No note named “Assumptions”
محمي بكلمة مرور Error: “Assumptions” is protected — unlock it to use its values
في سلة المهملات Error: “Assumptions” is in the Trash — restore it to use its values
يستخدم هذه الملاحظة بدوره Error: Circular use: A → B → A

إعادة التسمية والحفاظ على التحديث

عند إعادة تسمية الملاحظة المصدر، يعيد Varlig كتابة أسطر use التي تشير إليها. تُعاد حسابات الملاحظة المفتوحة عندما تتغير ملاحظة تعتمد عليها، وتعيد كل ملاحظة قراءة مصادرها عند فتحها.

يُحسب كل مصدر وفق إعداداته الخاصة: الإعدادات المحلية للحسابات وتنسيقات النتائج وأسعار الصرف المثبّتة. تحتفظ الملاحظة المكتوبة لإعدادات منطقة معينة بمعناها عندما تستخدمها ملاحظة أخرى.

توضح نافذة الشرح المنبثقة مصدر الاسم المستورد، مثل rate = 1.08 (from Assumptions)، لتتمكن دائمًا من التمييز بين قيمة محلية وقيمة مشتركة.

لمعرفة ما يعتمد على قيمة قبل تغييرها، راجع الملاحظة المصدر. يعرض How Was This Read? على سطر يعرّف قيمة أو دالة قسم Used by 2 Notes، مع أسماء الملاحظات التي تستخدمها، مثل Invoice (uses every value). تبدأ Backlinks في الملاحظة المصدر بقسم Used in calculations by 2 notes، مع ما تستورده كل ملاحظة. لا تُحتسَب أسطر use كروابط خلفية عادية.