Uwaga: duża część tego tekstu pochodzi z odpowiedzi na pytanie, które okazało się być duplikatem tego pytania . Niektóre materiały są na tyle różne, że warto dodać je do tego pytania.
Tryb konspektu i funkcje składania AUCTeX to dwie różne bestie, które mają zasadniczo robić to samo: ukrywać i pokazywać wybrane części bufora.
Kluczowym elementem, który należy rozpoznać podczas używania, outline-minor-mode
jest to, że ma on inny klucz prefiksu niż outline-mode
(tj. Tryb główny ) - właśnie w celu uniknięcia konfliktu kluczy z kluczami ruchu itp. Prefiks ten domyślnie jest niezręczny do pisania C-c @
(chociaż można to zrobić zmień to, dostosowując outline-minor-mode-prefix
). Wszystkie wymienione Skróty klawiszowe na tym węźle podręcznika powinien nadal działać, ale z akcentami, które zastąpi główną prefiks modalny C-c
z minor prefiksu modalnej C-c @
. Stąd C-c @ C-c
przebiegi hide-entry
, C-c @ C-e
przebiegi show-entry
i tak dalej.
Aby korzystać z tych udogodnień, musisz włączyć outline-minor-mode
. Najprostszym sposobem jest hak trybu:
(add-hook 'LaTeX-mode-hook #'outline-minor-mode)
wymiana pieniędzy outline-minor-mode-prefix
To powinna być prosta rzecz do zmiany outline-minor-mode-prefix
(to kiedyś z powrotem w ciągu dnia). Ale nie jest. Co za zabawa!
Dokumenty zawierają teraz tajemniczą notatkę, która:
Klawisz prefiksu używany dla poleceń Zarys w trybie pomocniczym Zarys. Wartość tej zmiennej jest sprawdzana w ramach ładowania trybu konspektu. Następnie zmiana klucza prefiksu wymaga manipulowania mapami klawiszy.
Tak, bardzo pomocny. Co dziwne, nawet customize
nie ustawia tej zmiennej w czasie, aby uniknąć „manipulowania mapami klawiszy” (mimo że jest zdefiniowana defcustom
w kodzie źródłowym). Praktyczne obejście: ustaw tę zmienną w pliku init przed załadowaniem outline
lub jakimkolwiek innym elementem z niego zbudowanym (np org-mode
.).
Możesz na przykład chcieć, aby prefiks był C-o
(co oznacza, że przegrywasz open-line
, ale możesz ponownie powiązać go, jeśli naprawdę chcesz). Umieszczenie następujących plików na początku pliku inicjującego załatwi sprawę:
(global-unset-key "\C-o")
(setq outline-minor-mode-prefix "\C-o")
Teraz powinieneś być w stanie uzyskać dostęp do wszystkich funkcji trybu konspektu za pomocą C-o
prefiksu - C-o C-c
aby zadzwonić hide-entry
, C-o C-e
zadzwonić show-entry
i tak dalej.
dodawanie nowych nagłówków konspektu
Jako dodatkowy bonus możesz również dostosować, które nagłówki konturu można składać i do jakich poziomów. Na przykład lubię mieć możliwość tworzenia „fałszywych” nagłówków sekcji, aby ukryć tekst, który nie ma prawdziwego nagłówka LaTeX, ale logicznie jest przechowywany na tym samym poziomie dokumentu. Za pomocą następującego kodu możesz użyć:
%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
Będziesz mógł manipulować fałszywą sekcją tak jak każdą inną, ale LaTeX zignoruje ją podczas kompilacji dokumentu:
;; 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
rozszerza tryby konspektu na org-mode
ukrywanie / pokazywanie za pomocą magicznego klawisza tab. Innymi słowy, prawdopodobnie możesz dodać to do swojego przepływu pracy i sprawić, że twoje dokumenty LaTeX będą zachowywać się bardziej jak org
dokumenty. (Nie używam go sam, więc nie mogę komentować funkcjonalności.)
Urządzenia do składania AUCTeX działają w środowiskach i w tym, co (myląco) nazywają makra , a nie sekcje. Aby korzystać z tej funkcji, musisz ją włączyć za pomocą TeX-fold-mode
.
Na przykład itemize
środowisko , które zostało rozwinięte, może wyglądać następująco:
\begin{itemize}
\item An item
\item Another item
\end{itemize}
Wywołanie TeX-fold-env
(domyślnie C-c C-o C-e
:) w środowisku składa się, aby wyglądać następująco:
[itemize]
Umieszczenie kursora gdzieś w środku [itemize]
spowoduje jego tymczasowe rozwinięcie podczas edytowania, a następnie zwinie się z powrotem do [itemize]
momentu wyprowadzenia kursora ze środowiska.
Przez „makro” AUCTeX oznacza takie rzeczy \footnote{...}
. Dlatego wywołanie TeX-fold-macro
(domyślnie :), C-c C-o C-m
gdy jest w środku, \footnote{This is a footnote}
złoży to do [f]
; będzie się rozszerzać i kurczyć w sposób analogiczny do tego, co dzieje się w środowisku.
Możesz używać obu funkcji outline-minor-mode
składania i AUCTeX razem w tym samym dokumencie: robią różne rzeczy na różnych jego częściach.