Amebis/Besana-doc
0
0
Fork 0
Code Issues 1 Pull Requests Actions Packages Projects Releases Wiki Activity

Compare commits

base: Amebis:master
Branches Tags
Amebis:master Amebis:v4 Amebis:v5.1
..
compare: Amebis:2893869b00219231fc6d482206ff2585c5333b3f
Branches Tags
Amebis:master Amebis:v4 Amebis:v5.1

1 Commits
master ... 2893869b00

Author SHA1 Message Date
Simon Rozman
2893869b00 Describe BesStr registry/plist knobs 2025-05-15 09:18:07 +02:00
4 changed files with 50 additions and 176 deletions
Expand all files Collapse all files

53
Changelog.md
View File

@@ -1290,56 +1290,3 @@
- Nova verzija odjemalca - Nova verzija odjemalca
- Pregibanje odstrani krajne predsledke v besedilu pripetem iz odložišča - Pregibanje odstrani krajne predsledke v besedilu pripetem iz odložišča
## 5.1-pre2
- Nova verzija odjemalca
- Popravljeni kontaktni podatki
## 5.1-pre3
## 5.1-pre4
- Nova verzija odjemalca
- Popravljen gumb X pri nasvetu napake
## 5.2-pre
- Popravljena napaka, zaradi katere pri namestitvi in v Microsoft Office na Windows 7 ni naložilo datotek DLL.
- Popravljena napaka, zaradi katere uvodna namestitev ni mogla preveriti kode licence.
- Nova verzija odjemalca
- Podpora za dostopnost
- Podpora za macOS
- Navigacija med napakami
- Nova verzija jezikovnega jedra
## 5.2-pre1
- Nova verzija odjemalca
- Popravljena uvodna postavitev okna
- Nova verzija jezikovnega jedra, baze in slovarja za črkovalnik
## 5.2-pre2
- Nova verzija odjemalca
- Možnost povrnitve povečave vmesnika
- Nova verzija jezikovnega jedra, baze in slovarja za črkovalnik
- Verzija za macOS
## 5.2-pre3
- Črkovanje v sistemskih vnosnih poljih aplikacij macOS
## 5.2-pre4
- Nova verzija odjemalca
- Ime izvršne datoteke preimenovano iz BesClient v Besana.
- Nova verzija jezikovnega jedra

134
admin/Install.md
View File

