Posting examples on the wiki

Hi,

I've wanted to browse through examples from other people's
publishing
tool chains on many occasions over the past few years. 
Today I spent
some time figuring out a particular xi:include technique and
now that I
have it, I'd like to post it somewhere.  I see in the
archives, this
subject has come up before.

Is there a more commonly used wiki for DocBook publishing
techniques
than this one?

http://wiki.d
ocbook.org/topic/FrontPage

If that's the one, is there a spot in it for posting
miscellaneous
stylesheet customizations or other publishing tricks?  I
don't see one
so unless there's a more appropriate wiki, I would create a
new topic
for that.

Does anyone feel that miscellaneous publishing system
snippets *should
not* be shared on the DocBook wiki?  Clearly, code from my
stylesheets,
content, or publishing scripts will not necessarily work for
anyone
else.  However, I learn best from concrete examples that I
can modify
for my own environment.

Thanks for your guidance.

Peter Desjardins

------------------------------------------------------------
---------
To unsubscribe, e-mail: docbook-apps-unsubscribelists.oasis-open.org
For additional commands, e-mail: docbook-apps-helplists.oasis-open.org

Peter Desjardins <pdesjardinssupplyscape.com>,
2007-09-18 09:58 -0400:

> I've wanted to browse through examples from other
people's publishing
> tool chains on many occasions over the past few years. 
Today I spent
> some time figuring out a particular xi:include
technique and now that I
> have it, I'd like to post it somewhere.  I see in the
archives, this
> subject has come up before.
> 
> Is there a more commonly used wiki for DocBook
publishing techniques
> than this one?
> 
> http://wiki.d
ocbook.org/topic/FrontPage

Nope, that's the one.

> If that's the one, is there a spot in it for posting
miscellaneous
> stylesheet customizations or other publishing tricks? 
I don't see one
> so unless there's a more appropriate wiki, I would
create a new topic
> for that.

There is no existing topic for it yet, so I think it would
be
great if you could create one and post an announcement to
the
list after you've added some content to it.

  --Mike

-- 
Michael(tm) Smith
http://people.w3.org/mike/

http://sideshowbarker.net/

Peter,

I've had the same experience myself (combing through the
list archives),
  and I've considered starting such a page on the wiki (see
the
docbook-apps thread "customization layer for DocBook
5.0: The Transition
Guide") using a cookbook-style approach. Concrete
examples are a great
way to learn.

I sort of dropped the ball--lots of things going on here at
work--but
let's do it! I think others are interested too (Dick
Hamilton, etc). If
you have access, Peter, go ahead and create a new topic page
on the
wiki. What should it be called? DocBookCustomizations might
work, but
it's sort of system-centered. Maybe DocBookCookbook ?

Cheers,

Brett

On 9/18/2007 9:58 AM, Peter Desjardins wrote:
> Hi,
> 
> I've wanted to browse through examples from other
people's publishing
> tool chains on many occasions over the past few years. 
Today I spent
> some time figuring out a particular xi:include
technique and now that I
> have it, I'd like to post it somewhere.  I see in the
archives, this
> subject has come up before.
> 
> Is there a more commonly used wiki for DocBook
publishing techniques
> than this one?
> 
> http://wiki.d
ocbook.org/topic/FrontPage
> 
> If that's the one, is there a spot in it for posting
miscellaneous
> stylesheet customizations or other publishing tricks? 
I don't see one
> so unless there's a more appropriate wiki, I would
create a new topic
> for that.
> 
> Does anyone feel that miscellaneous publishing system
snippets *should
> not* be shared on the DocBook wiki?  Clearly, code from
my stylesheets,
> content, or publishing scripts will not necessarily
work for anyone
> else.  However, I learn best from concrete examples
that I can modify
> for my own environment.
> 
> Thanks for your guidance.
> 
> Peter Desjardins



