Personalizzazione della Sfinge per evitare di generare la casella di ricerca

Question

C'è un modo semplice (cioè, senza creare un tema completamente nuovo) per personalizzare Sphinx in modo che generi pagine HTML senza la casella di ricerca?

Answer 1

Puoi farlo personalizzando (o dovrei dire disabilitando) il modello della casella di ricerca.

1. In conf.py, aggiungere questa riga:

   templates_path = ["templates"] 
   

2. Creare una cartella denominata templates nella directory del progetto Sfinge.

3. In tale cartella, aggiungere un file vuoto denominato searchbox.html. Questo sovrascrive il file di modello predefinito (che si trova in sphinx/themes/basic dove è installato Sphinx).

Answer 2

Un'alternativa, che ho scoperto leggendo il alabaster theme documentation è quello di elencare in modo esplicito che (se eventuali barre laterali) si desiderano nel file conf.py. Ad esempio, tra questo frammento in conf.py:

html_theme = 'alabaster' 
html_sidebars = { 
    '**': [ 
     'about.html', 
     'navigation.html', 
     'searchbox.html', 
    ] 
} 

produce la searchbox; rimuovendo searchbox.html da quella lista e poi la costruzione produce la stessa pagina ma senza la scatola. (Maggiori informazioni possono essere trovate a the Sphinx documentation for the build-configuration file.)