Re: [lang] web site
Henri Yandell wrote: The psteitz Lang docs aren't there anymore it seems. Do they completely replicate the current Lang page for information? Yes. I just copied lang.xml from the commons xdocs and adjusted a couple of links. If you update lang to grab the /xdocs and run maven site:generate locally, you should see the same thing, modulo some reports that I commented out when I generated what I posted earlier. I will do the site update this weekend if there are no objections. Phil Hen On Mon, 3 Nov 2003, __matthewHawthorne wrote: I successfully performed a 'maven site:deploy' for [io] a few weeks ago without a problem. As long at and are correct, it should go smoothly. I would suggest doing it on cvs.apache.org, since you'll avoid the overhead of copying the site across the network - but either way works fine. Either remotely or locally on cvs.apache.org, should be /www/jakarta.apache.org/commons/lang, which I would assume it already is. Phil Steitz wrote: __matthewHawthorne wrote: I don't think that the HTML for each commons project's site is stored in CVS, only the main commons HTML. Log in to cvs.apache.org, cd to /www/jakarta.apache.org/commons and do a 'cvs diff', you'll see what I mean. Also, as long as the is correct in lang's project.xml, you shouldn't have to copy the site docs manually to /www/jakarta.apache.org/commons/lang - doing a 'maven site:deploy' remotely or 'maven site:generate site:fsdeploy' while on cvs.apache.org should put the files in the correct place. If running remotely, a username property needs to be set, but I can't find the exact name in the docs. It'll tell you if you don't have it set. Thanks! Have you (anyone?) done either of the maven deployment steps above successfully? Call me a wimp, but given the strange behavior that I have sometimes seen from maven, I am hesitant to be the first to try this on cvs.apache.org. If I do the deploy from cvs.apache.org, what should be? Everything else looked correct to me. I don't think it's silly to do this now - I haven't heard anything about the main site becoming mavenized anytime soon. Phil Steitz wrote: I have put a first cut at a "mavenized" lang site at http://www.apache.org/~psteitz/docs/ There is nothing new or different in terms of content. Comments welcome. There are a couple of errors that I know about -- the link in the upper right does not work and should be replaced by the Commons logo image and incl_nav has not been updated to reflect the recent promotions of math and dbutils. I will make these changes. Modulo a little clean up, I would like to publish this to the public site. I would appreciate confirmation (or gentle indication that I am out of my mind) re the following steps to accomplish this: 1. Add xdocs directory to jakarta-commons/lang cvs including the files used to make the maven site. 2, Remove lang.xml from jakarta-commons/xdocs (this is replaced by index.xml in jakarta-commons/lang/xdocs). 3. Edit jakarta-commons/xdocs/components.xml and jakarta-commons/stylesheets/menus/components.xml to remove references to lang.html 4. Follow the instructions in jakarta-commons/BUILD_DOCS.txt to build the main commons site locally, commit the changes and update the site. I have done this successfully up to the commit. 5. Generate the mavenized [lang] site locally and move the files manually to /www/jakarta.apache.org/commons/lang. The last step seems odd to me, since we seem to be storing HTML in CVS for all of the of the non-maven sites. Did I miss anything? Is it silly to do this before moving the main site to maven? Are we planning to migrate the main site soon? Phil - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED] - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED] - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED] - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
Re: [lang] web site
The psteitz Lang docs aren't there anymore it seems. Do they completely replicate the current Lang page for information? Hen On Mon, 3 Nov 2003, __matthewHawthorne wrote: > I successfully performed a 'maven site:deploy' for [io] a few weeks ago > without a problem. As long at and are > correct, it should go smoothly. I would suggest doing it on > cvs.apache.org, since you'll avoid the overhead of copying the site > across the network - but either way works fine. > > Either remotely or locally on cvs.apache.org, should be > /www/jakarta.apache.org/commons/lang, which I would assume it already is. > > > > > Phil Steitz wrote: > > __matthewHawthorne wrote: > > > >> I don't think that the HTML for each commons project's site is stored > >> in CVS, only the main commons HTML. Log in to cvs.apache.org, cd to > >> /www/jakarta.apache.org/commons and do a 'cvs diff', you'll see what I > >> mean. > >> > >> Also, as long as the is correct in lang's project.xml, > >> you shouldn't have to copy the site docs manually to > >> /www/jakarta.apache.org/commons/lang - doing a 'maven site:deploy' > >> remotely or 'maven site:generate site:fsdeploy' while on > >> cvs.apache.org should put the files in the correct place. If running > >> remotely, a username property needs to be set, but I can't find the > >> exact name in the docs. It'll tell you if you don't have it set. > > > > > > Thanks! Have you (anyone?) done either of the maven deployment steps > > above successfully? Call me a wimp, but given the strange behavior that > > I have sometimes seen from maven, I am hesitant to be the first to try > > this on cvs.apache.org. > > > > If I do the deploy from cvs.apache.org, what should be? > > > >> > >> Everything else looked correct to me. I don't think it's silly to do > >> this now - I haven't heard anything about the main site becoming > >> mavenized anytime soon. > >> > >> > >> > >> > >> Phil Steitz wrote: > >> > >>> I have put a first cut at a "mavenized" lang site at > >>> http://www.apache.org/~psteitz/docs/ > >>> > >>> There is nothing new or different in terms of content. Comments > >>> welcome. There are a couple of errors that I know about -- the link > >>> in the upper right does not work and should be replaced by the > >>> Commons logo image and incl_nav has not been updated to reflect the > >>> recent promotions of math and dbutils. I will make these changes. > >>> > >>> Modulo a little clean up, I would like to publish this to the public > >>> site. I would appreciate confirmation (or gentle indication that I > >>> am out of my mind) re the following steps to accomplish this: > >>> > >>> 1. Add xdocs directory to jakarta-commons/lang cvs including the > >>> files used to make the maven site. > >>> > >>> 2, Remove lang.xml from jakarta-commons/xdocs (this is replaced by > >>> index.xml in jakarta-commons/lang/xdocs). > >>> > >>> 3. Edit jakarta-commons/xdocs/components.xml and > >>> jakarta-commons/stylesheets/menus/components.xml to remove references > >>> to lang.html > >>> > >>> 4. Follow the instructions in jakarta-commons/BUILD_DOCS.txt to build > >>> the main commons site locally, commit the changes and update the > >>> site. I have done this successfully up to the commit. > >>> > >>> 5. Generate the mavenized [lang] site locally and move the files > >>> manually to /www/jakarta.apache.org/commons/lang. > >>> > >>> The last step seems odd to me, since we seem to be storing HTML in > >>> CVS for all of the of the non-maven sites. > >>> > >>> Did I miss anything? Is it silly to do this before moving the main > >>> site to maven? Are we planning to migrate the main site soon? > >>> > >>> Phil > >> > >> > >> > >> > >> - > >> To unsubscribe, e-mail: [EMAIL PROTECTED] > >> For additional commands, e-mail: [EMAIL PROTECTED] > >> > > > - > To unsubscribe, e-mail: [EMAIL PROTECTED] > For additional commands, e-mail: [EMAIL PROTECTED] > - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
Re: [lang] web site
I successfully performed a 'maven site:deploy' for [io] a few weeks ago without a problem. As long at and are correct, it should go smoothly. I would suggest doing it on cvs.apache.org, since you'll avoid the overhead of copying the site across the network - but either way works fine. Either remotely or locally on cvs.apache.org, should be /www/jakarta.apache.org/commons/lang, which I would assume it already is. Phil Steitz wrote: __matthewHawthorne wrote: I don't think that the HTML for each commons project's site is stored in CVS, only the main commons HTML. Log in to cvs.apache.org, cd to /www/jakarta.apache.org/commons and do a 'cvs diff', you'll see what I mean. Also, as long as the is correct in lang's project.xml, you shouldn't have to copy the site docs manually to /www/jakarta.apache.org/commons/lang - doing a 'maven site:deploy' remotely or 'maven site:generate site:fsdeploy' while on cvs.apache.org should put the files in the correct place. If running remotely, a username property needs to be set, but I can't find the exact name in the docs. It'll tell you if you don't have it set. Thanks! Have you (anyone?) done either of the maven deployment steps above successfully? Call me a wimp, but given the strange behavior that I have sometimes seen from maven, I am hesitant to be the first to try this on cvs.apache.org. If I do the deploy from cvs.apache.org, what should be? Everything else looked correct to me. I don't think it's silly to do this now - I haven't heard anything about the main site becoming mavenized anytime soon. Phil Steitz wrote: I have put a first cut at a "mavenized" lang site at http://www.apache.org/~psteitz/docs/ There is nothing new or different in terms of content. Comments welcome. There are a couple of errors that I know about -- the link in the upper right does not work and should be replaced by the Commons logo image and incl_nav has not been updated to reflect the recent promotions of math and dbutils. I will make these changes. Modulo a little clean up, I would like to publish this to the public site. I would appreciate confirmation (or gentle indication that I am out of my mind) re the following steps to accomplish this: 1. Add xdocs directory to jakarta-commons/lang cvs including the files used to make the maven site. 2, Remove lang.xml from jakarta-commons/xdocs (this is replaced by index.xml in jakarta-commons/lang/xdocs). 3. Edit jakarta-commons/xdocs/components.xml and jakarta-commons/stylesheets/menus/components.xml to remove references to lang.html 4. Follow the instructions in jakarta-commons/BUILD_DOCS.txt to build the main commons site locally, commit the changes and update the site. I have done this successfully up to the commit. 5. Generate the mavenized [lang] site locally and move the files manually to /www/jakarta.apache.org/commons/lang. The last step seems odd to me, since we seem to be storing HTML in CVS for all of the of the non-maven sites. Did I miss anything? Is it silly to do this before moving the main site to maven? Are we planning to migrate the main site soon? Phil - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED] - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
Re: [lang] web site
__matthewHawthorne wrote: I don't think that the HTML for each commons project's site is stored in CVS, only the main commons HTML. Log in to cvs.apache.org, cd to /www/jakarta.apache.org/commons and do a 'cvs diff', you'll see what I mean. Also, as long as the is correct in lang's project.xml, you shouldn't have to copy the site docs manually to /www/jakarta.apache.org/commons/lang - doing a 'maven site:deploy' remotely or 'maven site:generate site:fsdeploy' while on cvs.apache.org should put the files in the correct place. If running remotely, a username property needs to be set, but I can't find the exact name in the docs. It'll tell you if you don't have it set. Thanks! Have you (anyone?) done either of the maven deployment steps above successfully? Call me a wimp, but given the strange behavior that I have sometimes seen from maven, I am hesitant to be the first to try this on cvs.apache.org. If I do the deploy from cvs.apache.org, what should be? Everything else looked correct to me. I don't think it's silly to do this now - I haven't heard anything about the main site becoming mavenized anytime soon. Phil Steitz wrote: I have put a first cut at a "mavenized" lang site at http://www.apache.org/~psteitz/docs/ There is nothing new or different in terms of content. Comments welcome. There are a couple of errors that I know about -- the link in the upper right does not work and should be replaced by the Commons logo image and incl_nav has not been updated to reflect the recent promotions of math and dbutils. I will make these changes. Modulo a little clean up, I would like to publish this to the public site. I would appreciate confirmation (or gentle indication that I am out of my mind) re the following steps to accomplish this: 1. Add xdocs directory to jakarta-commons/lang cvs including the files used to make the maven site. 2, Remove lang.xml from jakarta-commons/xdocs (this is replaced by index.xml in jakarta-commons/lang/xdocs). 3. Edit jakarta-commons/xdocs/components.xml and jakarta-commons/stylesheets/menus/components.xml to remove references to lang.html 4. Follow the instructions in jakarta-commons/BUILD_DOCS.txt to build the main commons site locally, commit the changes and update the site. I have done this successfully up to the commit. 5. Generate the mavenized [lang] site locally and move the files manually to /www/jakarta.apache.org/commons/lang. The last step seems odd to me, since we seem to be storing HTML in CVS for all of the of the non-maven sites. Did I miss anything? Is it silly to do this before moving the main site to maven? Are we planning to migrate the main site soon? Phil - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED] - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
RE: [lang] web site
Very nice! One thing I have notices with Maven sites is that hyperlinks often include the space AFTER a word end. Is that a bug in Maven or in the data you feed it? Gary > -Original Message- > From: Phil Steitz [mailto:[EMAIL PROTECTED] > Sent: Sunday, November 02, 2003 23:10 > To: Jakarta Commons Developers List > Subject: [lang] web site > > I have put a first cut at a "mavenized" lang site at > http://www.apache.org/~psteitz/docs/ > > There is nothing new or different in terms of content. Comments welcome. > There are a couple of errors that I know about -- the link in the upper > right does not work and should be replaced by the Commons logo image and > incl_nav has not been updated to reflect the recent promotions of math > and dbutils. I will make these changes. > > Modulo a little clean up, I would like to publish this to the public > site. I would appreciate confirmation (or gentle indication that I am > out of my mind) re the following steps to accomplish this: > > 1. Add xdocs directory to jakarta-commons/lang cvs including the files > used to make the maven site. > > 2, Remove lang.xml from jakarta-commons/xdocs (this is replaced by > index.xml in jakarta-commons/lang/xdocs). > > 3. Edit jakarta-commons/xdocs/components.xml and > jakarta-commons/stylesheets/menus/components.xml to remove references to > lang.html > > 4. Follow the instructions in jakarta-commons/BUILD_DOCS.txt to build > the main commons site locally, commit the changes and update the site. > I have done this successfully up to the commit. > > 5. Generate the mavenized [lang] site locally and move the files > manually to /www/jakarta.apache.org/commons/lang. > > The last step seems odd to me, since we seem to be storing HTML in CVS > for all of the of the non-maven sites. > > Did I miss anything? Is it silly to do this before moving the main site > to maven? Are we planning to migrate the main site soon? > > Phil > > > > > - > To unsubscribe, e-mail: [EMAIL PROTECTED] > For additional commands, e-mail: [EMAIL PROTECTED]
Re: [lang] Web site
Sounds like a good idea. I think that detailed descriptions and examples for each package would be good additions to the Maven site... creating a lightweight user manual of sorts. It's always a hard choice to decide what to put in package.html and what to put in a user manual. Maven seems great for generating this type of documentation with the Anakia xdocs. At a glance - betwixt, cli, jxpath are projects that have great Maven documentation. It seems that, since [lang] is such a low-level component, the use cases should be fairly easy to document. I'm willing to help, just let me know. Phil Steitz wrote: Are we ready to move to the maven-generated site? If there are no objections and no one more compe.. (er, I mean "confident") wants to step up, I will attempt the conversion. Ideas on how/what to improve would be most welcome. Phil - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]