[PD-dev] formatting HTML doc in Pd distro?

Mon Jul 1 04:18:19 CEST 2019

There may be a way not to reinvent the wheel and also maintain some use
previous use cases other patchers and developers have used.

Consider e.g. the reflection classes in purr data, like [canvasinfo], which
has a [dir( method.

Likewise pddp/pddplink etc. can open files in the native OS, and they are
used a ton in documentation for externals, for instance.

I'm not saying that either of these specifically needs to be included in
vanilla, but these are problems that have already been solved in various
ways and it could be worthwhile to see what exists.

On Sun, Jun 30, 2019 at 9:44 PM Miller Puckette <msp at ucsd.edu> wrote:

> The gotcha is that I can't find a way to typeset equations in native
> HTML...
> and properly documenting even osc~ is going to require some.
>
> Perhaps it would work to have basic doc in HTML and detailed doc (theory of
> operation level stuff) in either markdown or latex.
>
> cheers
> M
>
> On Mon, Jul 01, 2019 at 01:22:40AM +0000, Lucas Cordiviola wrote:
> > On 6/30/2019 1:05 AM, Miller Puckette wrote:
> >
> > > Any advice would be very helpful!
> >
> >
> > Stay in the HTML format.
> >
> > Following https://www.w3schools.com/html/html_basic.asp anyone can come
> > up with an object documentation.
> >
> > HTML is the way to go. No need for latex, md, or whatever. HTML is
> > really simple and works on any computer and is very straightforward to
> > maintain and enhance. Most importantly it does not add compiling
> dependency.
> >
> > *************************************
> >
> > <!DOCTYPE html>
> > <html>
> > <head>
> > </head>
> > <body>
> >
> > <h1> big heading </h1>
> > <h2> h2 smaller heading </h2>
> >
> > <p> paragraph
> >
> > <p> paragraph 2
> >
> > </body>
> > </html>
> >
> > *********************************
> >
> >
> > Having the ability to open local or remote URLs?? is a total Pd enhancer.
> >
> >
> > :)
> >
> >
> > Mensaje telepatico asistido por maquinas.
> >
>
>
>
> _______________________________________________
> Pd-dev mailing list
> Pd-dev at lists.iem.at
> https://lists.puredata.info/listinfo/pd-dev
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.puredata.info/pipermail/pd-dev/attachments/20190630/86211f9b/attachment.html>