Ao editar arquivos organizacionais, acho extremamente conveniente como você pode ocultar e exibir manchetes e seu conteúdo apenas pressionando TABa manchete.

Por exemplo, considere o seguinte buffer

* Headline 1
Some text here.

* Headline 2
Some more text here.

Se eu colocar o ponto no primeiro *e pressionar TAB, obterá o seguinte:

* Headline 1...
* Headline 2
Some more text here.

Existe uma maneira de conseguir isso com as seções do LaTeX?
ou seja, como posso ocultar e exibir o conteúdo de uma seção / capítulo / etc do LaTeX, mantendo o título visível? Estou usando o AucTeX no modo LaTeX, mas não encontrei nada que pareça desempenhar esse papel.

Nota: grande parte deste texto veio de uma resposta a uma pergunta que acabou sendo uma duplicata dessa pergunta . Parte do material é suficientemente diferente que parecia valer a pena adicioná-lo a essa pergunta.

O modo de estrutura de tópicos e as instalações dobráveis do AUCTeX são duas bestas diferentes que devem fazer amplamente a mesma coisa: ocultar e mostrar partes selecionadas do buffer.

outline-minor-mode

Um elemento-chave para reconhecer quando se usa outline-minor-modeé que ele tem uma tecla de prefixo diferente outline-mode(ou seja, o modo maior ) -, precisamente para evitar conflitos de chave com chaves de movimento, etc, que padrões de prefixo para o estranho-a-tipo C-c @(embora você pode mude isso personalizando outline-minor-mode-prefix). Todas as combinações de teclas listadas neste nó do manual ainda devem funcionar, mas com o toque que você substitui o prefixo do modo principalC-c com o prefixo do modo menor de C-c @. Portanto, C-c @ C-ccorre hide-entry, C-c @ C-ecorre show-entrye assim por diante.

Para usar esses recursos, você precisa habilitar outline-minor-mode. A maneira mais simples é com um gancho de modo:

(add-hook 'LaTeX-mode-hook #'outline-minor-mode)

mudando outline-minor-mode-prefix

Ele deve ser uma coisa simples de mudança outline-minor-mode-prefix(que costumava ser de volta ao dia). Mas isso não. Que divertido!

A docstring agora fornece uma nota enigmática de que:

Tecla de prefixo a ser usada nos comandos Estrutura de tópicos no modo secundário Estrutura de tópicos. O valor dessa variável é verificado como parte do carregamento do modo Esboço. Depois disso, alterar a chave de prefixo requer manipulação de mapas de teclas.

Sim, muito útil. Curiosamente, nem mesmo customizedefine essa variável a tempo de evitar "manipular mapas de teclas" (apesar de ser definida defcustomno código-fonte). A solução prática: defina essa variável no seu arquivo init antes de carregar outlineou qualquer outra coisa criada a partir dele (por exemplo, org-mode).

Você pode, por exemplo, querer que o prefixo seja C-o(o que significa que você está perdendo open-line, mas pode religá-lo, se realmente quiser). Colocar o seguinte no início do arquivo init fará o truque:

(global-unset-key "\C-o")
(setq outline-minor-mode-prefix "\C-o")

Agora, você deve conseguir acessar toda a funcionalidade do modo de estrutura de tópicos usando o C-oprefixo - C-o C-cpara ligar hide-entry, C-o C-eligar show-entrye assim por diante.

adicionando novos títulos de estrutura de tópicos

Como um bônus adicional, você também pode personalizar quais cabeçalhos de estrutura de tópicos podem ser dobrados e em que níveis. Eu, por exemplo, gostaria de poder criar cabeçalhos de seção "falsos" para ocultar o texto que não possui um cabeçalho LaTeX verdadeiro, mas logicamente é mantido no mesmo nível do documento. Com o seguinte código, você pode usar:

%section{a fake section}

Blah blah blah blah blah, LaTeX doesn't recognize me as a section...

\section{a real section}

Blah blah blah blah blah, LaTeX treats me as a real section

E você poderá manipular a seção falsa como qualquer outra, mas o LaTeX a ignorará quando você compilar o documento:

;; extra outline headers 
(setq TeX-outline-extra
      '(("%chapter" 1)
        ("%section" 2)
        ("%subsection" 3)
        ("%subsubsection" 4)
        ("%paragraph" 5)))

