Hello there, I just thought I'd comment a bit on the reflow-maven-skin, particularly in regards to simplicity and readability.
First - we use (or should use) the Maven Site plugin to document our projects and products. Personally, I use m-s-p mechanics to create user documentation, operations documentation and technical/developer documentation. With some inclusions of PlantUML plugins, markdown standards, and configuration fiddling in the POM it is a fine tool to simplify the documentation effort for many developers in concert. Add a skin like Fluido, and we have decent readability as well. I saw the reflow maven skin awhile back and decided to give it a try. While the result of reflow is stunning as far as a website goes, it does also push the simplicity-vs-configuration ration drastically towards the more complex side. When creating a normal website, we have the mechanics of the HTML and CSS bits to work with; each of which is decently documented. When using m-s-p and the reflow skin, the mechanics of HTML must be configured within the site.xml document - on a per-page basis using custom configuration which is unknown to anyone not having tested the reflow skin. This implies a new level of complexity, which makes the reflow skin difficult to use in a multimodule reactor or for larger projects. I would like to be able to create sites for projects such as are exemplified by the reflow-maven-skin - but I honestly believe we need to simplify or revamp the maven site plugin in order to get there. (I get the feeling that requirements for skins such as reflow were not really considered when drafting the m-s-p). Keeping configuration on a per-page basis in the site.xml is a workaround for not having needed mechanics available elsewhere, or in another form. It is understandable - and commendable! - that Andrius has gone the extra mile to demonstrate what can be done using m-s-p. However, I feel that the current state is far from usable/simple. But we all need to generate really modern, responsive, readable and stunning documentation from Maven projects, so I believe that the reflow skin defines a nice goal/target state. 2015-04-06 8:25 GMT+02:00 Mirko Friedenhagen <[email protected]>: > Hello, > > +1 for moving to the fluido theme as a first step. > Concerning mobilization of the site, there is already a responsive site > theme (http://andriusvelykis.github.io/reflow-maven-skin/). It is licensed > under Apache license as well. > > Regards > Mirko > -- > Sent from my mobile > On Apr 5, 2015 10:18 PM, "Tibor Digana" <[email protected]> wrote: > > > Nice Logo. > > If we move the right hand side bar to the footer, we will get more space > on > > small display <= 480 px. > > Maybe some other page other than footer. > > Is everything important in that bar? > > > > Cheers > > Tibor > > > > > > > > -- > > View this message in context: > > http://maven.40175.n5.nabble.com/Maven-Web-Site-tp5831558p5831710.html > > Sent from the Maven Developers mailing list archive at Nabble.com. > > > > --------------------------------------------------------------------- > > To unsubscribe, e-mail: [email protected] > > For additional commands, e-mail: [email protected] > > > > > -- -- +==============================+ | Bästa hälsningar, | [sw. "Best regards"] | | Lennart Jörelid | EAI Architect & Integrator | | jGuru Europe AB | Mölnlycke - Kista | | Email: [email protected] | URL: www.jguru.se | Phone | (skype): jgurueurope | (intl): +46 708 507 603 | (domestic): 0708 - 507 603 +==============================+
