OpenChain Reference Training Slides now in MarkDown (Draft, needs work)


 

Well, this is big news. Our reference training slides - one of the most used parts of our reference library - is now in MarkDown. The conversation status is “draft” and we need to check for rough edges:
https://github.com/OpenChain-Project/Reference-Material/blob/master/Training-Slides/Official/2.1/en/openchain-reference-training-slides-iso5230-version1.md

Original PowerPoint slides here for compare, contrast and planning:
https://github.com/OpenChain-Project/Reference-Material/blob/master/Training-Slides/Official/2.1/en/openchain-reference-training-slides-for-ISO-5230-en.pptx

The biggest to-do item is that we need to extract the images from the slides and add them to the MarkDown. This is probably a relatively big lift… we may want to recreate some of the images at this juncture.


Carlo Piana <carlo@...>
 

Hi,

I have tried to figure out an easier way to do it and extract the images in a bulk-ish way, but they appear to be Powerpoint internal objects without any coherence. The best way I have figured out without spending too much time, was to export to PDF, open the PDF in Inkscape, remove the text, group the graphic and export what remains as SVG.

Now Inkscape can deal with multiple pages, but it would be a much better idea to separate each page, remove the ones without images, put the remaining ones in a place and proceed page by page.

It's painful and error prone. Powerpoint is something that is better left with presentations (or even better, alone, sitting in the dark to rotten), not documents.

Cheers

Carlo


----- Messaggio originale -----

Da: "Shane Coughlan" <scoughlan@...>
A: "OpenChain Main" <main@...>
Cc: "OpenChain Education" <education@...>
Inviato: Mercoledì, 16 novembre 2022 15:02:02
Oggetto: [openchain] OpenChain Reference Training Slides now in MarkDown (Draft, needs work)
Well, this is big news. Our reference training slides - one of the most used
parts of our reference library - is now in MarkDown. The conversation status is
“draft” and we need to check for rough edges:
https://github.com/OpenChain-Project/Reference-Material/blob/master/Training-Slides/Official/2.1/en/openchain-reference-training-slides-iso5230-version1.md

Original PowerPoint slides here for compare, contrast and planning:
https://github.com/OpenChain-Project/Reference-Material/blob/master/Training-Slides/Official/2.1/en/openchain-reference-training-slides-for-ISO-5230-en.pptx

The biggest to-do item is that we need to extract the images from the slides and
add them to the MarkDown. This is probably a relatively big lift… we may want
to recreate some of the images at this juncture.


Carlo Piana <carlo@...>
 

Anyway, even in Powerpoint online, the charts have issues.

see here:


----- Messaggio originale -----

Da: "Carlo Piana" <carlo@...>
A: "main@..." <main@...>
Cc: "OpenChain Education" <education@...>
Inviato: Venerdì, 18 novembre 2022 12:15:09
Oggetto: Re: [openchain] OpenChain Reference Training Slides now in MarkDown (Draft, needs work)
Hi,

I have tried to figure out an easier way to do it and extract the images in a
bulk-ish way, but they appear to be Powerpoint internal objects without any
coherence. The best way I have figured out without spending too much time,
was to export to PDF, open the PDF in Inkscape, remove the text, group the
graphic and export what remains as SVG.

Now Inkscape can deal with multiple pages, but it would be a much better idea to
separate each page, remove the ones without images, put the remaining ones in a
place and proceed page by page.

It's painful and error prone. Powerpoint is something that is better left with
presentations (or even better, alone, sitting in the dark to rotten), not
documents.

Cheers

Carlo


----- Messaggio originale -----
Da: "Shane Coughlan" <scoughlan@...>
A: "OpenChain Main" <main@...>
Cc: "OpenChain Education" <education@...>
Inviato: Mercoledì, 16 novembre 2022 15:02:02
Oggetto: [openchain] OpenChain Reference Training Slides now in MarkDown (Draft,
needs work)
Well, this is big news. Our reference training slides - one of the most used
parts of our reference library - is now in MarkDown. The conversation status is
“draft” and we need to check for rough edges:
https://github.com/OpenChain-Project/Reference-Material/blob/master/Training-Slides/Official/2.1/en/openchain-reference-training-slides-iso5230-version1.md

