Usando Sfinge, come posso rimuovere il titolo che appare nella tabella di contesto della barra laterale? - python-sfinge, toc

Dì il mio some.rst il file assomiglia a questo:

============
My Title
============

1. Section
================

2. Section
=================

Dopo la compilazione, nel risultante some.html ci sarà un sommario nella barra laterale che appare come:

Il mio titolo

1. Sezione
2. Sezione

C'è un modo semplice per rimuovere "Il mio titolo" dal sommario in some.html?

risposte:

Il modo più semplice è utilizzare un tipo di oggetto che viene ignorato dalla direttiva TOC:

.. rubric:: My Title

Questo crea un testo che assomiglia un po 'a un'intestazione, ma è escluso dal sommario. Puoi aggiornare il tuo file CSS con qualsiasi stile tu voglia per .rubric classe, anche imitando lo stile h1 se ti piace.

Vedi "Titoli non TOC all'interno di una pagina Ristrutturato"per come definire le classi in stile rubrica.

Se stai cercando di rimuoverlo da tutti i tuoi documenti, prova personalizzazione del modello predefinito. Altrimenti dovrai modificare il file Costruttore HTML creando una sottoclasse.

Molto tardi a questa festa, lo so. Ho appena avuto questo problema, necessario per imitare h2 e non ero in grado di modificare il foglio di stile.

La mia soluzione ha finito per aggiungere html raw nel some.rst:

:raw-html:`<h1>My Title</h1>`

1. Section
================

2. Section
=================

Sono stato in grado di risolvere questo utilizzando il .. raw:: html metodo come descritto sopra, con una leggera modifica (che evitava di interrompere il TOC generato automaticamente). come descritto in precedenza, se il tuo file contiene solo .. raw:: html titoli, romperà la TOC generata automaticamente dalla Sfinge. tuttavia, se si utilizza .. raw:: html e aggiungi --------------------- sotto di esso, ha vinto "t show sul nav di sinistra, e vinto" t rompere il TOC. per esempio.

così alla fine ho capito per caso come ottenere che le intestazioni non vengano visualizzate nella TOC di sinistra. se il tuo file contiene solo .. raw:: html intestazioni h2, si romperà la TOC generata automaticamente dalla sfinge (come menzionato nell'articolo Stackoverflow). tuttavia, se si utilizza .. raw:: html e --------------------- sotto di esso, ha vinto "t show sul nav di sinistra, e won" t break the TOC: star2: per esempio.

.. raw:: html

<h2>What Can I Do With KSQL?</h2>

---------------------