199 lines
8.3 KiB
HTML
199 lines
8.3 KiB
HTML
<!DOCTYPE html>
|
|
<html lang="en">
|
|
<head>
|
|
|
|
|
|
<meta charset="utf-8">
|
|
<meta http-equiv="X-UA-Compatible" content="IE=edge">
|
|
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
|
|
|
|
|
<link rel="canonical" href="https://git.tylconsulting.it/thothii-docs/install/shell-and-language/">
|
|
<link rel="shortcut icon" href="../../img/favicon.ico">
|
|
<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0" />
|
|
<title>Display mode and language - ThothII Docs</title>
|
|
<link href="../../css/bootstrap-3.3.7.min.css" rel="stylesheet">
|
|
<link href="../../css/font-awesome-4.7.0.css" rel="stylesheet">
|
|
<link href="../../css/base.css" rel="stylesheet">
|
|
<link rel="stylesheet" href="../../css/highlight.css">
|
|
<link href="../../stylesheets/extra.css" rel="stylesheet">
|
|
<!-- HTML5 shim and Respond.js IE8 support of HTML5 elements and media queries -->
|
|
<!--[if lt IE 9]>
|
|
<script src="https://oss.maxcdn.com/libs/html5shiv/3.7.0/html5shiv.js"></script>
|
|
<script src="https://oss.maxcdn.com/libs/respond.js/1.3.0/respond.min.js"></script>
|
|
<![endif]-->
|
|
|
|
<script src="../../js/jquery-3.2.1.min.js"></script>
|
|
<script src="../../js/bootstrap-3.3.7.min.js"></script>
|
|
<script src="../../js/highlight.pack.js"></script>
|
|
|
|
<base target="_top">
|
|
<script>
|
|
var base_url = '../..';
|
|
var is_top_frame = false;
|
|
|
|
var pageToc = [
|
|
{title: "Display mode and language", url: "#_top", children: [
|
|
{title: "Standalone setup", url: "#standalone-setup" },
|
|
{title: "Authentication and embedded deployments", url: "#authentication-and-embedded-deployments" },
|
|
{title: "Three different languages", url: "#three-different-languages" },
|
|
]},
|
|
];
|
|
|
|
</script>
|
|
<script src="../../js/base.js"></script>
|
|
<script src="../../javascripts/layout-init.js"></script>
|
|
</head>
|
|
|
|
<body>
|
|
<script>
|
|
if (is_top_frame) { $('body').addClass('wm-top-page'); }
|
|
</script>
|
|
|
|
|
|
|
|
<div class="container-fluid wm-page-content">
|
|
<a name="_top"></a>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<div class="row wm-article-nav-buttons" role="navigation" aria-label="navigation">
|
|
|
|
<div class="wm-article-nav pull-right">
|
|
<a href="../authentication-local/" class="btn btn-xs btn-default pull-right">
|
|
Next
|
|
<i class="fa fa-chevron-right" aria-hidden="true"></i>
|
|
</a>
|
|
<a href="../authentication-local/" class="btn btn-xs btn-link">
|
|
Local authentication
|
|
</a>
|
|
</div>
|
|
|
|
<div class="wm-article-nav">
|
|
<a href="../standalone-manual-en/" class="btn btn-xs btn-default pull-left">
|
|
<i class="fa fa-chevron-left" aria-hidden="true"></i>
|
|
Previous</a><a href="../standalone-manual-en/" class="btn btn-xs btn-link">
|
|
Mac, Windows, Linux — English
|
|
</a>
|
|
</div>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
<h1 id="display-mode-and-language">Display mode and language<a class="headerlink" href="#display-mode-and-language" title="Permanent link">¶</a></h1>
|
|
<p>ThothII can run with its own application header (<strong>full</strong>) or inside an integrated
|
|
portal (<strong>embedded</strong>). Display mode and authentication are separate choices.</p>
|
|
<table>
|
|
<thead>
|
|
<tr>
|
|
<th>Installation</th>
|
|
<th>Display</th>
|
|
<th>Authentication</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td>Standalone local instance</td>
|
|
<td><code>full</code></td>
|
|
<td>Local ThothII account</td>
|
|
</tr>
|
|
<tr>
|
|
<td>Standalone server</td>
|
|
<td><code>full</code></td>
|
|
<td>Local accounts or configured OIDC provider</td>
|
|
</tr>
|
|
<tr>
|
|
<td>Integrated portal</td>
|
|
<td><code>embedded</code></td>
|
|
<td>Identity verified by the portal's trusted server proxy</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
<h2 id="standalone-setup">Standalone setup<a class="headerlink" href="#standalone-setup" title="Permanent link">¶</a></h2>
|
|
<p>Follow the complete <a href="../standalone-manual-it/">Italian</a> or
|
|
<a href="../standalone-manual-en/">English</a> installation procedure. It explicitly selects
|
|
<code>--shell-mode full --shell-default-locale en</code> and separates configuration, credentials,
|
|
initial migrations and startup. Do not skip those steps by running setup alone.</p>
|
|
<p>The authored installation descriptor contains:</p>
|
|
<pre class="highlight"><code class="language-yaml">shell:
|
|
mode: full
|
|
defaultLocale: en</code></pre>
|
|
<p>Use <code>it</code> for an Italian initial interface. Existing browser language preferences can
|
|
override that initial value. Full mode remembers language and theme in the browser.</p>
|
|
<p>For an existing installation, preserve the current descriptor and edit only the intended
|
|
settings; do not rerun setup to overwrite it. With a current host <code>tht</code> binary:</p>
|
|
<pre class="highlight"><code class="language-sh">tht --installation /absolute/path/thothii-installation.yaml installation generate
|
|
tht --installation /absolute/path/thothii-installation.yaml start
|
|
tht --installation /absolute/path/thothii-installation.yaml status
|
|
tht --installation /absolute/path/thothii-installation.yaml doctor --json</code></pre>
|
|
<p>Generation updates derived configuration; it does not start services. <code>start</code> applies
|
|
the installation's normal lifecycle and is not guaranteed to touch only the frontend.
|
|
Follow the deployment's maintenance procedure and retain its network, authentication and
|
|
model settings. Do not edit generated files or remove persistent volumes.</p>
|
|
<h2 id="authentication-and-embedded-deployments">Authentication and embedded deployments<a class="headerlink" href="#authentication-and-embedded-deployments" title="Permanent link">¶</a></h2>
|
|
<p>Full mode does not configure login by itself. See <a href="../authentication-local/">local authentication</a>
|
|
or <a href="../authentication-oidc/">OIDC</a>, with <a href="../authentik/">Authentik</a> as a provider option.</p>
|
|
<p>Embedded mode requires a compatible portal integration, not just a descriptor toggle.
|
|
The portal owns login/logout and supplies a server-verified identity. A presentation
|
|
adapter does not authenticate users. The core must not be reachable by a route that
|
|
bypasses the trusted proxy. Do not add a second OIDC login to an already authenticated
|
|
upstream deployment.</p>
|
|
<p>Portal implementation details belong to the
|
|
<a href="https://git.tylconsulting.it/mptyl/ThothII/src/branch/main/docs/install/authentication-upstream.md">developer integration reference in the repository</a>,
|
|
not to the standalone installation procedure.</p>
|
|
<h2 id="three-different-languages">Three different languages<a class="headerlink" href="#three-different-languages" title="Permanent link">¶</a></h2>
|
|
<ul>
|
|
<li><strong>Interface language</strong> controls labels, forms and application messages.</li>
|
|
<li><strong>Session interaction language</strong> is captured when a session is created. Resuming it
|
|
retains that language even if the interface language changes later.</li>
|
|
<li><strong>Workspace language</strong> concerns domain content and retrieval; switching the interface
|
|
does not translate Evidence, SQL, identifiers or database values.</li>
|
|
</ul>
|
|
<p>In embedded mode the interface follows the portal's language and theme. A portal language
|
|
change may reload the page. Saved session artifacts remain available, but resuming work
|
|
is explicit; a reload does not by itself request a new model generation.</p>
|
|
|
|
<br>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<div class="row wm-article-nav-buttons" role="navigation" aria-label="navigation">
|
|
|
|
<div class="wm-article-nav pull-right">
|
|
<a href="../authentication-local/" class="btn btn-xs btn-default pull-right">
|
|
Next
|
|
<i class="fa fa-chevron-right" aria-hidden="true"></i>
|
|
</a>
|
|
<a href="../authentication-local/" class="btn btn-xs btn-link">
|
|
Local authentication
|
|
</a>
|
|
</div>
|
|
|
|
<div class="wm-article-nav">
|
|
<a href="../standalone-manual-en/" class="btn btn-xs btn-default pull-left">
|
|
<i class="fa fa-chevron-left" aria-hidden="true"></i>
|
|
Previous</a><a href="../standalone-manual-en/" class="btn btn-xs btn-link">
|
|
Mac, Windows, Linux — English
|
|
</a>
|
|
</div>
|
|
|
|
</div>
|
|
|
|
<br>
|
|
</div>
|
|
|
|
<footer class="container-fluid wm-page-content">
|
|
<p>Documentation built with <a href="https://www.mkdocs.org/">MkDocs</a> using <a href="https://github.com/gristlabs/mkdocs-windmill">Windmill</a> theme by Grist Labs.</p>
|
|
</footer>
|
|
|
|
</body>
|
|
</html> |