Original PowerPoint slides here for compare, contrast and planning:
https://github.com/OpenChain-Project/Reference-Material/blob/master/Training-Slides/Official/2.1/en/openchain-reference-training-slides-for-ISO-5230-en.pptx

The biggest to-do item is that we need to extract the images from the slides and
add them to the MarkDown. This is probably a relatively big lift… we may want
to recreate some of the images at this juncture.



Carlo Piana <carlo@...>
 

Too fast.

see attached.

K



----- Messaggio originale -----

Da: "Carlo Piana" <carlo@...>
A: "main@..." <main@...>
Cc: "OpenChain Education" <education@...>
Inviato: Venerdì, 18 novembre 2022 12:33:43
Oggetto: Re: [openchain] OpenChain Reference Training Slides now in MarkDown (Draft, needs work)
Anyway, even in Powerpoint online, the charts have issues.

see here:


----- Messaggio originale -----
Da: "Carlo Piana" <carlo@...>
A: "main@..." <main@...>
Cc: "OpenChain Education" <education@...>
Inviato: Venerdì, 18 novembre 2022 12:15:09
Oggetto: Re: [openchain] OpenChain Reference Training Slides now in MarkDown
(Draft, needs work)
Hi,

I have tried to figure out an easier way to do it and extract the images in a
bulk-ish way, but they appear to be Powerpoint internal objects without any
coherence. The best way I have figured out without spending too much time,
was to export to PDF, open the PDF in Inkscape, remove the text, group the
graphic and export what remains as SVG.

Now Inkscape can deal with multiple pages, but it would be a much better idea to
separate each page, remove the ones without images, put the remaining ones in a
place and proceed page by page.

It's painful and error prone. Powerpoint is something that is better left with
presentations (or even better, alone, sitting in the dark to rotten), not
documents.

Cheers

Carlo


----- Messaggio originale -----
Da: "Shane Coughlan" <scoughlan@...>
A: "OpenChain Main" <main@...>
Cc: "OpenChain Education" <education@...>
Inviato: Mercoledì, 16 novembre 2022 15:02:02
Oggetto: [openchain] OpenChain Reference Training Slides now in MarkDown (Draft,
needs work)
Well, this is big news. Our reference training slides - one of the most used
parts of our reference library - is now in MarkDown. The conversation status is
“draft” and we need to check for rough edges:
https://github.com/OpenChain-Project/Reference-Material/blob/master/Training-Slides/Official/2.1/en/openchain-reference-training-slides-iso5230-version1.md

Original PowerPoint slides here for compare, contrast and planning:
https://github.com/OpenChain-Project/Reference-Material/blob/master/Training-Slides/Official/2.1/en/openchain-reference-training-slides-for-ISO-5230-en.pptx

The biggest to-do item is that we need to extract the images from the slides and
add them to the MarkDown. This is probably a relatively big lift… we may want
to recreate some of the images at this juncture.



Jacob Wilson
 

Hi Carlo,

First of all excellent work, this is no small task and is a huge benefit to the community. Second you mentioned conversion of the powerpoint graphs to SVG and then displaying in markdown. Have you had a chance to read this github blog post tackling similar issues? I took a pass at what this might look like in pull request 41 specifically for slide 54 from your last screen shot. Luckily the Mermaid dev team was nice enough to include a live editor, here's a link to the source code for this diagram in action. The chart type I picked was a sequence diagram, it could be that flow diagram or even a mind map works better. Hopefully this helps, or at least provides another option.

Jacob Wilson

On Fri, Nov 18, 2022 at 8:02 AM Carlo Piana <carlo@...> wrote:
Too fast.