@@ -71,35 +71,7 @@ Uporabniki, ki ne vedo vnaprej, katere arhitekture je računalnik, lahko uporabi
### macOS ### macOS
Za namestitev programskega paketa uporabljamo datoteke PKG. Priporočamo prenos datotek PKG na svoj LAN. _V pripravi_
Uvodna namestitev mora biti izvedena interaktivno. Ker je Safari edini brskalnik, ki zahteva uporabo HTTPS tudi za naslove localhost, mora uvodna namestitev izdelati lokalno digitalno potrdilo in ga nastaviti v sistemskem Keychainu. Kar pa zahteva dodaten interaktiven vnos skrbniških poverilnic.
Programski paket lahko kasneje nadgradimo z ukazom:
```sh
sudo installer -pkg Besana.pkg -target / -allowUntrusted -verbose
```
Z dodatnimi parametri, ki jih predhodno vpišemo v datoteko `/tmp/si.amebis.Besana.ALicMSICA.plist`, lahko natančneje upravljamo postopek namestitve oz. nadgradnje.
#### Nastavitev licence
Nastavimo lokalno licenco. Kodo licence smo dobili ob nakupu.
```sh
defaults write /tmp/si.amebis.Besana.ALicMSICA.plist KODALICENCE -string 123-456-789-012-345
chmod a+r /tmp/si.amebis.Besana.ALicMSICA.plist
```
#### Nastavitev Posrednika licenc
Nastavimo omrežno preverjanje licenc z Amebisovim posrednikom licenc. Kot ime računalnika, na katerega smo namestili Posrednik licenc, lahko navedemo ime računalnika, FQDN, IPv4, [IPv6] (v oglatih oklepajih). Privzeta vrata so 321 (vedno TCP).
```sh
defaults write /tmp/si.amebis.Besana.ALicMSICA.plist POSREDNIK -array -string alicpos.lj.org.home -string alicpos.mb.org.home
chmod a+r /tmp/si.amebis.Besana.ALicMSICA.plist
```
# Nastavitev licenciranja # Nastavitev licenciranja
@@ -143,15 +115,15 @@ reg delete "HKLM\SOFTWARE\Amebis\Besana\Licenca" /f /reg:64
Lokalno licenco lahko spremenimo tako, da vpišemo novo kodo licence z ukazom: Lokalno licenco lahko spremenimo tako, da vpišemo novo kodo licence z ukazom:
```sh ```sh
sudo defaults write /Library/Preferences/si.amebis.Besana.ALic.plist KodaLicence -string 123-456-789-012-345 sudo defaults write /Library/Application\ Support/Amebis/Besana.plist KodaLicence -string 123-456-789-012-345
sudo chmod a+r /Library/Preferences/si.amebis.Besana.ALic.plist sudo chmod a+r /Library/Application\ Support/Amebis/Besana.plist
sudo /Library/Application\ Support/Amebis/Besana/ALicVL /Applications/Amebis\ Besana/ALicVL
``` ```
Lokalna licenca je shranjena v `/Library/Preferences/si.amebis.Besana.Licenca.plist`. Odstranimo jo z ukazom: Lokalna licenca je shranjena v `/Library/Application\ Support/Amebis/Besana/Licenca.plist`. Odstranimo jo z ukazom:
```sh ```sh
sudo rm /Library/Preferences/si.amebis.Besana.Licenca.plist sudo rm /Library/Application\ Support/Amebis/Besana/Licenca.plist
``` ```
## Omrežna licenca ## Omrežna licenca
@@ -185,23 +157,23 @@ reg delete "HKLM\SOFTWARE\Amebis\Besana\Posredno" /f /reg:64
Posrednik nastavimo z ukazom: Posrednik nastavimo z ukazom:
```sh ```sh
sudo defaults write /Library/Preferences/si.amebis.Besana.ALic.plist Posrednik -array -string 10.1.1.5 sudo defaults write /Library/Application\ Support/Amebis/Besana.plist Posrednik -array -string 10.1.1.5
sudo chmod a+r /Library/Preferences/si.amebis.Besana.ALic.plist sudo chmod a+r /Library/Application\ Support/Amebis/Besana.plist
sudo /Library/Application\ Support/Amebis/Besana/ALicVL /Applications/Amebis\ Besana/ALicVL
``` ```
ali: ali:
```sh ```sh
sudo defaults write /Library/Preferences/si.amebis.Besana.ALic.plist Posrednik -array -string alicpos.lj.org.home -string alicpos.mb.org.home 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/Preferences/si.amebis.Besana.ALic.plist sudo chmod a+r /Library/Application\ Support/Amebis/Besana.plist
sudo /Library/Application\ Support/Amebis/Besana/ALicVL /Applications/Amebis\ Besana/ALicVL
``` ```
Omrežna licenca je shranjena v `/Library/Preferences/si.amebis.Besana.Posredno.plist`. Odstranimo jo z ukazom: Omrežna licenca je shranjena v `/Library/Application\ Support/Amebis/Besana/Posredno.plist`. Odstranimo jo z ukazom:
```sh ```sh
sudo rm /Library/Preferences/si.amebis.Besana.Posredno.plist sudo rm /Library/Application\ Support/Amebis/Besana/Posredno.plist
``` ```
# Pravopisni strežnik Amebis Besana # Pravopisni strežnik Amebis Besana
@@ -210,7 +182,9 @@ Pravopisni strežnik BesStr je sistemski servis Windows oz. servis `launchd` na
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. 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 programskega paketa nastavi servis za samodejni zagon in ga požene. 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. Pri vsakem spreminjanju nastavitev v registru oz. datotekah `.plist` moramo servis ponovno zagnati, saj prebere nastavitve samo ob svojem zagonu.
@@ -218,14 +192,10 @@ Morebitna obvestila in napake servis zapisuje v Event Log (Windows) oz. v Consol
## Vtičnica TCP za sprejemanje zahtev ## Vtičnica TCP za sprejemanje zahtev
Strežnik privzeto sprejema zahteve na `localhost:225` - IPv4 in IPv6, TCP, HTTP. 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. 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.
### TLS
_V pripravi_
### Windows ### Windows
Spisek vtičnic nastavimo z ukazom (ukazna vrstica s skrbniškimi pravicami): Spisek vtičnic nastavimo z ukazom (ukazna vrstica s skrbniškimi pravicami):
@@ -241,39 +211,12 @@ net start BesStr
Spisek vtičnic nastavimo z ukazom: Spisek vtičnic nastavimo z ukazom:
```sh ```sh
sudo defaults write /Library/LaunchDaemons/si.amebis.Besana.BesStr.plist Sockets/http -array -dict SockFamily -string IPv4 SockNodeName -string 0.0.0.0 SockServiceName -int 225 -dict SockFamily -string IPv6 SockNodeName -string :: SockServiceName -int 225 sudo defaults write "/Library/Application Support/Amebis/Besana/BesStr.plist" "Sprejemaj" -array -string "0.0.0.0:225" -string "[::]:225"
sudo defaults write /Library/LaunchDaemons/si.amebis.Besana.BesStr.plist Sockets/https -array -dict SockFamily -string IPv4 SockNodeName -string 0.0.0.0 SockServiceName -int 4225 -dict SockFamily -string IPv6 SockNodeName -string :: SockServiceName -int 4225 sudo chmod a+r "/Library/Application Support/Amebis/Besana/BesStr.plist"
sudo chmod a+r /Library/LaunchDaemons/si.amebis.Besana.BesStr.plist sudo launchctl unload /System/Library/LaunchDaemons/BesStr.plist
sudo launchctl unload /Library/LaunchDaemons/si.amebis.Besana.BesStr.plist sudo launchctl load /System/Library/LaunchDaemons/BesStr.plist
sudo launchctl load /Library/LaunchDaemons/si.amebis.Besana.BesStr.plist
``` ```
## Beleženje zahtev v datoteko
Strežnik privzeto ne beleži zahtev. Lahko pa za diagnostične potrebe vklopimo beleženje zahtev HTTP v datoteko.
### Windows
Beleženje zahtev v datoteko nastavimo z ukazom (ukazna vrstica s skrbniškimi pravicami):
```bat
reg add "HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\BesStr\Parametri" /v "DatotekaDnevnika" /t REG_EXPAND_SZ /d "%TEMP%\BesStr.log" /f /reg:64
net stop BesStr
net start BesStr
```
### macOS
Beleženje zahtev v datoteko nastavimo z ukazom:
```sh
sudo defaults write /Library/LaunchDaemons/si.amebis.Besana.BesStr.plist Parametri/DatotekaDnevnika -string /tmp/BesStr.log
sudo chmod a+r /Library/LaunchDaemons/si.amebis.Besana.BesStr.plist
sudo launchctl unload /Library/LaunchDaemons/si.amebis.Besana.BesStr.plist
sudo launchctl load /Library/LaunchDaemons/si.amebis.Besana.BesStr.plist
```
<!---
## Zaledni strežnik LanguageTool ## 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/)). 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/)).
@@ -301,21 +244,20 @@ net start BesStr
Uporabo svojega zalednega strežnika LanguageTool lahko nastavimo z ukazom: Uporabo svojega zalednega strežnika LanguageTool lahko nastavimo z ukazom:
```sh ```sh
sudo defaults write /Library/LaunchDaemons/si.amebis.Besana.BesStr.plist Parametri/LanguageToolStreznik -string "" sudo defaults write "/Library/Application Support/Amebis/Besana/BesStr.plist" "LanguageToolStreznik" -string ""
sudo chmod a+r /Library/LaunchDaemons/si.amebis.Besana.BesStr.plist sudo chmod a+r "/Library/Application Support/Amebis/Besana/BesStr.plist"
sudo launchctl unload /Library/LaunchDaemons/si.amebis.Besana.BesStr.plist sudo launchctl unload /System/Library/LaunchDaemons/BesStr.plist
sudo launchctl load /Library/LaunchDaemons/si.amebis.Besana.BesStr.plist sudo launchctl load /System/Library/LaunchDaemons/BesStr.plist
``` ```
Uporabo svojega zalednega strežnika LanguageTool lahko nastavimo z ukazom: Uporabo svojega zalednega strežnika LanguageTool lahko nastavimo z ukazom:
```sh ```sh
sudo defaults write /Library/LaunchDaemons/si.amebis.Besana.BesStr.plist Parametri/LanguageToolStreznik -string "http://localhost:8080/" sudo defaults write "/Library/Application Support/Amebis/Besana/BesStr.plist" "LanguageToolStreznik" -string "http://localhost:8080/"
sudo chmod a+r /Library/LaunchDaemons/si.amebis.Besana.BesStr.plist sudo chmod a+r "/Library/Application Support/Amebis/Besana/BesStr.plist"
sudo launchctl unload /Library/LaunchDaemons/si.amebis.Besana.BesStr.plist sudo launchctl unload /System/Library/LaunchDaemons/BesStr.plist
sudo launchctl load /Library/LaunchDaemons/si.amebis.Besana.BesStr.plist sudo launchctl load /System/Library/LaunchDaemons/BesStr.plist
``` ```
-->
## Slovar v glavnem pomnilniku ## Slovar v glavnem pomnilniku
@@ -346,17 +288,17 @@ net start BesStr
Nalaganje slovarja v glavni pomnilnik vklopimo z ukazom: Nalaganje slovarja v glavni pomnilnik vklopimo z ukazom:
```sh ```sh
sudo defaults write /Library/Preferences/si.amebis.Besana.AJTOdj.plist SlovarVPomnilniku -bool True sudo defaults write "/Library/Application Support/Amebis/Besana/AJTOdj.plist" "SlovarVPomnilniku" -bool True
sudo chmod a+r /Library/Preferences/si.amebis.Besana.AJTOdj.plist sudo chmod a+r "/Library/Application Support/Amebis/Besana/AJTOdj.plist"
sudo launchctl unload /Library/LaunchDaemons/si.amebis.Besana.BesStr.plist sudo launchctl unload /System/Library/LaunchDaemons/AJTOdj.plist
sudo launchctl load /Library/LaunchDaemons/si.amebis.Besana.BesStr.plist sudo launchctl load /System/Library/LaunchDaemons/AJTOdj.plist
``` ```
Nalaganje slovarja v glavni pomnilnik izklopimo z ukazom: Nalaganje slovarja v glavni pomnilnik izklopimo z ukazom:
```sh ```sh
sudo defaults write /Library/Preferences/si.amebis.Besana.AJTOdj.plist SlovarVPomnilniku -bool False sudo defaults write "/Library/Application Support/Amebis/Besana/AJTOdj.plist" "SlovarVPomnilniku" -bool False
sudo chmod a+r "/Library/Preferences/si.amebis.Besana.AJTOdj.plist" sudo chmod a+r "/Library/Application Support/Amebis/Besana/AJTOdj.plist"
sudo launchctl unload /Library/LaunchDaemons/si.amebis.Besana.BesStr.plist sudo launchctl unload /System/Library/LaunchDaemons/AJTOdj.plist
sudo launchctl load /Library/LaunchDaemons/si.amebis.Besana.BesStr.plist sudo launchctl load /System/Library/LaunchDaemons/AJTOdj.plist
``` ```

