wikiman Download - wikiman Source Code Download

wikiman

شفرة المصدر الأخرى

v2.13.2

تنزيل

عن

Wikiman هو محرك بحث غير متصل بالصفحات اليدوية ، القوس ويكي ، Gentoo Wiki وغيرها من الوثائق.

يوفر Wikiman واجهة سهلة لتصفح الوثائق دون الحاجة إلى أن تكون دقيقة وتوصيلها بالإنترنت. يتم تحقيق ذلك من خلال الاستفادة من البحث عن النص الكامل عن الويكي ، والاسم الجزئي والوصف المطابقة لصفحات الرجل ، والتصفية الغامضة لنتائج البحث.

بشكل افتراضي ، يبحث ويكيمان فقط في الصفحات اليدوية للنظام. اتبع هذه التعليمات لتمكين المصادر الاختيارية.

توضيح

العرض التوضيحي

تثبيت

قوس لينكس

التثبيت من مستودع Arch Linux الإضافي:

pacman -S wikiman

# Optional: Enable Arch Wiki
pacman -S arch-wiki-docs

إذا كنت تقوم بتشغيل Manjaro أو توزيع آخر قائم على القوس ، فقم بتنزيل أحدث حزمة .pkg.tar.zst من علامة التبويب READES ، واتبع هذه الإرشادات لإضافة القوس ويكي كمصدر.

sudo pacman -U wikiman * .pkg.tar.zst

Ubuntu / Debian

قم بتنزيل أحدث حزمة .DEB من علامة التبويب REESER.

sudo apt update
sudo apt install ./wikiman * .deb

Fedora / Opensuse

قم بتنزيل أحدث حزمة .rpm من علامة تبويب الإصدارات.

 # Fedora
sudo dnf install wikiman * .rpm

# openSUSE (skip signature verification)
sudo zypper in wikiman * .rpm

FreeBsd

تثبيت TextProc/Wikiman من مجموعة المنافذ:

portsnap auto
cd /usr/ports/textproc/wikiman
make install

أو قم بتنزيل أحدث حزمة .txz من علامة التبويب Redease.

pkg install wikiman * .txz

التثبيت اليدوي لـ Linux و BSD

التبعيات: man ، fzf ، ripgrep ، awk ، w3m ، coreutils ، parallel

 # Clone from GitHub
git clone ' https://github.com/filiparag/wikiman '
cd ./wikiman

# Switch to latest stable release (optional)
git checkout $( git describe --tags | cut -d ' - ' -f1 )

# Available targets: all, core, widgets, completions, config, docs
make all

# Only for BSD users: install to /usr/local instead of /usr
make local

# Install Wikiman
sudo make install

يستخدم Wikiman GNU find و awk ، لذلك يتعين على مستخدمي BSD تثبيت findutils و gawk .

مصادر توثيق إضافية

المصادر الاختيارية المتاحة حاليًا هي:

القوس ويكي ( arch )
جينتو ويكي ( gentoo )
توثيق FreeBSD ( fbsd )
صفحات TLDR ( tldr )

بسبب حجمها الكبير ، لا تأتي ويكي مع ويكيمان. إذا كنت ترغب في استخدامها ، فيمكنك تنزيل أحدث لقطاتها باستخدام الأوامر التالية.

 # Download latest Makefile
curl -L ' https://raw.githubusercontent.com/filiparag/wikiman/master/Makefile ' -o ' wikiman-makefile '

# Example for Linux: install Arch Wiki
make -f ./wikiman-makefile source-arch
sudo make -f ./wikiman-makefile source-install
sudo make -f ./wikiman-makefile clean

# Example for BSD: install FreeBSD Documentation
make -f ./wikiman-makefile source-fbsd local
sudo make -f ./wikiman-makefile source-install
sudo make -f ./wikiman-makefile clean

بعد التثبيت ، يجب تمكينها تلقائيًا إذا كان متغير تكوين sources فارغًا.

