Как сделать встроенные комментарии в Org-режиме?

В Org-режиме есть несколько способов сделать комментарии. Но я не знаю, как сделать встроенные комментарии. Согласно руководству

области, окруженные '# + BEGIN_COMMENT...' # + END_COMMENT, не будут экспортироваться.

Но это верно только в том случае, если указанная область запускает линию.

В следующем

#+TITLE: Test

text #+BEGIN_COMMENT comment 1 #+END_COMMENT text

text
#+BEGIN_COMMENT comment 2 #+END_COMMENT text

только комментарий 2 рассматривается как комментарий. Он экспортирует (например, C-e A) как

текст # + BEGIN_COMMENT комментарий 1 # + текст END_COMMENT

текст

Кроме того, org-toggle-comment не работает для создания встроенных комментариев, используя его в регионах, а comment-region даже не создает комментарий.

Итак, как я могу сделать встроенные комментарии в Org-режиме?

Ответ 1

Комментарии Jonathan Leech-Pepin на ваш вопрос на \printbibliography дал мне представление. Вы можете использовать макрос для встроенных комментариев. Обратите внимание, что после определения комментария вам нужно оставить пробел.

#+macro: comment  

...

{{{comment(here is a comment)}}}

EDIT: поскольку предполагается, что макрос нечетный вход может повредить. Я немного удивлен, что

{{{comment(here is a)}} comment)}}}

работает для меня, хотя

{{{comment(here is a comment) more}}}

нет. Я бы предположил, что ничего, кроме довольно простого текста, будет довольно хрупким, если они решат изменить способ обработки макросов в будущем.

Ответ 2

Другим способом будет использование фрагментов экспорта (определенных в Синтаксис (проект), поиск "Экспорт фрагментов" ), например

This is the @@comment:This is an inline [email protected]@ original text.

Я использовал слово comment, где бэкэнд экспорта должен быть просто для ясности, вы можете использовать любое другое слово (помимо бэкэнда, который вы экспортируете).