Ceci est une ancienne révision du document !
Introduction
Uzbl est un navigateur web qui utilise comme moteur de rendu de page web : Webkit.
Il est présenté comme le vim du navigateur web.
Installation
Depuis les dépôts officiels (Lucid)
Depuis un dépôt tiers (Karmic et versions antérieures d'Ubuntu)
Ajoutez les dépôts suivants à vos sources de logiciels (remplacez "jaunty" par votre version d'Ubuntu) 1) :
# UZBL deb http://ppa.launchpad.net/pplr/uzbl/ubuntu jaunty main
# PPA for WebKit Team deb http://ppa.launchpad.net/webkit-team/ppa/ubuntu jaunty main
Ainsi que les clés d'authentification en tapant dans un terminal :
sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys 2D9A3C5B sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys 2A8BDB14
Rechargez la liste des paquets, puis installez le paquet uzbl
Depuis le tarball
(cette option permet d'avoir le système d'onglets!)
Tout d'abord installez le paquet git-core.
Puis lancez
git clone git://github.com/Dieterbe/uzbl.git cd uzbl make sudo make install-uzbl-core sudo make install-uzbl-browser sudo make install-uzbl-tabbed
Optionnel : Logiciel à installer
Première configuration
Comme vous pouvez le remarquer au premier lancement, uzbl n'est pas opérationnel.
Pour pouvoir utiliser uzbl , lancez les commandes suivantes :
Création du répertoire de configuration
mkdir ~/.uzbl/
On copie la configuration de base dans le répertoire
sudo cp -r /usr/share/uzbl/examples/* ~/.uzbl/
On s'approprie les fichiers copiés
sudo chown -Rv "votre_user":users ~/.uzbl/
On ajoute des variables utiles pour les scripts de uzbl dans notre bashrc
echo "export XDG_DATA_HOME=~/.uzbl/data" >> ~/.bashrc echo "export XDG_CONFIG_HOME=~/.uzbl/config" >> ~/.bashrc
On ajoute l'icone de l'application (optionnel)
echo "set icon = /home/"votre_user"/.uzbl/data/uzbl/uzbl.png" >> ~/.uzbl/config/config
On re-charge la configuration (XDG_DATA_HOME et XDG_CONFIG_HOME) (on peut aussi fermer et ré-ouvrir le terminal) :
source ~/.bashrc
Votre nouveau navigateur est maintenant prêt à l'usage !!
uzbl
Commandes utiles
o <une_adresse_web> : ouvrir l'adresse web demandée
gg <mots_clefs> : recherche Google des mots clefs
b : retourner à la page précédente
u : ouvre le gestionnaire de favoris
U : ouvre le gestionnaire d'historique
B : ajoute la page actuelle aux favoris
Echap : annuler
S : stop
ZZ : sortir du navigateur
r ou R : actualiser (reload / Reload_ign_cache)
t : enlève la barre du bas, écrit dans le titre de la fenêtre
Recherche d'occurrences :
/blabla : recherche l'occurrence "blabla" dans la page
n : mettre en valeur l'occurrence suivante
N : mettre en valeur l'occurrence précédente
Déplacements :
j : descend progressivement
k : monte progressivement
h : à gauche progressivement
l : à droite progressivement (L minuscule)
Déplacements rapides :
< < (collés) : haut de page
> > (collés) : bas de page
Espace : bas de page
$ : droite de la page
Zooms :
+ : zoom +
- : zoom -
T : toogle zoom
Sélectionner un lien et/ou rentrer du texte(procédure dans l'ordre):
i : passer en mode insertion
Tab : sélectionner le lien ou la zone de texte suivante
Maj + Tab : sélectionner le lien ou la zone de texte précédente
Entrée : valider
ou
Espace : valider pour les cases à cocher en mode insertion, en effet Entrée ne marche pas pour ça…
Le fichier de configuration
Les commandes de base ainsi que les alias de uzbl sont contenus dans le fichier config à l'adresse ~/.uzbl/config/uzbl/config
Voici un exemple de fichier config opérationnel :
# config uzbl revue par helly # la config est optionnelle . vous pouvez utiliser uzbl sans elle (mais uzbl ne ferra pas grand chose) #les commandes sont inspirées de vim # Handlers set download_handler = spawn $XDG_DATA_HOME/uzbl/scripts/download.sh set cookie_handler = spawn $XDG_DATA_HOME/uzbl/scripts/cookies.py #set new_window = sh 'echo uri "$8" > $4' # open in same window set new_window = sh 'uzbl -u $8' # equivalent to the default behaviour set scheme_handler = spawn $XDG_DATA_HOME/uzbl/scripts/scheme.py set load_start_handler = chain 'set keycmd = ' 'set status_message = <span foreground="khaki">wait</span>' set load_commit_handler = set status_message = <span foreground="green">recv</span> set load_finish_handler = chain 'set status_message = <span foreground="gold">done</span>' 'spawn $XDG_DATA_HOME/uzbl/scripts/history.sh' ## desactiver Javascript #set disable_scripts = 1 # Apparences set show_status = 1 set status_background = #303030 set status_format = <span font_family="monospace"><span background="khaki" foreground="black">[\@[\@MODE]\@]</span> [<span weight="bold" foreground="red">\@[\@keycmd]\@</span>] <span foreground="#606060"> \@[\@LOAD_PROGRESSBAR]\@ </span><span foreground="#99FF66">\@[\@uri]\@</span> <span foreground="khaki">\@[\@NAME]\@</span> <span foreground="orange">\@status_message</span><span foreground="#606060"> \@[\@SELECTED_URI]\@</span></span> set status_top = 0 set insert_indicator = I set command_indicator = C set useragent = Uzbl (Webkit @WEBKIT_MAJOR.@WEBKIT_MINOR.@WEBKIT_MICRO) (@(uname -o)@ @(uname -m)@ [@ARCH_UZBL]) (Commit @COMMIT) set fifo_dir = /tmp set socket_dir = /tmp set shell_cmd = sh -c # déclaration des commandes set modkey = Mod1 # like this you can enter any command at runtime, interactively. prefixed by ':' bind :_ = chain '%s' bind j = scroll_vert 20 bind k = scroll_vert -20 bind h = scroll_horz -20 bind l = scroll_horz 20 bind << = scroll_begin bind >> = scroll_end bind b = back bind m = forward bind S = stop bind r = reload bind R = reload_ign_cache bind + = zoom_in bind - = zoom_out bind T = toggle_zoom_type bind 1 = sh "echo set zoom_level = 1.0 > $4" bind 2 = sh "echo set zoom_level = 2.0 > $4" bind t = toggle_status bind /* = search %s bind ?* = search_reverse %s #jump to next bind n = search bind N = search_reverse bind gh _ = uri http://ixquick.com/do/metasearch.pl?query=%s&cat=web&pl=chrome&language=francais # shortcut to set the uri. TODO: i think we can abandon the uri command in favor of 'set uri = ..' bind o _ = uri %s # shortcut to set variables bind s _ = set %s bind \wiki _ = uri http://fr.wikipedia.org/w/index.php?search=%s&go=Lire bind \doc _ = uri http://doc.ubuntu-fr.org/?do=search&id=%s bind \des _ = uri http://desencyclopedie.wikia.com/index.php?search=%s&fulltext=Rechercher bind gg _ = uri http://www.google.com/search?q=%s #bin gg _ = uri http://ixquick.com/do/metasearch.pl?query=%s&cat=web&pl=chrome&language=francais bind i = toggle_insert_mode # disable insert mode (1 to enable). note that Esc works to disable, regardless of this setting bind I = toggle_insert_mode 0 # Enclose the executable in quotes if it has spaces. Any additional parameters you use will # appear AFTER the default parameters bind B = spawn $XDG_DATA_HOME/uzbl/scripts/insert_bookmark.sh bind U = spawn $XDG_DATA_HOME/uzbl/scripts/load_url_from_history.sh bind u = spawn $XDG_DATA_HOME/uzbl/scripts/load_url_from_bookmarks.sh # with the sample yank script, you can yank one of the arguments into clipboard/selection bind yurl = spawn $XDG_DATA_HOME/uzbl/scripts/yank.sh 6 primary bind ytitle = spawn $XDG_DATA_HOME/uzbl/scripts/yank.sh 7 clipboard # does the same as yurl but without needing a script bind y2url = sh 'echo -n $6 | xclip' # go the page from primary selection bind p = sh 'echo "uri `xclip -selection primary -o`" > $4' # go to the page in clipboard bind P = sh 'echo "uri `xclip -selection clipboard -o`" > $4' # start a new uzbl instance from the page in primary selection bind 'p = sh 'exec uzbl --uri $(xclip -o)' bind ZZ = exit bind Xs = js alert("hi"); # example showing how to use sh # it sends a command to the fifo, whose path is told via a positional param # if fifo_dir is not set, it'll echo to a file named (null) somewhere >:) remember to delete it # The body of the shell command should be one parameter, so if it has spaces like here, # you must enclose it in quotes. Remember to escape (and double-escape) quotes and backslashes # in the body. Any additional parameters you use will appear AFTER the default parameters (cfg file # path, fifo & socket dirs, etc.) bind XS = sh 'echo "js alert (\\"This is sent by the shell via a fifo\\")" > "$4"' bind !dump = sh "echo dump_config > $4" bind !reload = sh 'cat $1 > $4' # this script allows you to configure (per domain) values to fill in form fields (eg login information) and to fill in these values automatically bind za = spawn $XDG_DATA_HOME/uzbl/scripts/formfiller.sh bind ze = spawn $XDG_DATA_HOME/uzbl/scripts/formfiller.sh edit bind zn = spawn $XDG_DATA_HOME/uzbl/scripts/formfiller.sh new bind zl = spawn $XDG_DATA_HOME/uzbl/scripts/formfiller.sh load # other - more advanced - implementation using perl: (could not get this to run - Dieter ) bind LL = spawn $XDG_DATA_HOME/uzbl/scripts/formfiller.pl load bind LN = spawn $XDG_DATA_HOME/uzbl/scripts/formfiller.pl new bind LE = spawn $XDG_DATA_HOME/uzbl/scripts/formfiller.pl edit # we ship some javascripts to do keyboard based link hinting/following. (webkit does not have C DOM bindings yet) # this is similar to how it works in vimperator (and konqueror) # TODO: did we resolve: "no click() event for hyperlinks so no referrer set" ? #hit F to toggle the Hints (now in form of link numbering) bind F = script $XDG_DATA_HOME/uzbl/scripts/hint.js # the most stable version: bind fl* = script $XDG_DATA_HOME/uzbl/scripts/follow_Numbers.js %s # using strings, not polished yet: bind fL* = script $XDG_DATA_HOME/uzbl/scripts/follow_Numbers_Strings.js %s
Les scripts
uzbl dépend à 100% des scripts, en effet comme vous avez pu le voir l'ors de l'installation, uzbl sans script n'est qu'une fenêtre Webkit.
Les scripts se trouvent à l'adresse ~/.uzbl/data/uzbl/scripts/
Ils sont pour la plupart en python et en shell.
Il semble que le script load_url_from_bookmarks.sh soit mal codé, il n'affiche pas les tags des favoris, vous pouvez le remplacer par celui ci:
#!/bin/bash #revu par helly le 9/04/2010 #NOTE: it's the job of the script that inserts bookmarks to make sure there are no dupes. file=${XDG_DATA_HOME:-$HOME/.local/share}/uzbl/bookmarks [ -r "$file" ] || exit COLORS=" -nb #303030 -nf khaki -sb #CCFFAA -sf #303030" if dmenu --help 2>&1 | grep -q '\[-rs\] \[-ni\] \[-nl\] \[-xs\]' then DMENU="dmenu -i -xs -rs -l 10" # vertical patch # show tags as well goto=`$DMENU $COLORS < $file | awk '{print $1}'` else DMENU="dmenu -i" tag=`awk '{print $2}' $file | $DMENU $COLORS` # $1 fi lien=$(grep "$tag" $file | cut -d " " -f1) #[ -n "$goto" ] && echo "uri $goto" > $4 [ -n "$lien" ] && echo "uri $lien" | socat - unix-connect:$5