diff options
author | Dieter Plaetinck <dieter@plaetinck.be> | 2009-06-08 19:59:18 +0200 |
---|---|---|
committer | Dieter Plaetinck <dieter@plaetinck.be> | 2009-06-08 19:59:18 +0200 |
commit | 67b0fc24261282130bdb86b5f902ccf524d22b77 (patch) | |
tree | 8ff56a4681f54387ee281fdfac03f48a5023cd26 | |
parent | 1465169d25cd1a86852e13ff0d5792e14594167f (diff) |
new way to try out the sample stuff. makes it even easier for new users
-rw-r--r-- | README | 2 | ||||
-rw-r--r-- | docs/FAQ | 14 |
2 files changed, 10 insertions, 6 deletions
@@ -7,7 +7,7 @@ ### TO NEW PEOPLE: * please read the documentation in /usr/share/uzbl/docs * invoke uzbl --help -* to get you started: uzbl --uri 'http://www.archlinux.org' --config /usr/share/uzbl/examples/configs/sampleconfig +* to get you started: `XDG_DATA_HOME=/usr/share/uzbl/examples/data XDG_CONFIG_HOME=/usr/share/uzbl/examples/config uzbl --uri www.archlinux.org` * study the sample config, have a look at all the bindings, and note how you can call the scripts to load new url from history and the bookmarks file * note that there is no url bar. all url editing is supposed to happen _outside_ of uzbl. For now, you can use the `load_from_*` dmenu based scripts to pick a url or type a new one or write commands into the fifo (see /usr/share/uzbl/docs/CHECKLIST) @@ -4,11 +4,15 @@ FAQ ### I just installed uzbl but it doesn't do much. What now? Uzbl includes very limited default settings (statusbar settings, but no keybinds, history/download handlers etc.) Look at /usr/share/uzbl/docs/config.h to see the default settings. -Neither does uzbl create a default config file on startup like some other programs do. -Because we want to give you the freedom to place your config where you want, and to use a config or not. -Have a look in /usr/share/uzbl/examples/configs to see what you can do. You will probably want to create your own config based on an example config -so you can add keybinds and to use scripts. -Use the --config parameter or save your config as $XDG\_CONFIG\_HOME/uzbl/config to have it auto-loaded. +Neither does uzbl create a default config file on startup like some other programs do because we want to give you the freedom to place your config where you want, and to use a config or not. +Have a look in /usr/share/uzbl/examples/configs to see what you can do. +If you save a config as $XDG\_CONFIG\_HOME/uzbl/config it will be loaded automatically. +Running with the `--verbose` flag on a command line can also be interesting. +To get you started, try this: +`XDG_DATA_HOME=/usr/share/uzbl/examples/data XDG_CONFIG_HOME=/usr/share/uzbl/examples/config uzbl` +It will temporarily override your $XDG\_CONFIG\_HOME and $XDG\_DATA\_HOME +variables so you can try the sample stuff directly in /usr/share/uzbl/examples. +If you like what you can do, you can copy the sample stuff into your ~ and edit to your liking. ### Where is the location bar? How do I change the URL ? Uzbl has no location bar. All changes to the uri (editing of current uri, typing new uri, loading of uri from bookmarks/history/...) happens *outside* of uzbl. |