دليل أسطرلاب English GitHub

الخلاصات

كتابة الآخرين تُقرأ هنا: قائمة خلاصات محفوظة في ملاحظة، لا تُجلب إلا حين تأذن، والمقالات التي تستحق البقاء تُكتب في الخزانة.


الخلاصات هي الجانب القارئ من RSS. تحتفظ بقائمة المدونات والمجلات والنشرات التي تتابعها؛ ويسألها الخادم عن مقالات جديدة وفق جدول؛ وتعرض صفحة الخلاصات ما لم يُقرأ، مجمّعًا حسب الخلاصة، مع قارئ إلى جانبه؛ واحتفظ تجعل المقالة التي تريدها ملاحظة من ملاحظاتك.

وهي ليست خلاصة المدونة. فالخلاصة التي ينشرها موقعك (/feed.xml، انظر وضع المدونة) هي الموقع يتكلم إلى الخارج؛ أما الخلاصات فهي أنت تستمع. ولا يجمع بينهما إلا صيغة الملف.

القائمة ملاحظة

تعيش الخلاصات التي تتابعها في ملاحظة، هي Feeds.md في جذر الخزانة ما لم تسمِّ الإعدادات ← القراءة ← الخلاصات غيرها. وفيها كتلة شيفرة feeds تحمل عنوانًا في كل سطر:

# Feeds

```feeds
#reading
https://example.org/feed.xml → Reading/Essays
#essays #long-form
https://another.example/rss
https://a-blog.example/
// السطر الذي يبدأ بشرطتين مائلتين تعليق
```
  • عنوان في كل سطر. تُقرأ RSS 2.0 وAtom وJSON Feed كلها. وتصلح الصفحة الأولى لمدونة أيضًا: يقرأ الخادم وسم <link rel="alternate"> في الصفحة ويتبع الخلاصة التي يسمّيها، كما يفعل زر الخلاصة في المتصفح.
  • → مجلد (أو ->) بعد العنوان يحدد أين تُحفظ المقالة المأخوذة من تلك الخلاصة. ومن دونه تذهب المقالات المحفوظة إلى Reading/.
  • سطر من الوسوم #وسم يضيف تلك الوسوم إلى الخلاصة التي فوقه. وسطر الوسوم الذي يسبق أول عنوان ينطبق على كل خلاصات الكتلة.
  • أول ذكر للعنوان هو المعتمد؛ والذكر الثاني يُعرض مشكلةً ولا يُدمج. والسطر الذي ليس عنوانًا، والمجلد الذي لا يصلح، وسطر الوسوم الذي لا خلاصة فوقه: كل واحد منها يظهر أعلى صفحة الخلاصات برقم سطره، وتبقى بقية القائمة عاملة.

ولأن القائمة ملاحظة فهي تتزامن وتحفظ تاريخها ويمكن التعليق حولها كأي ملاحظة: اكتب حول الكتلة ما شئت؛ فالكتلة وحدها هي التي تُقرأ. وإن لم تكن الملاحظة موجودة بعد عرضت صفحة الخلاصات أن تنشئها بكتلة فارغة.

الجلب بيدك تشغّله

التثبيت الجديد لا يجلب شيئًا. شغّل اجلب الخلاصات في الإعدادات ← القراءة ← الخلاصات، فيبدأ الخادم بالسؤال. وعند الإيقاف لا تُسأل أي خلاصة عن أي شيء: تبقى صفحة الخلاصات تعرض ما جُلب من قبل، وتقول لماذا لا يصل جديد.

ومع تشغيل الجلب يسأل الخادم كل خلاصة في القائمة:

  • بإيقاع مزامنة git حين تعمل النسخ الاحتياطي والمزامنة بمؤقّت (فاصل واحد لكل ما يفعله هذا التثبيت عبر الشبكة)، وكل ساعة حين لا تعمل؛
  • فورًا للخلاصة التي أضفتها للتو إلى القائمة؛
  • كلما ضغطت افحص الآن في صفحة الخلاصات.

