2014-07-01 14 views
12

Ho ricevuto avvisi nella documentazione della varietà "Livello di titolo incoerente". Per quanto posso dire, ho una struttura coerente che sembra qualcosa di simile:Che cosa significa "Livello di titolo incoerente"?

Big Title 
========= 

Section 
------- 

Subsection 
~~~~~~~~~~ 

ma l'errore è associato generato automaticamente (automodapi) testo che non riesco a rintracciare:

Classes 
^^^^^^^ 

Come posso capire da dove viene la "inconsistenza"?

risposta

15

A quanto pare la risposta era ovvia: http://sphinx-doc.org/rest.html#sections

# with overline, for parts 
* with overline, for chapters 
=, for sections 
-, for subsections 
^, for subsubsections 
", for paragraphs 

avevo usato ==== come la mia intestazione di livello superiore perché è quello che riv.vim fa, ma #### e **** sono al di sopra di loro. ~~~~~ a quanto pare non è nemmeno ufficiale.

Non riesco ancora a capire il problema, dal momento che stavo usando sopra le posizioni che stavano usando nominalmente ^^^^, che dovrebbe andare bene, ma sbattere tutti i titoli di un livello ha risolto il mio problema particolare.

0

Ho ricevuto lo stesso errore segnalato. A me sembra che sia stato causato mixando^e ~ per le sottosezioni. Sostituendo l'uno per l'altro nell'intero documento, l'errore è scomparso.