Как сделать встроенные комментарии в 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
, где бэкэнд экспорта должен быть просто для ясности, вы можете использовать любое другое слово (помимо бэкэнда, который вы экспортируете).