[[Vorlage(Getestet, bionic, focal)]]

{{{#!vorlage Wissen
[:Programme_kompilieren:]
[:Pakete installieren: Installation von Programmen]
[:Terminal: Ein Terminal öffnen]
[:Editor: Einen Editor verwenden]
[:Cron: Einen Cron-Job einrichten]
}}}

[[Inhaltsverzeichnis(1)]]

[https://www.uninformativ.de/git/lariza/ Lariza] {en} ist ein einfacher Webbrowser, der auf [:GTK+:GTK 3] sowie [https://webkitgtk.org/ WebKit2GTK+] {en} basiert und von [https://www.uninformativ.de/ Peter Hofmann] {de} entwickelt wird. Ziel der Entwicklung war auch, einen Browser mit weniger als 1000 Zeilen Code zu erstellen, daher entspricht der Browser sehr seinen persönlichen Bedürfnissen. Dabei enthält das Programm dennoch die wichtigsten Funktionen anderer Browser:

 * Downloadmanager
 * Inhaltszoom
 * Werbeblocker
 * Unterstützt JavaScript
 * Zertifikatsspeicher
 * Tabs

[[Bild(Lariza.png, 300, align=right)]] 

= Installation =
Für Lariza gibt es keine fertigen Pakete. Das Programm muss daher aus dem Quellcode kompiliert[1] werden.

== Voraussetzungen ==
Zuerst werden folgende Abhängigkeiten benötigt[2]:

{{{#!vorlage Paketinstallation
build-essential
git
libgtk-3-dev
libglib2.0-dev
libwebkit2gtk-4.0-37
libwebkit2gtk-4.0-dev
}}}

== Kompilierung =
Im nächsten Schritt wird der Quelltext mit [:Git:] heruntergeladen [3]:

{{{#!vorlage Befehl
git clone https://www.uninformativ.de/git/lariza.git
}}}

{{{#!vorlage Hinweis
Es besteht die Möglichkeit, den Zielordner der Installation zu ändern. Hierzu muss in der Datei '''Makefile''' der Eintrag `prefix = /usr/local` entsprechend geändert werden.
}}}

Dann führt man folgende Befehle zum Kompilieren aus:

{{{#!vorlage Befehl
cd lariza/
make
}}}
Die Installation via `sudo make install` sollte besser mit [:checkinstall:] durchgeführt werden, um Lariza nicht an der [:Paketverwaltung:] vorbei zu installieren und rückstandsfrei entfernen zu können.

= Verwendung =
Lariza kann über ein Terminal gestartet werden: 

{{{#!vorlage Befehl
lariza
}}}

Ein [:Programmstarter:] kann bei Bedarf von Hand angelegt werden.

== Umgebungsvariablen ==
Lariza arbeitet mit Umgebungsvariablen. Um diese anzupassen, öffnet man die Datei '''~/.bashrc''' mit einem Editor [4] und fügt am Ende der Datei folgendes ein:

{{{
export LARIZA_ACCEPTED_LANGUAGE=de-DE
export LARIZA_DOWNLOAD_DIR=/home/$USER/Downloads/
export LARIZA_HOME_URI=https://www.ubuntuusers.de/
export LARIZA_HISTORY_FILE=/home/$USER/.config/lariza/history
export LARIZA_USER_AGENT=Mozilla/5.0 (X11; Linux x86_64; rv:45.5.1) Gecko/20121011 Firefox/45.5.1
export LARIZA_ZOOM=1.0
export LARIZA_TAB_POS=top
}}}

Eine kurze Erläuterung der Variablen:

{{{#!vorlage Tabelle
<-2 rowclass="titel"> Umgebungsvariablen
+++
<rowclass="kopf"> Variable
Bedeutung
+++
`LARIZA_ACCEPTED_LANGUAGE`
Sprache mit der sich der Browser bei Webseiten zeigt
+++
`LARIZA_DOWNLOAD_DIR`
Das Downloadverzeichnis, wichtig das / am Ende
+++
`LARIZA_HOME_URI`
Startseite
+++
`LARIZA_HISTORY_FILE`
Verlaufsdatei des Browsers
+++
`LARIZA_TAB_POS`
Postion der Tabs (möglich Werte: `top`, `bottom`, `left`, `right`)
+++
`LARIZA_USER_AGENT`
Der User Agent mit dem sich der Browser bei Webseiten authentifiziert
+++
`LARIZA_ZOOM`
Zoomlevel des Inhalts

}}}

Abschließend müssen die neuen Variablen dem System noch bekanntgegeben werden:

{{{#!vorlage Befehl
source .bashrc
}}}

== Werbeblocker ==
In Lariza ist ein Werbeblocker integriert. Um diese nutzen zu können, muss die Datei '''~/.config/lariza/adblock''' angelegt werden. Diese kann den z.B. den folgenden Inhalt haben:

{{{
.*/ad/.*
.*/ads/.*
^https?://ad.*
^https?://advert.*
^https?://.*\.advertising\.com/
}}}
Um den Werbeblocker mit bekannten Filterlisten nutzen zu können, kann man folgendes Script verwenden, was drei der größten Filterlisten herunterlädt und diese in die entsprechende Datei einbindet:

{{{#!code bash
#!/bin/bash

cd ~/.config/lariza/ 

wget -O 1.txt https://easylist-downloads.adblockplus.org/easylist.txt
wget -O 2.txt https://raw.githubusercontent.com/zpacman/Blockzilla/master/Blockzilla.txt
wget -O 3.txt https://easylist-downloads.adblockplus.org/fanboy-annoyance.txt

cat 1.txt > adblock
cat 2.txt >> adblock
cat 3.txt >> adblock

rm 1.txt
rm 2.txt
rm 3.txt
}}}
Über einen zusätzlichen Cron-Job[5] kann man die Filterlisten regelmäßig aktualisieren lassen.


== Tastenkürzel ==
{{{#!vorlage Tabelle
<-2 rowclass="titel"> Tastenkombinationen
+++
<rowclass="kopf"> Funktion
Tastenkombinationen
+++
Fenster/Tab schließen
[[Vorlage(Tasten, alt+q)]]
+++
Startseite öffnen
[[Vorlage(Tasten, alt+w)]]
+++
Neues Fenster/Tab öffnen
[[Vorlage(Tasten, alt+e)]]
+++
Aktualisieren der Seite
[[Vorlage(Tasten, alt+r)]]
+++
Downloadmanager öffnen
[[Vorlage(Tasten, alt+d)]]
+++
Fokus in die Adressleiste setzen
[[Vorlage(Tasten, alt+l)]]
+++
Auf der Seite suchen
[[Vorlage(Tasten, alt+k)]]
+++
Wiederhole letze Suche (Vorwärts)
[[Vorlage(Tasten, alt+2)]]
+++
Wiederhole letze Suche (Rückwärts)
[[Vorlage(Tasten, alt+3)]]
+++
Vorwärts/Rückwärts im Verlauf
[[Vorlage(Tasten, F2)]], [[Vorlage(Tasten, F3)]]
}}}

= Problembehebung =
== Zertifikatsfehler ==
Sollte es beim Surfen im Internet zu einem Zertifikatsfehler kommen, kann man diesen wie folgt beheben:

 1. Erst wird ein Ordner '''certs''' erstellt: {{{#!vorlage Befehl
mkdir -p ~/.config/lariza/certs
}}}
 1. Nun lädt man das aktuelle Zertifikat der Webseite herunter: {{{#!vorlage Befehl
echo | openssl s_client -connect example.com:443 | openssl x509 > example.com
}}}

Wichtig ist, dass die Datei genauso heißt wie die Top Level Domain der Webseite. Nach einem erneuten Laden der Seite mit [[Vorlage(Tasten, alt+r)]] sollte der Besuch nun möglich sein.

= Links =
 * [https://www.uninformativ.de/git/lariza/ Projektseite] {en}
 * [archwiki:lariza:Lariza] {en} im Arch-Wiki
 * [:Internetanwendungen:] {Übersicht} Übersichtsartikel

# tag: Netzwerk, Internet, Browser