ورّاق

الرئيسية pocketshelf

التثبيت

كيف تثبّت pocketshelf على حاسوبك في دقيقة، بلا اعتماديات خارجية.

pocketshelf أداة بايثون صغيرة (نحو 170 كيلوبايت) لا تعتمد على أي حزمة أخرى. تحتاج بايثون 3.10 أو أحدث فقط.

بأمر واحد بلا تثبيت دائم#

uvx pocketshelf build ~/Books

يشغّل uvx الأداة في بيئة مؤقتة ثم يتركها. إن لم يكن عندك uv فاستعمل pipx.

تثبيت دائم#

pipx install pocketshelf

أو بـ pip في بيئة افتراضية:

python -m venv .venv
.venv/bin/pip install pocketshelf

التحقق من التثبيت#

pocketshelf --version
pocketshelf demo --open

الأمر الثاني يبني فهرسًا تجريبيًا من بيانات للملك العام (مكتبة مشروع غوتنبرغ ومختارات من التراث العربي) ويفتحه في المتصفح.

ملاحظة

لا يحتاج الفهرس الناتج إلى بايثون ولا إلى خادم. بعد البناء يصبح ملف HTML واحدًا يفتحه أي متصفح حديث.

قراءة مزيد من البيانات الوصفية#

القراءة من ملفات PDF وEPUB مدمجة في الأداة نفسها. وإن ثبّتَّ حزمة arabic-bib فسيستعملها --profile warraq تلقائيًا لتحليل أسماء الملفات العربية تحليلًا أدق، دون أي إعداد:

pipx inject pocketshelf arabic-bib

انظر البدء السريع للخطوة التالية.

حرّر هذه الصفحة