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] Re: [docbook-apps] DocBook specializations


For those who want to customize a DocBook DTD, I made a presentation at an
O'Reilly conference about best practices for doing so.  I added a link to
my slides from the Wiki page on DocBookCustomization:

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

Slides are not complete instructions, of course, but they might help you
sort out where to make a certain change, especially with regard to the
parameter entities with "class" and "mix" in their names.

I include links to LiveDTD as well, a utility which helps you see which
declaration for an item is the active one (live links) and which have been
preempted by the customization.

Bob Stayton
Sagehill Enterprises
DocBook Consulting
bobs@sagehill.net


----- Original Message ----- 
From: "Camille Bégnis" <camille@neodoc.biz>
To: "docbooklist" <docbook@lists.oasis-open.org>
Cc: <docbook-apps@lists.oasis-open.org>
Sent: Thursday, March 02, 2006 7:46 AM
Subject: [docbook] Re: [docbook-apps] DocBook specializations


> -----BEGIN PGP SIGNED MESSAGE-----
> Hash: SHA1
>
> [I just realized this thread should go to docbook@, sorry for
cross-posting]
>
> I just created such page (to be filled), but I thought anyone registered
> could create new pages? Please ask me if needed, I think I can add
> people to the authors list (UserGroup).
>
> http://wiki.docbook.org/topic/DocBookSpecializations
>
> Camille.
>
> cstrong@arielpartners.com a écrit :
> > I and others on this list have already traded specializations and even
> > made an attempt at coming up with packaging guidelines.
> >
> > Based on my experiences with other open source products (Ant, Zope,
Cocoon,
> > Struts, Emacs, etc.) having a library of optional add-ons is an
important
> > factor in speeding adoption/attracting new users.  For open source, the
> > size of the community is perhaps the single most important factor, for
> > many obvious reasons.
> >
> > The most successful of the projects I mentioned above had one thing in
> > common--they had something akin to the "specializations repository"
> > mentioned below.  There were many variations in how it was done,
however.
> >
> > There are many second order benefits to this.  Specializations that
> > become very popular often end up migrating (in some form) to the core.
> > After all, open source users vote with their feet.
> >
> > We could start very simply by having a "specializations" page on the
docbook
> > wiki that includes a set of links.  Having the ability to upload
> > a zip file containing the package would be nice.  Bigger packages
> > could live on sourceforge.  The specializations page could be more than
> > a list; it could include a couple of guidelines, best practices, etc.
> >
> > If someone with privileges would create such a page, I would be willing
> > to contribute to it (a) draft1 of some guidelines and (b) a first
example
> > package.
> >
> > Oh-- we might need two wiki areas.  I am only talking about Docbook5.
> > Some other motivated person will have to take the lead for Docbook < 5.
> > :-)
> >
> > Regards,
> >
> > --Craeg
> >
> >
> >
> >>> Would it makes sense to provide customization developers a best
> >>> practices guide, and a "DocBook Specializations Repository" where
people
> >>> could contribute their customized schemas and stylesheets to handle
> >>> specific requirements, by metier for example?
> >> This idea is worth, but is there anyone who can devote his/her free
time
> >> for this project? Or fund development of such guide and repository?
> >>
> >
> >
> > ---------------------------------------------------------------------
> > To unsubscribe, e-mail: docbook-apps-unsubscribe@lists.oasis-open.org
> > For additional commands, e-mail: docbook-apps-help@lists.oasis-open.org
> >
> -----BEGIN PGP SIGNATURE-----
> Version: GnuPG v1.4.2 (GNU/Linux)
> Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org
>
> iD8DBQFEBxNrjv9P65BfOUMRAnj6AJ9vmvVHztQEQNAu1l1IAxIMlUjbHwCeN83e
> z2kykzw2PhxogGxx7+jZrws=
> =CjNt
> -----END PGP SIGNATURE-----
>


---------------------------------------------------------------------------
-----


> ---------------------------------------------------------------------
> To unsubscribe, e-mail: docbook-unsubscribe@lists.oasis-open.org
> For additional commands, e-mail: docbook-help@lists.oasis-open.org




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