Passa al contenuto principale

Docusaurus.config.js

Descrizione​

Il file docusaurus.config.js è il file di configurazione principale di Docusaurus. Controlla le impostazioni globali del sito, il tema, i plugin e la struttura della navigazione.

Modifiche Possibili​

Configurazioni Base​

Per modificare le informazioni base del sito:

const config = {
  title: 'Titolo del Sito',        // Titolo principale
  tagline: 'Descrizione del sito', // Sottotitolo
  favicon: 'img/favicon.ico',      // Icona del sito
  url: 'https://tuo-dominio.com',  // URL base
  baseUrl: '/',                    // Path base del sito
}

Configurazione Lingua​

Per gestire le lingue disponibili:

i18n: {
  defaultLocale: 'it',       // Lingua predefinita
  locales: ['it', 'en'],     // Lingue disponibili
}

Personalizzazione Navbar​

Per modificare la barra di navigazione:

navbar: {
  hideOnScroll: true,        // Nascondi durante lo scroll
  title: 'Titolo Navbar',    // Titolo nella navbar
  logo: {
    alt: 'Logo Alt Text',
    src: 'img/logo.png',     // Percorso del logo
  },
  items: [
    {
      type: 'docSidebar',    // Tipo di elemento
      sidebarId: 'idSidebar',// ID della sidebar
      position: 'left',      // Posizione (left/right)
      label: 'Etichetta',    // Testo visualizzato
    }
  ]
}

Aggiungere Plugin​

Per aggiungere funzionalità:

plugins: [
  [
    'nome-plugin',
    {
      // Configurazione del plugin
      opzione1: valore1,
      opzione2: valore2
    }
  ]
]

Personalizzare il Tema​

Per modificare il tema:

themeConfig: {
  // Colori, stili e altre opzioni del tema
  colorMode: {
    defaultMode: 'light',
    respectPrefersColorScheme: true
  }
}

Aggiungere Script​

Per includere script esterni:

scripts: [
  {
    src: '/percorso/script.js',
    async: true,             // Caricamento asincrono
  }
]

Configurare i Preset​

Per configurare i preset di Docusaurus:

presets: [
  [
    'classic',
    {
      docs: {
        sidebarPath: './sidebars.js',    // Percorso sidebar
        // Altre opzioni per i documenti
      },
      theme: {
        customCss: './src/css/custom.css' // CSS personalizzato
      }
    }
  ]
]