From 6710d545aaa95b3bcf7ac2cb2cf1330128c902b6 Mon Sep 17 00:00:00 2001 From: GitHub Actions Date: Wed, 9 Oct 2024 13:21:35 +0000 Subject: [PATCH] differences for PR #25 --- index.md | 2 +- links.md | 4 ++++ md5sum.txt | 6 +++--- setup.md | 28 ++++++++++++++++++++++++++++ 4 files changed, 36 insertions(+), 4 deletions(-) diff --git a/index.md b/index.md index 70326b1..e1dd22d 100644 --- a/index.md +++ b/index.md @@ -2,7 +2,7 @@ site: sandpaper::sandpaper_site --- -This is a new lesson built with [The Carpentries Workbench][workbench]. It is currently in pre-alpha development by the [Edinburgh Parallel Computing Centre][epcc-link], the [National Oceanography Centre][noc-link], and the [UK Met Office][uk-met-link]. +This is a new lesson built with [The Carpentries Workbench][workbench]. It is currently in pre-alpha development by the [Edinburgh Parallel Computing Centre][epcc-link], the [National Centre for Atmospheric Science][ncas-link], the [National Oceanography Centre][noc-link], and the [UK Met Office][uk-met-link]. This course is aimed at users and developers who know how to program, but have little or no experience in Fortran, and those who may wish to diff --git a/links.md b/links.md index 03f3035..b300146 100644 --- a/links.md +++ b/links.md @@ -11,7 +11,11 @@ any links that you are not going to use. [contact]: mailto:d.theodorakis@metoffice.gov.uk [epcc-link]: https://www.epcc.ed.ac.uk/ +[ncas-link]: https://ncas.ac.uk/ [noc-link]: https://noc.ac.uk/ [uk-met-link]: https://www.metoffice.gov.uk/ [install-gfortran]: https://fortran-lang.org/learn/os_setup/install_gfortran/ + +[emacs-link]: https://www.gnu.org/software/emacs/ +[emacs-init-link]: https://www.gnu.org/software/emacs/manual/html_node/emacs/Init-File.html \ No newline at end of file diff --git a/md5sum.txt b/md5sum.txt index c4faa63..530883d 100644 --- a/md5sum.txt +++ b/md5sum.txt @@ -2,11 +2,11 @@ "CODE_OF_CONDUCT.md" "c93c83c630db2fe2462240bf72552548" "site/built/CODE_OF_CONDUCT.md" "2024-10-07" "LICENSE.md" "b24ebbb41b14ca25cf6b8216dda83e5f" "site/built/LICENSE.md" "2024-10-07" "config.yaml" "d2267d8f4b7506c689db7eb30c1cfc22" "site/built/config.yaml" "2024-10-07" -"index.md" "3805e770257efa14dc17eee63ec45500" "site/built/index.md" "2024-10-07" -"links.md" "e0a8f306dd2dfa5adfc27965f32441a3" "site/built/links.md" "2024-10-07" +"index.md" "460111f6ab60c07fef2cb1b2e5569475" "site/built/index.md" "2024-10-09" +"links.md" "3310192ccfeabb362f34db338a2abfee" "site/built/links.md" "2024-10-09" "episodes/introduction.Rmd" "82188ceeb809ba0eeb51ec3918a65b95" "site/built/introduction.md" "2024-10-07" "instructors/instructor-notes.md" "5cf113fd22defb29d17b64597f3c9bc0" "site/built/instructor-notes.md" "2024-10-07" "learners/reference.md" "527a12e217602daae51c5fd9ef8958df" "site/built/reference.md" "2024-10-07" -"learners/setup.md" "1969cff95cff6288fe45afa8f6a1dfe8" "site/built/setup.md" "2024-10-07" +"learners/setup.md" "f97b0c03acde4422eeaf05d6dd6f60b1" "site/built/setup.md" "2024-10-09" "profiles/learner-profiles.md" "5fe5bf7537072422b91ed393ada03f9a" "site/built/learner-profiles.md" "2024-10-07" "renv/profiles/lesson-requirements/renv.lock" "e3647f7536c823a256ab0c3fa64db72f" "site/built/renv.lock" "2024-10-07" diff --git a/setup.md b/setup.md index cc97f4c..ec3ebfc 100644 --- a/setup.md +++ b/setup.md @@ -42,5 +42,33 @@ If you are not taking this course on archer2 we recommend installing the [GFortr ::::::::::::::::::::::::: +## Text Editors and Integrated Development Environments (IDEs) +While Fortran files are plain text can could be edited with any plain text editor, it is recommened that you use an editor that is capable of _syntax highlighting_. There are a number of these available. +### Emacs + +[Emacs][emacs-link] is a cross-platform text editor available for Linux, MacOS, and Windows. It will contain syntax highlighting for many Fortran file, but additional file extensions, such as `.X90` may be valid Fortran files but will not be picked up in Emacs _f90-mode_. This mode allows for tab-completion of Fortran statements and the addition of a drop-down menu that provides additional Fortran-related options. + +Files can be manually set to f90-mode using `M-x f90-mode`, but file extensions can be added to your [Emacs initialization file][emacs-init-link] to ensure that these are recognised when opened. The format for this is +```lisp +(setq auto-mode-alist + (append '(("\\.mf90" . f90-mode) + ("\\.X90" . f90-mode) + ) auto-mode-alist)) +``` +::::::::::::::::: tab + +### Windows/MacOS + +From your home directory, initialization settings can be placed within your `.emacs.d/init.el` file. + +### Linux + +Initialization settings can be placed within your `~/.config/emacs/init.el` file. This location follows the Linux desktop environment guidelines. + +### Legacy (cross platform) + +The `.emacs` or `.emacs.el` file is an older method of configuring Emacs. This file is held in your home directory. + +:::::::::::::::::::::::::