P: ¿Cómo puedo decir org-mode
que excluya titulares específicos de la tabla de contenido al exportar?
Por ejemplo, exportando
* Headline 1: Put me in TOC
* Headline 2: Put me in TOC
* Headline 3: DO NOT put me in TOC
a HTML produce
...
<div id="text-table-of-contents">
<ul>
<li><a href="#sec-1">1. Headline 1: Put me in TOC</a></li>
<li><a href="#sec-2">2. Headline 2: Put me in TOC</a></li>
<li><a href="#sec-3">3. Headline 3: DO NOT put me in TOC</a></li>
</ul>
</div>
...
pero quiero que produzca
...
<div id="text-table-of-contents">
<ul>
<li><a href="#sec-1">1. Headline 1: Put me in TOC</a></li>
<li><a href="#sec-2">2. Headline 2: Put me in TOC</a></li>
</ul>
</div>
...
La sección Tabla de contenido del org-mode
manual no tiene ninguna información al respecto.
Además, sé que puedo evitar org-mode
exportar titulares configurando la COMMENT
palabra clave a través de C-c ;( org-toggle-comment
) o etiquetándolas con :noexport:
. Si bien esto evita que los titulares afectados aparezcan en la tabla de contenido, también hace que su contenido se omita del documento resultante, que no es lo que quiero.
org-mode
org-export
itsjeyd
fuente
fuente
EXPORT_OPTIONS: toc:nil
casi hace lo que quiere, pero solo cuando exporta solo el subárbol. Para aclarar, ¿desea que la sección siga numerada o desea algo similar a LaTeX\section*
?Respuestas:
Org utiliza
org-export-collect-headlines
para recopilar titulares que deberían estar en la tabla de contenido. Esta función ya incluye dos criterios para excluir títulos: la profundidad del título y si es una "sección de nota al pie" (*), por lo que es fácil agregar otra.Vea la versión modificada de
org-export-collect-headlines
abajo. Esta versión permite evitar que aparezca un título en la tabla de contenido al establecer laNOTOC
propiedad.(*) Sin embargo, no sé qué son las "secciones de notas al pie".
Esto funciona para los backends de exportación que crean el TOC manualmente. Los backends de LaTeX, Beamer y Texinfo no lo hacen.
Al agregar este consejo a
org-export-numbered-headline-p
uno, puede aparecer titulares con laUNNUMBERED
exportación de propiedades como\section*{...}
, excluyéndolos de TOC al exportar a LaTeX y Beamer:Tenga en cuenta que a partir del 2014-10-03 20:06:34 (GMT) la verificación de UNNUMBERED ya está integrada
fuente
.html
y los.tex
archivos que seorg-mode
producen al exportar, el problema principal parece ser queorg-mode
construye el TOC manualmente para HTML, pero simplemente descarga un genérico\tableofcontents
en el.tex
archivo.org-mode
el código de exportación requeriría grandes cambiosorg-latex-headline
. En cuanto a la implementación de esto en el Texinfo respaldado, incluso no sé por dónde empezar.org-export-numbered-headline-p
para obtener este comportamiento casi automáticamente, si convertirlo en una sección sin numerar es una opción, es decir. Puedo dar más detalles si te interesa.