http: documented 'baseUrl' option, the base URL fallback outside HTTP requests

Author: dg

application/cs/bootstrapping.texy

@@ -263,7 +263,7 @@ V konfiguračních souborech můžete využít tyto parametry:
 - `%tempDir%` je absolutní cesta k adresáři pro dočasné soubory
 - `%vendorDir%` je absolutní cesta k adresáři, kam Composer instaluje knihovny
 - `%rootDir%` je absolutní cesta ke kořenovému adresáři projektu
-- `%baseUrl%` je absolutní URL ke kořenovému adresáři (dynamický parametr vyhodnocovaný za běhu)
+- `%baseUrl%` je absolutní URL ke kořenovému adresáři (dynamický parametr vyhodnocovaný za běhu; mimo HTTP požadavek se odvozuje z [http: baseUrl |http:configuration#Základní URL aplikace])
 - `%debugMode%` udává, zda je aplikace v debugovacím režimu
 - `%consoleMode%` udává, zda request přišel přes příkazovou řádku
 

application/en/bootstrapping.texy

@@ -263,7 +263,7 @@ You can use these parameters in the configuration files:
 - `%tempDir%` is the absolute path to the directory for temporary files
 - `%vendorDir%` is the absolute path to the directory where Composer installs libraries
 - `%rootDir%` is the absolute path to the root directory of the project
-- `%baseUrl%` is the absolute URL to the root directory (a dynamic parameter resolved at runtime)
+- `%baseUrl%` is the absolute URL to the root directory (a dynamic parameter resolved at runtime; outside an HTTP request it is derived from [http: baseUrl |http:configuration#Application Base URL])
 - `%debugMode%` indicates whether the application is in debug mode
 - `%consoleMode%` indicates whether the request came through the command line
 

http/cs/configuration.texy

@@ -122,6 +122,20 @@ http:
 ```
 
 
+Základní URL aplikace .{data-version:3.4.1}
+-------------------------------------------
+
+Nette si zjišťuje adresu, na které aplikace běží, z HTTP požadavku, takže není potřeba nic nastavovat. Při spuštění z příkazové řádky (cron, úlohy, MCP server) ale žádný požadavek není a odvozené hodnoty jako `%baseUrl%`, odkazy z `LinkGenerator` nebo `$baseUrl` v šablonách by neměly odkud vzniknout. Pro tyto případy lze zadat základní URL aplikace:
+
+```neon
+http:
+	# použije se jen tehdy, když nelze adresu zjistit z požadavku
+	baseUrl: https://example.com/    # (string) výchozí je nenastaveno
+```
+
+Hodnota se uplatní pouze tehdy, když z prostředí nevzejde žádný host. Na webu má vždy přednost skutečný požadavek, takže stejná konfigurace funguje na localhostu i v produkci. URL musí být absolutní, včetně případného podadresáře (`https://example.com/eshop`).
+
+
 Session
 =======
 

http/en/configuration.texy

@@ -122,6 +122,20 @@ http:
 ```
 
 
+Application Base URL .{data-version:3.4.1}
+------------------------------------------
+
+Nette detects the address the application runs at from the HTTP request, so nothing needs to be configured. When run from the command line (cron, tasks, an MCP server) there is no request, and derived values such as `%baseUrl%`, links from `LinkGenerator` or `$baseUrl` in templates would have nothing to come from. For these cases you can specify the base URL of the application:
+
+```neon
+http:
+	# used only when the address cannot be detected from the request
+	baseUrl: https://example.com/    # (string) defaults to not set
+```
+
+The value applies only when the environment yields no host. On the web the actual request always takes precedence, so the same configuration works on localhost and in production. The URL must be absolute, including any subdirectory (`https://example.com/eshop`).
+
+
 Session
 =======