&dhucpackage; &dhsection;

&dhpackage;

displays &wikipedia; entries on the command line

          &dhcommand;

          -BCnNoOpPsSuU
          -b prog
          -c -i -I patt
          -l lang
          -W base-url
          -X "browser options"
          Query

          &dhcommand;

           -o
          -b prog
          -l lang
          Query

          &dhcommand;

          -h

          &dhcommand;

           -v

          &dhcommand;

           -r

## DESCRIPTION

This manual page documents briefly the &dhcommand; command.

&dhcommand; fetches and renders &wikipedia; articles using a text-mode web-browser (currently recognises `elinks`, `links2`, `links`, `lynx` and `w3m`) and display the text of the article on STDOUT respectively in a pager.

## OPTIONS

The program recognizes the following command line options:

`-b` `prog`

- Use program `prog` as browser.

`-B`

- Do not use browser configured via configuration file or environment.

`-c` `patt`, `-I` `patt`

- Colorize case-sensitive pattern `patt` in output.

`-C`, `-N`

- Colorize output.

`-h`

- Show help and a summary of options.

`-i` `patt`

- Colorize case-insensitive pattern `patt` in output.

`-l` `lang`

- use &wikipedia; in language `lang`. See the &wikipedia; Languages entry elsewhere in this document.

`-n`

- Do not colorize output.

`-o`

- Open the &wikipedia; page in the browser.

`-O`

- Do not open the &wikipedia; page in the browser.

`-p`

- Use a pager (set by default).

`-P`

- Don't use a pager.

`-r`

- Display a random &wikipedia; article.

`-s`

- Display only the summary of the &wikipedia; article.

`-S`

- Display the full content of the &wikipedia; article and not only the summary.

`-u`

- Just print the URL of the &wikipedia; page and exit.

`-U`

- Display the full content of the &wikipedia; article and not only print the URL of the page.

`-v`

- Show version number.

`-W` `base-url`

- use `base-url` as base URL for wikipedia (e.g. use a different wiki), querying this URL will happen by appending the search term.

`-X` `browser-options`

- pass through `browser-options` to browser, e.g. "-width 180". (Warning: must be in quotes if multiple options should be passed; browser specific, not checked.)

## ENVIRONMENT

The following environment variables are recognized:

`ABROWSER`

- Browser to use as default instead of to found or configured web browser.

`IGNCASE`

- Default value for case-sensitivity of colorizing the output. Can be set to "true" or "false".

`LOCAL`

- Default value for language in which &wikipedia; should be used. See the &wikipedia; Languages entry elsewhere in this document.

`OUTPUTURL`

- Determines, if &dhcommand; should display only the URL of the &wikipedia; article by default. Can be set to "true" or "false".

`PAGER`

- Default value for pager to use. Can also be set to "true", in which case, &dhcommand; tries to figure out the appropriate pager, or "false", which means not to use a pager at all.

`SHORT`

- Determines, if &dhcommand; should display only the summary of the &wikipedia; article by default. Can be set to "true" or "false".

`USEBROWSER`

- Determines, if &dhcommand; should open the &wikipedia; page via `openurl` in the globally set default browser, i.e. `Firefox` or `Konqueror`, by default. Can be set to "true" or "false".

## FILES

`$HOME/.wikipedia2textrc`

- Will be sourced from `&dhpackage` on startup. Should contain variable assignments. The same variables as for the environment are recognised.

## WIKIPEDIA LANGUAGES

&dhcommand; currently supports the following &wikipedia; languages:

af

- Cape Dutch (Afrikaans)

als

- Alemannic

ca

- Catalan

cs

- Czech

da

- Danish

de

- German

en

- English

eo

- Esperanto

es

- Spanish

fi

- Finnish

fr

- French

hu

- Hungarian

ia

- Interlingua

is

- Islandic

it

- Italian

la

- Latin

lb

- Luxembourgian

nds

- Low German

nl

- Dutch

nn, no

- Norwegian (Nynorsk and Bokmål)

pl

- Polish

pt

- Portuguese

rm

- Rhaeto-Romanic

ro

- Romanian

simple

- Simple English

sk

- Slovak

sl

- Slovenian

sv

- Swedish

tr

- Turkish

## SEE ALSO

elinks(1), links(1), links2(1), lynx(1), w3m(1)

## AUTHOR

&dhcommand; was written by Christian Brabandt <cb@256bit.org>. Patches also from &dhusername; &dhemail;.

This manual page was written by &dhusername; &dhemail; for the &debian; system (but may be used by others). Permission is granted to copy, distribute and/or modify this document under the terms of the &gnu; General Public License (GPL), Version 2 any later version published by the Free Software Foundation.

On Debian systems, the complete text of the &gnu General Public License can be found in `/usr/share/common-licenses/GPL`.

## HISTORY

&dhpackage; was first released by Christian Brabandt on in his blog with as script named `wiki`. Some users may find it useful to create an alias with that name for speeding up the typing of a &dhcommand; command if no other command of that name is present.

## OTHER INFO

The current version of &dhcommand; should be available at on Christian Brabandt's website.