Re: [Website] Progress on the Website-Generation topic

[Maxim Solodovnik]

It is sad Maven has no references to this skin :(
Not sure if I will have time, but maybe I'll invest some time to
refactoring the site one more time :)))


On Fri, Oct 14, 2016 at 6:26 PM, Christofer Dutz <christofer.d...@c-ware.de>
wrote:

> Hi Maxim,
>
>
> I initially setup the fluido skin, but that is more a skin for the normal
> maven-style pages. Generating our website with that would look sort of 90s
> or max early 2000s ;-)
>
>
> The cool thing with the reflow-skin is that it's a reactive version that
> adjusts to mobile devices nicely and allows us to auto-generate something
> looking very similar to our current Website.
>
>
> Chris
>
> 
> Von: Maxim Solodovnik <solomax...@gmail.com>
> Gesendet: Freitag, 14. Oktober 2016 11:54:40
> An: dev@flex.apache.org
> Betreff: Re: [Website] Progress on the Website-Generation topic
>
> On Fri, Oct 14, 2016 at 4:02 PM, Christofer Dutz <
> christofer.d...@c-ware.de>
> wrote:
>
> > Hi Om,
> >
> >
> > I think that approach is probably the best ... I did encounter problems
> > when running the website from the working directory of Jenkins. Don't
> know
> > why.
> >
> >
> Jenkins is on https:// and scripts are being loaded from CDN via http://
> Things like this need to be fixed in final version :(
>
> For our project we are generating site using
> https://maven.apache.org/skins/maven-fluido-skin/
> Works for us :)
>
>
> > The template is configured in the site.xml document, as this configures
> > the the reflow themes built-in template. You can see all the options
> here:
> >
> > http://andriusvelykis.github.io/reflow-maven-skin/skin/components.html
> >
> >
> > The toc component seems to have this sort of option (offsetTopnav), but
> > not the topNav element responsible for the top navigation. I hope this is
> > customizable without having to adjust the reflow template itself.
> >
> >
> > But I just stumbled over the bottomNav column feature ... will add that
> > right away :-)
> >
> >
> > Another option would be to overwrite the css style by adding the
> > declarations to "site.css" but as I said ... I'm no web-developer and I
> > sort of feel like wasting days on stuff like that ... so if you know what
> > to do, just give it a try.
> >
> >
> > With a simple:
> >
> >
> > mvn clean site
> >
> >
> > you can re-generate the site and have a look at the result in the
> > "target/site" directory.
> >
> >
> >
> > Chris
> >
> > 
> > Von: omup...@gmail.com <omup...@gmail.com> im Auftrag von OmPrakash
> > Muppirala <bigosma...@gmail.com>
> > Gesendet: Freitag, 14. Oktober 2016 10:33:28
> > An: dev@flex.apache.org
> > Betreff: Re: [Website] Progress on the Website-Generation topic
> >
> > Never mind, I checked out the flex-site.
> >
> > The proper fix would be to
> > 1.  Remove the class "navbar-fixed-top" on the navbar div in all pages.
> > 2.  Set padding-top = 0 for body in bootswatch.css
> >
> > (2) is straightforward.  But it looks like we need to make the change for
> > (1) in every page.  Is there a html template that drives all the pages?
> >
> > Thanks,
> > Om
> >
> > On Fri, Oct 14, 2016 at 1:28 AM, Harbs <harbs.li...@gmail.com> wrote:
> >
> > > The link is lower down in this thread:
> > > https://builds.apache.org/view/E-G/view/Flex/job/Flex-
> > > Site%20(Maven)/ws/target/site/index.html
> > >
> > > On Oct 14, 2016, at 11:07 AM, OmPrakash Muppirala <
> bigosma...@gmail.com>
> > > wrote:
> > >
> > > > Where can I find this site?
> > > >
> > > > It sounds like the nav bar has CSS setting position: sticky;
> > > > Either that, or the position of the nav bar is being translated in an
> > > > onScroll event handler in javascript.
> > > >
> > > > Thanks,
> > > > Om
> > > >
> > > > On Fri, Oct 14, 2016 at 12:59 AM, Christofer Dutz <
> > > christofer.d...@c-ware.de
> > > >> wrote:
> > > >
> > > >> If someone knows bootstrap good enough to eventually help me with
> the
> > > >> position of the navigation bar? Currently it's stuck to the top no
> > > matter
> > > >> where you scroll to. I would prefer it to have the Flex and Apache
> > logo
> > > >> a

