Documentazione di Wardterm

Le basi del terminale

Lavora nel terminale di Wardterm: schede e sessioni, il menu della sessione, pannelli divisi e gruppi di lavoro, il pannello laterale, temi e scorciatoie.

Sessioni e schede

  • Su Mac e iPad ogni sessione è una scheda. Cmd+T apre una nuova scheda, dove trovi un server o scrivi user@host e premi Invio. Da Cmd+1 a Cmd+9 passi da una scheda all'altra.
  • Trascina una scheda lungo la barra per cambiare l'ordine. Su Mac, trascinala in giù fuori dalla barra e si apre in una finestra a parte (Pro), con la sessione che continua; trascinala nella barra della finestra principale e torna dove la lasci.
  • Fai clic destro su una scheda, o tienila premuta, per il menu della sessione, che finisce con Sposta in una nuova finestra (Mac), Chiudi le altre sessioni e Chiudi le sessioni a destra. In una finestra a parte, il clic destro su una scheda ha Riporta nella finestra principale.
  • Fai clic destro sulla parte vuota della barra per Nuova scheda e Riapri la sessione chiusa (Maiusc+Cmd+T), che si ricollega ai server dell'ultima sessione chiusa.
  • Su iPhone, la scheda Connessioni elenca le sessioni attive. Scorri verso sinistra su una per chiuderla.

La riga delle sessioni su iPhone

In fondo a un terminale su iPhone, una riga tiene, da sinistra a destra:

  • la freccia indietro, verso la lista
  • la sessione davanti, con il logo del sistema, il nome e l'indirizzo, nel colore del suo stato. Toccala per l'elenco delle sessioni aperte. La sua x chiude quella sessione.
  • +, una nuova sessione su un server che scegli nella lista
  • il quadrato, con il numero delle sessioni aperte. Il numero prende il colore d'accento quando una sessione dietro ha output nuovo. Tocca il quadrato per vedere tutte le sessioni aperte una accanto all'altra.

Per passare alla sessione successiva o precedente, fai scorrere due dita a sinistra o a destra sul terminale. Tocca il terminale per aprire la tastiera.

Tocca due volte il quadrato per tornare alla sessione di prima.

Tutte le sessioni a colpo d'occhio su iPhone

Il quadrato mostra fino a quattro terminali vivi alla volta; scorri di lato per gli altri. Ognuno dice cosa è successo mentre eri altrove: un pallino per l'output nuovo, una spunta quando un comando è finito, una nota quando la connessione è caduta, un bordo rosso per un server di produzione.

  • Tocca un terminale per portarlo davanti.
  • Tienine premuto uno e trascinalo per cambiare l'ordine delle sessioni.
  • Tienilo premuto senza muoverlo per il suo menu: Duplica, Riconnetti, Sposta in cima, Condividi la sessione e Chiudi sessione.
  • Scorrine uno verso l'alto per chiuderlo.
  • Tocca l'ultimo riquadro, +, per una nuova sessione.
  • Tocca Seleziona, scegli le sessioni, poi Scrivi a tutti. Sopra la tastiera si apre un pannello con quante sessioni lo ricevono e un campo: scrivi un comando e tocca Invia, o Invio sulla tastiera, e parte in tutte. Il campo si svuota per il successivo e i riquadri sopra mostrano i risultati. Tocca un riquadro per escluderlo o includerlo. Fine smette e torna al terminale.

Con la tastiera aperta, la riga sta subito sopra la barra dei tasti. Chiudere l'ultima sessione riporta alla lista.

Il menu della sessione

