Hi Eric, 2012/5/23 Eric Charles <[email protected]>: > Hi Ioan,s > > A few feedbacks and more questions... > > So CMS is now happy with different sidebars? > http://james.staging.apache.org/mime4j/ > http://james.staging.apache.org/sever/3 > That's good! > > I didn't retry to edit a page since my last attempt hoping it would get > fixed in the meantime.
It was, and now it's broken again. > From what you previously explained, I understand/assume editing a page in > CMS will commit it back in XML in the correct project and ensure the > publication (after 3 minutes). This means the complete project could be > still again built. > > Example: I edit > http://james.staging.apache.org/server/3/feature-smtp-hooks.html via CMS, > and > http://svn.apache.org/repos/asf/james/server/trunk/src/site/xdoc/feature-smtp-hooks.xml > is updated in SVN with valid XML that reflect my edits. This means the > server/3 website can still be built via 'mvn site' such as before. > > Will it be the case? It's more complicated because James is complicated and a has many modules with site (TOO MANY!!!). The bookmarklet works it it can resolve the file path to a similar path in content/xdoc. This implies we have all our site files in a single directory. Unfortunately this is not the case for James. Almost every component on the menu has 1-4 site dirs with some files in it (mostly 2-3) . e.g. mailet has mailet/api, mailet/base/ mailet/crypto, each with it's own site. I've added 25 svn:external entries and configured the same amount of site executions in pom.xml to build the site as it was, with each component providing it's own sidebar. So currently: - updating the site for a component (server) will trigger a site rebuild in staging - Bookmarklet editing does not work (the rules to resolve file.html back to file.xml do not work in our setu-up) We can't have a better site if we are not willing to make some compromises and change. Some James components have not been updated since 2009 !. CMS can solve this issue by building and deploying the site automatically on commit. With some constraints it can allow editing from the browser (e.g. all files are in content/xdoc or content/apt so it can resolve them etc.). You can't have your cake and eat it too. So what will it be? > Thx, > > Eric > > > On 05/23/2012 11:55 AM, Ioan Eugen Stan wrote: >> >> Hi again, >> >> It's been pretty quiet and I hate being the only one to reply to this >> post but I did something new: >> >> Work done: >> >> I've added most of the site directories as entries in svn:externals >> and configured maven-site-plugin to run multiple times, building each >> site and setting the output into the proper directory. >> >> I had one issue with the links: they where resolved as relative and >> that messed up menu navigation (via top-menu). I fixed it with >> <relativizeDecorationLinks>false</relativizeDecorationLinks>. >> Unfortunately this makes all the top-menu links absolute to >> james.apache.org so if you wish to see the staging enter the links >> yourself. >> >> Conclusion: >> >> - we have most of the docs as they are on live, the rest can go with >> direct import >> - working with a multi-module project with maven site and cms is a >> nightmare, especially with all the modules james has. >> - I really wish for someone to step in and give a hand or just reply >> so I know my work here is not for nothing >> >> Thanks, >> >> 2012/5/22 Ioan Eugen Stan<[email protected]>: >>> >>> Hi, >>> >>> I've tried Bookmarklet editing with a page from mime4j and it seems it >>> doesn't work (can't resolve pages defined with svn:externals so if we >>> plan on using this we will need to move the site trees in site-cms and >>> declare them with svn:externals. >>> >>> I wish to get the website up and running before BerlinBuzzwords. We >>> will probably have more people interested and it will be nice to have >>> something to show. Any ideas on how to solve the sidebar issue? >>> >>> >>> 2012/5/21 Ioan Eugen Stan<[email protected]>: >>>> >>>> Hi, >>>> >>>> I've added mime4j with svn externals to site-cms: >>>> http://svn.apache.org/viewvc?view=revision&revision=1341004 . The >>>> infrastructure detects changes and builds mime4j site as expected: >>>> http://james.staging.apache.org/mime4j/index.html . >>>> >>>> Unfortunately the sidebar does not update. It's defined in >>>> site/site.xml [1], and I'm not importing that with externals. Each >>>> module has it's own site.xml with a custom side-bar defined and it >>>> will create a name clash. >>>> >>>> Does anybody know a quick& easy way around this? I can imagine a few: >>>> >>>> >>>> - use a standard sidebar across modules and define a link on that >>>> sidebar that opens relative paths >>>> - use javscript to override it >>>> >>>> Not sure how any of those might work so if you know an easy way to do >>>> include site.xml inside the xdoc directory of each project it would be >>>> great. >>>> >>>> Thanks, >>>> >>>> [1] http://svn.apache.org/repos/asf/james/mime4j/trunk/src/site/ >>>> >>>> -- >>>> Ioan Eugen Stan >>>> http://ieugen.blogspot.com/ *** http://bucharest-jug.github.com/ *** >>> >>> >>> >>> >>> -- >>> Ioan Eugen Stan >>> http://ieugen.blogspot.com/ *** http://bucharest-jug.github.com/ *** >> >> >> >> > > -- > eric | http://about.echarles.net | @echarles > > > --------------------------------------------------------------------- > To unsubscribe, e-mail: [email protected] > For additional commands, e-mail: [email protected] > -- Ioan Eugen Stan http://ieugen.blogspot.com/ *** http://bucharest-jug.github.com/ *** --------------------------------------------------------------------- To unsubscribe, e-mail: [email protected] For additional commands, e-mail: [email protected]
