This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision Next revision Both sides next revision | ||
other:emacs_doc [2023/12/06 16:13] jypeter [Windows installation] Improved a bit, and simplified by removing the "emacs in WSL" option |
other:emacs_doc [2024/02/15 14:09] jypeter [Example configuration file] Improved |
||
---|---|---|---|
Line 50: | Line 50: | ||
==== Windows installation ==== | ==== Windows installation ==== | ||
- | |||
Line 57: | Line 56: | ||
<note warning>When installing emacs, you will need an account that can get **//elevated// (i.e. //administrator//) permissions** | <note warning>When installing emacs, you will need an account that can get **//elevated// (i.e. //administrator//) permissions** | ||
- | \\ At LSCE, use the ''[[https://wiki.lsce.ipsl.fr/pmip3/doku.php/other:win10config#the_available_accounts|.\admin]]'' account</note> | + | \\ On a computer configured at LSCE, use your ''[[https://wiki.lsce.ipsl.fr/pmip3/doku.php/other:win10config#the_available_accounts|.\admin]]'' account</note> |
- | * Use [[other:win10apps#installing_applications_with_winget|winget]] to install ''emacs'' for Windows: | + | * Use ''winget'' to install ''emacs'' for Windows (optional [[other:win10apps#installing_applications_with_winget|winget]] details, for people who want to learn more): |
- | * Just type the folllowing, in a windows ''cmd'', ''PowerShell'' or ''Terminal'' **with //elevated// (i.e. //administrator//) permissions**:\\ ''%%winget install --id GNU.Emacs%%'' | + | * Just type the folllowing, in a windows ''cmd'', ''PowerShell'' or ''Terminal'' |
- | * IF the automated installation with ''winget'' does not work, download the most recent Windows installer from a gnu ftp mirror | + | * ''%%winget install --id GNU.Emacs%%'' |
+ | * if your Windows terminal does not have //elevated// (i.e. //administrator//) permissions, a pop-up window will open and ask for confirmation | ||
+ | * IF the automated installation with ''winget'' does not work, download the most recent Windows installer from a gnu //ftp// mirror | ||
* Go to [[https://ftpmirror.gnu.org/emacs/|gnu emacs ftp mirror]] | * Go to [[https://ftpmirror.gnu.org/emacs/|gnu emacs ftp mirror]] | ||
* Go to the most recent ''windows/emacs-XX/'' folder (e.g. ''windows/emacs-29/'') | * Go to the most recent ''windows/emacs-XX/'' folder (e.g. ''windows/emacs-29/'') | ||
* Download the most recent ''emacs-XX.YY-installer.exe'' file (e.g. ''emacs-29.1_2-installer.exe'') and execute it | * Download the most recent ''emacs-XX.YY-installer.exe'' file (e.g. ''emacs-29.1_2-installer.exe'') and execute it | ||
+ | |||
+ | * If everything went well, you should have a new ''Start''=>''Emacs-XX'' menu that you can use to start ''emacs'' | ||
+ | * If that's not the case, ask JYP and remind him to finish this section FIXME | ||
* You can work with the default ''emacs'' settings, but it is highly recommended to start with a nice existing emacs configuration file (if available) | * You can work with the default ''emacs'' settings, but it is highly recommended to start with a nice existing emacs configuration file (if available) | ||
Line 71: | Line 75: | ||
=== Recommended EXTRA binaries for Windows === | === Recommended EXTRA binaries for Windows === | ||
- | * **If** you need to **work with remote files**, ''emacs'' can automatically transfer files from your computer and remote servers, if configured properly\\ <wrap hi>**Extremely** useful</wrap> | + | * **If** you need to **work with remote files**, ''emacs'' can automatically transfer files between your local computer and remote servers, if configured properly\\ <wrap hi>**Extremely** useful</wrap> |
* [[https://wiki.lsce.ipsl.fr/pmip3/doku.php/other:putty_conf|Install PuTTY]], and configure a PuTTY //profile// for the desired //host **and** user// combination, so that emacs can use the [[https://the.earth.li/~sgtatham/putty/0.78/htmldoc/Chapter7.html#plink|PuTTY plink]] command to connect to remote servers (and transfer files) | * [[https://wiki.lsce.ipsl.fr/pmip3/doku.php/other:putty_conf|Install PuTTY]], and configure a PuTTY //profile// for the desired //host **and** user// combination, so that emacs can use the [[https://the.earth.li/~sgtatham/putty/0.78/htmldoc/Chapter7.html#plink|PuTTY plink]] command to connect to remote servers (and transfer files) | ||
- | * Do not use //space// characters in the predefined PuTTY profile name! | + | * **Do not use //space// characters in the predefined PuTTY profile name**! |
- | * ''mylogin_server'' (e.g. ''jyp_ssh1'') is OK | + | * ''mylogin_server'' (e.g. ''me_ssh1'') is OK |
* but ''mylogin server'' will **not** work | * but ''mylogin server'' will **not** work | ||
* Use the [[https://www.gnu.org/software/tramp/#Inline-methods|plinkx]] //method// when opening a remote file with emacs: ''/plinkx:mylogin_server:/path/to/file'' | * Use the [[https://www.gnu.org/software/tramp/#Inline-methods|plinkx]] //method// when opening a remote file with emacs: ''/plinkx:mylogin_server:/path/to/file'' | ||
- | * Use **exactly** the same profile name as an existing PuTTY profile! | + | * Use **exactly the same profile name** as an existing PuTTY profile! |
* More details in FIXME | * More details in FIXME | ||
Line 109: | Line 113: | ||
==== Windows launch ==== | ==== Windows launch ==== | ||
- | * ''Start'' => ''E'' => ''Emacs'' | + | * ''Start'' => ''E'' => ''Emacs-XX.Y'' => ''Emacs'' |
==== Mac launch ==== | ==== Mac launch ==== | ||
Line 194: | Line 198: | ||
* Edit the file (with ''emacs'' or another editor) and search //Microsoft// to (un)comment MS Windows specific sections of the configuration file | * Edit the file (with ''emacs'' or another editor) and search //Microsoft// to (un)comment MS Windows specific sections of the configuration file | ||
* (re)start ''emacs'' to take this configuration file into account | * (re)start ''emacs'' to take this configuration file into account | ||
+ | * If ''emacs'' displays the following error message, just create the ''server'' directory (''c:/Users/your_login/AppData/Roaming/.emacs.d/server'') by hand and restart ''emacs''\\ <code>Warning (initialization): An error occurred while loading ‘c:/Users/your_login/AppData/Roaming/.emacs’: | ||
+ | |||
+ | File is missing: Opening output file, No such file or directory, c:/Users/your_login/AppData/Roaming/.emacs.d/server/server</code> | ||
- | * Keyboard shortcuts defined by the example configuration file | + | * **Keyboard shortcuts** defined by the example configuration file |
* ''C-x C-g'': go to a specific line | * ''C-x C-g'': go to a specific line | ||
* ''Shift Left_Arrow'' and ''Shift Right_Arrow'': go to the beginning/end of a line\\ Same behavior as ''C-a'' and ''C-e'', and the ''Home'' and ''End'' keyboard keys | * ''Shift Left_Arrow'' and ''Shift Right_Arrow'': go to the beginning/end of a line\\ Same behavior as ''C-a'' and ''C-e'', and the ''Home'' and ''End'' keyboard keys |