------------------------------------------------------------
---------
To unsubscribe, e-mail: docbook-apps-unsubscribelists.oasis-open.org
For additional commands, e-mail: docbook-apps-helplists.oasis-open.org

DocBookCustomizations is too generic and appears to refer to
the XSL.

Go with DocBookCookbook. Unless, of course, you prefer 

	DocBookCookingTheBooks

 

-----Original Message-----
From: Brett Leber [mailto:bleber+cs.cmu.edu] 
Sent: Wednesday, September 19, 2007 9:26 AM
To: Peter Desjardins
Cc: docbook-appslists.oasis-open.org
Subject: Re: [docbook-apps] Posting examples on the wiki

Peter,

I've had the same experience myself (combing through the
list archives),
  and I've considered starting such a page on the wiki (see
the
docbook-apps thread "customization layer for DocBook
5.0: The Transition
Guide") using a cookbook-style approach. Concrete
examples are a great
way to learn.

I sort of dropped the ball--lots of things going on here at
work--but
let's do it! I think others are interested too (Dick
Hamilton, etc). If
you have access, Peter, go ahead and create a new topic page
on the
wiki. What should it be called? DocBookCustomizations might
work, but
it's sort of system-centered. Maybe DocBookCookbook ?

Cheers,

Brett

On 9/18/2007 9:58 AM, Peter Desjardins wrote:
> Hi,
> 
> I've wanted to browse through examples from other
people's publishing
> tool chains on many occasions over the past few years. 
Today I spent
> some time figuring out a particular xi:include
technique and now that I
> have it, I'd like to post it somewhere.  I see in the
archives, this
> subject has come up before.
> 
> Is there a more commonly used wiki for DocBook
publishing techniques
> than this one?
> 
> http://wiki.d
ocbook.org/topic/FrontPage
> 
> If that's the one, is there a spot in it for posting
miscellaneous
> stylesheet customizations or other publishing tricks? 
I don't see one
> so unless there's a more appropriate wiki, I would
create a new topic
> for that.
> 
> Does anyone feel that miscellaneous publishing system
snippets *should
> not* be shared on the DocBook wiki?  Clearly, code from
my stylesheets,
> content, or publishing scripts will not necessarily
work for anyone
> else.  However, I learn best from concrete examples
that I can modify
> for my own environment.
> 
> Thanks for your guidance.
> 
> Peter Desjardins



------------------------------------------------------------
---------
To unsubscribe, e-mail: docbook-apps-unsubscribelists.oasis-open.org
For additional commands, e-mail: docbook-apps-helplists.oasis-open.org


------------------------------------------------------------
---------
To unsubscribe, e-mail: docbook-apps-unsubscribelists.oasis-open.org
For additional commands, e-mail: docbook-apps-helplists.oasis-open.org

On 19/09/2007, Barton Wright <barton.wrightstreambase.com> wrote:
> DocBookCustomizations is too generic and appears to
refer to the XSL.
>
> Go with DocBookCookbook. Unless, of course, you prefer
>
>         DocBookCookingTheBooks

How about

Cooking with Docbook?


S

------------------------------------------------------------
---------
To unsubscribe, e-mail: docbook-apps-unsubscribelists.oasis-open.org
For additional commands, e-mail: docbook-apps-helplists.oasis-open.org

I have created a new page on the DocBook wiki to hold
examples of
publishing system code.  

http://
wiki.docbook.org/topic/DocBookCookbook

I just posted some xi:include syntax that I am using.  

My instinct is to keep all content on one page until it
grows.  Then
break it into separate pages in a way that seems logical
based on what
content is there.  That's why I made only one page.

I plan to post some of the XSL customizations that took me
some time to
figure out.  I hope others will do the same.

Peter Desjardins

------------------------------------------------------------
---------
To unsubscribe, e-mail: docbook-apps-unsubscribelists.oasis-open.org
For additional commands, e-mail: docbook-apps-helplists.oasis-open.org