ويسأل بأدب: يحمل كل طلب آخر ETag وLast-Modified للخلاصة، فلا تكلّف الخلاصة التي لم تتغير إلا جواب «لم يتغير» بلا بايتات. والخلاصة التي تفشل (انتهاء المهلة، أو 404، أو صفحة لا تسمّي خلاصة) تُعرض مع السبب، وتُسأل مرة أخرى في الجولة التالية.

وما جُلب، وأي المقالات قرأت، يُحفظ في مجلد بيانات الخادم (feeds.db)، لا في الخزانة أبدًا. فمئة مقالة في الساعة من مدونة شخص آخر ضجيج في ملاحظاتك وفي تاريخ git، و«قرأت هذا» حقيقة عنك على هذا الجهاز. ولا يسافر مع الخزانة (انظر النسخ الاحتياطي والمزامنة)؛ وحذفه لا يُفقد إلا علامات القراءة.

القراءة

افتح الخلاصات من لوحة الأوامر، أو من أيقونة الخلاصة بجانب التقويم أعلى النافذة، أو على /feeds. تُعرض المقالات غير المقروءة حسب الخلاصة، الأحدث أولًا؛ اختر واحدة فتُفتح في القارئ بجانب القائمة.

وتُعرض المقالة كما حملتها الخلاصة، بعد تنظيفها: تُزال السكربتات والأنماط والنماذج والإطارات المضمّنة، وتُفتح الروابط في تبويب جديد، ولا تُحمَّل الصور إلا حين تصل إليها، من موقعها، دون إرسال المُحيل. وحين لا تحمل الخلاصة إلا ملخصًا يقول القارئ ذلك.

المفاتيحالفعل
j / kالمقالة التالية / السابقة
oفتح الصفحة الأصلية في تبويب جديد
eتعليمها مقروءة، والانتقال إلى التالية

وتعليم المقالة مقروءة لا يسحبها من تحتك: تخفت في مكانها، وتختفي في المرة التالية التي تُحمَّل فيها الصفحة. وعلّمها غير مقروءة تعيدها.

الاحتفاظ

احتفظ تكتب المقالة في الخزانة ملاحظةً، بالمحوّل نفسه الذي تستعمله القصاصة:

  • حين تحمل الخلاصة المقالة كاملة، فذلك ما يُحفظ؛
  • وحين لا تحمل إلا مقدمة والجلب مشغّل، تُجلب الصفحة نفسها ويُحفظ مقالها (لا قوائمها وتذييلها)؛
  • وحين يكون الجلب متوقفًا، يُحفظ ما حملته الخلاصة.

وتُسمّى الملاحظة بعنوان المقالة، في مجلد الخلاصة (Reading/ ما لم تقل القائمة غير ذلك)؛ والمقالة الثانية بالعنوان نفسه تصير Title (2). وتقول ترويستها من أين جاءت:

---
source: "https://example.org/essays/marginalia"
feed: "The Marginal Reader"
published: 2026-09-18
kept: 2026-09-24
tags: [reading, essays]
---

# Marginalia, Briefly

لا يُنشر شيء مما تحتفظ به. ليس في الملاحظة مفتاح publish:؛ فهي خاصة حتى تنشرها بنفسك (انظر النشر والوصول).

ومن بعدها هي ملاحظة كغيرها: اربط إليها، ووسمها، وظلّل فيها — فالتظليل ==هكذا== الذي تصنعه في مقالة محفوظة بطاقة في المجموعة الضمنية في المدارات، كأي تظليل في الخزانة.

على الهاتف وفي خزانة الجيب

على الهاتف، الخلاصات صف تحت المزيد. والقائمة صف لكل مقالة تحت اسم خلاصتها؛ المس واحدة لتقرأها، واحتفظ وعلّمها مقروءة وافتح الأصل في ورقة ⋯ الخاصة بها. والرجوع يعيدك إلى القائمة.

وخزانة الجيب لا تجلب خلاصات: فجولة الخلاصات خادم يسأل خوادم أخرى بمؤقّت، وعلامات القراءة تعيش في مجلد بيانات ذلك الخادم. أما الملاحظات التي احتفظت بها فملاحظات، وخزانة الجيب تملكها كأي ملاحظة أخرى.

حرّر هذه الصفحة على GitHub

أسطرلاب برنامج حر. هذه الصفحات مبنية من ملفات Markdown في مجلد docs بالمستودع.