الجدول المساعد (sidecar)
صحّح البيانات في جدول بيانات عادي وأعد البناء دون أن تغيّر أسماء ملفاتك.
أسهل طريق لتصحيح البيانات هو جدول CSV تعدّله في أي برنامج جداول.
pocketshelf scan ~/Books -o books.csv
افتح books.csv، وصحّح الأعمدة التي تريد (title وauthor وauthor_death وcategory …)، واحفظه بترميز UTF-8. ثم:
pocketshelf build ~/Books --sidecar books.csv
تُطابَق الصفوف بعمود path، وتتقدّم الحقول غير الفارغة في الجدول على ما استُنتج من الملفات.
سنة الوفاة والقرون#
عمودا author_death وauthor_calendar (ah للهجري، ce للميلادي) يغذّيان تبويب «المؤلفون» الذي يجمع المؤلفين حسب القرن الهجري أو الميلادي.
فهرس بلا ملفات#
يمكنك بناء فهرس من جدول فقط، دون مجلد كتب (قائمة مراجع، أو فهرس مكتبة تخطط لاقتنائها):
pocketshelf build catalog.csv -o catalog.html --lang ar
الأعمدة كلها في مواصفة الجدول.
الطبعات#
اكتب في عمود work معرّفًا واحدًا للصفوف التي هي طبعات لكتاب واحد، فتُجمع في بطاقة واحدة تُعرض طبعاتها عند فتحها. فإن تركته فارغًا جمع pocketshelf الصفوف التي يتفق عنوانها واسم مؤلفها بعد توحيد الحروف.