التصدير

ملف ZIP يحوي ملاحظاتك والملفات التي تستعملها، ملاحظةً واحدة أو مجلدًا أو وسمًا أو الخزانة كلها، وأي ملاحظة صفحةَ HTML مستقلة.

خزانتك مجلد من ملفات ماركداون، ولا شيء مما يفعله أسطرلاب يغيّر ذلك أبدًا. انسخ المجلد تحصل على نسخة. أما التصدير فللحظات التي لا تكون فيها النسخة العادية بالشكل المطلوب: حين تريد هذا المجلد ومعه الصور التي يستعملها هو وحده؛ أو كل ملاحظة تحمل وسمًا معيّنًا؛ أو نسخةً تظل فيها [[الروابط الويكية]] تعمل في أداة لا تفهمها؛ أو ملاحظةً واحدة صفحةً واحدة ترسلها بالبريد إلى من لا خزانة عنده أصلًا.

اضغط Ctrl/Cmd P وشغّل تصدير…، أو انقر بالزر الأيمن على مجلد في الشجرة واختر تصدير المجلد…. كلاهما يفتح الورقة الصغيرة نفسها. والتصدير للمشرف وحده: فزائر موقعك عنده الموقع، والأرشيف لا يغادر خادمك أبدًا إلا إلى مجلد تنزيلاتك أنت.

الأرشيف


ما الذي يُصدَّر	هذه الملاحظة، أو مجلد (النقر الأيمن في الشجرة يبدأ هنا، على ذلك المجلد؛ واختر… ينتقي غيره أو جذر الخزانة)، أو وسم (كل ملاحظة تحمله، سواء كان `#وسمًا` في النص أو `tags:` في المقدمة، ومعه الوسوم المتفرّعة منه)، أو الخزانة كلها.
المرفقات	مضمّنة تأخذ كل ملف تشير إليه الملاحظات المصدَّرة، بكل طريق يعرفه القارئ: `![[التضمينات]]`، و`![alt](Media/x.png)`، و`banner:` الملاحظة، و`cover:` المتتبِّع، وملف svg بجانب الرسم المضمَّن. ولا شيء غير ذلك؛ فالصورة التي لا تستعملها أي ملاحظة مصدَّرة تبقى في مكانها. أما الملاحظات فقط فتتركها كلها.
المسارات في الداخل	مسارات الخزانة نفسها: `Folder/Note.md` و`Media/cover.png`، أيًّا كان النطاق. فكّ ضغط تصديرين في مجلد واحد تحصل على ترتيب الخزانة، لا على ترتيبين متنافسين. والأسماء العربية تنجو، لأن الأرشيف يعلّم كل اسم على أنه UTF-8.
البايتات	كما هي على القرص، إلا إذا طلبت روابط قياسية (أدناه). وأوقات التعديل محفوظة إلى الثانية. والأرشيف مخزَّن بلا ضغط: فمعظم حجم الخزانة صورها، وهي مضغوطة أصلًا، والغاية من التصدير الأمانة.
السطر تحت الأزرار	قبل أن تنزّل، تسأل الورقةُ الخادمَ عمّا سيحمله هذا التنزيل وتطبعه، ١٢ ملاحظة، ٤ ملفات · ٣٫٢ ميغابايت، فيكون الرفض جملةً هنا لا تنزيلًا فاشلًا في قائمة متصفحك.
الحد	غيغابايتان. وفوقهما تقول الورقة ذلك وتطلب منك تصدير مجلد أو وسم في كل مرة.

والتنزيل تنزيلُ متصفحك نفسه، بشريط تقدّمه ومجلد تنزيلاته، ويُسمّى باسم ما صدّرته واليوم: Ideas 2026-09-14.zip، وقراءة 2026-09-14.zip، وvault 2026-09-14.zip.

الروابط في النسخ

تترابط ملاحظات أسطرلاب بـ[[الروابط الويكية]]، أي اسم الملاحظة بين قوسين مربّعين مزدوجين، وكذلك ملاحظات أوبسيديان. أما معظم أدوات ماركداون الأخرى (مولّد موقع ثابت، أو GitHub، أو عارض عادي) فلا تفهمها. ويقرّر خيار الروابط في النسخ ما تحمله الملفات المصدَّرة:

