Re: [Csnd-dev] Manual for Csound 7
Hlöðver Sigurðsson <[email protected]>
| Newsgroups | gmane.comp.audio.csound.devel |
|---|---|
| Message-ID | <CAB8vR8LsTKC9f=i5ivR2OOxsEhxXUdwbQN+EOfWZq8ecLgztvA@mail.gmail.com> |
look good. The only downside off the bat for me, is I use the data programmability of xml to create emacs and web-ide editor support. But it could be supported separately, in fact perhaps even as opcode metadata built in down the road. On Tue, 25 Feb 2025 at 20:52, Rory Walsh <[email protected]> wrote: > Great work guys. It looks and functions great. :) > > On Tue, 25 Feb 2025 at 18:33, Dr. Richard Boulanger < > [email protected]> wrote: > >> Looking great! But... the historical preface mentions Berry Vercoe. >> ;-). It is Barry Vercoe >> Dr. Richard Boulanger >> Professor >> Electronic Production and Design >> Berklee College of Music >> >> On Feb 25, 2025, at 1:27 PM, vlz <[email protected]> wrote: >> >> Yes, absolutely. Thanks a lot for this work. It will simplify >> maintenance significantly. >> Prof. Victor Lazzarini >> Maynooth University >> Ireland >> >> On 25 Feb 2025, at 17:08, Francois PINOT <[email protected]> wrote: >> >> >> Dear devs, >> >> Joachim, Menno and I are working on a new platform for the manual for >> Csound 7. We're using mkdocs-material which is based on markdown, a >> technology simpler and more recent than docbook. It produces >> beautiful pages. >> >> The transformation from xml to markdown is a bit tedious. I tried >> different tools available on the web, but the results were not convincing. >> I finally wrote a program to transform one notice from xml to markdown: it >> works fine on nearly all files: for each file it takes me about 2mn to >> transform it, verify the result and eventually do some hand adjustment. I >> wrote another program to cleanly replace the tabulations by spaces in the >> csd files. >> >> After three weeks, I've transformed about 65% of the manual. You can see >> the result here: https://joachimheintz.github.io/CS7_Manual/ >> >> If everyone agrees, we'd like to move this repository from Joachim's >> github to the csound github even if it's not complete so that people can >> begin to add notices for Csound 7. We can add it as a new branch to the >> actual manual repo, protecting the other branches against writing, so that >> this new branch becomes the official develop branch of the manual with its >> own CI action. Of course, we'll provide guidelines to help people writing >> new notices. >> >> Comments and advice are welcome. >> >> Regards >> >> François >> >>