Hi Mike, Sorry for the puzzle, you're the first to work on this since Eric Lowe, so bear with me while I get you started. Eric, if you have a minute, can you answer Mike's question #2 below about the XSL directory and Makefile, so he'll know how to proceed? Thanks in advance! My comments inline below:
Mike Kupfer wrote: > I'm working on some code changes that should be reflected in the > Developers Reference. I thought I would try downloading the DevRef > source so that I could submit an XML patch, but after poking around the > docs community pages, I'm feeling puzzled and confused. > > 1. I've downloaded devref-xml.20070412.tar.gz. Do I use the DTD in > devref-xml.20070412, or do I use the DTD in the template_file.tar > file that > http://www.opensolaris.org/os/community/documentation/doc_collab/templates/ > links to? > > Use the DTD in devref-xml.20070412, this goes for all the source documents, I will try to make this more explicit on the template information page. Thanks for the feedback. > 2. The comments in devref-xml.20070412/Makefile point me at > http://sourceforge.net/project/showfiles.php?group_id=21935#files, > but they don't tell me what I should download. I had assumed it was > the docbook5-xsl package, but when I unpack it, I don't see the XSL > subdirectory that the Makefile comments refer to. The templates page > > (http://www.opensolaris.org/os/community/documentation/doc_collab/templates/) > links to the docbook-xsl package (rather than docbook5-xsl), but that > package doesn't have an XSL directory, either. (This could explain > why Rainer was having problems building the DevRef...) > It should be docbook5-XSL package. Thanks for helping us get to the bottom of this... > I'm thinking that the DevRef makefile needs to be updated to track > the current structure of the docbook package(s). But I'd like some > confirmation that I'm on the right track before I spend more time on > this. And which package should it be: docbook5-xsl or docbook-xsl? > Hmm, I'm not sure because I'm looking at the 1.70 version of the docbook-xsl and it doesn't have an XSL directory either, so I'm stumped right now, will dig around some more to jog my memory. We were using a tool to generate the HTML for the other books, and I know Eric had this book working, but I'll need to check through my histories. I think what you suggest is the way to go, and Eric will know for sure. Apologies for the delay, I do appreciate your help with this one. BTW, not sure if you know that this book has been translated via the Portals project, so if you can note the changes you make, I can help to get them updated in the Japanese version also. -Michelle > thanks, > mike > _______________________________________________ > docs-discuss mailing list > docs-discuss at opensolaris.org >