see attached.

K



----- Messaggio originale -----
> Da: "Carlo Piana" <carlo@...>
> A: "main@..." <main@...>
> Cc: "OpenChain Education" <education@...>
> Inviato: Venerdì, 18 novembre 2022 12:33:43
> Oggetto: Re: [openchain] OpenChain Reference Training Slides now in MarkDown (Draft, needs work)

> Anyway, even in Powerpoint online, the charts have issues.
>
> see here:
>
>
> ----- Messaggio originale -----
>> Da: "Carlo Piana" <carlo@...>
>> A: "main@..." <main@...>
>> Cc: "OpenChain Education" <education@...>
>> Inviato: Venerdì, 18 novembre 2022 12:15:09
>> Oggetto: Re: [openchain] OpenChain Reference Training Slides now in MarkDown
>> (Draft, needs work)
>
>> Hi,
>>
>> I have tried to figure out an easier way to do it and extract the images in a
>> bulk-ish way, but they appear to be Powerpoint internal objects without any
>> coherence. The best way I have figured out without spending too much time,
>> was to export to PDF, open the PDF in Inkscape, remove the text, group the
>> graphic and export what remains as SVG.
>>
>> Now Inkscape can deal with multiple pages, but it would be a much better idea to
>> separate each page, remove the ones without images, put the remaining ones in a
>> place and proceed page by page.
>>
>> It's painful and error prone. Powerpoint is something that is better left with
>> presentations (or even better, alone, sitting in the dark to rotten), not
>> documents.
>>
>> Cheers
>>
>> Carlo
>>
>>
>> ----- Messaggio originale -----
>>> Da: "Shane Coughlan" <scoughlan@...>
>>> A: "OpenChain Main" <main@...>
>>> Cc: "OpenChain Education" <education@...>
>>> Inviato: Mercoledì, 16 novembre 2022 15:02:02
>>> Oggetto: [openchain] OpenChain Reference Training Slides now in MarkDown (Draft,
>>> needs work)
>>
>>> Well, this is big news. Our reference training slides - one of the most used
>>> parts of our reference library - is now in MarkDown. The conversation status is
>>> “draft” and we need to check for rough edges:
>>> https://github.com/OpenChain-Project/Reference-Material/blob/master/Training-Slides/Official/2.1/en/openchain-reference-training-slides-iso5230-version1.md
>>>
>>> Original PowerPoint slides here for compare, contrast and planning:
>>> https://github.com/OpenChain-Project/Reference-Material/blob/master/Training-Slides/Official/2.1/en/openchain-reference-training-slides-for-ISO-5230-en.pptx
>>>
>>> The biggest to-do item is that we need to extract the images from the slides and
>>> add them to the MarkDown. This is probably a relatively big lift… we may want
>>> to recreate some of the images at this juncture.
>>>
>>>
>>
>>
>>






 

Carlo, outstanding exploration and work.

This raises the question: should we just redo the images rather than try to extract?

Jacob also said:
First of all excellent work, this is no small task and is a huge benefit to the community. Second you mentioned conversion of the powerpoint graphs to SVG and then displaying in markdown. Have you had a chance to read this github blog post tackling similar issues? I took a pass at what this might look like in pull request 41 specifically for slide 54 from your last screen shot. Luckily the Mermaid dev team was nice enough to include a live editor, here's a link to the source code for this diagram in action. The chart type I picked was a sequence diagram, it could be that flow diagram or even a mind map works better. Hopefully this helps, or at least provides another option.
Reference, here:
https://github.com/OpenChain-Project/Reference-Material/pull/41/commits/5e62a8018fce4d329a589e3ec1c815b881c49ea5#diff-26923ec3cd664c6e9c8c2c9f16445e0ad73e14f03851f1ede249fdbb05ffc241


This looks pretty groovy! Did it take a lot of time?

Regards

Shane

On Nov 18, 2022, at 20:34, Carlo Piana <carlo@...> wrote:

