|Hans-Christoph Steiner||Apr 29, 2005 2:30 pm|
|Frank Barknecht||Apr 29, 2005 7:01 pm|
|Michal Seta||Apr 30, 2005 8:24 am|
|Krzysztof Czaja||Apr 30, 2005 8:30 am|
|Hans-Christoph Steiner||Apr 30, 2005 4:44 pm|
|Krzysztof Czaja||May 1, 2005 3:42 am|
|Hans-Christoph Steiner||May 1, 2005 8:06 am|
|Krzysztof Czaja||May 1, 2005 9:29 am|
|Hans-Christoph Steiner||May 1, 2005 2:34 pm|
|Hans-Christoph Steiner||May 1, 2005 2:49 pm|
|Hans-Christoph Steiner||May 1, 2005 2:50 pm|
|Frank Barknecht||May 1, 2005 3:42 pm|
|Michal Seta||May 1, 2005 9:04 pm|
|Hans-Christoph Steiner||May 1, 2005 9:59 pm|
|Krzysztof Czaja||May 2, 2005 12:18 am|
|Krzysztof Czaja||May 2, 2005 12:21 am|
|B. Bogart||May 2, 2005 7:26 am|
|B. Bogart||May 2, 2005 9:22 am|
|Anton Woldhek||May 2, 2005 12:24 pm|
|Krzysztof Czaja||May 3, 2005 11:33 am|
|Frank Barknecht||May 3, 2005 3:47 pm|
|Anton Woldhek||May 3, 2005 4:26 pm|
|Krzysztof Czaja||May 4, 2005 4:04 am|
|Anton Woldhek||May 4, 2005 4:08 am|
|Krzysztof Czaja||May 4, 2005 4:11 am|
|B. Bogart||May 4, 2005 8:42 am|
|B. Bogart||May 4, 2005 12:24 pm|
|B. Bogart||May 4, 2005 12:38 pm|
|Hans-Christoph Steiner||May 4, 2005 4:33 pm|
|Hans-Christoph Steiner||May 4, 2005 4:36 pm|
|Hans-Christoph Steiner||May 4, 2005 4:40 pm|
|Anton Woldhek||May 5, 2005 2:04 am|
|Krzysztof Czaja||May 5, 2005 4:14 am|
|B. Bogart||May 5, 2005 8:03 am|
|B. Bogart||May 5, 2005 8:14 am|
|B. Bogart||May 5, 2005 8:18 am|
|B. Bogart||May 5, 2005 8:52 am|
|Hans-Christoph Steiner||May 5, 2005 1:36 pm|
|Krzysztof Czaja||May 6, 2005 7:20 am|
|B. Bogart||May 6, 2005 8:06 am|
|B. Bogart||May 9, 2005 8:15 am|
|Subject:||Re: [PD-dev] pddp style guide|
|From:||Hans-Christoph Steiner (ha...@eds.org)|
|Date:||Apr 30, 2005 4:44:25 pm|
And I am totally grateful for the large amount of coding that you have done. And toxy totally changed the way I thought of Pd, from application to programming platform.
As for HTML docs, I don't understand why you want to separate the patches from the text. Yes, the text formatting abilities of Pd are pretty limited, but I think its very helpful to have the text right next to the running examples, instead of having to switch back and forth between applications. The SuperCollider docs are a great example of that. With a little more work on the [comment] object, I think we could have all of the text formatting capabilities that we'd really need to make very nice, linked help patches with texts, all within Pd.
Something like Miller's book, which goes much more into the theory behind what one does with Pd, is a good example of something that works much better in a proper text format.
On Apr 30, 2005, at 11:30 AM, Krzysztof Czaja wrote:
firstly -- I am very grateful for yours and Dave's work.
Secondly, imho it is better to rethink pddp now, before adding new contents. The original idea was that pddp should provide a consistent framework for at least three kinds of media: patches, html, and ps/pdf. The choice then was to either base it on docbook, or to design a very simple custom format. The latter never materialized, and certainly never will. Hardly being a docbook fan myself, I do not see any alternative...
Anyway, the worst thing that could happen, would be having all the reference pages, and ``more info'' propaganda embedded in Pd comments. There would be no other way of putting those on other media, than many days of hard manual work. The likely result of which would be forking of the pddp source.
Let us use patches as patches, and comments as comments.
A tricky part, besides tailoring docbook styles, is deciding about a mechanism for opening patches in Pd by invoking links in a html browser. The easiest way is including a simple httpd server in pd-gui. There is a ready to use 250-liner at http://cvs.sourceforge.net/viewcvs.py/tclhttpd/tclhttpd/bin/mini/
Hans-Christoph Steiner wrote: ...
If anyone is interested, it'd be great if we could work together to create the style guides. The way I currently see it there are two kinds of patches "all_about_" which has lots of text and examples, and the basic help patch, which should be a reference with a link to the relevant "all_about_" pages. float-help.pd from PDDP is a decent example of a reference patch.
As we enjoy great advantages from inventions of others, we should be glad of an opportunity to serve others by any invention of ours; and this we should do freely and generously. - Benjamin Franklin