#+options: toc:nil num:nil

* An example on how to look for files and editing scripts

[[https://luakit.github.io/][luakit]] is an awesome web browser. It's extensible and customizable.

To get some things set on this browser it's important to find system files and edit
configuration files.

After installing ~luakit~, e.g., in Parabola GNU-Linux:

#+begin_example sh
  pacman -S luakit
#+end_example

You may be interested in make some adjusts. Let's say you want to set 'Adblock'
extension to the browser.

** Set adblock in luakit

To do that you could follow the luakit manual:

#+begin_quote
 * Add require "adblock" and require "adblock_chrome" to your rc.lua.
 * Download AdblockPlus-compatible filter lists to the adblock directory. Multiple lists are supported. EasyList is the most popular Adblock Plus filter list, and can be downloaded from https://easylist.to/.
 * Filter lists downloaded to the adblock directory must have a filename ending in .txt in order to be loaded.
 * Filter lists need to be updated regularly (~weekly), use cron!
#+end_quote


*** Add require 'adblock' to yout 'rc.lua'


First search for the ~rc.lua~ script:

#+begin_example sh
  pacman -Ql luakit | grep rc.lua
#+end_example

Which results in:

: luakit /etc/xdg/luakit/rc.lua

Then, edit the file, including the suggested lines.

*** Download AdblockPlus-compatible filter lists to the adblock director

#+begin_quote
All filterlists should be downloaded to the adblock data directory (~/.local/share/luakit/adblock) By default, this is the adblock sub-directory of the luakit data directory. All filterlists must have a filename ending in .txt.
#+end_quote


#+begin_example sh
  cd .local/share/luakit/adblock
  wget https://easylist.to/easylist/easylist.txt
#+end_example

** References

 * [[https://bbs.archlinux.org/viewtopic.php?id=83411][Archlinux forum]]
 * [[https://luakit.github.io/docs/modules/adblock.html][luakit manual]]