Skip to content

Improve structure of learn section #611

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
connoraird wants to merge 3 commits into
base: main
Choose a base branch
from
Open

Improve structure of learn section #611

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
ded2143
Add tile for setting up your os to the top of the Getting started sec…
connoraird Dec 15, 2025
92bbc73
Cleanup the Setting up OS page to match the style of other pages
connoraird Dec 15, 2025
2a3a8b8
Link to subsections from setting up os index page
connoraird Dec 15, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
24 changes: 24 additions & 0 deletions source/learn.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -24,6 +24,30 @@ Getting Started
::::{grid} 1 1 1 1
:gutter: 1

:::{grid-item-card} {octicon}`beaker;1em;sd-text-info` Setup your local environment
:shadow: none

Hit the ground running and setup your local environment to develop Fortran your way!

```{card}
:link-type: url
:link: os_setup/
:class-card: sd-btn
:class-body: sd-p-1 sd-text-center sd-font-weight-bold sd-text-info sd-btn-primary sd-text-light sd-btn
:shadow: none

{octicon}``beaker;1em;sd-text-info`` Setting up your OS
```

:::
::::
:::::

:::::{grid-item}

::::{grid} 1 1 1 1
:gutter: 1

:::{grid-item-card} {octicon}`info;1em;sd-text-info` New to Fortran
:shadow: none

Expand Down
25 changes: 11 additions & 14 deletions source/learn/os_setup/index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,19 +1,8 @@
<br/><br/>

<div style="text-align:center"><span style="font-size:1.5em">A beginner's tutorial on the software that needs to be installed to start with Fortran development</span></div>
<br/><br/>

---

<span style="color:grey; font-size:0.8em">_Authors: Stavros Meskos, Laurence Kedward, Arjen Markus, Ondřej Čertík, Milan Curcic_</span>

<span style="color:grey; font-size:0.8em">_Last update: 16-Feb-2021_</span>

---

# Setting up your OS

In this mini-book we address the very first problem that many new Fortran programmers encounter. Before everything, you will need to choose a compiler and install it. Then you will need a text editor or perhaps an IDE (Integrated Development Environment). There are many options, most of them available in all major OSs (operating systems). However, the process to install and configure them greatly differs between Windows, Linux, and macOS. There are several Fortran compilers. Here, we pick those that meet certain criteria and provide a guide on how to install them in all the aforementioned OSs. A list of popular text editors and IDEs and information on how to choose between them is presented as well.
**A beginner's tutorial on the software that needs to be installed to start with Fortran development**

In this mini-book we address the very first problem that many new Fortran programmers encounter. Before everything, you will need to choose a compiler and install it. There are several Fortran compilers. In [our guide](/learn/os_setup/choose_compiler), we cover those that meet certain criteria. Then you will need a text editor or perhaps an IDE (Integrated Development Environment). There are many options, most of them available in all major OSs (operating systems). However, the process to install and configure them greatly differs between Windows, Linux, and macOS. A list of popular [text editors](/learn/os_setup/text_editors) and [IDEs](/learn/os_setup/ides) and information on how to choose between them is presented within our guide.

::::{note}
If you have already set up your environment, you may skip this tutorial and move forward with the Quickstart Fortran Tutorial to start coding your first `Hello World` program or with the Building programs mini-book to understand how a compiler works.
Expand All @@ -23,6 +12,14 @@ If you have already set up your environment, you may skip this tutorial and move

_The choice of text editors and IDEs has been controversial among the developers. What you choose is a matter of personal taste. Every solution comes with its own pros and cons. For that reason, in this guide, we will not push the reader towards one or another direction. We will, however, present a list of the most popular tools._

---

<span style="color:grey; font-size:0.8em">_Authors: Stavros Meskos, Laurence Kedward, Arjen Markus, Ondřej Čertík, Milan Curcic_</span>

<span style="color:grey; font-size:0.8em">_Last update: 16-Feb-2021_</span>

---

Comment on lines +15 to +22
Copy link
Contributor

@joewallwork joewallwork Dec 15, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

How come you moved this down? Also the date could be updated.

Copy link
Author

@connoraird connoraird Dec 15, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I thought it made more sense as a footer but I could move back up to the top. I also didn't change the contents too much so left the date but suppose I should update

```{toctree}
:hidden:
Choosing a compiler <choose_compiler>
Expand Down