📔 Clean up some things

docs/source/2_admin/1_installation/3_configuring_dns.rst

@@ -1,17 +1,17 @@
 Configurazione DNS
 ==================
 
-Si scelga il dominio (o sottodominio) sul quale si vuole che Sophon sia accessibile e si aggiungano i seguenti record DNS, sostituendo il dominio scelto a ``DOMINIO`` e gli indirizzi IPv4 e IPv6 del server al posto di `0.0.0.0` e `1234::1234`:
+Si scelga il dominio (o sottodominio) sul quale si vuole che Sophon sia accessibile e si aggiungano i seguenti record DNS, sostituendo il dominio ``ilmiosophon.it`` con il proprio nome di dominio, e gli indirizzi IPv4 e IPv6 del server al posto di `0.0.0.0` e `1234::1234`:
 
 .. code-block:: dns
 
-   *.DOMINIO 1800 IN A    0.0.0.0
+   *.ilmiosophon.it 1800 IN A    0.0.0.0
-   *.DOMINIO 1800 IN AAAA 1234::1234
+   *.ilmiosophon.it 1800 IN AAAA 1234::1234
-   DOMINIO   1800 IN A    0.0.0.0
+   ilmiosophon.it   1800 IN A    0.0.0.0
-   DOMINIO   1800 IN AAAA 1234::1234
+   ilmiosophon.it   1800 IN AAAA 1234::1234
 
-Sophon sarà accessibile ai seguenti indirizzi:
+Sophon sarà quindi accessibile ai seguenti indirizzi:
 
