X-Git-Url: https://git.armaanb.net/?a=blobdiff_plain;f=README;h=a42cedd3563e14239cb34ea0e32b946557440bb7;hb=refs%2Fheads%2Fdraft;hp=f92c08552fecf1cbfd50081c2540d9cdce82c5b7;hpb=3bf5e9826fe54ef64bbecd9cdb407fab40207835;p=chorizo.git diff --git a/README b/README index f92c085..a42cedd 100644 --- a/README +++ b/README @@ -1,123 +1,50 @@ +chorizo +====== - ========== - lariza - ========== +http://armaanb.net/chorizo.html +A simple web browser using GTK+ 3, GLib and WebKit2GTK+. -A simple web browser using GTK+ 2, GLib and WebKitGTK+. +Refer to the manpages chorizo(1), and chorizo-usage(1) for more information. -Features: +Installation +------------ - - A WebKit viewport - - An input box to change the current URL - - Global content zoom - - Pluggability into suckless' tabbed - - Built-in downloads - - vi-like scrolling (modified by CTRL) - - Searching the current page for a word - - Adblock - - Support for Flash and Java - - Cooperative instances using FIFOs (can be turned off) +The following C libraries are required: -Planned features: + - GTK+ 3 + - WebKit2 API for GTK+ 3 + - gst-libav, gst-plugins-good (for media playback) - - Keyword based searching (opening "wi foo" will search wikipedia) +The following programs are required: + - A C compiler supporting C11 + - make + - pkg-config +chorizo expects to be run on a POSIX-ish operating system. -About the name -============== +To build and install the program: -"lariza" stems from a german sentence: + $ make + # make install - Alle anderen waren mir zu anstrengend. - l a r i z a -That phrase basically means: "It was too tiresome to deal with any other -browser." I couldn't find a simple browser that does just what I need. -Most of them are utterly bloated, others lack essential functions. Thus, -I was forced to write scripts and tools and stuff to deal with these -issues. That is what was tiresome. I don't want to work around bugs or -nonsensical behavior anymore. +How is chorizo related to lariza? +--------------------------------- -So, I wrote my own browser^W WebKit GUI. WebKit does all the dirty work. + chorizo is a fork of the lariza browser by Peter Hofmann. I wanted + to take it in a slightly different direction (mostly just adding + features not considered to be in the spirit of lariza), so I forked + it. The name was changed in order to reduce confusion between the + two browsers as they grew apart. - -What lariza is and what it's not -================================ - -lariza does what I need. It won't do other things. I'm open for pull -requests but please don't be upset if I turn them down -- which might -happen if it's a feature that I simply don't need. - -Especially, it's very likely that lariza will never have a "follow -mode" like dwb, luakit or others have. I've used these browsers for -quite some time and I also used Firefox extensions that add a "follow -mode". The point is, "follow mode" doesn't work anymore. This was a good -thing ten years ago. Today, a lot of websites make heavy use of -JavaScript or hovering. You NEED some kind of pointing device. I found -using "follow mode" to be very frustrating today, because you still have -to reach for the mouse all the time. So, you might as well just optimize -your mousing workflow. - -lariza does not compete with powerful browsers like dwb or luakit, nor -with monstrous applications like Firefox or Chromium. lariza won't have -persistent storage, nor a plugin system, nor cloud sync, nor bookmarks. - -lariza tries not to exceed 1000 lines of code. - - -Using lariza with tabbed -======================== - -The order of arguments for lariza doesn't matter. This means you can run -it like this: - - $ tabbed -c lariza file:///home/hans/bookmarks.html -z 0.8 -e - -Each new tab will then show your bookmarks and is scaled by a factor of -0.8. - -If "-e" is not specified, lariza will launch tabbed automatically. Note -that you can't use tabbed's "Ctrl+Shift+Enter" hotkey to open a new tab -this way (lariza will simply call "tabbed -c -d", so tabbed will know -nothing about lariza). However, due to lariza's cooperative instances, -you can simply start lariza a second time and it will create a new tab. - - -Adblock -======= - -lariza has built-in adblock functionality. In each line of - - ~/.config/lariza/adblock.black - -you can store a regular expression. These expressions match -case-insensitive and partially, i.e. ".*foo.*" is the same as ".*FOO.*" -and you can use anchors like "^https?://...". - - -WebKit local storage -==================== - -WebKit does create files in your $XDG_* directories, i.e. ~/.local/share -or ~/.cache. It's up to you what you want to do with this junk. I remove -it regularly if no WebKit browser is running. Another option would be to -change the $XDG_* variables. - -I have explicitly not turned off the local storage feature in WebKit -because I don't know if this breaks web applications. - - -Literature -========== - -API references: - - - http://webkitgtk.org/reference/webkitgtk/stable/index.html - - https://developer.gnome.org/gtk2/stable/index.html - - https://developer.gnome.org/glib/stable/index.html - -Regular expressions supported by GRegex, you can use these in your -adblock patterns: - - - https://developer.gnome.org/glib/stable/glib-regex-syntax.html + Differences: + - New versioning scheme + - Revamped download manager + - New keybindings + - Better default directories + - Easily togglable JavaScript + - Cleaned up source code + - Easy web searching + - User stylesheet support + - A variety of tweaks and adjustments that make the experience nicer