Mode Org: exclure des titres spécifiques de la table des matières lors de l'exportation

Q: Comment puis-je dire org-moded'exclure des titres spécifiques de la table des matières lors de l'exportation?

Par exemple, exporter

* Headline 1: Put me in TOC
* Headline 2: Put me in TOC
* Headline 3: DO NOT put me in TOC

au HTML produit

...
<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>
...

mais je veux qu'il produise

...
<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 section Table des matières du org-modemanuel ne contient aucune information à ce sujet.

De plus, je sais que je peux éviter org-moded'exporter les titres en définissant le COMMENTmot - clé via C-c ;( org-toggle-comment) ou en les marquant avec :noexport:. Bien que cela empêche les titres concernés d'apparaître dans la table des matières, cela entraîne également l'omission de leur contenu dans le document résultant, ce qui n'est pas ce que je veux.

Org utilise org-export-collect-headlinespour collecter les titres qui devraient figurer dans la table des matières. Cette fonction inclut déjà deux critères pour exclure les titres: la profondeur du titre et s'il s'agit d'une "section de note de bas de page" (*), il est donc facile d'en ajouter une autre.

Voir la version modifiée de org-export-collect-headlinesci - dessous. Cette version permet d'empêcher un titre de s'afficher dans la table des matières en définissant la NOTOCpropriété.

* Section 1: shows up in the TOC

* Section 2: modified Org code (not in the TOC)
  :PROPERTIES:
  :NOTOC:    t
  :END:

  This is the modified =org-export-collect-headlines=:

  #+BEGIN_SRC elisp
  (defun org-export-collect-headlines (info &optional n)
    "Collect headlines in order to build a table of contents. [...]

  Return a list of all exportable headlines as parsed elements.
  Footnote sections, if any, will be ignored."
    (let ((limit (plist-get info :headline-levels)))
      (setq n (if (wholenump n) (min n limit) limit))
      (org-element-map (plist-get info :parse-tree) 'headline
        #'(lambda (headline)
            (unless (or (org-element-property :NOTOC headline)               ; new condition
                        (org-element-property :footnote-section-p headline)) ; old condition
              (let ((level (org-export-get-relative-level headline info)))
                (and (<= level n) headline))))
        info)))
  #+END_SRC

** Sub-section
   This shows up in the TOC: property inheritance is off by default.

(*) Je ne sais pas ce que sont les "sections de notes de bas de page".

Cela fonctionne pour les backends d'exportation qui génèrent la table des matières manuellement. Les backends LaTeX, Beamer et Texinfo ne le font pas.

En ajoutant ces conseils à org-export-numbered-headline-pun, vous pouvez faire les gros titres avec l' UNNUMBEREDexportation de propriété en les \section*{...}excluant de la table des matières lors de l'exportation vers LaTeX et Beamer:

(advice-add 'org-export-numbered-headline-p :around
            (lambda (orig headline info)
              (and (funcall orig headline info)
                   (not (org-element-property :UNNUMBERED headline)))))

Notez que depuis le 2014-10-03 20:06:34 (GMT), la vérification de UNNUMBERED est déjà intégrée