Re: [Website] Progress on the Website-Generation topic

[Maxim Solodovnik]

On Fri, Oct 14, 2016 at 4:02 PM, Christofer Dutz <christofer.d...@c-ware.de>
wrote:

> Hi Om,
>
>
> I think that approach is probably the best ... I did encounter problems
> when running the website from the working directory of Jenkins. Don't know
> why.
>
>
Jenkins is on https:// and scripts are being loaded from CDN via http://
Things like this need to be fixed in final version :(

For our project we are generating site using
https://maven.apache.org/skins/maven-fluido-skin/
Works for us :)


> The template is configured in the site.xml document, as this configures
> the the reflow themes built-in template. You can see all the options here:
>
> http://andriusvelykis.github.io/reflow-maven-skin/skin/components.html
>
>
> The toc component seems to have this sort of option (offsetTopnav), but
> not the topNav element responsible for the top navigation. I hope this is
> customizable without having to adjust the reflow template itself.
>
>
> But I just stumbled over the bottomNav column feature ... will add that
> right away :-)
>
>
> Another option would be to overwrite the css style by adding the
> declarations to "site.css" but as I said ... I'm no web-developer and I
> sort of feel like wasting days on stuff like that ... so if you know what
> to do, just give it a try.
>
>
> With a simple:
>
>
> mvn clean site
>
>
> you can re-generate the site and have a look at the result in the
> "target/site" directory.
>
>
>
> Chris
>
> 
> Von: omup...@gmail.com <omup...@gmail.com> im Auftrag von OmPrakash
> Muppirala <bigosma...@gmail.com>
> Gesendet: Freitag, 14. Oktober 2016 10:33:28
> An: dev@flex.apache.org
> Betreff: Re: [Website] Progress on the Website-Generation topic
>
> Never mind, I checked out the flex-site.
>
> The proper fix would be to
> 1.  Remove the class "navbar-fixed-top" on the navbar div in all pages.
> 2.  Set padding-top = 0 for body in bootswatch.css
>
> (2) is straightforward.  But it looks like we need to make the change for
> (1) in every page.  Is there a html template that drives all the pages?
>
> Thanks,
> Om
>
> On Fri, Oct 14, 2016 at 1:28 AM, Harbs <harbs.li...@gmail.com> wrote:
>
> > The link is lower down in this thread:
> > https://builds.apache.org/view/E-G/view/Flex/job/Flex-
> > Site%20(Maven)/ws/target/site/index.html
> >
> > On Oct 14, 2016, at 11:07 AM, OmPrakash Muppirala <bigosma...@gmail.com>
> > wrote:
> >
> > > Where can I find this site?
> > >
> > > It sounds like the nav bar has CSS setting position: sticky;
> > > Either that, or the position of the nav bar is being translated in an
> > > onScroll event handler in javascript.
> > >
> > > Thanks,
> > > Om
> > >
> > > On Fri, Oct 14, 2016 at 12:59 AM, Christofer Dutz <
> > christofer.d...@c-ware.de
> > >> wrote:
> > >
> > >> If someone knows bootstrap good enough to eventually help me with the
> > >> position of the navigation bar? Currently it's stuck to the top no
> > matter
> > >> where you scroll to. I would prefer it to have the Flex and Apache
> logo
> > >> above (like in the current version) but as soon as you scroll down and
> > the
> > >> header hit's the top of the browser window, it stays there and remains
> > >> visible. I know I have seen this behavior but I simply don't know the
> > CSS
> > >> magic I would have to apply here ;-)
> > >>
> > >>
> > >> So if anyone here knows this stuff, please come forward and help me
> get
> > >> this site a little more into shape :-)
> > >>
> > >>
> > >> Chris
> > >>
> > >> 
> > >> Von: Justin Mclean <jus...@classsoftware.com>
> > >> Gesendet: Freitag, 14. Oktober 2016 09:44:27
> > >> An: dev@flex.apache.org
> > >> Betreff: Re: [Website] Progress on the Website-Generation topic
> > >>
> > >> Hi,
> > >>
> > >>> So has anyone else had a look at the newly generated documentation in
> > >> the flex-site.git "maven-site" branch? As I mentioned, if you checkout
> > the
> > >> "asf-site" branch you can see the generated output.
> > >>
> > >> Just taking look now. It been a couple of busy weeks with conferences
> > and
> > >> other work (yesterday I assembled, programmed and tested 40 prototype
> > >> devices) and I’m just catching up on a few things.
> > >>
> > >> Thanks,
> > >> Justin
> > >>
> >
> >
>



