X-Git-Url: https://git.armaanb.net/?a=blobdiff_plain;f=README;h=8c85e3b81528803b4420f0bef2fc20e33f9d1b60;hb=813150ab894f92565735ad5b140a41a512fc6264;hp=d6bff5d5a655dff588322f4362a42363d3deca0d;hpb=15e4cb8ad0bcc9bc11a4470d1ae3bf93d16c05ae;p=chorizo.git

diff --git a/README b/README
index d6bff5d..8c85e3b 100644
--- a/README
+++ b/README
@@ -1,60 +1,92 @@
-zea - zeig's einfach an
-=======================
+   _            _
+  | | __ _ _ __(_)______ _
+  | |/ _` | '__| |_  / _` |
+  | | (_| | |  | |/ / (_| |
+  |_|\__,_|_|  |_/___\__,_|
+  https://uninformativ.de/git/lariza
+  https://uninformativ.de/bugs.html
 
-zea is a minimalistic web browser using Gtk2, GLib and WebKit. "Zeig's
-einfach an" is german and translates roughly to "just show it" (the damn
-web page).
+
+- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
+
+
+A simple web browser using GTK+ 3, GLib and WebKit2GTK+.
 
 Features:
 
-	- A WebKit viewport
-	- An input box to change the current URL
-	- Global content zoom
-	- Pluggability into suckless' tabbed
-	- vi-like scrolling (modified by CTRL)
-	- Searching the current page for a word
-	- Adblock
-	- Support for Flash and Java
+    - A WebKit2 viewport
+    - An input box to change the URI or to search the current page
+    - Built-in download manager
+    - Indicator for web feeds
+    - Optimized hotkeys: Left hand on keyboard, right hand on mouse
+    - Keyword based searching: Opening "wi foo" will search wikipedia
+    - Global content zoom
+    - Cooperative instances using FIFOs
+    - Certificate trust store
+    - Bundled user-supplied JavaScripts (optional):
+        - Link hints
+    - Bundled web extensions (optional):
+        - Adblock
+
+
+Installation
+------------
+
+The following C libraries are required:
+
+    - GTK+ 3
+    - WebKit2 API for GTK+ 3
+
+lariza expects to be run on a POSIX-ish operating system.
+
+To build the program and install it to /usr/local:
 
-Planned features:
+    $ make
+    # make install
 
-	- Keyword based searching (opening "wi foo" will search wikipedia)
+To use bundled web extensions, they must be copied or symlinked to the
+appropriate path. Please refer to the manpage.
 
 
-Using zea with tabbed
-====================
+Running
+-------
 
-The order of arguments for zea doesn't matter. This means you can run it
-like this:
+You simply invoke the main program:
 
-	$ tabbed -c ./zea file:///home/hans/bookmarks.html -z 0.8 -e
+    $ lariza
 
-Each new tab will then show your bookmarks and is scaled by a factor of
-0.8.
+Refer to the manpage for all options.
 
 
-Adblock
-=======
+Background information
+----------------------
 
-zea has built-in adblock functionality. In each line of
+ What lariza is and what it's not
 
-	~/.config/zea/adblock.black
+  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. That being said,
+  you should have a look at the PATCHES file. :-)
 
-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?://...".
+  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.
 
 
-Literature
-==========
+ About the name
 
-API references:
+  "lariza" stems from a german sentence:
 
-	- http://webkitgtk.org/reference/webkitgtk/stable/index.html
-	- https://developer.gnome.org/gtk2/stable/index.html
-	- https://developer.gnome.org/glib/stable/index.html
+      Alle anderen waren mir zu anstrengend.
+       l   a         r    i  z  a
 
-Regular expressions supported by GRegex, you can use these in your
-adblock patterns:
+  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.
 
-	- https://developer.gnome.org/glib/stable/glib-regex-syntax.html
+  So, I wrote my own browser^W WebKit GUI. WebKit does all the dirty
+  work.