Too fast.

see attached.

K



----- Messaggio originale -----
Da: "Carlo Piana" <carlo@...>
A: "main@..." <main@...>
Cc: "OpenChain Education" <education@...>
Inviato: Venerdì, 18 novembre 2022 12:33:43
Oggetto: Re: [openchain] OpenChain Reference Training Slides now in MarkDown (Draft, needs work)
Anyway, even in Powerpoint online, the charts have issues.

see here:


----- Messaggio originale -----
Da: "Carlo Piana" <carlo@...>
A: "main@..." <main@...>
Cc: "OpenChain Education" <education@...>
Inviato: Venerdì, 18 novembre 2022 12:15:09
Oggetto: Re: [openchain] OpenChain Reference Training Slides now in MarkDown
(Draft, needs work)
Hi,

I have tried to figure out an easier way to do it and extract the images in a
bulk-ish way, but they appear to be Powerpoint internal objects without any
coherence. The best way I have figured out without spending too much time,
was to export to PDF, open the PDF in Inkscape, remove the text, group the
graphic and export what remains as SVG.

Now Inkscape can deal with multiple pages, but it would be a much better idea to
separate each page, remove the ones without images, put the remaining ones in a
place and proceed page by page.

It's painful and error prone. Powerpoint is something that is better left with
presentations (or even better, alone, sitting in the dark to rotten), not
documents.

Cheers

Carlo


----- Messaggio originale -----
Da: "Shane Coughlan" <scoughlan@...>
A: "OpenChain Main" <main@...>
Cc: "OpenChain Education" <education@...>
Inviato: Mercoledì, 16 novembre 2022 15:02:02
Oggetto: [openchain] OpenChain Reference Training Slides now in MarkDown (Draft,
needs work)
Well, this is big news. Our reference training slides - one of the most used
parts of our reference library - is now in MarkDown. The conversation status is
“draft” and we need to check for rough edges:
https://github.com/OpenChain-Project/Reference-Material/blob/master/Training-Slides/Official/2.1/en/openchain-reference-training-slides-iso5230-version1.md

Original PowerPoint slides here for compare, contrast and planning:
https://github.com/OpenChain-Project/Reference-Material/blob/master/Training-Slides/Official/2.1/en/openchain-reference-training-slides-for-ISO-5230-en.pptx

The biggest to-do item is that we need to extract the images from the slides and
add them to the MarkDown. This is probably a relatively big lift… we may want
to recreate some of the images at this juncture.






<Screenshot from 2022-11-18 12-32-41.png>


Carlo Piana <carlo@...>
 

Shane, all,

I take no credit, for this outstanding work, just flagged the issue of images. ;-)

I am sort of familiar with the tools mentioned by Jacob, I and Alberto (mainly Alberto) used one to create a complex workflow in certain slides we have made for Eclipse Oniro toolchain. I think they are excellent for creating new charts or to replicate the logic. Sometimes you would want a bit of flair and eyecandy, in which case I find that a less semantic and more graphic tool like https://app.diagrams.net/ (exported in SVG or png) can be better. It's a matter of taste and clarity in source code.

HST, the graphigs in 55-65 are the same graph with a sliding element, it's not much work once the basis is created, so redoing it is advisable.

54 is worth rearranging, and I have done it (see attached, an Inkscape SVG which should be readable with any SVG), cleaning up artifacts that don't scale, eliminating kerning and stuff.

Noticeably, the elements in the upper graphic can be cut, pasted in diagrams.net or in another Inkscape document, the single elements can be changed in colors and the sliding element can be relatively easily created (a first attempt is also attached). From there it should be relatively easy to create the visuals for those (there is some additional stuff, like adding arrows and enlarging the container, painting it blue) but really I could not do it right now.

Cheers

Carlo



----- Messaggio originale -----

