✎ uzbl [Wiki ubuntu-fr]

Vous affichez une ancienne révision du document ! Si vous l'enregistrez, vous créerez une nouvelle version avec ce contenu.

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

{{ http://pix.toile-libre.org/upload/original/1271101468.png?800x600 }}

===== Installation =====

====Depuis les dépôts officiels (Lucid)====

[[:tutoriel:comment_installer_un_paquet#paquet_present_dans_les_depots|Installez le paquet]] **[[apt://uzbl|uzbl]]**

==== Depuis un dépôt tiers (Karmic et versions antérieures d'Ubuntu) ====

[[:tutoriel:comment_modifier_sources_maj|Ajoutez les dépôts suivants à vos sources de logiciels]] (remplacez "jaunty" par votre [[versions|version]] d'Ubuntu) ((Aucun paquet n'est disponible pour Hardy)) :

# 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 [[:tutoriel:comment_modifier_sources_maj#gerer_les_cles_d_authentification|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

[[:tutoriel:comment_modifier_sources_maj#recharger_la_liste_des_paquets|Rechargez la liste des paquets]], puis [[:tutoriel:comment_installer_un_paquet|installez le paquet]] **[[apt://uzbl|uzbl]]**

==== Depuis le tarball ====
(cette option permet d'avoir le système d'onglets!)
Tout d'abord [[:tutoriel:comment_installer_un_paquet|installez le paquet]] **[[apt://git-core|git-core]]**.\\
Puis lancez
<code>
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
</code>

==== Optionnel : Logiciel à installer ====

[[xclip]]

===== 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
<code>mkdir ~/.uzbl/</code>
On copie la configuration de base dans le répertoire
<code>sudo cp -r /usr/share/uzbl/examples/* ~/.uzbl/</code>
On s'approprie les fichiers copiés
<code>sudo chown -Rv "votre_user":users ~/.uzbl/</code>
On ajoute des variables utiles pour les scripts de uzbl dans notre bashrc
<code>echo "export XDG_DATA_HOME=~/.uzbl/data" >> ~/.bashrc
 echo "export XDG_CONFIG_HOME=~/.uzbl/config" >> ~/.bashrc</code>
On ajoute l'icone de l'application (optionnel)
<code>echo "set icon = /home/"votre_user"/.uzbl/data/uzbl/uzbl.png" >> ~/.uzbl/config/config</code>
On re-charge la configuration (XDG_DATA_HOME et XDG_CONFIG_HOME) (on peut aussi fermer et ré-ouvrir le terminal) :
<code>source ~/.bashrc</code>
Votre nouveau navigateur est maintenant prêt à l'usage !!
<code>uzbl</code>

===== 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\\

===== 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 :
<code>
# 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 = wait'
set load_commit_handler = set status_message = recv
set load_finish_handler = chain 'set status_message = done' '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 = [\@[\@MODE]\@] [\@[\@keycmd]\@] \@[\@LOAD_PROGRESSBAR]\@ \@[\@uri]\@ \@[\@NAME]\@ \@status_message \@[\@SELECTED_URI]\@
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
</code>

===== 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:
<code>#!/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</code>

===== Liens =====
[[http://www.uzbl.org/ | Le site officiel]]

[[http://forum.ubuntu-fr.org/viewtopic.php?id=318448 | Le sujet du forum]]

--------

//**Contributeurs principaux :** [[utilisateurs:helly]]

Merci de recopier le code ci-contre pour prouver que vous êtes humain : S I P P J Merci de laisser ce champ vide :

Résumé

Note : En modifiant cette page, vous acceptez que le contenu soit placé sous les termes de la licence suivante : CC Paternité-Partage des Conditions Initiales à l'Identique 3.0 Unported