logo

badwolf

minimalist and privacy-oriented web browser based on WebKitGTK git clone https://hacktivis.me/git/badwolf.git

badwolf.sr.1 (9021B)

    

  1. .\" BadWolf: Minimalist and privacy-oriented WebKitGTK+ browser
  2. .\" Copyright © 2019-2023 Badwolf Authors <https://hacktivis.me/projects/badwolf>
  3. .\" SPDX-License-Identifier: BSD-3-Clause
  4. .Dd 2022-07-13
  5. .Dt BADWOLF 1
  6. .Os
  7. .Sh НАЗИВ
  8. .Nm badwolf
  9. .Nd минималистички веб читач посвећен приватности заснован на WebKitGTK
  10. .Sh ПРЕГЛЕД
  11. .Nm
  12. .Op Ar webkit/gtk опције
  13. .Op Ar УРЛ-ови или путање
  14. .Sh ОПИС
  15. .Nm
  16. је минималистички читач који поштује приватност.
  17. Заснован је на WebKitGTK-у, па зато прихвата и опције и променљиве окружења WebKitGTK-а (и пакета од којих зависи).
  18. Нажалост, за њих не постоје man странице.
  19. .Pp
  20. Runtime конфигурација
  21. .Nm
  22. -а ће вероватно бити додата у наредној верзији.
  23. .Sh ПРЕЧИЦЕ
  24. Следећа секција наводи пречице по њиховим акцијама.
  25. Свака ставка је описана виџетом на коме је фокус или са
  26. .Aq свуда
  27. ако функционише за цео прозор, и пречицом на коју реагује.
  28. .Bl -tag -width Ds
  29. .It вебпреглед Ctrl-Scroll
  30. Повећава/смањује увећање веб странице.
  31. .It вебпреглед Ctrl-0
  32. Враћа увећање веб странице на 100%.
  33. .It вебпреглед Ctrl-ЛевоДугмеМиша, вебпреглед СредњеДугмеМиша
  34. Отвара изабрану везу у новом језичку. (Напомена: JS и даље намеће догађај)
  35. .It свуда Ctrl-t
  36. Креира нови језичак (у новој сесији, слично као кад се притисне дугме)
  37. .It читач Ctrl-F4, читач Alt-d
  38. Затвара текући језичак
  39. .It читач Ctrl-f
  40. Фокусира унос претраге
  41. .It читач Ctrl-l
  42. Фокусира унос локације (УРЛ-а)
  43. .It читач Ctrl-Shift-r / Ctrl-r, читач F5
  44. Поново учитава текући језичак (са/без чишћења кеша)
  45. .It читач Escape
  46. Зауставља учитавање у текућем језичку
  47. .It читач F7
  48. Смењује caret.
  49. .It читач F12
  50. Отвара веб инспектор.
  51. .It читач Ctrl-[ / Ctrl-]
  52. Иде назад/напред у историји текућег језичка
  53. .It читач Ctrl-p
  54. Штампа текућу страницу. (отвара дијалог)
  55. .It свуда Alt-Лево / Alt-Десно
  56. Иде на претходни/следећи језичак
  57. .It свуда F1
  58. Приказује дијалог о програму
  59. .It свуда Alt-n
  60. Ако је n било који нумерички тастер, иде на n-ти језичак; 0 иде на последњи.
  61. .El
  62. .Ss ПОДРАЗУМЕВАНЕ
  63. Ево непотпуне листе подразумеваних Webkit/GTK пречица:
  64. .Bl -tag -width Ds
  65. .It свуда Ctrl-PageUp / Ctrl-PageDown
  66. Иде на претходни/следећи језичак
  67. .It претрага Ctrl-g / Ctrl-Shift-g
  68. Када је фокусирано поље за претрагу, иде на следеће/претходно појављивање.
  69. .It претрага Escape
  70. Поништава текућу претрагу
  71. .It пољезаунос Ctrl-;
  72. Убацује Емоџи
  73. .El
  74. .Sh ОКРУЖЕЊЕ
  75. .Bl -tag -width Ds
  76. .It Ev BADWOLF_L10N
  77. Листа раздвојена двотачком, у облику језик_ЗЕМЉА, где је језик у ISO-639 а ЗЕМЉА у ISO-3166.
  78. На пример,
  79. .Ic BADWOLF_L10N="en_GB:fr_FR:de_DE" .
  80. Ако ова променљива није постављена, провера правописа неће бити активирана.
  81. У будућности се планира општије име променљиве.
  82. .Pp
  83. Да бисте добили списак подржаних речника извршите
  84. .Ic enchant-lsmod-2 -list-dicts
  85. или уз верзију enchant-а пре 2.0:
  86. .Ic enchant-lsmod -list-dicts
  87. .El
  88. .Sh ДАТОТЕКЕ
  89. Следеће путање користе
  90. .Xr sh 1
  91. синтаксу за исправну подршку XDG спецификацији основног директоријума, можете користити наредбу
  92. .Xr echo 1
  93. да проверите где се оне налазе на вашем систему.
  94. .Pp
  95. .Bl -tag -width Ds -compact
  96. .It Pa ${XDG_CONFIG_HOME:-$HOME/.config}/badwolf/content-filters.json
  97. Датотека филтера садржаја за WebKit.
  98. Она омогућава да се блокира нежељени садржај (рекламе, негвер, ...).
  99. За основне информације о формату погледајте:
  100. .Lk https://webkit.org/blog/3476/content-blockers-first-look/
  101. .Lk https://webkit.org/blog/4062/targeting-domains-with-content-blockers/
  102. .Lk https://developer.apple.com/documentation/safariservices/creating_a_content_blocker
  103. .Pp
  104. Да бисте конвертовали филтере у формату AdblockPlus-а, пробајте:
  105. .Lk https://gitlab.com/eyeo/adblockplus/abp2blocklist
  106. .Pp
  107. За готову датотеку (коју треба повремено ажурирати), пробајте:
  108. .Lk https://easylist-downloads.adblockplus.org/easylist_min_content_blocker.json
  109. .It Pa ${XDG_CACHE_HOME:-$HOME/.cache}/badwolf/filters
  110. Овде су смештени компајлирани филтери.
  111. Датотеке у њему су аутоматски генерисане и не би требало да се мењају.
  112. Овде је документован само у сврху сендбоксинга/контроле приступа.
  113. .It Pa ${XDG_DATA_HOME:-$HOME/.local/share}/badwolf/bookmarks.xbel
  114. Датотека XBEL (XML Bookmark Exchange Language), коју у овом тренутку подржавају:
  115. .Xr elinks 1 ,
  116. .Xr konqueror 1 ,
  117. .Xr kbookmarkeditor 1 .
  118. .Pp
  119. Може се и креирати симболичка веза ка њиховој путањи, али бисте можда пре користили
  120. .Lk https://www.w3.org/TR/xinclude/ XInclude
  121. кога природно подржава
  122. .Nm
  123. да спојите више XBEL датотека.
  124. .Pp
  125. За више информација о овом формату погледајте:
  126. .Lk http://pyxml.sourceforge.net/topics/xbel/
  127. .Pp
  128. За пример XBEL датотеке погледајте:
  129. .Lk https://hacktivis.me/bookmarks.xbel
  130. .It Pa ${XDG_DATA_HOME:-$HOME/.local/share}/badwolf/webkit-web-extension/
  131. Директоријум који садржи
  132. .Lk https://webkitgtk.org/reference/webkit2gtk/stable/WebKitWebExtension.html WebKitWebExtensions
  133. за учитавање у
  134. .Nm .
  135. Напомена: Оне нису веб екстензије засноване на JavaScript-у, које подржавају Firefox и Chrome, већ бинарни код у дељеним објектним датотекама који користи WebKitGTK API.
  136. .Pp
  137. Примери корисних екстензија се могу наћи на:
  138. .Lk https://hacktivis.me/git/badwolf-extensions
  139. .It Pa ${DATADIR:-/usr/local/share}/badwolf/interface.css
  140. .It Pa ${XDG_DATA_HOME:-$HOME/.local/share}/badwolf/interface.css
  141. CSS датотеке (редом, системска и корисничка) за стилизовање интерфејса
  142. .Nm
  143. -а.
  144. Погледајте
  145. .Lk https://docs.gtk.org/gtk3/css-properties.html
  146. за доступна својства.
  147. .Pp
  148. За тестирање стилова препоручујем употребу променљиве окружења
  149. .Ev GTK_DEBUG=interactive
  150. приликом покретања
  151. .Nm
  152. и отварање CSS језичка.
  153. .It Pa ${XDG_DATA_HOME:-$HOME/.local/share}/badwolf/scripts/
  154. Директоријум који садржи JS корисничке скриптове (који се завршавају са
  155. .Ic .js )
  156. покрећу на почетку учитавања страница и гранају на iframe-ове.
  157. Корисни за наметање понашања веб сајтова или додавање недостајућих одлика веб сајтовима.
  158. .Pp
  159. Имајте у виду да за разлику од корисничких скриптова у стилу Greasemonkey-ја, ови скриптови се увек покрећу, без обзира на хост или УРЛ.
  160. .El
  161. .Sh АУТОРИ
  162. .An Haelwenn (lanodan) Monnier Aq Mt contact+badwolf@hacktivis.me
  163. .Sh ГРЕШКЕ
  164. Можете послати доприносе или пријаве грешака на
  165. .Lk https://sr.ht/~lanodan/badwolf/
  166. преко
  167. .Xr git-send-email 1
  168. за закрпе.