;; add font locking to the headers
(font-lock-add-keywords
 'latex-mode
 '(("^%\\(chapter\\|\\(sub\\|subsub\\)?section\\|paragraph\\)"
    0 'font-lock-keyword-face t)
   ("^%chapter{\\(.*\\)}"       1 'font-latex-sectioning-1-face t)
   ("^%section{\\(.*\\)}"       1 'font-latex-sectioning-2-face t)
   ("^%subsection{\\(.*\\)}"    1 'font-latex-sectioning-3-face t)
   ("^%subsubsection{\\(.*\\)}" 1 'font-latex-sectioning-4-face t)
   ("^%paragraph{\\(.*\\)}"     1 'font-latex-sectioning-5-face t)))

outline-magic

outline-magicestende os modos de estrutura de tópicos para usar org-modeocultação / exibição semelhantes com a tecla tab mágica. Em outras palavras, você provavelmente pode adicionar isso ao seu fluxo de trabalho e fazer com que seus documentos LaTeX se comportem mais como orgdocumentos. (Eu não o uso, não posso comentar sobre a funcionalidade.)

Instalações dobráveis ​​AUCTeX

As instalações dobráveis ​​do AUCTeX funcionam em ambientes e no que eles (confusamente) chamam de macros , em vez de seções. Para usar essa funcionalidade, será necessário ativá-la TeX-fold-mode.

Por exemplo, o itemize ambiente , desdobrado, pode se parecer com:

\begin{itemize}
  \item An item
  \item Another item
\end{itemize}

A chamada TeX-fold-env(padrão :) C-c C-o C-edentro do ambiente é dobrada para se parecer com:

[itemize]

Colocar o cursor em algum lugar interno [itemize]o expandirá temporariamente novamente enquanto você o edita e depois se dobrará novamente para [itemize]quando você mover o cursor para fora do ambiente.

Por uma "macro", o AUCTeX significa coisas assim \footnote{...}. Portanto, chamar TeX-fold-macro(padrão C-c C-o C-m:) quando estiver dentro \footnote{This is a footnote}dobra-o até [f]; ele irá expandir e contrair de maneira análoga ao que acontece com os ambientes.

Você pode usar as outline-minor-modeinstalações dobráveis ​​e as do AUCTeX juntas no mesmo documento: elas fazem coisas diferentes em partes diferentes.

O que você quer se chama dobrar e há duas maneiras de fazer isso.

Modo secundário de estrutura de tópicos

Este é um modo secundário integrado que é exatamente o que o modo organizacional usa para ocultar e exibir suas manchetes. Você pode garantir que ele esteja sempre ativado latex-modecom

(add-hook 'LaTeX-mode-hook #'outline-minor-mode)

As teclas de atalho que define são um pouco difíceis de usar, portanto, você pode alterar algumas delas.

C-c @ C-a       show-all
C-c @ C-c       hide-entry
C-c @ C-d       hide-subtree
C-c @ C-e       show-entry
C-c @ TAB       show-children
C-c @ C-k       show-branches
C-c @ C-l       hide-leaves
C-c @ C-o       hide-other
C-c @ C-q       hide-sublevels
C-c @ C-s       show-subtree
C-c @ C-t       hide-body

Látex-extra

O latex-extra é um modo secundário disponível no Melpa e no Melpa-stable. Você pode instalá-lo M-x package-install RET latex-extrae ativá-lo com

(add-hook 'LaTeX-mode-hook #'latex-extra-mode)

Ele adiciona uma série de conveniências latex-mode, uma delas é a seção dobrável. latex-extratambém usa outline-minor-modenos bastidores, mas a vantagem é que emula o comportamento do modo organizacional mais de perto (embora não de forma idêntica).

Do seu leia - me :

Semelhante a como o modo organizacional oculta e exibe subárvores, se você pressionar TAB em um cabeçalho de seção, o latex-extra ocultará o conteúdo dessa seção para você. Pressionar a guia duas vezes irá expandi-la novamente.
Isso não interferirá no que quer que seja com outras combinações de teclas que você definiu para o TAB , como yasnippet ou preenchimento automático.

Shift-TAB fará o mesmo para todo o buffer.

Obviamente, o mesmo vale para capítulos, subseções etc.