RE: simplified docbook plugin (Was: Forrest run works but forrest doesn't)
> -Original Message- > From: Ross Gardler [mailto:[EMAIL PROTECTED] > Sent: Wednesday, August 03, 2005 3:06 PM > To: user@forrest.apache.org > Subject: Re: simplified docbook plugin (Was: Forrest run > works but forrest doesn't) > > Phillip Evans wrote: > > > > Thanks for your time on this. I have done as you outlined. After > > running forrest site in testSDocbook directory I again got > the message > > in the > > console: > > > > BROKEN: > > C:\apachefriends\xampp\htdocs\apache-forrest-0.7\plugins\plugins.xml > > > > > > However all the plugins appeared to be retrieved and > configured as you > > describe. > > Yes the plugin download mechanism doesn't use a local copy of > the file (neither does the docs build anymore, thanks to your > report above). > > > I checked the distribution zip file for forrest and found that > > \apache-forrest-0.7\plugins\plugins.xml was present, so > copied it to > > where it should have been in my installation. I re-ran forrest site > > without problems. > > How can it have been present in the distribution but not in > your installation? Is it safe for me to assume that this is a > problem local to you rather than in the distribution. Yes, safe to assume that. I have no explanation for it not being there in the installation, but a local problem, yes. > > I then ran forrest run in: > > > FORREST_HOME/build/plugins/org.apache.forrest.plugin.input.simplifiedD > > ocbook without problems, and could view sdocbook.html and .pdf > > > > I then tried adding one of my own sdocbook documents, and again had > > the problem of no content. I checked out input.xmap, and > found that it > > had a sourcetype of sdocbook-v1.0, whereas my documents are all > > sdocbook-v1.1 > > > > I assigned sdocbook-v1.0 to a couple of my documents, and > they worked fine. > > > > I suppose it is possible to modify input.xmap so that will accept > > sdocbook-v1.1 as well? > > > > Where should that be done? > > I've updated the plugin for version 4.1.2.5 of the plugin but > there isn't a released 1.1 version that I can see ( > http://www.oasis-open.org/docbook/xml/simple/ ). What is the > public identifier you are using? I've been using a version from docbook.org which although it says it is available at Oasis, actually isn't. It looks like I've mixed up the public identifier in the following. http://docbook.org/xml/simple/1.1/sdocbook.dtd";> Perhaps I should revert to v1.0 for my documents? > > Once I know what we need to add I'll update the plugin. If > you want to do this yourself (and supply a patch please) then > take a look at input.xmap The supported DTD's are listed at > the top of the file and you will need to add a matcher later > in the file, it is pretty much a cut and past job. > Phil
RE: simplified docbook plugin (Was: Forrest run works but forrest doesn't)
Ross, Thanks for your time on this. I have done as you outlined. After running forrest site in testSDocbook directory I again got the message in the console: BROKEN: C:\apachefriends\xampp\htdocs\apache-forrest-0.7\plugins\plugins.xml However all the plugins appeared to be retrieved and configured as you describe. I checked the distribution zip file for forrest and found that \apache-forrest-0.7\plugins\plugins.xml was present, so copied it to where it should have been in my installation. I re-ran forrest site without problems. I then ran forrest run in: FORREST_HOME/build/plugins/org.apache.forrest.plugin.input.simplifiedDocbook without problems, and could view sdocbook.html and .pdf I then tried adding one of my own sdocbook documents, and again had the problem of no content. I checked out input.xmap, and found that it had a sourcetype of sdocbook-v1.0, whereas my documents are all sdocbook-v1.1 I assigned sdocbook-v1.0 to a couple of my documents, and they worked fine. I suppose it is possible to modify input.xmap so that will accept sdocbook-v1.1 as well? Where should that be done? It may have been that downloading the plugins manually meant that they were not installed correctly. Might I suggest that on the initial plugins page on forrest.apache.org that a indication be placed above the download section that this is normally done automatically by forrest, rather than having to follow a link to a second page to find this out. Still, I have learned heaps more than I would have if it had all gone smoothly, as it obviously does if done right. Next time, read the instructions, Phillip, read the instructions. Now to try out the testSDocbook site with some of my documents. Thanks again, Ross. I am using forrest-0.7 -Original Message- From: Ross Gardler [mailto:[EMAIL PROTECTED] Sent: Wednesday, August 03, 2005 2:53 AM To: user@forrest.apache.org Subject: Re: simplified docbook plugin (Was: Forrest run works but forrest doesn't) Phillip Evans wrote: > OK, here is the process I followed and the issues that I have found > while getting forrest to work with sdocbook. Once we have verified that this works (or debugged why it doesn't work) we'll get your sdocbook files working in the new sample site we did. Ross
RE: simplified docbook plugin (Was: Forrest run works but forrest doesn't)
OK, here is the process I followed and the issues that I have found while getting forrest to work with sdocbook. I edited forrest.properties to include the sdocbook plugin and the Open Office plugin. I put a (validated) sdocbook file and an Open Office document into 'sample' directory of a freshly seeded site. (I also added some sdocbook files to a 'manuals' subdirectory of 'sample') I edited site.xml to give LH Navigation to these documents. I ran 'forrest' to build a static site. The build was unsuccessful due to some broken links. I downloaded plugin.xml from forrest.apache.org into the plugins directory as the build said that file was missing. (It took me a while to figure that out) I then got a successful build. The Open Office document converted OK,(except for images) but the sdocbook page had only the header and LH Navigation, no content. The build listing shows all plugins being available and mounts them. Following the documentation from "V5.2. How do I use DocBook as the xml documentation format?" as best as I was able with my limited knowledge, I made the following changes to sitemap.xmap in src/documentation/ : I added the following -- -- After this existing section: -- -- I added this: -- -- And I added this section: -- -- After which everything worked. I had presumed that just declaring the sdocbook plugin would do the trick. I needed to move sdocbook2document.xsl because of the mailto:[EMAIL PROTECTED] Sent: Tuesday, August 02, 2005 8:22 PM To: user@forrest.apache.org Subject: simplified docbook plugin (Was: Forrest run works but forrest doesn't) > > It would skin blank pages until I moved that file. > Is this due to a configuration error on my part? Sorry i don't understand what you mean. Have you declared the simplifiedDocbook plugin in your forrest.properties file? David > Anyway, thank you for your assistance > > Phil >
RE: Forrest run works but forrest doesn't
>What do you mean by "edit styles"? Two things really. There are some aspects of the sdocbook conversion that don't seem to be handled well by sdocbook2document.xsl, but you are right, I don't know enough to make any beneficial changes there. I really need a docbook2document.xsl in the longer term. I understand that there used to be one, but I can't seem to find it in the current release. By the way, forrest did not handle the sdocbook conversion until I moved 'sdocbook2document.xsl' to: \site\src\documentation\resources\stylesheets\sdocbook2document.xsl It would skin blank pages until I moved that file. Is this due to a configuration error on my part? The other aspect is editing the css, and that is made interesting through the Firefox plugin as described in the howto's. >I suggest waiting until you understand a bit more before trying to write documentation for others. Yes, you are right, but sometimes a bit of naivety can uncover some of the assumptions that us mere footsloggers get stuck on. After several days of struggle since starting from scratch, with very little to show for it, I was very close to giving the exercise up as being beyond my grasp. But now, I'm very happy with a usable result that I can fine-tune. Anyway, thank you for your assistance Phil
RE: Forrest run works but forrest doesn't
I created a new seed site and started from scratch and the problem has disappeared. I must have broken something with my tinkering previously. That's the trouble with not really knowing what I am doing. I'm still having problems with some images not rendering correctly in PDF, and with one document that won't render in PDF at all, but now at least I have something to play with. I now need to figure out where, and how, to edit styles for sdocbook. Would it be of any help to other beginners for me to document what I have done that worked? I must admit I found the documentation seemed to assume a bit more knowledge than I started with. Of course, I could just be leading myself up the garden path. Phil -Original Message- From: Diwaker Gupta [mailto:[EMAIL PROTECTED] Sent: Tuesday, August 02, 2005 3:26 PM To: user@forrest.apache.org Subject: Re: Forrest run works but forrest doesn't On Monday 01 August 2005 8:23 pm, Phillip Evans wrote: > I am running under windows xp. I am running 'forrest' and 'forrest run' > from the site directory that I ran forrest seed in. $FORREST_HOME is > set to the directory above the site directory, ie > 'apache-forrest-0.7'. Listed below is the broken links file generated > by the build, the majority of which I am guessing relates to the failure to generate the LH Navigation. Can you please paste the output of a "forrest site". My guess is that this is a plugin related issue, but I'd rather not speculate without further evidence. > My next step is to start a new seed site and apply my changes one step > at a time and test with both 'forrest run' and 'forrest' at each > stage. What better way to learn? Yes, the very first test should be that you are able to seed a fresh project and run Forrest in both static and dynamic modes without any errors. If that works, then something specific to your project is causing problems (forrest.properties, skinconf, validation etc). Diwaker -- Web/Blog/Gallery: http://floatingsun.net
RE: Forrest run works but forrest doesn't
I am running under windows xp. I am running 'forrest' and 'forrest run' from the site directory that I ran forrest seed in. $FORREST_HOME is set to the directory above the site directory, ie 'apache-forrest-0.7'. Listed below is the broken links file generated by the build, the majority of which I am guessing relates to the failure to generate the LH Navigation. I did a lot of playing around to get sdocbook files working under 'forrest run', even with the sdocbook plugin, so I probably made some changes that affected 'the 'forrest' command that I didn't reverse. My next step is to start a new seed site and apply my changes one step at a time and test with both 'forrest run' and 'forrest' at each stage. What better way to learn? - - - - - - - - - - - - - - - - - -Original Message- From: CFAS Webmaster [mailto:[EMAIL PROTECTED] Sent: Tuesday, August 02, 2005 12:09 PM To: user@forrest.apache.org Subject: Re: Forrest run works but forrest doesn't Phil, What error is forrest giving? From where are you running either command and to what directory is $FORREST_HOME set, if any? I can't remember seeing this behavior so I don't have any additional ideas right now. A copy & paste of the failed command would help. -Paul Phillip Evans wrote: > >A rank beginner here. It's taken a while but I have forrest accepting >sdocbook files, and rendering them in both html and pdf, (with a bit of >a problem but more on that later) This works ok with the 'forrest run' >command but with 'forrest' the build fails, with none of the new >documents included in the static site, only the documents from the >original 'seed' are rendered. The LH menu doesn't appear either, >whereas using 'forrest run' it does. > >Can someone point me to documentation that might assist me? I'm >guessing its something simple in the setup that I have missed, but I >seem to be reading the same thing over and over with no flashes of inspiration. My head hurts. > >PhilE > > > >
Forrest run works but forrest doesn't
A rank beginner here. It's taken a while but I have forrest accepting sdocbook files, and rendering them in both html and pdf, (with a bit of a problem but more on that later) This works ok with the 'forrest run' command but with 'forrest' the build fails, with none of the new documents included in the static site, only the documents from the original 'seed' are rendered. The LH menu doesn't appear either, whereas using 'forrest run' it does. Can someone point me to documentation that might assist me? I'm guessing its something simple in the setup that I have missed, but I seem to be reading the same thing over and over with no flashes of inspiration. My head hurts. PhilE
