Add browsers info

README.org

@@ -30,8 +30,12 @@ How to -safely- migrate to [[https://www.fsf.org][free software]] (free as in fr
 
 ** Internet
 
- * [[./doc/browsers.org][Browsers - internet protocols]]
+ * [[./doc/browsers.org][knowing about internet browsers - internet protocols]]
+ * [[./doc/luakit_browser.org][Luakit browser: how to use "adblock"]]
+ * [[./doc/set_luakit_default.org][Set a browser as default: an example with luakit]]
+ * [[./doc/user_tor_luakit.org][Use tor with luakit browser]]
 
+   
 ** Hardware
 
  * [[./doc/hardware.org][Table - Free hardware]]

doc/browsers.org

@@ -27,7 +27,11 @@ The [[https://gemini.circumlunar.space/][gemini protocol]] can be used on specif
 
 ** Luakit
 
-[[https://luakit.github.io/][luakit]] is a "fast, extensible and highly customizable" web browser.
+[[https://luakit.github.io/][luakit]] is a "fast, extensible and highly customizable" web browser. You can use
+it using keybindings similar to those used in vim (a text editor)
+
+- Here some hints on how to use luakit on Trisquel [[https://trisquel.info/es/forum/configuring-and-running-luakit-browser][forum]]
+- Here some hints on how to use luakit on [[https://wiki.archlinux.org/title/Luakit][Arch linux wiki]]
 
 ** W3m
 

doc/luakit_browser.org

@@ -0,0 +1,25 @@
+#+options: toc:nil
+#+date: 2022-08-27
+
+* Use adblock in Luakit browser
+
+Luakit is a browser that has slightly differences from another web browsers.
+You may find, for instance, that there are no buttons to add any adblocker.
+
+An option to use "adblock" in luakit is getting a list of sites that should
+be blocked by the browser and include in the luakit configuration file.
+
+** Updating adblock in luakit
+
+Go to the following directory
+
+#+begin_example sh
+  cd ~/.local/share/luakit/
+#+end_example
+
+Download the easylist and put it there:
+
+#+begin_example sh
+  wget https://easylist.to/easylist/easylist.txt
+#+end_example
+

doc/set_luakit_default.org

@@ -0,0 +1,67 @@
+#+options: toc:nil
+#+date: 2023-03-26
+
+* Setting luakit as default browser
+
+Check default browser used by the system
+
+#+begin_example sh
+  xdg-settings get default-web-browser
+#+end_example
+
+Create a desktop entry for luakit and save on [[~./local/share/applications]]
+Call it something like "luakit.desktop"
+
+#+begin_example sh
+  echo "[Desktop Entry]
+  Encoding=UTF-8
+  Version=1.0
+  Name=Luakit Web Browser
+#  Comment=Browse the World Wide Web
+#  GenericName=Web Browser
+#  Keywords=Internet;WWW;Browser;Web;Explorer
+  Exec=luakit %u
+#  Terminal=false
+#  X-MultipleArgs=false
+  Type=Application
+#  Icon=luakit
+#  Categories=GNOME;GTK;Network;WebBrowser;
+#  MimeType=text/html;text/xml;application/xhtml+xml;application/xml;application/rss+xml;application/rdf+xml;image/gif;image/jpeg;image/png;x-scheme-handler/http;x-scheme-handler/https;x-scheme-handler/ftp;x-scheme-handler/chrome;video/webm;application/x-xpinstall;
+#  StartupNotify=true
+  Actions=NewWindow;" > ~/.local/share/applications/luakit.desktop
+
+#+end_example
+
+Set luakit as default browser:
+
+#+begin_example sh
+  xdg-settings set default-web-browser luakit.desktop
+#+end_example
+
+** References
+
+- [[https://askubuntu.com/questions/166455/how-do-i-make-luakit-my-default-browser][I used this great answer from 'askubuntu']] to write this text
+
+** Use tor in luakit
+
+#+begin_example sh
+  systemctl start tor
+#+end_example
+
+Torify the application using  [[https://support.torproject.org/glossary/torsocks/][torsocks]]
+
+#+begin_example sh
+  torsocks luakit --nounique
+#+end_example
+
+*** Verifiy if your browser is using tor:
+
+Visit the following url from luakit:
+
+ * https://check.torproject.org/
+
+Or use ~curl~ to check the ip:
+
+#+begin_example sh
+  curl -x socks5h://localhost:9050 -s https://check.torproject.org/api/ip
+#+end_example

doc/user_tor_luakit.org

@@ -0,0 +1,28 @@
+#+options: toc:nil
+#+date: 2023-03-26
+
+* Use tor with luakit browser
+
+** Use tor in luakit
+
+#+begin_example sh
+  systemctl start tor
+#+end_example
+
+Torify the application using  [[https://support.torproject.org/glossary/torsocks/][torsocks]]
+
+#+begin_example sh
+  torsocks luakit --nounique
+#+end_example
+
+*** Verifiy if your browser is using tor:
+
+Visit the following url from luakit:
+
+ * https://check.torproject.org/
+
+Or use ~curl~ to check the ip:
+
+#+begin_example sh
+  curl -x socks5h://localhost:9050 -s https://check.torproject.org/api/ip
+#+end_example