brain initiation

This commit is contained in:
2025-11-05 09:18:11 +01:00
commit 933aa8a985
191 changed files with 6203 additions and 0 deletions

View File

@@ -0,0 +1,69 @@
:PROPERTIES:
:ID: f52339f6-db99-4b43-91fd-48e7a1957ab2
:END:
#+title: synctex
#+filetags: :EMACS:latex:
This procedure will set up Emacs, [[id:3dfde3f4-2cc0-4356-a147-d4afd599e731][auctex]], and the Okular viewer to handle integrated forward and inverse search. (These instructions were tested on a Debian system)
Install Emacs. To install Emacs, open up the terminal and type the command:
[[id:dc54334e-afa9-4a53-be91-1e90bc6bf8d0][sudo]] ~apt-get install emacs~
Install AUCTeX.
Within Emacs, run M-x package install RET auctex RET.
To test for a successful installation, just open up a .tex file Emacs with and you will see new menus concerning LaTeX.
enter image description here
Install Okular.
sudo apt-get install okular
If not already done, open a tex file with emacs.
In the LaTeX menu, go to "Customize AUCTeX" and click on "Extend this menu".
Then go again to LaTeX, "Customize AUCTeX", go to the "Tex Command" submenu and click on the included "Tex command" item.
From within Emacs, run
~M-x customize-group RET TeX-command RET~
You are now in the "Tex command group" configuration buffer. Scroll down until you reach "Tex Pdf Mode". Its value is off (nil); click on the "Toggle" button to activate this mode. Click on the "State" button and select "Save for Future Sessions". AUCTeX will now compile your TeX file using pdflatex.
You should see something like this: enter image description here
For the "Save for Future Sessions", the button with the green down arrow can also be selected. When this is done, your .emacs will be updated accordingly.
enter image description here
Still in the "Tex command group" configuration buffer, scroll all the way down and click on the special item called "Tex View". In the "Tex view group" buffer, you have two things to do:
activate the correlate mode between the PDF and the TeX file, and
declare a PDF viewer which can read these correlations.
To activate the correlate mode:
item "Tex Source Correlate Method", click on the "Value Menu" button and select "synctex" and save for future sessions,
item "Tex Source Correlate Start [[id:f2b1d5af-1a7d-47a5-95c8-4a85d558419e][server]]", select "Always" and save,
item "Tex Source Correlate Mode", toggle it on and save.
To set Okular as the default PDF viewer:
(NOTE: this is necessary only if you are using AUCTeX 11.87 or lower, in which case you really should upgrade the package to a more recent version) item Tex View Program List then click INS
name: Okular
choice: Command
command: okular --unique %o#src:%n%b
item Tex View Program Selection then click INS
choice: Single predicate
single predicate: output-pdf
viewer: Okular
If you just added Okular to the Tex View Program List, this choice might not appear. Restart Emacs or Set for Current Session to have it show up.
Set and save both for future sessions.
To configure Okular: in the Okular window, go to the "Settings" menu, item "Configure Okular", "Editor", select Emacs [[id:70899526-8b7d-4976-94fc-cc07c41e550a][client]].
To use Forward search from Emacs to Okular, just hit C-c C-v or click on the glasses button of the tool-bar to call the viewer. Okular will center its display on the intended line of the pdf.
To use Inverse search from Okular to Emacs, make sure that the Browse Tool (in the Tools menu of Okular) is enabled; then just hit Shift+Left mouse click on the pdf. Emacs will come up and position the cursor at the intended line of the TeX source.