Jaki jest związek między ~ foo ~ i = foo = w trybie org?

11

Oba =foo=i ~foo~wydają się być używane w org do wbudowanych bitów kodu. Czym się różnią? Którego należy użyć i kiedy?

Na przykład z ORG-NEWSpliku:

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

Nie ma tu oczywisty wzór: org-export-exclude-tagsi org-odd-levels-onlyto zarówno zmienne, a org-next-visible-headingi outline-modesą obie funkcje.

Czy którakolwiek z tych składni obsługuje przeskakiwanie do *Help*buforów, tak `foo'jak w przypadku dokumentów?

org-mode Wilfred Hughes
źródło
Mam takie samo pytanie od wielu lat. Skończyło się na tym, że nigdy nie używałem ~ .. ~, a zamiast tego = .. = używałem wszystkiego dosłownie, w tym fragmentów kodu wbudowanego.
Kaushal Modi
1
Spójrz na stackoverflow.com/questions/18991981/…, aby zobaczyć różnicę podczas eksportu
CantrianBear,

Odpowiedzi:

6

Ze strony informacyjnej organizacji na temat „Nacisk i monospace” mamy

`=verbatim=' and `~code~'

W twoich przykładach funkcje i zmienne są fragmentami kodu elisp, więc ~...~jest to właściwe. Korzysta z =...=was cytować są dla kluczowych sekwencji i tekstu dla użytkownika miejscu w orgbuforze, czyli znaczników zamiast kodu. Jednak znaczniki =outline-mode=są granicą między dwiema kategoriami.

Andrew Swann
źródło
3

Nadaje się do interpretacji. Byłem redefinicji np ~C-f~eksportu do <kbd>C-f</kbd>HTML, a np =forward-char=do <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>")))

Ale ich domyślne nazwy są rzeczywiście codei verbatim, jak mówi druga odpowiedź.

abo-abo
źródło