docs not building to PDF

[Sam Price]

Have you guys looked at mermaidjs for simplistic diagrams?
https://mermaid-js.github.io/mermaid/#/flowchart

You can embed it in markdown. pandoc will convert it to images for html.
it works on gitlab wiki, and prob others.

On Wed, Oct 12, 2022 at 8:31 PM Chris Johns <chrisj at rtems.org> wrote:

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



-- 
Sincerely,

Sam Price
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.rtems.org/pipermail/devel/attachments/20221012/31abcea9/attachment-0001.htm>