Org-mode: ไม่รวมหัวข้อเฉพาะจาก 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-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)))))

โปรดทราบว่าตั้งแต่วันที่ 2014-10-03 20:06:34 (GMT) การตรวจสอบของ UNNUMBERED นั้นมีอยู่แล้วภายใน