filiparag / wikiman Goto Github PK

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

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.

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

Hello, is it possible to add support for Fedora wiki? 😍♥️

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.

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.

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

The rpm package requires zsh and fish.

I've got this error when I configure more than one source:

sources = man, arch

error: source 'manarch' does not exist

This is not necessary, but I think it's nice to have.

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.

Put Debian Wiki into this, I may make a PR soon incorporating this.

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.

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.

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.

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.

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).

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

It'd be nice if you could add the Ubuntu wiki, I may make a PR to add this sometime in the future.

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.

So everybody can see if his version is up to date or not.