Describe BesStr registry/plist knobs

admin/Install.md

@@ -101,6 +101,7 @@ Lokalno licenco lahko spremenimo tako, da vpišemo novo kodo licence z ukazom (u
 
 ```bat
 reg add "HKEY_LOCAL_MACHINE\SOFTWARE\Amebis\Besana" /v "KodaLicence" /t REG_SZ /d "123-456-789-012-345" /f /reg:64
+"C:\Program Files\Amebis Besana\ALicVL.exe"
 ```
 
 Lokalna licenca je shranjena v registru `HKEY_LOCAL_MACHINE\\SOFTWARE\\Amebis\\Besana\\Licenca`. Odstranimo jo z ukazom (ukazna vrstica s skrbniškimi pravicami):
@@ -116,6 +117,7 @@ Lokalno licenco lahko spremenimo tako, da vpišemo novo kodo licence z ukazom:
 ```sh
 sudo defaults write /Library/Application\ Support/Amebis/Besana.plist KodaLicence -string 123-456-789-012-345
 sudo chmod a+r /Library/Application\ Support/Amebis/Besana.plist
+/Applications/Amebis\ Besana/ALicVL
 ```
 
 Lokalna licenca je shranjena v `/Library/Application\ Support/Amebis/Besana/Licenca.plist`. Odstranimo jo z ukazom:
@@ -134,12 +136,14 @@ Posrednik nastavimo z ukazom (ukazna vrstica s skrbniškimi pravicami):
 
 ```bat
 reg add "HKEY_LOCAL_MACHINE\SOFTWARE\Amebis\Besana" /v "Posrednik" /t REG_SZ /d "10.1.1.5" /f /reg:64
+"C:\Program Files\Amebis Besana\ALicVL.exe"
 ```
 
 ali:
 
 ```bat
 reg add "HKEY_LOCAL_MACHINE\SOFTWARE\Amebis\Besana" /v "Posrednik" /t REG_MULTI_SZ /d "alicpos.lj.org.home\0alicpos.mb.org.home" /f /reg:64
+"C:\Program Files\Amebis Besana\ALicVL.exe"
 ```
 
 Omrežna licenca je shranjena v registru `HKEY_LOCAL_MACHINE\\SOFTWARE\\Amebis\\Besana\\Posredno`. Odstranimo jo z ukazom (ukazna vrstica s skrbniškimi pravicami):
@@ -155,6 +159,7 @@ Posrednik nastavimo z ukazom:
 ```sh
 sudo defaults write /Library/Application\ Support/Amebis/Besana.plist Posrednik -array -string 10.1.1.5
 sudo chmod a+r /Library/Application\ Support/Amebis/Besana.plist
+/Applications/Amebis\ Besana/ALicVL
 ```
 
 ali:
@@ -162,6 +167,7 @@ ali:
 ```sh
 sudo defaults write /Library/Application\ Support/Amebis/Besana.plist Posrednik -array -string alicpos.lj.org.home -string alicpos.mb.org.home
 sudo chmod a+r /Library/Application\ Support/Amebis/Besana.plist
+/Applications/Amebis\ Besana/ALicVL
 ```
 
 Omrežna licenca je shranjena v `/Library/Application\ Support/Amebis/Besana/Posredno.plist`. Odstranimo jo z ukazom:
@@ -169,3 +175,130 @@ Omrežna licenca je shranjena v `/Library/Application\ Support/Amebis/Besana/Pos
 ```sh
 sudo rm /Library/Application\ Support/Amebis/Besana/Posredno.plist
 ```
+
+# Pravopisni strežnik Amebis Besana
+
+Pravopisni strežnik BesStr je sistemski servis Windows oz. servis `launchd` na macOS, ki ponuja preverjanje pravopisa in črkovanja besed preko protokola HTTP. Za komunikacijo uporablja protokol HTTP. Vgrajen ima lasten strežnik HTTP in ne potrebuje storitve Internet Information Services.
+
+Je sestavni del programskega paketa Amebis Besana od verzije 4.15 dalje. Prvotno je bil namenjen podpori vtičnikom LanguageTool za spletne brskalnike. Kasneje je bil razširjen za splošnejšo rabo. Uporablja ga tudi aplikacija Besana.
+
+Namestitev in posodobitev programskega paketa vedno nastavi servis za samodejni zagon in ga požene, če je bil prej ustavljen.
+
+Pri posodabljanju servisa ni treba ročno zaustavljati, saj ga namestitveni paket MSI samodejno zaustavi in po koncu posodobitve zažene nazaj. Je pa med posodobitvijo posledično prekinjeno delovanje servisa.
+
+Pri vsakem spreminjanju nastavitev v registru oz. datotekah `.plist` moramo servis ponovno zagnati, saj prebere nastavitve samo ob svojem zagonu.
+
+Morebitna obvestila in napake servis zapisuje v Event Log (Windows) oz. v Console (macOS).
+
+## Vtičnica TCP za sprejemanje zahtev
+
+Strežnik privzeto sprejema zahteve na `localhost:225`: IPv4 in IPv6, TCP, HTTP.
+
+Lahko navedemo svoj spisek vtičnic, na katerih želimo, da strežnik sprejema zahteve. Vtičnice so lahko naslov IPv4, naslov IPv6 (obdan z oglatimi oklepaji, npr. [::1]), ime računalnika ali FQDN. Vtičnici lahko pripišemo dvopičje in številko vrat TCP, kadar želimo, da strežnik sprejema odjemalce na drugih vratih TCP, kot privzeto TCP 225.
+
+### Windows
+
+Spisek vtičnic nastavimo z ukazom (ukazna vrstica s skrbniškimi pravicami):
+
+```bat
+reg add "HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\BesStr\Parametri" /v "Sprejemaj" /t REG_MULTI_SZ /d "0.0.0.0:80\0[::]:80" /f /reg:64
+net stop BesStr
+net start BesStr
+```
+
+### macOS
+
+Spisek vtičnic nastavimo z ukazom:
+
+```sh
+sudo defaults write "/Library/Application Support/Amebis/Besana/BesStr.plist" "Sprejemaj" -array -string "0.0.0.0:225" -string "[::]:225"
+sudo chmod a+r "/Library/Application Support/Amebis/Besana/BesStr.plist"
+sudo launchctl unload /System/Library/LaunchDaemons/BesStr.plist
+sudo launchctl load /System/Library/LaunchDaemons/BesStr.plist
+```
+
+## Zaledni strežnik LanguageTool
+
+Strežnik BesStr nudi jezikovne storitve samo za slovenščino. Kadar vtičnik LanguageTool navede jezik besedila kot `auto`, strežnik najprej poskusi določiti jezik besedila. Če jezik ni slovenski, privzeto posreduje zahtevo Amebisovemu strežniku LanguageTool. To omogoča preverjanje tudi ne-slovenskih besedil, a uporabnikova besedila zapustijo uporabnikov računalnik ([politika zasebnosti](https://besana.amebis.si/pravno_obvestilo/)).
+
+### Windows
+
+Uporabo zalednega strežnika izklopimo z ukazom (ukazna vrstica s skrbniškimi pravicami):
+
+```bat
+reg add "HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\BesStr\Parametri" /v "LanguageToolStreznik" /t REG_SZ /d "" /f /reg:64
+net stop BesStr
+net start BesStr
+```
+
+Uporabo svojega zalednega strežnika LanguageTool lahko nastavimo z ukazom (ukazna vrstica s skrbniškimi pravicami):
+
+```bat
+reg add "HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\BesStr\Parametri" /v "LanguageToolStreznik" /t REG_SZ /d "http://localhost:8080/" /f /reg:64
+net stop BesStr
+net start BesStr
+```
+
+### macOS
+
+Uporabo svojega zalednega strežnika LanguageTool lahko nastavimo z ukazom:
+
+```sh
+sudo defaults write "/Library/Application Support/Amebis/Besana/BesStr.plist" "LanguageToolStreznik" -string ""
+sudo chmod a+r "/Library/Application Support/Amebis/Besana/BesStr.plist"
+sudo launchctl unload /System/Library/LaunchDaemons/BesStr.plist
+sudo launchctl load /System/Library/LaunchDaemons/BesStr.plist
+```
+
+Uporabo svojega zalednega strežnika LanguageTool lahko nastavimo z ukazom:
+
+```sh
+sudo defaults write "/Library/Application Support/Amebis/Besana/BesStr.plist" "LanguageToolStreznik" -string "http://localhost:8080/"
+sudo chmod a+r "/Library/Application Support/Amebis/Besana/BesStr.plist"
+sudo launchctl unload /System/Library/LaunchDaemons/BesStr.plist
+sudo launchctl load /System/Library/LaunchDaemons/BesStr.plist
+```
+
+## Slovar v glavnem pomnilniku
+
+Besana lahko ob zagonu naloži slovar `.apz` v glavni pomnilnik. Poraba pomnilnika je sicer ustrezno večja in zagon počasnejši, a je preverjanje pravopisa potem hitrejše. Kadar je Besana nameščena na pogonu HDD, bo hitrost preverjanja pravopisa za velikostni razred večja. Na pogonih SSD je razlika v hitrosti še vedno opazna.
+
+Zato to možnost svetujemo na vseh računalnikih z dovolj delovnega pomnilnika.
+
+### Windows
+
+Nalaganje slovarja v glavni pomnilnik vklopimo z ukazom (ukazna vrstica s skrbniškimi pravicami):
+
+```bat
+reg add "HKEY_LOCAL_MACHINE\SOFTWARE\Amebis\Besana\AJTOdj" /v "SlovarVPomnilniku" /t REG_DWORD /d 1 /f /reg:64
+net stop BesStr
+net start BesStr
+```
+
+Nalaganje slovarja v glavni pomnilnik izklopimo z ukazom (ukazna vrstica s skrbniškimi pravicami):
+
+```bat
+reg add "HKEY_LOCAL_MACHINE\SOFTWARE\Amebis\Besana\AJTOdj" /v "SlovarVPomnilniku" /t REG_DWORD /d 0 /f /reg:64
+net stop BesStr
+net start BesStr
+```
+
+### macOS
+
+Nalaganje slovarja v glavni pomnilnik vklopimo z ukazom:
+
+```sh
+sudo defaults write "/Library/Application Support/Amebis/Besana/AJTOdj.plist" "SlovarVPomnilniku" -bool True
+sudo chmod a+r "/Library/Application Support/Amebis/Besana/AJTOdj.plist"
+sudo launchctl unload /System/Library/LaunchDaemons/AJTOdj.plist
+sudo launchctl load /System/Library/LaunchDaemons/AJTOdj.plist
+```
+
+Nalaganje slovarja v glavni pomnilnik izklopimo z ukazom:
+
+```sh
+sudo defaults write "/Library/Application Support/Amebis/Besana/AJTOdj.plist" "SlovarVPomnilniku" -bool False
+sudo chmod a+r "/Library/Application Support/Amebis/Besana/AJTOdj.plist"
+sudo launchctl unload /System/Library/LaunchDaemons/AJTOdj.plist
+sudo launchctl load /System/Library/LaunchDaemons/AJTOdj.plist
+```