Skip to content

Agave è un software open-source composto da una serie di strumenti interconnessi che cooperano tra loro per la generazione di un sito statico

License

Notifications You must be signed in to change notification settings

italia/agavecms

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Introduzione

Agave è un software open-source composto da una serie di strumenti interconnessi che cooperano tra loro per la generazione di un sito statico.

Lo scopo è fornire una soluzione avanzata che permetta di realizzare e mantenere un sito statico, mettendo a disposizione gli automatismi per publicare contenuti ed estendere le sezioni del sito tramite un'interfaccia usabile e immediata.

Agave è composto dai seguenti blocchi logici:

  • Un'area amministrativa (CMS);
  • Un sito web statico (Jekyll) contenente un template Jekyll ;
  • Un'ambiente di produzione per la generazione e la pubblicazione del sito e della parte di amministrazione (ambiente Docker).

Ambiente di produzione

L'ambiente di produzione, è una configurazione Docker-Compose di una macchina virtuale. Questo ambiente permette di ospitare l'area amministrativa (CMS), e di generare e pubblicare il sito statico.

Area amministrativa (CMS)

L'area amministrativa è di fatto un CMS (content management system) realizzato tramite un'applicazione web e studiato per permettere la creazione e generazione di modelli di dati e rispettivi contenuti che verranno poi utilizzati dallo staticizzatore per compilare il sito statico.

L'area amministrativa è una applicazione realizzata tramite un Frontend in React ed un Backend Rails, e utilizza Postgres come database relazionale.

Sito statico

Il sito statico è un template Jekyll contenuto in un repository publico git. L'ambiente di produzione contine gli strumenti e gli script necessari alla generazione del sito statico a partire dai file del template contenuti nel repository git e dai dati fruiti dal CMS.

Un template Jekyll di esempio è disponibile su questo repository.

Utilizzo

Una volta configurato il sistema saranno presenti due url una relativa all'interfaccia di amministrazione e una relativa al sito statico.

Dall'area amministrativa sarà possibile creare modelli di dati, caricare media e popolare i contenuti Inoltre permetterà di pubblicare i contenuti e avviare il processo di build del sito statico.

L'area amministrativa di default ha un utente admin per dare la possibilità di creare utenze e configurare le impostazioni generali del sito. Prevede diversi profili utente per la gestione delle varie sezioni. Vedi la guida area amministrativa per tutte le info riguardante l'accesso per l'utente amministratore. Per la gestione dei contenuti invece consultare la guida relativa al CMS

Il sito statico è un template Jekyll popolato al momento del build con i contenuti creati sull'area amministrativa. Esiste un template di esempio su questo repository .

Documentazione e Configurazione

Agave admin di esempio

E' possibile vedere in anteprima la demo dell'area admin di Agave al seguente indirizzo.

Bug noti

  • I modelli contenuti in un campo modulare devono essere impostati senza lingua. Impostare come multilingua solo il contenuto modulare.

Credits

Progetto sviluppato e mantenuto da Cantiere Creativo per conto di Developers Italia

License

The gem is available as open source under the terms of the GNU Affero General Public License version 3.

About

Agave è un software open-source composto da una serie di strumenti interconnessi che cooperano tra loro per la generazione di un sito statico

Resources

License

Code of conduct

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published