إبقاء [[الروابط الويكية]]، وهو الافتراضي. تكون الملفات بايتًا ببايت كما هي على القرص، وهذا هو التصدير الصحيح إلى خزانة أسطرلاب أو أوبسيديان أخرى.
روابط ماركداون قياسية: كل [[ملاحظة]] و[[ملاحظة#عنوان|تسمية]] و![[صورة.png]] في النسخ المصدَّرة يُعاد كتابته رابطًا نسبيًّا يعمل بعد فكّ الضغط: [ملاحظة](../ملاحظة.md)، و[تسمية](../ملاحظة.md#عنوان)، و![صورة.png](Media/صورة.png). وتُحوَّل العناوين إلى معرّفات كما يفعل عرض القراءة تمامًا، فيصير #عنواني الكبير هو #عنواني-الكبير. أما الملاحظة المضمَّنة (![[أخرى]]) فلا نظير قياسيًّا لها، فتصير رابطًا إليها.

وثمّة حدّان نقولهما بصراحة. خزانتك لا تُمسّ أبدًا؛ فإعادة الكتابة تحدث في الأرشيف ولا في مكان سواه. والرابط إلى ملاحظة ليست في التصدير يبقى كما كُتب بالضبط: فرابط [ملاحظة](ملاحظة.md) يشير إلى ملف غير موجود أسوأ من [[ملاحظة]] التي كتبتها أنت، لأن الأخيرة تقول على الأقل ما كانت عليه. وتُترك كتل الكود والكود المضمّن في السطر وشأنها للسبب نفسه: فالرابط الويكي بداخلها نصٌّ عن الروابط الويكية، لا رابط.

ملاحظة واحدة صفحةَ HTML

حين تختار هذه الملاحظة تعرض الورقة زرًّا ثانيًا هو تصدير كـ HTML. يبني هذا الزر ملف .html واحدًا في متصفحك، من غير أن يطلب من الخادم شيئًا لا تطلبه قراءة الملاحظة أصلًا، ويسلّمه إلى تنزيلاتك:

معروضة كما تقرؤها بالضبط. المعرِّض نفسه الذي يستعمله عرض القراءة، مع حذف بطاقة الخصائص وأزرار التطبيق، كما تحذفها الطباعة.
وسمتك مضمّنة فيها. تُكتب ألوان السمة التي تقرأ فيها وخطوطها ومقاساتها داخل الصفحة على هيئة خصائص CSS مخصصة، ومعها أوراق أنماط القراءة نفسها. افتحها في أي مكان تبدُ كأسطرلابك.
والصور داخل الملف. تُجلب كل صورة تعرضها الملاحظة وتُكتب داخل الصفحة نفسها نصًّا (على هيئة data URI)، فتكون الصفحة كاملة بذاتها. أما الصورة التي يتعذّر جلبها، أو التي تتجاوز 25 ميغابايت، فتحتفظ بعنوانها رابطًا مطلقًا: فتظهر ما دامت نسخة من التطبيق تعمل، وتكون صورةً مكسورة بصدق حين لا تعمل. ولا تُحذف في صمت أبدًا.
ومن اليمين إلى اليسار حين تكون الملاحظة كذلك. يتبع اتجاهُ الصفحة نثرَ الملاحظة، أو قيمة dir: التي تثبّتها مقدمتها.

وتُعرض الرياضيات، وتُرسم بطاقات المتتبِّعات والسِّجِلّات (بلا أزرارها)، وتخرج ملاحظة .tex الصفحةَ نفسها التي يعرضها عرض قراءتها.

من سطر الأوامر

الورقة واجهة لمسار واحد، يستطيع curl استدعاءه مع ملف جلسة المشرف:

GET /api/export?scope=note|folder|tag|vault&target=<path or tag>&links=wiki|relative&attachments=1|0

ولا يحتاج scope=vault إلى target. أضف &dry=1 لتحصل على بيانات JSON التي يُصنع منها سطر ملخّص الورقة، { notes, attachments, bytes, filename }، مع حالات الرفض نفسها: 404 exportEmpty حين لا يطابق شيء، و413 exportTooLarge فوق الحد، و401 من غير جلسة مشرف. وانظر النسخ الاحتياطي والمزامنة للطريق الآخر الذي تخرج به الأشياء من الخزانة، وهو الطريق الذي يحفظ التاريخ.