Su Mac e iPad, il menu ... della scheda di una sessione ha:

  • Riconnetti e Nuova sessione su questo server
  • Mantieni questa sessione: la sessione continua sul server se cade la connessione. Vedi Mantenere attive le sessioni.
  • Dividi affiancati (Cmd+D) e Dividi sopra e sotto (Maiusc+Cmd+D)
  • Cerca (Cmd+F) nel testo del terminale
  • File di questo server, Cronologia dei comandi e Aspetto, che aprono il pannello laterale
  • Condividi la sessione: vedi Condividere una sessione del terminale
  • Altro, in quattro gruppi: Sessione (rinomina, suggerimenti, salva come gruppo di lavoro), Più sessioni (invia a più sessioni, scrivi a tutti, aggiungi un server, disposizione), Registra e condividi (registrazione), Shell (comando precedente e successivo, integrazione della shell, importa la cronologia della shell, Dettagli della connessione)
  • Chiudi sessione (Cmd+W).

Su iPhone, il menu ... in alto a destra nel terminale ha Riconnetti, Mantieni questa sessione, Cerca, Suggerimenti, Condividi la sessione e Altro. File, Cronologia e Aspetto sono nel pannello laterale. + e x nella riga delle sessioni aprono e chiudono le sessioni.

Riquadri divisi e gruppi di lavoro

Su Mac e iPad una scheda può contenere più pannelli. In Altro, Disposizione li sistema: due affiancati, due sovrapposti, quattro in griglia, oppure uno grande e due, con Opzione+Cmd+1 fino a Opzione+Cmd+4. Misure uguali li riporta della stessa misura. Maiusc+Cmd+Invio mette a fuoco un pannello, e Mostra tutti i pannelli riporta gli altri.

  • Salva come gruppo di lavoro tiene i server e la disposizione, per riaprirli insieme da Gruppi di lavoro (Pro). Il menu di un gruppo di lavoro ha Apri, Rinomina ed Elimina.
  • Scrivi a tutti manda quello che scrivi a ogni pannello. Una barra mostra quanti pannelli lo ricevono. Se tra loro ci sono server di produzione, l'app chiede prima.
  • Invia a più sessioni manda una riga alle sessioni che scegli.

Tutte le sessioni affiancate

Su Mac e iPad, il pulsante a griglia a destra della barra delle schede mostra tutte le sessioni aperte affiancate, in una griglia che segue quante sono: due affiancate, tre o quattro su due righe, e così via. Si trova anche nel menu Vista come Affianca tutte le sessioni (Maiusc+Cmd+\). Premilo di nuovo, o scegli Torna alle schede, e le schede tornano come prima. Fai doppio clic sul nome di una sessione per tornare alle schede su quella.

  • Fai clic su una sessione per scrivere solo lì.
  • Scrivi a tutti (Maiusc+Cmd+I) apre sotto le sessioni un pannello con quante lo ricevono e un campo: scrivi un comando e fai clic su Invia, o premi Invio, e parte in tutte. Il campo si svuota per il successivo e le sessioni sopra mostrano i risultati.
  • Con il pannello aperto, fai clic su una sessione per escluderla o includerla. Se tra loro ci sono server di produzione, un comando rischioso chiede prima.
  • Fine, o Esc, chiude il pannello.

Il pannello laterale

Il pannello laterale tiene Server, Comandi salvati, Cronologia, File, Container e Aspetto accanto al terminale. Aprilo con il pulsante del pannello laterale, o con Cmd+. su Mac e iPad.

Su iPhone, tocca il pulsante del pannello laterale in alto a destra, accanto a .... Su iPhone e iPad, quando accanto al terminale non c'è spazio, il pannello entra da destra e copre lo schermo, con un'icona per ogni scheda. Chiudilo con Fine o trascinandolo verso destra. Si riapre sull'ultima scheda usata.

  • Server: CPU, memoria, dischi e rete del server. Vedi Statistiche del server.
  • Comandi salvati: un tocco scrive il comando sulla riga senza eseguirlo, il pulsante play lo esegue. Vedi Comandi salvati.
  • Cronologia: i comandi eseguiti su questo server, da eseguire, copiare o salvare come comando.
  • File: i file di questo server, nella cartella della shell. Vedi File via SFTP.
  • Container: i container Docker o Podman del server. Vedi Container.
  • Aspetto: font, dimensione del testo e tema.

