ogbrowser/README.md

71 lines
2.0 KiB
Markdown

# OG Browser
El OpenGnsys Browser es un navegador limitado de tipo quiosco, basado en Qt6/Chrome.
## Compilación
Compilar require Qt6. Hay paquetes disponibles para todas las distribuciones modernas.
El módulo de terminal requiere `lxqt-build-tools` porque es parte del proyecto LxQt, pero el navegador resultante no require LxQt.
### Dependencias
#### Ubuntu 22.04
# apt install build-essential cmake g++ qt6-base-dev qt6-webengine-dev linguist-qt6 libgl1-mesa-dev qt6-tools-dev qt6-l10n-tools qt6-tools-dev-tools libqt6core5compat6-dev lxqt-build-tools qt6-webengine-dev-tools libqt6webenginecore6-bin
### Compilar
El sistema esta basado en CMake. Para compilar:
git clone https://ognproject.evlt.uma.es/gitea/unizar/ogbrowser.git
cd ogbrowser
mkdir build
cd build
cmake ..
make -j8 # 8 cores -- cambiar según el numero de cores del hardware
## Uso
src/OGBrowser URL
Por ejemplo:
src/OGBrowser http://example.com
## URLs especiales:
El navegador reconoce URLs especiales dentro de los documentos, que pueden usarse
para ejecutar comandos locales.
* command - Ejecuta un comando
* command+output - Ejecuta un comando y muestra la salida
* command+confirm - Pregunta antes de ejecutar un comando
* command+confirm+output - Pregunta antes de ejecutar un comando y muestra la salida
* command+output+confirm - Idéntico al anterior
Ejemplo:
<a href="command+confirm+output:/bin/ping -c 5 127.0.0.1">Ejecutar</a>
Esto crea un enlace que al hacerse click, ejecuta el comando ping y muestra el resultado en una ventana.
## Proxy
Usa el proxy del sistema, incluyendo las variables de entorno: HTTP_PROXY, HTTPS_PROXY, ALL_PROXY, NO_PROXY
## Modo administrativo
El administrador dispone de una consola y mas información sobre la ejecución de comandos.
Se activa estableciendo la variable de entorno `ogactiveadmin=true`
## Modo quiosco
Se puede activar el modo quiosco que impide la salida del navegador con Alt+F4.
Se activa estableciendo la variable de entorno `OGKIOSKMODE=true`