search

fortran-lang / talks

Repository for talks and presentations about fortran-lang projects
13 stars 14 forks source link

Fpm presentation for FortranCon #19

Closed awvwgk closed 3 years ago

awvwgk commented 3 years ago

This is the staging area for our FortranCon presentation for fpm. Feel free to suggest changes or open PRs against my branch (please ping me in the PR or I might overlook it) and edit this description as we put together the presentation.

Technical details

Data

Outline

cc @certik @milancurcic @kubajj @vmagnin @epagone @LKedward @everythingfunctional @urbanjost

Compiled slides for a434ac8dfc612a9b715e3359660929a27be37a1d: main.pdf

everythingfunctional commented 3 years ago

Looking decent so far. Just let me know if you have questions or need help with something specifically. Thanks for taking the lead on putting it together.

vmagnin commented 3 years ago

I have just git cloned the @awvwgk repository. Note that on my system (Texmaker in Ubuntu), I did not succeed to compile the latex using PDFLatex or XeLaTeX, but it works with LuaLaTeX.

Concerning the installation of fpm, it will be important to note that you don't need to have admin rights to do it, as I noted in that post today: https://fortran-lang.discourse.group/t/fpm-0-4-0-released/1752/13

awvwgk commented 3 years ago

While not particular elegant, I also added the gnuplot scripts I used to produce the fpm-projects plot, in case anyone is interested in playing around with it. The graphic was post-processed in Inkscape to yield the final svg and pdf used in the presentation.

awvwgk commented 3 years ago

The basic structure of the presentation stands now. There is room for a couple of more slides, especially get a smoother flow of the presentation.

vmagnin commented 3 years ago

Great slides Sebastian @awvwgk ! Being an enthusiastic but just a naive user of fpm, some questions came into my mind while reading those slides:

awvwgk commented 3 years ago

Which standard is needed to compile fpm: Fortran 2008? Fortran 2018?

TOML Fortran and M_CLI2 can be compiled with GCC 5, the newest feature that we are using in fpm that requires GCC 7 is assignment to an allocatable class polymorphic object. Should be roughly Fortran 2008, but we might fail a strict check on this.

Why a C compiler is finally needed to build fpm?

We have an optional C component to access the POSIX API, this currently requires access to the macros and was easier to do in C if I recall correctly. It is mainly for performance but not needed for functionality.

personally I don't use conda, but git and then launch the ./install.sh (Linux). Why not give that method?

Fair point. Compiling from source is always an option, but I did prefer to advertise our package manager integrations, since it makes it easier to upgrade once installed this way.

For compiling from source it would be three steps:

git clone https://github.com/fortran-lang/fpm
cd fpm
./install.sh

I'll try to add this in the graphic as well.

awvwgk commented 3 years ago

I also added the compiled slides as attachment above, this way you don't have to install LuaLaTeX to checkout the presentation.

epagone commented 3 years ago

Really good presentation, thanks for putting it together @awvwgk .

Three small, optional comments from me:

awvwgk commented 3 years ago

but maybe I misunderstood the comments there.

Fpm accepts branch just fine, we just had to fool the registry to accept a different branch than the default one. I should have fixed the registry instead of hacking around the problem, but where is the fun in that? ;)

it would be nice to launch the "contest" for the fpm logo and show our current best candidate, inviting the audience to participate in the relevant discussion.

If we can we gather enough high quality submissions we can try to put this together. I don't want to just gather some drafts from the thread without making sure everybody got a chance to put their best effort into creating a logo draft. For example some drafts have incorrectly trimmed white boarders which will be visible in my presentation theme but not in GitHub's default theme.

epagone commented 3 years ago

I don't want to just gather some drafts from the thread without making sure everybody got a chance to put their best effort into creating a logo draft.

Ok, I'd like to clarify that I didn't mean to add additional work, maybe I used my words inappropriately and I have been misunderstood. With "contest" I didn't mean a true contest but just a "marketing" name for the presentation: just a way to motivate digital artists potentially present in the audience to chip-in and contribute. I did not imagine to put in a slide all the current potential candidates (some of them were even only jokes: the stork, the "Rustran" logo, etc...), but only one good example (please just do not choose any one with punched cards :pray: ) and use it as a lead to the discussion explaining that is just one of the examples that can be found and we are in search of the final solution.