Password e incolla

  • Quando un comando come sudo o su chiede una password, l'app propone Inserisci password salvata se il server ne ha una: un tocco la scrive solo in quella domanda. Altrimenti Inserisci password apre un campo, con Ricordala per le prossime volte per salvarla nel server. Se la password salvata viene rifiutata, l'app propone Aggiorna password.
  • Prima di incollare caratteri nascosti o un comando rischioso, l'app mostra Incollare questo testo? con il testo, e toglie i caratteri nascosti.

Temi e testo

  • Impostazioni, Terminale imposta la dimensione del testo, il tema e il font di ogni terminale. Vedi Impostazioni.
  • Un server o un gruppo può avere un tema suo: Mostra altro, Terminale, Tema.
  • Cmd+Più e Cmd+Meno cambiano la dimensione del testo. Su iPhone e iPad, pizzica.

Suggerimenti mentre scrivi

Mentre scrivi compaiono suggerimenti dalla tua cronologia, dai comandi salvati e dalle cartelle, dai comandi e dalle opzioni del server: sopra i tasti su iPhone e iPad, sotto il cursore su Mac. I più probabili vengono prima, in base a cosa esegui su questo server, in questa cartella e di recente. Un tocco, o la freccia destra, aggiunge il suggerimento alla riga. Invio lo premi tu.

Con Prevedi il prossimo comando, il prompt vuoto propone quello che di solito esegui dopo. Per esempio, dopo

cd /var/www/app

propone git pull, e dopo git pull propone npm run build. Impara dai comandi che esegui su questo dispositivo, e quello che impara resta lì.

  • Su iPhone e iPad i suggerimenti tengono il loro posto sopra i tasti, così il terminale resta fermo.
  • Per spegnerli in una sola sessione, scegli Suggerimenti nel menu della sessione, oppure tieni premuto sui suggerimenti e scegli Nascondi in questa sessione. Su Mac, clic destro sulla lista.
  • Impostazioni, Terminale: Suggerimenti mentre scrivi li spegne ovunque, Prevedi il prossimo comando spegne i suggerimenti al prompt vuoto e l'apprendimento. In Mostra altro, Dimentica le abitudini imparate riparte da zero e tiene la cronologia dei comandi.

Integrazione della shell

Con l'integrazione della shell, l'app sa dove inizia e finisce ogni comando. Un segno accanto a ogni prompt mostra se il comando è riuscito, con il codice di uscita e quanto ha impiegato, e puoi saltare da un comando all'altro (Cmd+Su e Cmd+Giù) o copiare l'output di un solo comando.

  1. Nel menu della sessione scegli Altro, poi Integrazione della shell.
  2. L'app mostra le righe che aggiungerebbe per bash, zsh o fish, e il file in cui vanno.
  3. Scegli Aggiungi. Prima l'app tiene una copia del file. Rimuovi toglie di nuovo le righe.
  4. Apri una nuova sessione per usarla.

Scorciatoie su Mac

  • Cmd+K: Trova qualsiasi cosa, server, comandi e posti
  • Cmd+J: chiedi un comando, vedi Chiedi
  • Cmd+N: nuovo server; Cmd+L: nuovo terminale locale
  • Cmd+Y: cronologia dei comandi, nel menu Sessione; Cmd+.: pannello laterale
  • Da Opzione+Cmd+1 a Opzione+Cmd+4: disposizioni dei pannelli
  • Maiusc+Cmd+\: tutte le sessioni affiancate; Maiusc+Cmd+I: Scrivi a tutti
  • Maiusc+Cmd+] e Maiusc+Cmd+[: sessione successiva e precedente
  • Maiusc+Cmd+T: riapri la sessione chiusa
  • Maiusc+Cmd+L: blocca l'app.