12
admin/Uninstall.md
View File

@@ -14,13 +14,7 @@ Licenca, nastavitev Amebisovega posrednika licenc in uporabniške nastavitve ost
### macOS ### macOS
Besano odstranimo z ukazom: _V pripravi_
```sh
sudo /Library/Application\ Support/Amebis/Besana/uninstall
```
Licenca, nastavitev Amebisovega posrednika licenc in uporabniške nastavitve ostanejo prisotne tudi po odstranitvi.
# Odstranitev licence in drugih nastavitev vezanih na računalnik # Odstranitev licence in drugih nastavitev vezanih na računalnik
@@ -35,8 +29,8 @@ reg delete "HKLM\SYSTEM\CurrentControlSet\Services\BesStr\Parametri" /f /reg:64
### macOS ### macOS
Programski paket vse svoje nastavitve, ki veljajo za posamezen računalnik, hrani v datotekah `/Library/Preferences/si.amebis.Besana.*`. Odstranimo jih lahko z ukazom: Programski paket vse svoje nastavitve, ki veljajo za posamezen računalnik, hrani v `/Library/Application Support/Amebis/Besana`. Odstranimo jih lahko z ukazom:
```sh ```sh
sudo rm -rf /Library/Preferences/si.amebis.Besana.* sudo rm -rf /Library/Application\ Support/Amebis/Besana
``` ```

