source commit: 54e4c1a

CODE_OF_CONDUCT.md

@@ -0,0 +1,13 @@
+---
+title: "Contributor Code of Conduct"
+---
+
+As contributors and maintainers of this project,
+we pledge to follow the [The Carpentries Code of Conduct][coc].
+
+Instances of abusive, harassing, or otherwise unacceptable behavior
+may be reported by following our [reporting guidelines][coc-reporting].
+
+
+[coc-reporting]: https://docs.carpentries.org/topic_folders/policies/incident-reporting.html
+[coc]: https://docs.carpentries.org/topic_folders/policies/code-of-conduct.html

LICENSE.md

@@ -0,0 +1,79 @@
+---
+title: "Licenses"
+---
+
+## Instructional Material
+
+All Carpentries (Software Carpentry, Data Carpentry, and Library Carpentry)
+instructional material is made available under the [Creative Commons
+Attribution license][cc-by-human]. The following is a human-readable summary of
+(and not a substitute for) the [full legal text of the CC BY 4.0
+license][cc-by-legal].
+
+You are free:
+
+- to **Share**---copy and redistribute the material in any medium or format
+- to **Adapt**---remix, transform, and build upon the material
+
+for any purpose, even commercially.
+
+The licensor cannot revoke these freedoms as long as you follow the license
+terms.
+
+Under the following terms:
+
+- **Attribution**---You must give appropriate credit (mentioning that your work
+  is derived from work that is Copyright (c) The Carpentries and, where
+  practical, linking to <https://carpentries.org/>), provide a [link to the
+  license][cc-by-human], and indicate if changes were made. You may do so in
+  any reasonable manner, but not in any way that suggests the licensor endorses
+  you or your use.
+
+- **No additional restrictions**---You may not apply legal terms or
+  technological measures that legally restrict others from doing anything the
+  license permits.  With the understanding that:
+
+Notices:
+
+* You do not have to comply with the license for elements of the material in
+  the public domain or where your use is permitted by an applicable exception
+  or limitation.
+* No warranties are given. The license may not give you all of the permissions
+  necessary for your intended use. For example, other rights such as publicity,
+  privacy, or moral rights may limit how you use the material.
+
+## Software
+
+Except where otherwise noted, the example programs and other software provided
+by The Carpentries are made available under the [OSI][osi]-approved [MIT
+license][mit-license].
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of
+this software and associated documentation files (the "Software"), to deal in
+the Software without restriction, including without limitation the rights to
+use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
+of the Software, and to permit persons to whom the Software is furnished to do
+so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+## Trademark
+
+"The Carpentries", "Software Carpentry", "Data Carpentry", and "Library
+Carpentry" and their respective logos are registered trademarks of [Community
+Initiatives][ci].
+
+[cc-by-human]: https://creativecommons.org/licenses/by/4.0/
+[cc-by-legal]: https://creativecommons.org/licenses/by/4.0/legalcode
+[mit-license]: https://opensource.org/licenses/mit-license.html
+[ci]: https://communityin.org/
+[osi]: https://opensource.org

config.yaml

@@ -0,0 +1,82 @@
+#------------------------------------------------------------
+# Values for this lesson.
+#------------------------------------------------------------
+
+# Which carpentry is this (swc, dc, lc, or cp)?
+# swc: Software Carpentry
+# dc: Data Carpentry
+# lc: Library Carpentry
+# cp: Carpentries (to use for instructor training for instance)
+# incubator: The Carpentries Incubator
+carpentry: 'incubator'
+
+# Overall title for pages.
+title: 'Introduction to Modern Fortran'
+
+# Date the lesson was created (YYYY-MM-DD, this is empty by default)
+created: '2023-08-04'
+
+# Comma-separated list of keywords for the lesson
+keywords: 'software, data, lesson, The Carpentries, Fortran'
+
+# Life cycle stage of the lesson
+# possible values: pre-alpha, alpha, beta, stable
+life_cycle: 'pre-alpha'
+
+# License of the lesson materials (recommended CC-BY 4.0)
+license: 'CC-BY 4.0'
+
+# Link to the source repository for this lesson
+# source: 'https://github.com/carpentries/fortran'
+source: 'https://github.com/astroDimitrios/intro-to-modern-fortran'
+
+# Default branch of your lesson
+branch: 'main'
+
+# Who to contact if there are any issues
+contact: '[email protected]'
+
+# Navigation ------------------------------------------------
+#
+# Use the following menu items to specify the order of
+# individual pages in each dropdown section. Leave blank to
+# include all pages in the folder.
+#
+# Example -------------
+#
+# episodes:
+# - introduction.md
+# - first-steps.md
+#
+# learners:
+# - setup.md
+#
+# instructors:
+# - instructor-notes.md
+#
+# profiles:
+# - one-learner.md
+# - another-learner.md
+
+# Order of episodes in your lesson
+episodes: 
+- introduction.Rmd
+
+# Information for Learners
+learners: 
+
+# Information for Instructors
+instructors: 
+
+# Learner Profiles
+profiles: 
+
+# Customisation ---------------------------------------------
+#
+# This space below is where custom yaml items (e.g. pinning
+# sandpaper and varnish versions) should live
+sandpaper: astroDimitrios/sandpaper
+pegboard: astroDimitrios/pegboard
+varnish: astroDimitrios/varnish
+
+

index.md

@@ -0,0 +1,58 @@
+---
+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 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
+have a refresher in Fortran.
+
+::::::::::::::::::::::::::::::::::::: prereq
+
+### Prerequisites
+
+Learners *must* be familiar with the basic concepts of
+programming: variables, logic, flow of control, loops, functions and
+so on. No knowledge of Fortran is assumed. Previous programming
+experience might typically be in the context C/C++ or python.
+If you know no programming, we suggest this course on Fortran is not
+the place to start.
+
+::::::::::::::::::::::::::::::::::::::::::::
+
+Fortran (a contraction of Formula Translation) was the first programming
+language to have a standard (in 1954), but has changed significantly over
+the years. More recent standards (the latest being Fortran 2018) come
+under the umbrella term "Modern Fortran". Fortran retains very great
+significance in many areas of scientific and numerical computing,
+particularly for applications such as quantum chemistry, plasmas, and in
+numerical weather prediction and climate models.
+
+This course provides an introduction to the basics of writing Fortran.
+It will cover basic syntax, variables, expressions and assignments,
+flow of control, and introductions to i/o and user-defined types.
+Common Fortran idioms are introduced and contrasted with those
+available in C-like languages; the course will try to focus on
+real usage rather than formal descriptions.
+
+At the end of the course you should be able to understand many Fortran
+programs and be confident to start to write well-structured and portable
+Fortran. Fortran is a rather "large" language, so it is not possible to
+cover all its features in a two day course. Further elements of Fortran
+are discussed in the "Intermediate Modern Fortran" course.
+
+The course requires a Fortran compiler, for which a local machine or
+laptop may be appropriate [1]. If you do not have access to a Fortran
+compiler, course training accounts on archer2 will be available which
+provide access to various compilers. Use of a text editor will be
+required (some may prefer an IDE, but we do not intend to consider or
+support IDEs).
+
+[1] This may typically be GFortran, freely available as part of
+    Gnu Compiler Collection (GCC).
+    See e.g., [Link to GFortran install page on fortran-lang][install-gfortran]
+
+
+[workbench]: https://carpentries.github.io/sandpaper-docs
+

instructor-notes.md

@@ -0,0 +1,5 @@
+---
+title: Instructor Notes
+---
+
+This is a placeholder file. Please add content here.