-- l'interfaccia web a ``https://DOMINIO/``;
+- l'interfaccia web al dominio base (``https://ilmiosophon.it/``);
-- l'API a ``https://api.DOMINIO/``;
+- l'API al dominio base prefisso con ``api.`` (``https://api.ilmiosophon.it/``);
-- i notebook a ``https://SLUG.DOMINIO/``.
+- i notebook al dominio base prefissi con lo slug del notebook (``https://ilmionotebook.ilmiosophon.it/``).

docs/source/2_admin/1_installation/4_configuring_compose.rst

@@ -39,11 +39,11 @@ Specifica la chiave segreta da usare per i cookie di sessione.
 ``DJANGO_PROXY_BASE_DOMAIN``
 ----------------------------
 
-Specifica il dominio che dovrà essere usato come radice per il proxy, ovvero il ``DOMINIO`` per il quale si è configurato il DNS in precedenza.
+Specifica il dominio che dovrà essere usato come radice per il proxy, ovvero il dominio per il quale si è configurato il DNS in precedenza.
 
 .. code-block:: yml
 
-   - DJANGO_PROXY_BASE_DOMAIN=prod.sophon.steffo.eu
+   - DJANGO_PROXY_BASE_DOMAIN=ilmiosophon.it
 
 .. note::
 
@@ -59,7 +59,7 @@ Specifica il dominio che dovrà essere usato come radice per il proxy, ovvero il
 
 Specifica il protocollo che dovrà essere usato nei mapping del proxy.
 
-Si consiglia caldamente di utilizzare ``https``, ma è un valore valido anche ``http``.
+Si consiglia vivamente di utilizzare ``https``, ma è un valore valido anche ``http``.
 
 .. code-block:: yml
 
@@ -73,11 +73,11 @@ Specifica i domini da cui possono provenire le richieste alla pagina di amminist
 
 Per specificare più domini, è necessario separarli con dei pipe ``|`` .
 
-Eccetto in configurazioni speciali, deve essere uguale a ``api.DOMINIO``.
+Eccetto in configurazioni speciali, deve essere uguale al dominio prefisso da ``api.``.
 
 .. code-block:: yml
 
-   - DJANGO_ALLOWED_HOSTS=api.prod.sophon.steffo.eu
+   - DJANGO_ALLOWED_HOSTS=api.ilmiosophon.it
 
 .. seealso::
 
@@ -91,11 +91,11 @@ Specifica i domini da cui possono provenire le richieste all'API.
 
 Per specificare più domini, è necessario separarli con dei pipe ``|`` .
 
-Eccetto in configurazioni speciali, deve essere uguale a ``PROTOCOLLO://DOMINIO|https://sophon.steffo.eu``.
+Eccetto in configurazioni speciali, deve contenere il proprio dominio prefisso dal protocollo, e in aggiunta il dominio speciale ``https://sophon.steffo.eu``, necessario per permettere l'accesso dall'interfaccia web "universale" di Sophon.
 
 .. code-block:: yml
 
-   - DJANGO_ALLOWED_ORIGINS=https://prod.sophon.steffo.eu|https://sophon.steffo.eu
+   - DJANGO_ALLOWED_ORIGINS=https://ilmiosophon.it|https://sophon.steffo.eu
 
 .. seealso::
 
@@ -107,15 +107,15 @@ Eccetto in configurazioni speciali, deve essere uguale a ``PROTOCOLLO://DOMINIO|
 
 Specifica l'URL a cui saranno accessibili i file statici di Sophon.
 
-Eccetto in configurazioni speciali, deve essere uguale a ``PROTOCOLLO://static.DOMINIO/django-static/``.
+Eccetto in configurazioni speciali, deve essere uguale alla seguente stringa, con le parole in maiuscolo sostituite rispettivamente dal protocollo e dal dominio selezionato: ``PROTOCOLLO://static.DOMINIO/django-static/``.
 
 .. code-block:: yml
 
-   - DJANGO_ALLOWED_ORIGINS=http://static.prod.sophon.steffo.eu/django-static/
+   - DJANGO_ALLOWED_ORIGINS=http://static.ilmiosophon.it/django-static/
 
 .. warning::
 
-   Ci si assicuri di inserire la barra finale, altrimenti Sophon non funzionerà correttamente!
+   Ci si assicuri che sia presente uno slash al termine della stringa, oppure il pannello di amministrazione non sarà visualizzato correttamente!
 
 .. seealso::
 
@@ -133,10 +133,6 @@ Usa il formato `language code`_ di Django.
 
    - DJANGO_LANGUAGE_CODE=en-us
 
-.. tip::
-
-   Generalmente è una buona idea impostarlo a ``en-us`` per facilitare la risoluzione di eventuali problemi.
-
 .. seealso::
 
    `LANGUAGE_CODE <https://docs.djangoproject.com/en/3.2/ref/settings/#language-code>`_ nella documentazione di Django
@@ -153,7 +149,7 @@ Usa il formato `tzdata`_.
 
 .. code-block:: yml
 
-   - DJANGO_TIME_ZONE=Europe/Rome
+   - DJANGO_TIME_ZONE=Europe/Paris
 
 .. hint::
 
@@ -200,6 +196,18 @@ Specifica la password del :ref:`superutente` che verrà automaticamente creato q
    La password è un dato estremamente riservato, in quanto chiunque ne venga a conoscenza potrà accedere a Sophon con pieni privilegi!
 
 
+``REACT_APP_DEFAULT_INSTANCE``
+------------------------------
+
+Specifica il valore con cui precompilare il campo "selezione istanza" dell'interfaccia web di Sophon.
+
+Eccetto in configurazioni speciali, deve essere uguale al dominio prefisso dal protocollo e da ``api.``.
+
+.. code-block:: yml
+
+   - REACT_APP_DEFAULT_INSTANCE=https://api.ilmiosophon.it
+
+
 ``APACHE_PROXY_BASE_DOMAIN``
 ----------------------------
 

docs/source/2_admin/1_installation/7_host_reverse_proxy.rst

@@ -20,8 +20,8 @@ Si aggiungano i seguenti ``VirtualHost`` alla configurazione:
 .. code-block:: apacheconf
 
    <VirtualHost *:80>
-       ServerName "DOMINIO"
+       ServerName "ilmiosophon.it"
-       ServerAlias "*.DOMINIO"
+       ServerAlias "*.ilmiosophon.it"
 
        RewriteEngine On
        RewriteRule ^(.*)$ https://%{HTTP_HOST}$1 [R=301,L]
@@ -30,12 +30,12 @@ Si aggiungano i seguenti ``VirtualHost`` alla configurazione:
 .. code-block:: apacheconf
 
    <VirtualHost *:443>
-       ServerName "DOMINIO"
+       ServerName "ilmiosophon.it"
-       ServerAlias "*.DOMINIO"
+       ServerAlias "*.ilmiosophon.it"
 
        SSLEngine on
-       SSLCertificateFile      "/PERCORSO/ALLA/CATENA/DI/CHIAVI/PUBBLICHE/SSL"
+       SSLCertificateFile      "/SOSTITUISCIMI/CON/IL/PERCORSO/ALLA/FULL/CHAIN/SSL"
-       SSLCertificateKeyFile   "/PERCORSO/ALLA/CHIAVE/PRIVATA/SSL"
+       SSLCertificateKeyFile   "/SOSTITUISCIMI/CON/IL/PERCORSO/ALLA/CHIAVE/PRIVATA/SSL"
 
        ProxyPreserveHost On
        RequestHeader set "X-Forwarded-Proto" expr=%{REQUEST_SCHEME}

docs/source/2_admin/1_installation/8_final_check.rst

@@ -1,4 +1,4 @@
 Verificare il funzionamento
 ===========================
 
-Se tutto è stato configurato correttamente, l'interfaccia utente Sophon dovrebbe essere raggiungibile al ``DOMINIO`` specificato, e dovrebbe essere possibile effettuare il login con le credenziali del primo :ref:`superutente` configurate.
+Se tutto è stato configurato correttamente, l'interfaccia web Sophon dovrebbe essere raggiungibile al dominio selezionato (``https://ilmiosophon.it``), e dovrebbe essere possibile effettuare il login con le credenziali configurate del primo :ref:`superutente`.

docs/source/2_admin/2_administration/customization.rst

@@ -1,6 +0,0 @@
-Personalizzazione
-=================
-
-È possibile personalizzare l'istanza come descritto nella sezione :ref:`Personalizzazione dell'istanza` modificando l'unica voce del tipo **Sophon instance details** all'interno di **Sophon Core**.
-
-.. image:: customization.png