15
admin/Update.md
View File

@@ -8,13 +8,13 @@ Verzija 4.39 je imela napako, zaradi katere samoposodobitev na novejšo izdajo n
Samoposodabljanje lahko izklopimo na več načinov. Samoposodabljanje lahko izklopimo na več načinov.
1. Da tega dela sploh ne namestimo (ukazna vrstica s skrbniškimi pravicami): Da tega dela sploh ne namestimo (ukazna vrstica s skrbniškimi pravicami):
```bat ```bat
msiexec /i "\\distsrv\share\Besana.x64.msi" /qb REMOVE=featAUpdate msiexec /i "\\distsrv\share\Besana.x64.msi" /qb REMOVE=featAUpdate
``` ```
2. Da preklopimo kanal za posodobitve s `"stable"` (privzeto) na `""` (ukazna vrstica s skrbniškimi pravicami): Da preklopimo kanal za posodobitve s `"stable"` (privzeto) na `""` (ukazna vrstica s skrbniškimi pravicami):
```bat ```bat
reg add "HKLM\SOFTWARE\Amebis\Besana\AUpdate" /v "Channel" /t REG_SZ /d "" /f /reg:64 reg add "HKLM\SOFTWARE\Amebis\Besana\AUpdate" /v "Channel" /t REG_SZ /d "" /f /reg:64
@@ -22,13 +22,4 @@ Samoposodabljanje lahko izklopimo na več načinov.
### macOS ### macOS
Samoposodabljanje lahko izklopimo na več načinov. _V pripravi_
1. Da te komponente sploh ne namestimo.
2. Da preklopimo kanal za posodobitve s `"stable"` (privzeto) na `""`:
```sh
sudo defaults write /Library/Preferences/si.amebis.Besana.AUpdate.plist Channel -string ""
sudo chmod a+r /Library/Preferences/si.amebis.Besana.AUpdate.plist
```