للتحقق من المصادر النشطة ، قم بتشغيل:

wikiman -S

تجميع لقطة (قواعد قاعدة البيانات البرامج النصية)

في build/ الدليل هناك برامج نصية لتجميع اللقطة اليدوية. يمكن أن يكون لهذه البرامج النصية تبعيات خارجية ولا ينصح بها المستخدمون من قبل المستخدمين النهائيين ، ولكن من قبل محفوظات ويكيمان. قد تختلف الأميال الخاصة بك.

الاستخدام

الاستخدام: wikiman [OPTION]... [KEYWORD]...

إذا لم يتم توفير كلمات رئيسية ، أظهر جميع الصفحات.

خيارات:

-l البحث (S)
الافتراضي: en
-s للاستخدام
الافتراضي: (كل شيء متاح)
-f الباحث الغامض للاستخدام
الافتراضي: FZF
-q تمكين وضع البحث السريع
-a تمكين ووضع المشغل
-p تعطيل معاينة النتيجة السريعة
-k استمر بعد عرض نتيجة
-c عرض عمود مصدر
-H صفحات HTML
الافتراضي: W3M
-R طباعة الإخراج الخام
-S المصادر المتاحة والخروج
-W PRINT CODEGED LING FOR SHELL و EXIT المحددة
-v النسخة المطبوعة والخروج
-h عرض هذه المساعدة والخروج

شل keybind واجهة المستخدم

يمكن إطلاق Wikiman باستخدام ملزمة مفتاح Shell (افتراضي: Ctrl+F ). سيتم استخدام المخزن المؤقت لسطر الأوامر الحالي كاستعلام بحث.

أضف سطرًا مناسبًا من أدناه إلى ملف التكوين .bashrc الخاص بك لجعل ربط المفتاح دائم.

 # bash
source /usr/share/wikiman/widgets/widget.bash

# fish
source /usr/share/wikiman/widgets/widget.fish

# zsh
source /usr/share/wikiman/widgets/widget.zsh

إعدادات

يوجد ملف تكوين المستخدم في ~/.config/wikiman/wikiman.conf ، والتكوين على مستوى النظام الاحتياطي هو /etc/wikiman.conf .

إذا قمت بتعيين متغير بيئة XDG_CONFIG_HOME ، فسيتم البحث عن تكوين المستخدم من هناك بدلاً من ذلك.

مثال ملف التكوين:

 # Sources (if empty, use all available)
sources = man, arch

# Fuzzy finder
fuzzy_finder = sk

# Quick search mode (only by title)
quick_search = true

# Raw output (for developers)
raw_output = false

# Manpages language(s)
man_lang = en, pt

# Wiki language(s)
wiki_lang = zh-CN

# Show previews in TUI
tui_preview = false

# Keep open after viewing a result
tui_keep_open = true

# Show source column
tui_source_column = true

# Viewer for HTML pages
tui_html = xdg-open

لسرد اللغات المتاحة ، قم بتشغيل هذه الأوامر:

 # Man pages (excluding English)
find ' /usr/share/man ' -maxdepth 1 -type d -not -name ' man* ' -printf ' %P '

# Arch Wiki
find ' /usr/share/doc/arch-wiki/html ' -maxdepth 1 -type d -printf ' %P '

# FreeBSD Documentation
find ' /usr/share/doc/freebsd-docs ' -maxdepth 1 -type d -printf ' %P '

# TLDR Pages
find ' /usr/share/doc/tldr-pages ' -maxdepth 1 -type d -printf ' %P '

مصادر مخصصة

تم تصميم Wikiman ليكون قابلاً للتمديد: كل مصدر لديه وحدة في sources/ الدليل.

وحدات المصدر هي نصوص قذيفة متوافقة مع POSIX. يستدعي Wikiman وظيفة search التي تقرأ متغيرات $query ، وتطبع النتائج إلى stdout . متغير مع صفوف منسقة NAMEtLANGtSOURCEtPATH .