Panoramica
La CLI di Riseact serve a creare, sviluppare e pubblicare applicazioni e temi per Riseact:
- crea una nuova applicazione da un template;
- la fa girare in locale con un URL pubblico HTTPS, tramite un tunnel di sviluppo verso Riseact;
- crea, sviluppa e pubblica temi.
Requisiti
- Git
- Node.js
- l'ultima versione di Chrome o Firefox
- un account Partner: se non lo hai, segui questa guida
Come iniziare
Scarica la CLI per il tuo sistema operativo da questa pagina, estrai l'archivio e apri un terminale nella cartella.
Accedi con le credenziali del tuo account Partner:
$ riseact auth loginPoi registra un'applicazione su Riseact. Per cominciare crea un'applicazione privata su un'organizzazione di sviluppo, così puoi provarla senza pubblicarla.
Inizializza il progetto seguendo le istruzioni a schermo:
$ riseact app initIl comando crea una cartella con il nome dell'applicazione e i file per iniziare. Entra nella cartella e avvia il server di sviluppo:
$ riseact app devLa CLI avvia il server locale, apre il tunnel e stampa l'URL pubblico dell'applicazione:
App url: https://d3f2c1a9b8e7d6c5b4a3f2e1d0.tun.riseact.orgL'URL resta lo stesso a ogni avvio e la CLI lo aggiorna da sé su Riseact. Al primo avvio di una nuova applicazione attende qualche secondo per preparare il certificato HTTPS.
Ora entra nella tua organizzazione di sviluppo e apri le applicazioni private: da lì attivi l'applicazione e la provi.
Comandi
| Comando | Cosa fa |
|---|---|
riseact auth login | Autentica la CLI con il tuo account Partner |
riseact auth logout | Rimuove le credenziali salvate |
riseact app init | Crea un nuovo progetto da un template |
riseact app dev | Avvia il server di sviluppo e il tunnel |
riseact theme init | Crea un nuovo tema partendo da un tema di esempio |
riseact theme dev | Sincronizza la cartella con un tema su un'organizzazione, nei due sensi |
riseact theme pull | Scarica i file di una versione pubblicata di un tuo tema |
riseact theme release | Pubblica il tema come nuova versione installabile |
riseact theme package | Crea uno zip del tema da caricare su Riseact |
riseact config | Mostra la configurazione della CLI |
--help mostra le opzioni di ogni comando. Il flag globale -w, --working-dir esegue il comando su un'altra cartella.
Opzioni di riseact app dev
| Opzione | Cosa fa |
|---|---|
-c, --command | Comando con cui avviare il server di sviluppo, al posto di npm run dev |
-p, --port | Fissa la porta del proxy locale; senza, ne viene scelta una libera a ogni avvio |
Vedi La porta locale per quando serve fissarla.
Editor per il changelog
riseact theme release apre un editor per il changelog, come git commit. L'editor viene scelto in questo ordine:
$VISUAL$EDITOR- la chiave
editornel file di configurazione git config core.editor- il primo installato fra
nano,vievim
Per impostarlo in ~/.config/riseact.yml:
editor: code --waitIl valore può contenere argomenti. Gli editor grafici richiedono l'opzione che attende la chiusura del file (code --wait, subl -w), altrimenti il changelog risulta vuoto.
riseact config mostra l'editor in uso.
Fermare il server
Ctrl+C chiude server di sviluppo e tunnel. Puoi riavviare subito.
Fonte: https://dev.riseact.org/docs/cli/overview. Copia automatica da dev.riseact.org: non modificare qui, le modifiche vanno fatte sulla documentazione Docusaurus.