From 67b0fc24261282130bdb86b5f902ccf524d22b77 Mon Sep 17 00:00:00 2001 From: Dieter Plaetinck Date: Mon, 8 Jun 2009 19:59:18 +0200 Subject: new way to try out the sample stuff. makes it even easier for new users --- README | 2 +- docs/FAQ | 14 +++++++++----- 2 files changed, 10 insertions(+), 6 deletions(-) diff --git a/README b/README index 4740b21..aea62ce 100644 --- a/README +++ b/README @@ -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) diff --git a/docs/FAQ b/docs/FAQ index ef5df5f..b377607 100644 --- a/docs/FAQ +++ b/docs/FAQ @@ -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. -- cgit v1.2.3