-- 
WBR
Maxim aka solomax

Re: [Website] Progress on the Website-Generation topic

[OmPrakash Muppirala]

Never mind, I checked out the flex-site.

The proper fix would be to
1.  Remove the class "navbar-fixed-top" on the navbar div in all pages.
2.  Set padding-top = 0 for body in bootswatch.css

(2) is straightforward.  But it looks like we need to make the change for
(1) in every page.  Is there a html template that drives all the pages?

Thanks,
Om

On Fri, Oct 14, 2016 at 1:28 AM, Harbs <harbs.li...@gmail.com> wrote:

> The link is lower down in this thread:
> https://builds.apache.org/view/E-G/view/Flex/job/Flex-
> Site%20(Maven)/ws/target/site/index.html
>
> On Oct 14, 2016, at 11:07 AM, OmPrakash Muppirala <bigosma...@gmail.com>
> wrote:
>
> > Where can I find this site?
> >
> > It sounds like the nav bar has CSS setting position: sticky;
> > Either that, or the position of the nav bar is being translated in an
> > onScroll event handler in javascript.
> >
> > Thanks,
> > Om
> >
> > On Fri, Oct 14, 2016 at 12:59 AM, Christofer Dutz <
> christofer.d...@c-ware.de
> >> wrote:
> >
> >> If someone knows bootstrap good enough to eventually help me with the
> >> position of the navigation bar? Currently it's stuck to the top no
> matter
> >> where you scroll to. I would prefer it to have the Flex and Apache logo
> >> above (like in the current version) but as soon as you scroll down and
> the
> >> header hit's the top of the browser window, it stays there and remains
> >> visible. I know I have seen this behavior but I simply don't know the
> CSS
> >> magic I would have to apply here ;-)
> >>
> >>
> >> So if anyone here knows this stuff, please come forward and help me get
> >> this site a little more into shape :-)
> >>
> >>
> >> Chris
> >>
> >> 
> >> Von: Justin Mclean <jus...@classsoftware.com>
> >> Gesendet: Freitag, 14. Oktober 2016 09:44:27
> >> An: dev@flex.apache.org
> >> Betreff: Re: [Website] Progress on the Website-Generation topic
> >>
> >> Hi,
> >>
> >>> So has anyone else had a look at the newly generated documentation in
> >> the flex-site.git "maven-site" branch? As I mentioned, if you checkout
> the
> >> "asf-site" branch you can see the generated output.
> >>
> >> Just taking look now. It been a couple of busy weeks with conferences
> and
> >> other work (yesterday I assembled, programmed and tested 40 prototype
> >> devices) and I’m just catching up on a few things.
> >>
> >> Thanks,
> >> Justin
> >>
>
>

Re: [Website] Progress on the Website-Generation topic

[Harbs]

The link is lower down in this thread:
https://builds.apache.org/view/E-G/view/Flex/job/Flex-Site%20(Maven)/ws/target/site/index.html

On Oct 14, 2016, at 11:07 AM, OmPrakash Muppirala <bigosma...@gmail.com> wrote:

> Where can I find this site?
> 
> It sounds like the nav bar has CSS setting position: sticky;
> Either that, or the position of the nav bar is being translated in an
> onScroll event handler in javascript.
> 
> Thanks,
> Om
> 
> On Fri, Oct 14, 2016 at 12:59 AM, Christofer Dutz <christofer.d...@c-ware.de
>> wrote:
> 
>> If someone knows bootstrap good enough to eventually help me with the
>> position of the navigation bar? Currently it's stuck to the top no matter
>> where you scroll to. I would prefer it to have the Flex and Apache logo
>> above (like in the current version) but as soon as you scroll down and the
>> header hit's the top of the browser window, it stays there and remains
>> visible. I know I have seen this behavior but I simply don't know the CSS
>> magic I would have to apply here ;-)
>> 
>> 
>> So if anyone here knows this stuff, please come forward and help me get
>> this site a little more into shape :-)
>> 
>> 
>> Chris
>> 
>> ________
>> Von: Justin Mclean <jus...@classsoftware.com>
>> Gesendet: Freitag, 14. Oktober 2016 09:44:27
>> An: dev@flex.apache.org
>> Betreff: Re: [Website] Progress on the Website-Generation topic
>> 
>> Hi,
>> 
>>> So has anyone else had a look at the newly generated documentation in
>> the flex-site.git "maven-site" branch? As I mentioned, if you checkout the
>> "asf-site" branch you can see the generated output.
>> 
>> Just taking look now. It been a couple of busy weeks with conferences and
>> other work (yesterday I assembled, programmed and tested 40 prototype
>> devices) and I’m just catching up on a few things.
>> 
>> Thanks,
>> Justin
>> 

