OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.


Help: OASIS Mailing Lists Help | MarkMail Help

docbook-apps message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]

Subject: RE: [docbook-apps] Docbook workshop syllabi?

Sounds like for her target audience a demo of one or more working
systems with some bells and whistles/convenience features would be
appropriate to show what's possible once you have everything glued
together. It would need to be made clear that any one system shows one
possible solution and that there are many different ways to put together
a tool chain depending on your needs, budget, etc. 

Something I could see the community doing is posting some screencaps or
flash movies showing geewhiz features or integrations in their systems
along with some text explaining what the feature does. Here's my
contribution (the only flash movie I've gone to the trouble of making).
This shows how we use XMetaL's resource manager (a browser pane
integrated into the editor) along with some javascript to provide a
dynamic glossary. The user selects a term from the pane, clicks on it,
and it's inserted into the document as a glossterm with an id. At build
time, a glossary is generated using terms that have been added and any
terms used in the definitions of the manually added terms:
http://www.thingbag.net/docbook/swfs/glossary.htm It should be clear
that I'm a noobie at making flash demos...the pacing is all wrong :-)

Probably some samples of DocBook output run thorugh varous customization
layers would be helpful too so they can see what is possible there. E.g.
the same content in several pdf formats and varous flavors of html, etc.
Some integrations require too much background information to demo well
(e.g. if the content is dynamically generated from a database), it might
be hard to show/explain by someone who's not very familiar with the
system, but there should be plenty that can be demoed. 

Karen could then combine these into a presentation. I would enjoy seeing
and being inspired by what others have done with their systems. 


> -----Original Message-----
> From: DavePawson [mailto:davep@dpawson.co.uk] 
> Sent: Tuesday, February 10, 2009 9:35 AM
> To: Karen Schneider
> Cc: docbook-apps@lists.oasis-open.org
> Subject: Re: [docbook-apps] Docbook workshop syllabi?
> Karen Schneider wrote:
> > Has anyone developed a half-day workshop or one-or-two-hour 
> webinar on 
> > Docbook?
> > 
> > I work with a software project that is considering a 
> proposal to adopt 
> > Docbook for its documentation needs. It has been suggested that a 
> > workshop might help build buy-in and bring more people into the 
> > native-XML-production fold (versus producing documentation 
> on the wiki 
> > or in Word, the two formats now used for our project). Some of the 
> > topics considered for this workshop/webinar include 
> demonstrating the 
> > use of core elements in a model chapter, using 
> communications devices 
> > such as tips and callouts, and possibly even advanced 
> topics such as 
> > interacting with subversion, automating the transformation 
> to multiple 
> > formats, etc.
> > 
> > The goals would be that participants would walk away from 
> the workshop 
> > more familiar and comfortable with Docbook, and with a nice sample 
> > template in hand for those interested in making contributions.
> I've recently joined the DITA mailing list.
> The number of DITA workshops seems quite significant.
> We have the expertise on this list.
> 1. Has it been done at all?
> I know ndw has done 'overviews' and such like, but I don't 
> recall any Docbook workshops, Eu or US.
> 2. Has anyone presented such a workshop *and* prepared to 
> donate the material to Docbook?
> Karens goal seems quite modest.
>  > The goals would be that participants would walk away from 
> the workshop  > more familiar and comfortable with Docbook, 
> and with a nice sample  > template in hand for .....
> [Customizing Docbook output?]
> [Modifying the Docbook Schema]
>  >those interested in making contributions.
> Not sure what that last part means Karen?
> regards
> --
> Dave Pawson
> http://www.dpawson.co.uk
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: docbook-apps-unsubscribe@lists.oasis-open.org
> For additional commands, e-mail: 
> docbook-apps-help@lists.oasis-open.org

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]