Skip to content

booklet Fortran 95 features #542

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

Jump to bottom
Open
wants to merge 10 commits into
base: main
Choose a base branch
from
Open

booklet Fortran 95 features #542

wants to merge 10 commits into from
+2,655 −4

Conversation

nbehrnd
Copy link
Contributor

@nbehrnd nbehrnd commented Mar 12, 2025

As an addition to the learning section, the material of the Wikipedia article "Fortran 95 language features"[1] is reformat as a multipage booklet.

[1] https://en.wikipedia.org/wiki/Fortran_95_language_features

Signed-off-by: Norwid Behrnd [email protected]

nbehrnd and others added 7 commits February 28, 2025 16:32
@nbehrnd
fix(object_based_programming_techniques.md): correct typos
0c40d5a 
A correction based on Beliavsky's reading.[1]

[1] fortran-lang#526

Signed-off-by: Norwid Behrnd <[email protected]>
@nbehrnd
Merge branch 'main' into main
285fe37
@nbehrnd
feat(f95_features.md): initiate work
5e7902b 
Based on a request on fortran-lang.org,[1] work for a new
booklet for the learning section of fortran-lang.org about
the features of Fortran 95 starts.

The initial step was to fetch the source code (mediawiki synatax)
which was converted with Pandoc to GitHub flavored Markdown where
possible.  This was not possible for the trailing bibliography
section of the Wikipedia article (hence left as such in a fenced
code block), which however is more an optional "for an additional
read, consult ..." rather than a specific literature reference to
a particular keyword, or phrase.

While GitHub flavored Markdown isn't (yet) MyST Markdown flavor
required, it is close enough for the manual edit ahed.  Equally
a TODO is to build a multipage booklet, i.e. an `index.md` and
individual Markdown files about each chapter; this gradually
removes `f95_features.md` as an intermediate container file.

[1] https://fortran-lang.discourse.group/t/fortran-95-language-features/9263

Signed-off-by: Norwid Behrnd <[email protected]>
@nbehrnd
add reference to "root version" of the booklet
da69a39 
Added an explicit note about the last commit (on side of Wikipedia)
the source of this booklet is about.

Signed-off-by: Norwid Behrnd <[email protected]>
@nbehrnd
adjust code fences to f90
aa29e6d 
Throughout the source file (and equally in the mediawiki file),
the label of the code fences was `fortran`.  Because the file is
about Fortran 95, it was updated by

```bash
sed 's/``` fortran/```f90/' f95_features.md > temp.txt
mv temp.text f95_features.md
rm temp.txt
```

Signed-off-by: Norwid Behrnd <[email protected]>
@nbehrnd
install index.md
3429d11 
Creation of the index.md file, already anticipating the first
chapter to be added.  Corresponding cut in the container file.
@nbehrnd
update index of learn.md
6888e51 
The index of booklets in `learn.md` was amended by a link about
the new booklet under construction.

Signed-off-by: Norwid Behrnd <[email protected]>
@nbehrnd
Copy link
Contributor Author

nbehrnd commented Mar 12, 2025

#build_preview

@github-actions GitHub Actions
Copy link

This PR has been built with Sphinx and can be previewed at: https://fortran-lang.github.io/webpage/pr/542

@nbehrnd
Copy link
Contributor Author

nbehrnd commented Mar 12, 2025

While building the booklet locally (with an instance of Linux Debian 13/trixie), I face a couple of difficulties; mainly the definition and subsequent use of links within the booklet, but across (specific sections of) Markdown files. Hence I would like to use the infrastructure provided here to "repair" these issues before squashing multiple commits which is going to affect the commit history.

Thus, I consider the present form as not yet ready to file a normal PR and standard review.

@nbehrnd
Copy link
Contributor Author

nbehrnd commented Mar 27, 2025

