Який зв’язок між ~ foo ~ і = foo = в org-режимі?

11

І те, =foo=і ~foo~здається, використовується в org для вбудованих бітів коду. Чим вони відрізняються? Що я повинен використовувати, і коли?

Наприклад, з ORG-NEWSфайлу:

If you want to exclude a headline from export while using its contents
for setting options, use =:noexport:= (see =org-export-exclude-tags=.)

...

The key sequences =C-c C-n= and =C-c C-p= are now bound to
~org-next-visible-heading~ and ~org-previous-visible-heading~ respectively,
rather than the =outline-mode= versions of these functions.  The Org
version of these functions skips over inline tasks (and even-level
headlines when ~org-odd-levels-only~ is set).

Існує не очевидний зразок тут: org-export-exclude-tagsі org-odd-levels-onlyє змінними, а також org-next-visible-headingі outline-modeє обидві функції.

Чи підтримує будь-який із цих синтаксисів перехід до *Help*буферів, як `foo'це робиться в docstrings?

org-mode

— Вільфред Х'юз
джерело

У мене було те саме питання вже багато років. Я в кінцевому підсумку ніколи не використовував ~ .. ~, а натомість використовував = .. = для всього дослівно, включаючи фрагменти вбудованого коду.

— Каушал Моді

1

Подивіться на stackoverflow.com/questions/18991981/… на різницю при експорті

— CantrianBear

6

З інформаційної сторінки Org у розділі "Наголос та монопростір" у нас є

`=verbatim=' and `~code~'

У ваших прикладах функції та змінні є частинами коду elisp, тому ~...~це доцільно. Використання, яке =...=ви цитуєте, призначене для ключових послідовностей та тексту, які користувач повинен розмістити в orgбуфері, тобто розмітка, а не код. Однак розмітка розміру =outline-mode=є граничною між двома категоріями.

— Ендрю Сванн
джерело

3

Це підходить для інтерпретації. Я переробляв, наприклад, ~C-f~для експорту <kbd>C-f</kbd>в HTML, і, наприклад, =forward-char=до <code>forward-char</code>.

(setq org-html-text-markup-alist
      '((bold . "<b>%s</b>")
        (code . "<kbd>%s</kbd>")
        (italic . "<i>%s</i>")
        (strike-through . "<del>%s</del>")
        (underline . "<span class=\"underline\">%s</span>")
        (verbatim . "<code>%s</code>")))

Але їхні за замовчуванням імена є насправді codeі verbatim, як говорить інша відповідь.

— або-або
джерело