I understand if you prefer to scrap the idea (among other aspects, there might be no time for that), it's perfectly fine for me, but it might be a missed opportunity to give visibility to that obscure discussion and to close in a more light-hearted way the talk.

LKedward commented 3 years ago

Thanks for uploading the compiled slides (I couldn't get it to compile). It looks great! Really captures everything nicely.

The graph on slide 4, is it possible to increase the font size of the milestones and the axes? Would be worth emphasising early on that the project is open source (MIT) with a prominent link to the Github repository. (Currently, the only link is right at the end). Could also mention developer documentation is generated with FORD and available at https://fpm.fortran.org. Is it a deliberate decision not to use sentence case for all the bullet points? It looks a little strange to me without capitalisation of first letter.

vmagnin commented 3 years ago

@awvwgk I have not found the MIT license of fpm in the presentation. It could be put on the Slide 4 (or 3? or 13?) which talks about contributors.

vmagnin commented 3 years ago

I agree with Laurence's @LKedward comment about capitalization, at first glance it looked odd for me.

vmagnin commented 3 years ago

Thank you for including the git clone command in the last slide. I am using it on all my machines, but it was especially useful for me to install fpm on a distant machine where I had no admin rights and there was no packaging system such as conda, but git was available.

awvwgk commented 3 years ago

Is it a deliberate decision not to use sentence case for all the bullet points? It looks a little strange to me without capitalisation of first letter.

Yeah, I usually use all lowercase for lists, if this is distracting or incorrect I can change it.

vmagnin commented 3 years ago

Yeah, I usually use all lowercase for lists, if this is distracting or incorrect I can change it.

Although unusual, if that is your style we should respect it.

epagone commented 3 years ago

Yeah, I usually use all lowercase for lists, if this is distracting or incorrect I can change it.

I strongly doubt that it's incorrect. Depending on the specific case, I use both: sentence case and lower case.

urbanjost commented 3 years ago

By the way, if the fonts were bigger so it would shrink better I think the slide with the graphic with fpm in the middle and the main functions surrounding it would get my vote for "fpm logo".

awvwgk commented 3 years ago

I created a repository with the graphics from this presentation released in the public domain: https://github.com/awvwgk/fpm-artwork. If you have inkscape you should be able to modify the svg files there, in the feature overview graphic the text is not converted to paths yet, changing the font size is therefore still possible.

vmagnin commented 3 years ago

Thanks Sebastian @awvwgk ! I still plan to write and post somewhere a short fpm tutorial in French, and these artworks could help a lot.

vmagnin commented 3 years ago

@awvwgk I would like to include the fpm "colored circle" in the Fortran French Wikipedia page, which has already a paragraph about fpm. Can I upload that graphic in https://commons.wikimedia.org ? It seems anyone can upload a public domain graphic, but maybe you prefer to do it yourself? Else, I will credit "Sebastian Ehlert (Fortran-lang community)".

awvwgk commented 3 years ago

I would like to include the fpm "colored circle" in the Fortran French Wikipedia page, which has already a paragraph about fpm. Can I upload that graphic in https://commons.wikimedia.org ?

Feel free to upload the graphic there.

vmagnin commented 3 years ago

@awvwgk , I have added it to Wikimedia commons: https://commons.wikimedia.org/wiki/File:Fpm_(Fortran_Package_Manager)_features.svg but for an unknown reason the fonts disappeared from the PNG previews :-( I could try to upload a PNG instead. Any other idea?

awvwgk commented 3 years ago

Try converting all fonts to paths and save the file as plain svg instead. Inkscape svg's allow certain extensions, which won't work everywhere.

awvwgk commented 3 years ago

Here is a plain svg version: https://gist.github.com/awvwgk/237b58071933fadc4a2444e4ab7dc7df

vmagnin commented 3 years ago

Here is a plain svg version: https://gist.github.com/awvwgk/237b58071933fadc4a2444e4ab7dc7df

Thanks a lot! It fixed the problem. The graphic is now in the French Fortran Wikipedia page: https://fr.wikipedia.org/wiki/Fortran#Gestionnaire_de_paquets_et_syst%C3%A8mes_de_construction