Test of a cross-link pattern proposed by chatgtp (which doesn't work in the local build - but perhaps here).

@nbehrnd
Copy link
Contributor Author

nbehrnd commented Mar 27, 2025

#build_preview

@github-actions GitHub Actions
Copy link

This PR has been built with Sphinx and can be previewed at: https://fortran-lang.github.io/webpage/pr/542

@nbehrnd nbehrnd force-pushed the dev branch 10 times, most recently from 1c5db17 to b911716 Compare April 11, 2025 17:17
@nbehrnd
language_elements.md: lint with mdl
6634c7c 
Linting with markdownlint (version 0.13.0) as packaged by Debian
Linux[1] except for any kind of links, tables and checks on
snippets of Fortran.

[1] https://tracker.debian.org/pkg/ruby-mdl

Signed-off-by: Norwid Behrnd <[email protected]>
@nbehrnd
Copy link
Contributor Author

nbehrnd commented Apr 11, 2025

After retaining a local .zip archive of the original repository, work previously committed in individual commits per chapter/section was rebased and squashed into a few commits. To guarantee the outcome is still the same as earlier, there will be again the call to the github action to build a new preview.

@nbehrnd
Copy link
Contributor Author

nbehrnd commented Apr 11, 2025

#build_preview

@github-actions GitHub Actions
Copy link

This PR has been built with Sphinx and can be previewed at: https://fortran-lang.github.io/webpage/pr/542

@nbehrnd
Copy link
Contributor Author

nbehrnd commented Apr 23, 2025

#build_preview

@github-actions GitHub Actions
Copy link

This PR has been built with Sphinx and can be previewed at: https://fortran-lang.github.io/webpage/pr/542

@nbehrnd
Copy link
Contributor Author

nbehrnd commented Apr 24, 2025

#build_preview

@github-actions GitHub Actions
Copy link

This PR has been built with Sphinx and can be previewed at: https://fortran-lang.github.io/webpage/pr/542

@nbehrnd
Copy link
Contributor Author

nbehrnd commented Apr 24, 2025

#build_preview

@github-actions GitHub Actions
Copy link

This PR has been built with Sphinx and can be previewed at: https://fortran-lang.github.io/webpage/pr/542

@nbehrnd
Copy link
Contributor Author

nbehrnd commented Apr 24, 2025

#build_preview

@github-actions GitHub Actions
Copy link

This PR has been built with Sphinx and can be previewed at: https://fortran-lang.github.io/webpage/pr/542

@nbehrnd
Copy link
Contributor Author

nbehrnd commented Apr 24, 2025

#build_preview

@github-actions GitHub Actions
Copy link

This PR has been built with Sphinx and can be previewed at: https://fortran-lang.github.io/webpage/pr/542

@nbehrnd
Copy link
Contributor Author

nbehrnd commented Apr 24, 2025

#build_preview

@github-actions GitHub Actions
Copy link

This PR has been built with Sphinx and can be previewed at: https://fortran-lang.github.io/webpage/pr/542

@nbehrnd
Copy link
Contributor Author

nbehrnd commented Apr 24, 2025

#build_preview

@github-actions GitHub Actions
Copy link

This PR has been built with Sphinx and can be previewed at: https://fortran-lang.github.io/webpage/pr/542

@nbehrnd nbehrnd force-pushed the dev branch 4 times, most recently from 87755dd to 6e684c0 Compare April 24, 2025 12:20
@nbehrnd
add bibliography.md
a856a4b 
This copies the mediawiki source code block of the Wikipedia
article's bibliography.  It will be edited after the other
sections are revised.

Signed-off-by: Norwid Behrnd <[email protected]>
@nbehrnd
Copy link
Contributor Author

nbehrnd commented Apr 24, 2025

#build_preview

@github-actions GitHub Actions
Copy link

This PR has been built with Sphinx and can be previewed at: https://fortran-lang.github.io/webpage/pr/542

@nbehrnd
Copy link
Contributor Author

nbehrnd commented Apr 24, 2025

#build_preview

@github-actions GitHub Actions
Copy link

This PR has been built with Sphinx and can be previewed at: https://fortran-lang.github.io/webpage/pr/542

@nbehrnd
detailed revision
e4ba981 
Markdown files were edited for a more readable syntax; the
cross-referencing to other sections of the same, or other
Markdown files revised (and checked with the `#build_preview`
robot provide by https://github.com/fortran-lang/webpage/).

This squashes multiple (iterative) individual commits into a
single one.

Signed-off-by: Norwid Behrnd <[email protected]>
@nbehrnd
Copy link
Contributor Author

nbehrnd commented Apr 24, 2025

#build_preview

@github-actions GitHub Actions
Copy link

This PR has been built with Sphinx and can be previewed at: https://fortran-lang.github.io/webpage/pr/542

@nbehrnd nbehrnd marked this pull request as ready for review April 24, 2025 12:55
@nbehrnd
Copy link
Contributor Author

nbehrnd commented Apr 24, 2025

@perazz, @henilp105, or other volunteering steward of the web site

After multiple iterations, the booklet to save Mike Metcalf's Fortran 95 features from Wikipedia (cf. discussion in February 2025) is ready for a first round of review.

To me, an obstacle was to figure out how to cross-reference from one Markdown file to a specific section of an other Markdown file because I did not identify an already existing multipage booklet using this feature as reference pattern. An accidental find provided an approach different to the instructions given, however (as checked with the previews built here on GitHub) working.

Second (especially in the course of the past days; hence the many #build_preview comments and builds in this thread), the setup of a local fork by cloning from GitHub, creation of a virtual Python environment including a pip install -r requirements.txt was not sufficient to locally build the previews. Tentatively, I attribute this to the constraint of the computer used (Windows 10 without gfortran, or any compiler aware of Fortran). To keep the commit history "compact", I squashed many individual commits into a few and presume after the review, an additional squash may take place. If you (as owner of the GitHub repository) can remove the intermediate builds, go ahead and erase them for good.

To ease the review of this larger booklet, I attach the pdf of the original article as exported by Wikipedia on February 28th (41 pages ISO A4, no illustrations, about 1 MB).

Fortran_95_language_features.pdf

@github-actions GitHub Actions
Copy link

This PR has been built with Sphinx and can be previewed at: https://fortran-lang.github.io/webpage/pr/542

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Reviewers
No reviews
Assignees
No one assigned
Labels
None yet
Projects
None yet
Milestone
No milestone
Development

Successfully merging this pull request may close these issues.

None yet
1 participant
@nbehrnd