filiparag / wikiman Goto Github PK
View Code? Open in Web Editor NEWWikiman is an offline search engine for manual pages, Arch Wiki, Gentoo Wiki and other documentation.
License: MIT License
Wikiman is an offline search engine for manual pages, Arch Wiki, Gentoo Wiki and other documentation.
License: MIT License
The rpm package requires zsh
and fish
.
Hello,
I'm on Debian 10 and trying to use your utility.
username@domain:~$ wikiman
find: ‘/home/username/.config/wikiman/sources’: No such file or directory
error: empty search query
Using the default config (/etc/wikiman.conf
) which comes with the .deb package. No ~/.config/wikiman/
directory yet.
Isn't man
the default source? Why it doesn't work then?
Thanks.
Hi, I would like to be able to set a custom program to preview HTML files in fzf
, such as lynx
or a wrapper around w3m
:
tui_preview_html = lynx
I can make a PR if you like the idea.
Arch Linux
wikiman v2.12.1 (installed from AUR)
The arch-wiki source is installed with pacman -S arch-wiki-docs
Installation of additional sources does not work:
~/fuentes $ make -f ./wikiman-makefile source-gentoo
% Total % Received % Xferd Average Speed Time Time Time Current
Dload Upload Total Spent Left Speed
100 655 100 655 0 0 1523 0 --:--:-- --:--:-- --:--:-- 1523
100 122M 100 122M 0 0 13.4M 0 0:00:09 0:00:09 --:--:-- 15.2M
~/fuentes $ sudo make -f ./wikiman-makefile source-install
cp: can't be done `stat' on '/home/juan/fuentes/srcbuild/usr/local/share/doc': File or directory does not exist
make: *** [wikiman-makefile:132: source-install] Error 1
~/fuentes $ sudo make -f ./wikiman-makefile clean
~/fuentes $ wikiman -S
NAME STATE PAGES PATH
arch + 6363 /usr/share/doc/arch-wiki/html
fbsd (not installed)
gentoo (not installed)
man + 16862 /usr/local/man /usr/local/share/man /usr/share/man /usr/lib/jvm/default/man
tldr (not installed)
$ ls /usr/share/wikiman/sources
arch.sh fbsd.sh gentoo.sh man.sh tldr.sh
The same when I try to install source-tldr
.
On the other hand, I think it would be better to be able to do this with an only wikiman
option.
Hello, is it possible to add support for Fedora wiki? 😍
Is there any built in way to pipe the output of initial searches or filtered searches or manpages themselves?
I notice that you've removed the dependence for arch-wiki-docs
. Of course this tool works fine without this package, but it will report a warning:
$ wikiman foo
warning: ArchWiki documentation for 'en' does not exist
So I think it might be better to add arch-wiki-docs
to depends
or optdepends
.
If ~/.config/wikiman/wikiman.conf
does not exist, then this tool will report a warning which is really annoying:
warning: configuration file missing, using defaults
So maybe you can add a default configuration file to /etc/wikiman.conf
and add this file to backup
in PKGBUILD.
In search results, ^C
is how you quit. q
key acts as a filter, which is understandable.
In article view, q
is how you quit. ^C
does nothing.
For consistency, ^C
in article view should quit.
I am using ZSH shell on Arch Linux, Konsole terminal emulator. I have installed the package from the AUR. I have arch-wiki-docs installed also.
$ wikiman -S
/usr/bin/env: ‘dash’: No such file or directory
Available shells:
$ chsh --list-shells
/bin/sh
/bin/bash
/usr/bin/git-shell
/bin/zsh
/usr/bin/zsh
I cannot help but think that source data installation is needlessly complex.
Ideally there should be a default path list (/usr/share/wikiman, ~/.local/share/wikiman) that could be overriden using a config and the download procedure should be a subcommand of wikiman that would try to write in the aforementioned path list sequentially. (So a sudo would allow me to write globally).
The application shouldn't need a config to work. Or even with a config present, a missing sources
clause in the config should make Wikiman simply autodetect sources.
Because Fedora links /bin
to /usr/bin
wikiman report this error (I don't know why). To fix this add:
/bin')
conf_sys_usr='/usr';
conf_sys_etc='/etc';;
to the init()
function.
The wikiman-makefile clean command just wiped out my $HOME/bin directory because i was stupid enough to run this without reading the source first. I probably should have done that plus ran it in a tmp directory, but live and learn. Luckily, I have tons of backups, so nothing was lost.
I'm not sure rm -rf bin is the best approach here, at the very least add a warning to the docs please.
Pressing q
results in Do you want to exit w3m? (y/n)
. This is not a default behavior of man
, less
, and other common CLI tools. I suggest disabling the exit prompt for Wikiman too.
I've got this error when I configure more than one source:
sources = man, arch
error: source 'manarch' does not exist
So everybody can see if his version is up to date or not.
When I'm searching for zh-CN docs, it will report a warning:
$ wikiman -s arch -l zh-CN,en
warning: Arch Wiki for 'zhCN' does not exist
But that does exist in /usr/share/doc/arch-wiki/html
$ find '/usr/share/doc/arch-wiki/html' -maxdepth 1 -type d -printf '%P '
ro uk hr hu sv da es lt el zh-CN id he it sr pt zh-TW nb ko ca ru cs sk en bg eo pl ar fi tr th nl
Looks like this script search for English only arch wiki L53
Could you add an option to specify the language to search for? For example:
wikiman --lang=zh_CN bootctl
Put Debian Wiki into this, I may make a PR soon incorporating this.
This is not necessary, but I think it's nice to have.
It'd be nice if you could add the Ubuntu wiki, I may make a PR to add this sometime in the future.
If you try to follow links in Gentoo's Handbook, it'll show an error like in the title because there is no such file as About.html
, instead there is a directory About
with files in different languages (which I also can't access using links?). I don't know if this problem is Gentoo-wiki-specific, but it's kinda annoying that I can't view related pages without reopening (or opening new instance of) Wikiman
Current behavior:
% wikiman
find: ‘/home/nowaker/.config/wikiman/sources’: No such file or directory
error: empty search query
A declarative, efficient, and flexible JavaScript library for building user interfaces.
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
An Open Source Machine Learning Framework for Everyone
The Web framework for perfectionists with deadlines.
A PHP framework for web artisans
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
Some thing interesting about web. New door for the world.
A server is a program made to process requests and deliver data to clients.
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
Some thing interesting about visualization, use data art
Some thing interesting about game, make everyone happy.
We are working to build community through open source technology. NB: members must have two-factor auth.
Open source projects and samples from Microsoft.
Google ❤️ Open Source for everyone.
Alibaba Open Source for everyone
Data-Driven Documents codes.
China tencent open source team.