Re: [Website] Progress on the Website-Generation topic

[OmPrakash Muppirala]

Where can I find this site?

It sounds like the nav bar has CSS setting position: sticky;
Either that, or the position of the nav bar is being translated in an
onScroll event handler in javascript.

Thanks,
Om

On Fri, Oct 14, 2016 at 12:59 AM, Christofer Dutz <christofer.d...@c-ware.de
> wrote:

> If someone knows bootstrap good enough to eventually help me with the
> position of the navigation bar? Currently it's stuck to the top no matter
> where you scroll to. I would prefer it to have the Flex and Apache logo
> above (like in the current version) but as soon as you scroll down and the
> header hit's the top of the browser window, it stays there and remains
> visible. I know I have seen this behavior but I simply don't know the CSS
> magic I would have to apply here ;-)
>
>
> So if anyone here knows this stuff, please come forward and help me get
> this site a little more into shape :-)
>
>
> Chris
>
> 
> Von: Justin Mclean <jus...@classsoftware.com>
> Gesendet: Freitag, 14. Oktober 2016 09:44:27
> An: dev@flex.apache.org
> Betreff: Re: [Website] Progress on the Website-Generation topic
>
> Hi,
>
> > So has anyone else had a look at the newly generated documentation in
> the flex-site.git "maven-site" branch? As I mentioned, if you checkout the
> "asf-site" branch you can see the generated output.
>
> Just taking look now. It been a couple of busy weeks with conferences and
> other work (yesterday I assembled, programmed and tested 40 prototype
> devices) and I’m just catching up on a few things.
>
> Thanks,
> Justin
>

Re: [Website] Progress on the Website-Generation topic

[Justin Mclean]

Hi,

> So has anyone else had a look at the newly generated documentation in the 
> flex-site.git "maven-site" branch? As I mentioned, if you checkout the 
> "asf-site" branch you can see the generated output.

Just taking look now. It been a couple of busy weeks with conferences and other 
work (yesterday I assembled, programmed and tested 40 prototype devices) and 
I’m just catching up on a few things.

Thanks,
Justin

Re: [Website] Progress on the Website-Generation topic

[Alex Harui]

Is there a URL we can go to and see the results of this workflow?

-Alex

On 10/12/16, 5:48 AM, "Christofer Dutz"  wrote:

>Hi,
>
>
>I just wanted to post, that I have finished setting up a new version of
>the Website. The source is located in the "maven-site" branch of the
>"flex-site.git" repository.
>
>
>This is a Maven build which produces the Website using the
>maven-site-plugin and the reflow-site plugin to render a responsive
>version of the website using bootstrap (Seems that this is pretty similar
>to the original version).
>
>
>I migrated all the ".cmsPage" files I needed to Markdown format and
>removed unnecessary html code inside. I think the code is a lot cleaner
>and easier to maintain.
>
>
>Currently the site does look a little different than the original, but
>I'm no CSS guru. I invested about 5 full days in migrating things to the
>current point and think we should start discussing if fine-tuning makes
>sense (I don't see any sense in investing more time and then we decide
>not to use it)
>
>
>The current workflow is that you checkout the "maven-site" branch
>(eventually apply your changes) and do a "mvn clean site" build. This
>will produce the website content in the "target/site" directory. Here you
>can have a look at the content which is produced. If you are satisfied
>with your changes, you commit and push them and a buildbot build-job I
>configured (what was quite a task) will run the same build and push the
>generated content to the "asf-site" branch in the same git repo
>(Currently you should be able to have a look at the generated content, by
>checking out that branch).
>
>
>As soon as we are happy with the new version, all we have to do is to
>tell Infra to sync the "asf-site" branch with their website repo and the
>website is online.
>
>
>I also documented the procedure of auto-building the website on the
>website itself as an additional page under Documentation "Contributing to
>the Flex Website".
>
>
>So I'm ready for some feedback ;-)
>
>
>Chris