Apa hubungan antara ~ foo ~ dan = foo = dalam mode-org?

11

Keduanya =foo=dan ~foo~tampaknya digunakan dalam org untuk bit kode inline. Bagaimana mereka berbeda? Mana yang harus saya gunakan, dan kapan?

Misalnya, dari ORG-NEWSfile:

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

Tidak ada pola yang jelas di sini: org-export-exclude-tagsdan org-odd-levels-onlykeduanya variabel, dan org-next-visible-headingdan outline-modekeduanya fungsi.

Apakah salah satu dari sintaksis ini mendukung lompatan ke *Help*buffer seperti `foo'dalam dokumen?

org-mode Wilfred Hughes
sumber
Saya memiliki pertanyaan yang sama selama bertahun-tahun. Saya akhirnya tidak pernah menggunakan ~ .. ~, dan sebagai gantinya menggunakan = .. = untuk semua kata demi kata, termasuk potongan kode inline.
Kaushal Modi
1
Lihatlah stackoverflow.com/questions/18991981/… untuk perbedaan saat mengekspor
CantrianBear

Jawaban:

6

Dari halaman info Org di "Penekanan dan monospace" yang kita miliki

`=verbatim=' and `~code~'

Dalam contoh Anda fungsi dan variabel adalah potongan-potongan kode elisp, jadi ~...~tepat. Penggunaan =...=Anda mengutip adalah untuk urutan kunci dan teks bagi pengguna untuk ditempatkan di orgbuffer, yaitu markup daripada kode. Namun, markup =outline-mode=adalah batas antara dua kategori.

Andrew Swann
sumber
3

Ini cocok untuk interpretasi. Saya telah mendefinisikan ulang misalnya ~C-f~untuk mengekspor ke <kbd>C-f</kbd>dalam HTML, dan misalnya =forward-char=ke <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>")))

Tetapi nama standar mereka memang codedan verbatim, seperti jawaban yang lain katakan.

abo-abo
sumber