Da: "Shane Coughlan" <scoughlan@...>
A: "OpenChain Main" <main@...>
Cc: "OpenChain Education" <education@...>
Inviato: Martedì, 13 dicembre 2022 5:40:55
Oggetto: Re: [openchain] OpenChain Reference Training Slides now in MarkDown (Draft, needs work)
Carlo, outstanding exploration and work.

This raises the question: should we just redo the images rather than try to
extract?

Jacob also said:
First of all excellent work, this is no small task and is a huge benefit to the
community. Second you mentioned conversion of the powerpoint graphs to SVG and
then displaying in markdown. Have you had a chance to read this github blog
post tackling similar issues? I took a pass at what this might look like in
pull request 41 specifically for slide 54 from your last screen shot. Luckily
the Mermaid dev team was nice enough to include a live editor, here's a link to
the source code for this diagram in action. The chart type I picked was a
sequence diagram, it could be that flow diagram or even a mind map works
better. Hopefully this helps, or at least provides another option.
Reference, here:
https://github.com/OpenChain-Project/Reference-Material/pull/41/commits/5e62a8018fce4d329a589e3ec1c815b881c49ea5#diff-26923ec3cd664c6e9c8c2c9f16445e0ad73e14f03851f1ede249fdbb05ffc241


This looks pretty groovy! Did it take a lot of time?

Regards

Shane

On Nov 18, 2022, at 20:34, Carlo Piana <carlo@...> wrote:

Too fast.

see attached.

K



----- Messaggio originale -----
Da: "Carlo Piana" <carlo@...>
A: "main@..." <main@...>
Cc: "OpenChain Education" <education@...>
Inviato: Venerd��, 18 novembre 2022 12:33:43
Oggetto: Re: [openchain] OpenChain Reference Training Slides now in MarkDown
(Draft, needs work)
Anyway, even in Powerpoint online, the charts have issues.

see here:


----- Messaggio originale -----
Da: "Carlo Piana" <carlo@...>
A: "main@..." <main@...>
Cc: "OpenChain Education" <education@...>
Inviato: Venerd��, 18 novembre 2022 12:15:09
Oggetto: Re: [openchain] OpenChain Reference Training Slides now in MarkDown
(Draft, needs work)
Hi,

I have tried to figure out an easier way to do it and extract the images in a
bulk-ish way, but they appear to be Powerpoint internal objects without any
coherence. The best way I have figured out without spending too much time,
was to export to PDF, open the PDF in Inkscape, remove the text, group the
graphic and export what remains as SVG.

Now Inkscape can deal with multiple pages, but it would be a much better idea to
separate each page, remove the ones without images, put the remaining ones in a
place and proceed page by page.

It's painful and error prone. Powerpoint is something that is better left with
presentations (or even better, alone, sitting in the dark to rotten), not
documents.

Cheers

Carlo


----- Messaggio originale -----
Da: "Shane Coughlan" <scoughlan@...>
A: "OpenChain Main" <main@...>
Cc: "OpenChain Education" <education@...>
Inviato: Mercoled��, 16 novembre 2022 15:02:02
Oggetto: [openchain] OpenChain Reference Training Slides now in MarkDown (Draft,
needs work)
Well, this is big news. Our reference training slides - one of the most used
parts of our reference library - is now in MarkDown. The conversation status is
���draft��� and we need to check for rough edges:
https://github.com/OpenChain-Project/Reference-Material/blob/master/Training-Slides/Official/2.1/en/openchain-reference-training-slides-iso5230-version1.md

Original PowerPoint slides here for compare, contrast and planning:
https://github.com/OpenChain-Project/Reference-Material/blob/master/Training-Slides/Official/2.1/en/openchain-reference-training-slides-for-ISO-5230-en.pptx

The biggest to-do item is that we need to extract the images from the slides and
add them to the MarkDown. This is probably a relatively big lift��� we may want
to recreate some of the images at this juncture.






<Screenshot from 2022-11-18 12-32-41.png>







[image/png:Screenshot 2022-12-13 at 13.39.27.png]