<div dir="ltr">Have you guys looked at mermaidjs for simplistic diagrams?<div><a href="https://mermaid-js.github.io/mermaid/#/flowchart">https://mermaid-js.github.io/mermaid/#/flowchart</a><br></div><div><br></div><div>You can embed it in markdown. pandoc will convert it to images for html.</div><div>it works on gitlab wiki, and prob others.</div></div><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Wed, Oct 12, 2022 at 8:31 PM Chris Johns <<a href="mailto:chrisj@rtems.org">chrisj@rtems.org</a>> wrote:<br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><br>
<br>
On 12/10/2022 8:56 pm, Frank Kühndel wrote:<br>
> Hello Chris,<br>
> On 10/11/22 23:47, Chris Johns wrote:<br>
>> On 11/10/2022 7:12 pm, Frank Kühndel wrote:<br>
>>> Hello Chris,<br>
>>><br>
>>> On 10/11/22 03:09, Chris Johns wrote:<br>
>>>> On 10/10/2022 9:22 pm, Frank Kühndel wrote:<br>
>>>>> images/filesystem/tftpfs_usage.png:<br>
>>>>> <a href="https://share.embedded-brains.de/index.php/s/fQ4WrLrqmBjcbwC" rel="noreferrer" target="_blank">https://share.embedded-brains.de/index.php/s/fQ4WrLrqmBjcbwC</a><br>
>>>> I have a greyed out image I cannot clearly see?<br>
>>> The image has a transparent background. Some image viewers put a gray pattern in<br>
>>> the background in those case. The PDF has naturally a white background on top of<br>
>>> which the image is displayed.<br>
>>><br>
>>>>> images/filesystem/ftpfs_usage.svg:<br>
>>>>> <a href="https://share.embedded-brains.de/index.php/s/xk7kArkm6mbjcn2" rel="noreferrer" target="_blank">https://share.embedded-brains.de/index.php/s/xk7kArkm6mbjcn2</a><br>
>>>>><br>
>>>>> The SVG file is the source for the PNG. Both files must be placed in the<br>
>>>>> images/filesystem folder.<br>
>>>> How is the SVG file created and how can it be edited?<br>
>>> I used Inkscape. It should be possible to edit it with (almost) any tool that<br>
>>> supports SVG.<br>
>> I tried withhttps://<a href="http://pixelied.com/features/svg-editor" rel="noreferrer" target="_blank">pixelied.com/features/svg-editor</a>  and it was a mess.<br>
> <br>
> Yes. I tried another Web-based tool and it was the same mess. Yet, all converter<br>
> handle this correctly. For example:<br>
> <br>
> $ firefox file:///home/frank/tftpfs_usage.svg<br>
> $ convert -geometry 1422x1574 tftpfs_usage.svg tftpfs_usage.png<br>
> $ display tftpfs_usage.svg<br>
> $ libreoffice tftpfs_usage.svg<br>
> $ rsvg-convert --width 1422 --height 1574 -o tftpfs_usage_Z.png tftpfs_usage.svg<br>
> <br>
> So, I guess it is a bug in the web-based tools.<br>
<br>
The format is always going to be fragile and locked into the specific tool used<br>
to create it. Being an open format does not help. Word is a form of XML and it<br>
is also not suitable.<br>
<br>
>> My concern is the widgets (or whatever they are called) a tool has may not be<br>
>> available in another.<br>
> <br>
> Inkscape is open source and available freely on (almost?) all operating system.<br>
> It is *the* standard open source tool for producing high-quality vector graphics<br>
> today.<br>
<br>
I do not agree and I question "the" in your last sentence. Making a fact of your<br>
view does not impress me.<br>
<br>
We need a solution that can be maintained past your current employment.<br>
<br>
>>> Your Web-Browser should be able to display SVG directly when you<br>
>>> point it to the file like for example:file:///home/<user-name>/tftpfs_usage.svg<br>
>>><br>
>>> You can recreate the PNG with Inkscape on the command line with:<br>
>>><br>
>>> $ inkscape --export-dpi=300 --export-filename=tftpfs_usage.png tftpfs_usage.svg<br>
>> We have a number of images in the doco created using PlantUML. Did you consider<br>
>> using that tool? It has the advantage the images can be regenerated from the<br>
>> source as part of the build if PlantUML and Ditaa are installed and we get a<br>
>> consistent looking set of images.<br>
> <br>
> I took a look into PlantUML:<br>
> <br>
> * My image is not an UML diagram (or similar to another diagram input format it<br>
> supports)<br>
<br>
Ditaa is an option and easy to use.<br>
<br>
> * It may be realized as an Activity Diagram, yet. But it will not look very<br>
> similar to the current image.<br>
><br>
> * Most of all, I will need to spend significant time to learn PlantUML and to<br>
> get the result in shape I will certainly need to do some trying and fumbling<br>
> around.<br>
<br>
Maybe an example would help:<br>
<br>
<a href="https://git.rtems.org/rtems-docs/tree/images/user/exe-debug-libdebugger.ditaa" rel="noreferrer" target="_blank">https://git.rtems.org/rtems-docs/tree/images/user/exe-debug-libdebugger.ditaa</a><br>
<br>
> Openly, my company will never pay me for converting the image to PlantUML. Sorry<br>
> about this.<br>
<br>
Seems you have made this a commercial issue on a public mailing list I have<br>
included Thomas on the email and he can reach out me directly. I always enjoy<br>
catching up with him.<br>
<br>
> Do you see any solution to this problem?<br>
<br>
1. Revert the patch.<br>
<br>
2. Use something like ditaa<br>
<br>
3. Reword the section to not include the image<br>
<br>
In the mean time the docs are not building.<br>
<br>
Chris<br>
_______________________________________________<br>
devel mailing list<br>
<a href="mailto:devel@rtems.org" target="_blank">devel@rtems.org</a><br>
<a href="http://lists.rtems.org/mailman/listinfo/devel" rel="noreferrer" target="_blank">http://lists.rtems.org/mailman/listinfo/devel</a></blockquote></div><br clear="all"><div><br></div>-- <br><div dir="ltr" class="gmail_signature"><div dir="ltr">Sincerely,<br><br>Sam Price<br><br></div></div>