Chế độ Org: Loại trừ các tiêu đề cụ thể khỏi TOC khi xuất

H: Làm thế nào tôi có thể nói org-modeđể loại trừ các tiêu đề cụ thể khỏi mục lục khi xuất khẩu?

Ví dụ: xuất

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

để HTML sản xuất

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

nhưng tôi muốn nó sản xuất

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

Các Mục lục phần của org-modethủ công không có bất kỳ thông tin về vấn đề này.

Ngoài ra, tôi biết rằng tôi có thể tránh org-modexuất các tiêu đề bằng cách đặt COMMENTtừ khóa thông qua C-c ;( org-toggle-comment) hoặc bằng cách gắn thẻ chúng với :noexport:. Mặc dù điều này không khiến các tiêu đề bị ảnh hưởng hiển thị trong TOC, nhưng điều đó cũng khiến nội dung của chúng bị bỏ qua khỏi tài liệu kết quả, đây không phải là điều tôi muốn.

Org sử dụng org-export-collect-headlinesđể thu thập các tiêu đề nên có trong TOC. Hàm này đã bao gồm hai tiêu chí để loại trừ các tiêu đề: độ sâu của tiêu đề và liệu đó có phải là "phần chú thích" (*) hay không, vì vậy thật dễ dàng để thêm một tiêu đề khác.

Xem phiên bản sửa đổi org-export-collect-headlinesdưới đây. Phiên bản này cho phép ngăn tiêu đề hiển thị trong TOC bằng cách đặt thuộc NOTOCtính.

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

(*) Tuy nhiên, tôi không biết "phần chú thích" là gì.

Điều này hoạt động để xuất phụ trợ xây dựng TOC bằng tay. Các phụ trợ LaTeX, Beamer và Texinfo không.

Bằng cách thêm lời khuyên này vào org-export-numbered-headline-pmột người có thể tạo tiêu đề với UNNUMBEREDxuất bất động sản \section*{...}, loại trừ chúng khỏi TOC khi xuất sang LaTeX và Beamer:

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

Lưu ý rằng kể từ 2014-10-03 20:06:34 (GMT) kiểm tra UNNUMBERED đã được tích hợp sẵn