[ http://opensource.atlassian.com/projects/hibernate/browse/HHH-5525?page=c... ] Steve Ebersole commented on HHH-5525: ------------------------------------- Ugh. http://confluence.jetbrains.net/display/CONTEST/RELAX-NG+Support?focusedC... http://devnet.jetbrains.net/thread/290551 -- This message is automatically generated by JIRA. - If you think it was sent incorrectly contact one of the administrators: http://opensource.atlassian.com/projects/hibernate/secure/Administrators.... - For more information on JIRA, see: http://www.atlassian.com/software/jira

[ http://opensource.atlassian.com/projects/hibernate/browse/HHH-5525?page=c... ] Steve Ebersole commented on HHH-5525: ------------------------------------- The issue from my last comment was specific to {{<info/>}}. Personally I never liked splitting the older {{<bookinfo/>}} tag into its own file anyway, so I dont really care about that. Folding Book_Info.xml back into the main doc as {{<info/>}} got around that issue. And the other tags we use as top-level in file did not have same issue. However, I am rolling back my local work here as this will require some jDocBook work to properly support. Here is the basic structure for using version 5: {code} <?xml version='1.0' encoding='utf-8' ?> <!DOCTYPE book [ <!ENTITY % BOOK_ENTITIES SYSTEM "Hibernate_Getting_Started_Guide.ent"> %BOOK_ENTITIES; ]> <book version="5.0" xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude" xmlns:xlink="http://www.w3.org/1999/xlink"> ... </book> {code} -- This message is automatically generated by JIRA. - If you think it was sent incorrectly contact one of the administrators: http://opensource.atlassian.com/projects/hibernate/secure/Administrators.... - For more information on JIRA, see: http://www.atlassian.com/software/jira

[ http://opensource.atlassian.com/projects/hibernate/browse/HHH-5525?page=c... ] Misty Stanley-Jones commented on HHH-5525: ------------------------------------------ It is easy enough to use procedures for now, and convert them to topics after the toolchain can handle Docbook 5. -- This message is automatically generated by JIRA. - If you think it was sent incorrectly contact one of the administrators: http://opensource.atlassian.com/projects/hibernate/secure/Administrators.... - For more information on JIRA, see: http://www.atlassian.com/software/jira

[ http://opensource.atlassian.com/projects/hibernate/browse/HHH-5525?page=c... ] Misty Stanley-Jones commented on HHH-5525: ------------------------------------------ How do you propose to present step-by-step instructions? I've seen people using itemizedlists and variablelists, but procedures present the best of both worlds. The one-line instruction can be set as the step title, and the details can go into a <para>. How would you prefer for them to render? It's better to fix the problem than to throw the baby out with the bathwater. -- This message is automatically generated by JIRA. - If you think it was sent incorrectly contact one of the administrators: http://opensource.atlassian.com/projects/hibernate/secure/Administrators.... - For more information on JIRA, see: http://www.atlassian.com/software/jira

[ http://opensource.atlassian.com/projects/hibernate/browse/HHH-5525?page=c... ] Misty Stanley-Jones commented on HHH-5525: ------------------------------------------ Good point, I suppose it may not be necessary if the instructions are more along the lines of pointing out juicy bits of the code they already have in front of them. I'm hoping to do some more hacking on the GSG this afternoon. I keep getting given more work (as do we all, I'm sure)! -- This message is automatically generated by JIRA. - If you think it was sent incorrectly contact one of the administrators: http://opensource.atlassian.com/projects/hibernate/secure/Administrators.... - For more information on JIRA, see: http://www.atlassian.com/software/jira

[ http://opensource.atlassian.com/projects/hibernate/browse/HHH-5525?page=c... ] Steve Ebersole commented on HHH-5525: ------------------------------------- Ok, I started looking at this in earnest today and wanted to document issues I ran into as I run into them so that we hopefully have a more detailed trail of what specifically needs to get done. First issue is that the gradle jdocbook plugin does not seem to be doing anything (or its not doing what I anticipated) with "transformerParameters". I need to override the 'html.stylesheet' XSLT parameter (as defined in http://anonsvn.jboss.org/repos/pressgang/pressgang-tools/trunk/pressgang-...) but my attempts so far have had no luck. -- This message is automatically generated by JIRA. For more information on JIRA, see: http://www.atlassian.com/software/jira

[ http://opensource.atlassian.com/projects/hibernate/browse/HHH-5525?page=c... ] Steve Ebersole commented on HHH-5525: ------------------------------------- Another issue: https://issues.jboss.org/browse/JDOCBOOKSTYLE-36 Basically the PressGang XSLT is not rendering the book title/subtitle for the html-single format (but does for html format). -- This message is automatically generated by JIRA. For more information on JIRA, see: http://www.atlassian.com/software/jira