Org-режим: під час експорту виключайте конкретні заголовки з TOC

Питання: Як я можу org-modeзапропонувати виключити конкретні заголовки зі змісту під час експорту?

Наприклад, експорт

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

до HTML виробляє

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

але я хочу, щоб це виробило

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

У розділі Змістorg-mode посібника немає жодної інформації щодо цього.

Також я знаю, що не можу org-modeекспортувати заголовки, встановивши COMMENTключове слово через C-c ;( org-toggle-comment) або позначивши їх :noexport:. Хоча це не дозволяє відображати заголовки заголовків у TOC, це також спричиняє відсутність їх вмісту з отриманого документа, а це не те, що я хочу.

Org використовує org-export-collect-headlinesдля збору заголовків, які мають бути в TOC. Ця функція вже включає два критерії виключення заголовків: глибина заголовка та чи є "розділом виноски" (*), тому легко додати ще один.

Дивіться модифіковану версію org-export-collect-headlinesнижче. Ця версія дозволяє запобігти появі заголовка в TOC, встановивши NOTOCвластивість.

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

(*) Я не знаю, що таке "розділи виносок".

Це працює для експортних програм, які створюють TOC вручну. Програми LaTeX, Beamer і Texinfo не відповідають.

Додавши цю пораду до org-export-numbered-headline-pодного, можна зробити заголовки з UNNUMBEREDекспортом власності як \section*{...}, виключаючи їх з TOC при експорті до LaTeX та Beamer:

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

Зауважте, що станом на 10.10.2014 20:06:34 (GMT) чек UNNUMBERED вже вбудований