You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@hbase.apache.org by Nick Dimiduk <nd...@gmail.com> on 2014/12/02 18:46:44 UTC
A face-lift for 1.0
Heya,
In mind of the new release, I was thinking we should clean up our act a
little bit in regard to hbase.apache.org and our book. Just because the
project started in 2007 doesn't mean we need a site that looks like it's
from 2007. Phoenix's site looks great in this regard.
For the home page, I was thinking of converting it over to bootstrap [0] so
that it'll be easier to pick up theme, either on of our own or something
pre-canned [1]. I'm no web designer, but the idea is this would make it
easier for someone who is to help us out.
For the book, I just want to skin it -- no intention of changing docbook
part (such a decision I'll leave up to Misty). I'm less sure on this
project, but Riak's docs are a nice inspiration.
What do you think? Do we know any web designers who can help out with the
CSS?
-n
[0]: http://getbootstrap.com
[1]: https://wrapbootstrap.com/
[2]: http://docs.basho.com/riak/latest/
Re: A face-lift for 1.0
Posted by Elliott Clark <ec...@apache.org>.
Let me know if you need or want any help.
On Tue, Dec 2, 2014 at 1:07 PM, Enis Söztutar <en...@gmail.com> wrote:
> Sounds great.
>
> Enis
>
> On Tue, Dec 2, 2014 at 9:50 AM, Ted Yu <yu...@gmail.com> wrote:
>
> > +1 on the face-lift initiative.
> >
> > On Dec 2, 2014, at 9:46 AM, Nick Dimiduk <nd...@gmail.com> wrote:
> >
> > > Heya,
> > >
> > > In mind of the new release, I was thinking we should clean up our act a
> > > little bit in regard to hbase.apache.org and our book. Just because
> the
> > > project started in 2007 doesn't mean we need a site that looks like
> it's
> > > from 2007. Phoenix's site looks great in this regard.
> > >
> > > For the home page, I was thinking of converting it over to bootstrap
> [0]
> > so
> > > that it'll be easier to pick up theme, either on of our own or
> something
> > > pre-canned [1]. I'm no web designer, but the idea is this would make it
> > > easier for someone who is to help us out.
> > >
> > > For the book, I just want to skin it -- no intention of changing
> docbook
> > > part (such a decision I'll leave up to Misty). I'm less sure on this
> > > project, but Riak's docs are a nice inspiration.
> > >
> > > What do you think? Do we know any web designers who can help out with
> the
> > > CSS?
> > >
> > > -n
> > >
> > > [0]: http://getbootstrap.com
> > > [1]: https://wrapbootstrap.com/
> > > [2]: http://docs.basho.com/riak/latest/
> >
>
Re: A face-lift for 1.0
Posted by Enis Söztutar <en...@gmail.com>.
Sounds great.
Enis
On Tue, Dec 2, 2014 at 9:50 AM, Ted Yu <yu...@gmail.com> wrote:
> +1 on the face-lift initiative.
>
> On Dec 2, 2014, at 9:46 AM, Nick Dimiduk <nd...@gmail.com> wrote:
>
> > Heya,
> >
> > In mind of the new release, I was thinking we should clean up our act a
> > little bit in regard to hbase.apache.org and our book. Just because the
> > project started in 2007 doesn't mean we need a site that looks like it's
> > from 2007. Phoenix's site looks great in this regard.
> >
> > For the home page, I was thinking of converting it over to bootstrap [0]
> so
> > that it'll be easier to pick up theme, either on of our own or something
> > pre-canned [1]. I'm no web designer, but the idea is this would make it
> > easier for someone who is to help us out.
> >
> > For the book, I just want to skin it -- no intention of changing docbook
> > part (such a decision I'll leave up to Misty). I'm less sure on this
> > project, but Riak's docs are a nice inspiration.
> >
> > What do you think? Do we know any web designers who can help out with the
> > CSS?
> >
> > -n
> >
> > [0]: http://getbootstrap.com
> > [1]: https://wrapbootstrap.com/
> > [2]: http://docs.basho.com/riak/latest/
>
Re: A face-lift for 1.0
Posted by Ted Yu <yu...@gmail.com>.
+1 on the face-lift initiative.
On Dec 2, 2014, at 9:46 AM, Nick Dimiduk <nd...@gmail.com> wrote:
> Heya,
>
> In mind of the new release, I was thinking we should clean up our act a
> little bit in regard to hbase.apache.org and our book. Just because the
> project started in 2007 doesn't mean we need a site that looks like it's
> from 2007. Phoenix's site looks great in this regard.
>
> For the home page, I was thinking of converting it over to bootstrap [0] so
> that it'll be easier to pick up theme, either on of our own or something
> pre-canned [1]. I'm no web designer, but the idea is this would make it
> easier for someone who is to help us out.
>
> For the book, I just want to skin it -- no intention of changing docbook
> part (such a decision I'll leave up to Misty). I'm less sure on this
> project, but Riak's docs are a nice inspiration.
>
> What do you think? Do we know any web designers who can help out with the
> CSS?
>
> -n
>
> [0]: http://getbootstrap.com
> [1]: https://wrapbootstrap.com/
> [2]: http://docs.basho.com/riak/latest/
Re: A face-lift for 1.0
Posted by Ted Yu <yu...@gmail.com>.
Nice.
User API points to:
http://people.apache.org/~ndimiduk/site/apidocs/index.html
which corresponds to unreleased snapshot.
Should link to 0.98 / 1.0 be added somewhere ?
Cheers
On Tue, Dec 16, 2014 at 7:21 PM, Nick Dimiduk <nd...@gmail.com> wrote:
>
> For those not following closely in JIRAland, I've two changes that are
> ready to go. First, there's transition over to a bootstrap-based layout for
> our home page. This work is done in HBASE-12688. This improves the looks of
> things and will make it pretty easy to update our look-and-feel in the
> future. Second, I fixed a build problem where the online book wasn't
> getting its intended styling. This is done in HBASE-12687. I'd like to
> update the book to look the same as the front-page, but getting styles into
> docbook is proving non-trivial.
>
> Anyway, both of these changes are pushed to master and we're ready for a
> site re-build with the new look. I'll make that happen tomorrow morning
> unless I hear actionable objections.
>
> You can get a preview of things to come over one
> http://people.apache.org/~ndimiduk/site/
>
> Thanks,
> Nick
>
> On Fri, Dec 5, 2014 at 12:29 PM, Stack <st...@duboce.net> wrote:
> >
> > Thanks. I've been having a dialog w/ your crew that has been going on a
> > while... was wondering if any progress.
> > Grand,
> > St.Ack
> >
> > On Fri, Dec 5, 2014 at 11:55 AM, Ryan Rawson <ry...@gmail.com> wrote:
> >
> > > I'm checking to see if our marketing and web team can help. The
> > > primary requirement is going to be ditching the mvn:site from the
> > > front page. "reskinning it" might not be so easy.
> > >
> > > -ryan
> > >
> > > On Thu, Dec 4, 2014 at 9:52 AM, lars hofhansl <la...@apache.org>
> wrote:
> > > > +1
> > > > I just came across one of the various HBase vs. Cassandra articles,
> and
> > > one of the main tenants of the articles was how much better the
> Cassandra
> > > documentation was.Thank god we have Misty now. :)
> > > >
> > > > (not sure how much just a skin would help, but it surely won't hurt)
> > > >
> > > > -- Lars
> > > > From: Nick Dimiduk <nd...@gmail.com>
> > > > To: hbase-dev <de...@hbase.apache.org>
> > > > Sent: Tuesday, December 2, 2014 9:46 AM
> > > > Subject: A face-lift for 1.0
> > > >
> > > > Heya,
> > > >
> > > > In mind of the new release, I was thinking we should clean up our
> act a
> > > > little bit in regard to hbase.apache.org and our book. Just because
> > the
> > > > project started in 2007 doesn't mean we need a site that looks like
> > it's
> > > > from 2007. Phoenix's site looks great in this regard.
> > > >
> > > > For the home page, I was thinking of converting it over to bootstrap
> > [0]
> > > so
> > > > that it'll be easier to pick up theme, either on of our own or
> > something
> > > > pre-canned [1]. I'm no web designer, but the idea is this would make
> it
> > > > easier for someone who is to help us out.
> > > >
> > > > For the book, I just want to skin it -- no intention of changing
> > docbook
> > > > part (such a decision I'll leave up to Misty). I'm less sure on this
> > > > project, but Riak's docs are a nice inspiration.
> > > >
> > > > What do you think? Do we know any web designers who can help out with
> > the
> > > > CSS?
> > > >
> > > > -n
> > > >
> > > > [0]: http://getbootstrap.com
> > > > [1]: https://wrapbootstrap.com/
> > > > [2]: http://docs.basho.com/riak/latest/
> > > >
> > > >
> > > >
> > >
> >
>
Re: A face-lift for 1.0
Posted by Nick Dimiduk <nd...@gmail.com>.
Any chance of fixing this by way of a contribution back to the maven-skin
maintainers? We can avoid bringing back the site.vm if we leave this in
their hands.
On Tue, Dec 30, 2014 at 12:11 PM, Dima Spivak <ds...@cloudera.com> wrote:
> Ooh, good call, guys. Yeah, looks like all we'd need to do is move
> bootstrap.min.css and bootstrap-responsive.min.css onto our server and link
> to it relatively instead of with absolute links it has now. Seeing as how
> both of those CSS files are Apache License, should be easy.
>
> -Dima
>
> On Tue, Dec 30, 2014 at 11:54 AM, Elliott Clark <ec...@apache.org> wrote:
>
> > Yeah the js and css are all loaded though a cdn. It should be pretty easy
> > to change the urls to be protocol relative and then things should work.
> >
> > On Tue, Dec 30, 2014 at 11:17 AM, Enis Söztutar <en...@gmail.com>
> > wrote:
> >
> > > I had the same problem. We link to CSS which is http instead of forking
> > and
> > > serving it in the site (I believe this is the default practice). My
> > chrome
> > > extension refuses to connect to http links causing rendering problems.
> > >
> > > Enis
> > >
> > > On Tue, Dec 30, 2014 at 11:00 AM, Dima Spivak <ds...@cloudera.com>
> > > wrote:
> > >
> > > > Not sure if this is something to address in this thread or if I
> should
> > > file
> > > > a separate JIRA, but for some reason, accessing the site over https
> > gets
> > > > rid of the pretty CSS. Seems to happen in Chrome and Firefox. Anyone
> > > have a
> > > > clue why?
> > > >
> > > > -Dima
> > > >
> > > > On Wed, Dec 17, 2014 at 10:53 AM, Nick Dimiduk <nd...@gmail.com>
> > > wrote:
> > > >
> > > > > Tweaking the layout of the website goes one of two ways. Either
> > > there's a
> > > > > configuration point exposed from the maven skin or there isn't. If
> > > there
> > > > > is, it's simply editing the appropriate custom tag in site.xml. If
> > not,
> > > > > we'll need to bring back the velocity site.vm template.
> > Configurations
> > > > are
> > > > > documented here:
> > > > > http://andriusvelykis.github.io/reflow-maven-skin/skin/config.html
> > > > >
> > > > > Tweaking visuals is now based on the theme. We can either choose
> > > another
> > > > > bootswatch theme, or write our own. That stuff is documented here:
> > > > > http://andriusvelykis.github.io/reflow-maven-skin/skin/themes/
> > > > >
> > > > > Right now the site is separate from the book. In theory we could
> move
> > > > book
> > > > > content over to become site content, in which case it would be
> > managed
> > > by
> > > > > this same plugin. Short of that, we get into applying style via the
> > > > docbook
> > > > > plugin. I've looked into this a bit; it's not nearly as easy as
> > > applying
> > > > > reflow-maven-skin. The current leads I have for this are
> > > > > https://github.com/lcahlander/docbook and
> > > > >
> > > > >
> > > >
> > >
> >
> https://github.com/pmartin/phing-documentation-docbook/commit/8d8f0b81951c4e07420083b204599a6b9ef00537
> > > > > .
> > > > >
> > > > > Honestly though, if we're looking at moving away from docbook, I
> > think
> > > we
> > > > > should consider a more modern toolset, Sphinx-doc, for example:
> > > > > http://sphinx-doc.org
> > > > >
> > > > > On Tue, Dec 16, 2014 at 8:21 PM, Misty Stanley-Jones <
> > > > > mstanleyjones@cloudera.com> wrote:
> > > > > >
> > > > > > Absolutely fantastic!!! Got pointers to how tweaking the website
> > > would
> > > > > > work?
> > > > > >
> > > > > > In the new year I hope to really get started on a restructure of
> > the
> > > > Ref
> > > > > > Guide. I've thought about asking to move to AsciiDOC or MarkDown
> > but
> > > > I'd
> > > > > > like to do a proof-of-concept and see if it really gets us
> anything
> > > we
> > > > > > don't already have with Docbook. It's less of a potential value
> > since
> > > > we
> > > > > > are not hosted on Github, which has great integration with
> AsciiDOC
> > > and
> > > > > > MarkDown. I'm very interested in improving the look and feel of
> the
> > > > doc.
> > > > > I
> > > > > > think a lot of it will be structural -- reorganizing and
> > re-chunking
> > > > > > content.
> > > > > >
> > > > > > In the meantime, theming the Docbook is not as hard as you might
> > > think.
> > > > > > Have a look at the XSLT files. (I know, famous last words).
> > > > > >
> > > > > > On Wed, Dec 17, 2014 at 1:21 PM, Nick Dimiduk <
> ndimiduk@gmail.com>
> > > > > wrote:
> > > > > >
> > > > > > > For those not following closely in JIRAland, I've two changes
> > that
> > > > are
> > > > > > > ready to go. First, there's transition over to a
> bootstrap-based
> > > > layout
> > > > > > for
> > > > > > > our home page. This work is done in HBASE-12688. This improves
> > the
> > > > > looks
> > > > > > of
> > > > > > > things and will make it pretty easy to update our look-and-feel
> > in
> > > > the
> > > > > > > future. Second, I fixed a build problem where the online book
> > > wasn't
> > > > > > > getting its intended styling. This is done in HBASE-12687. I'd
> > like
> > > > to
> > > > > > > update the book to look the same as the front-page, but getting
> > > > styles
> > > > > > into
> > > > > > > docbook is proving non-trivial.
> > > > > > >
> > > > > > > Anyway, both of these changes are pushed to master and we're
> > ready
> > > > for
> > > > > a
> > > > > > > site re-build with the new look. I'll make that happen tomorrow
> > > > morning
> > > > > > > unless I hear actionable objections.
> > > > > > >
> > > > > > > You can get a preview of things to come over one
> > > > > > > http://people.apache.org/~ndimiduk/site/
> > > > > > >
> > > > > > > Thanks,
> > > > > > > Nick
> > > > > > >
> > > > > > > On Fri, Dec 5, 2014 at 12:29 PM, Stack <st...@duboce.net>
> wrote:
> > > > > > > >
> > > > > > > > Thanks. I've been having a dialog w/ your crew that has been
> > > going
> > > > > on a
> > > > > > > > while... was wondering if any progress.
> > > > > > > > Grand,
> > > > > > > > St.Ack
> > > > > > > >
> > > > > > > > On Fri, Dec 5, 2014 at 11:55 AM, Ryan Rawson <
> > ryanobjc@gmail.com
> > > >
> > > > > > wrote:
> > > > > > > >
> > > > > > > > > I'm checking to see if our marketing and web team can help.
> > > The
> > > > > > > > > primary requirement is going to be ditching the mvn:site
> from
> > > the
> > > > > > > > > front page. "reskinning it" might not be so easy.
> > > > > > > > >
> > > > > > > > > -ryan
> > > > > > > > >
> > > > > > > > > On Thu, Dec 4, 2014 at 9:52 AM, lars hofhansl <
> > > larsh@apache.org>
> > > > > > > wrote:
> > > > > > > > > > +1
> > > > > > > > > > I just came across one of the various HBase vs. Cassandra
> > > > > articles,
> > > > > > > and
> > > > > > > > > one of the main tenants of the articles was how much better
> > the
> > > > > > > Cassandra
> > > > > > > > > documentation was.Thank god we have Misty now. :)
> > > > > > > > > >
> > > > > > > > > > (not sure how much just a skin would help, but it surely
> > > won't
> > > > > > hurt)
> > > > > > > > > >
> > > > > > > > > > -- Lars
> > > > > > > > > > From: Nick Dimiduk <nd...@gmail.com>
> > > > > > > > > > To: hbase-dev <de...@hbase.apache.org>
> > > > > > > > > > Sent: Tuesday, December 2, 2014 9:46 AM
> > > > > > > > > > Subject: A face-lift for 1.0
> > > > > > > > > >
> > > > > > > > > > Heya,
> > > > > > > > > >
> > > > > > > > > > In mind of the new release, I was thinking we should
> clean
> > up
> > > > our
> > > > > > > act a
> > > > > > > > > > little bit in regard to hbase.apache.org and our book.
> > Just
> > > > > > because
> > > > > > > > the
> > > > > > > > > > project started in 2007 doesn't mean we need a site that
> > > looks
> > > > > like
> > > > > > > > it's
> > > > > > > > > > from 2007. Phoenix's site looks great in this regard.
> > > > > > > > > >
> > > > > > > > > > For the home page, I was thinking of converting it over
> to
> > > > > > bootstrap
> > > > > > > > [0]
> > > > > > > > > so
> > > > > > > > > > that it'll be easier to pick up theme, either on of our
> own
> > > or
> > > > > > > > something
> > > > > > > > > > pre-canned [1]. I'm no web designer, but the idea is this
> > > would
> > > > > > make
> > > > > > > it
> > > > > > > > > > easier for someone who is to help us out.
> > > > > > > > > >
> > > > > > > > > > For the book, I just want to skin it -- no intention of
> > > > changing
> > > > > > > > docbook
> > > > > > > > > > part (such a decision I'll leave up to Misty). I'm less
> > sure
> > > on
> > > > > > this
> > > > > > > > > > project, but Riak's docs are a nice inspiration.
> > > > > > > > > >
> > > > > > > > > > What do you think? Do we know any web designers who can
> > help
> > > > out
> > > > > > with
> > > > > > > > the
> > > > > > > > > > CSS?
> > > > > > > > > >
> > > > > > > > > > -n
> > > > > > > > > >
> > > > > > > > > > [0]: http://getbootstrap.com
> > > > > > > > > > [1]: https://wrapbootstrap.com/
> > > > > > > > > > [2]: http://docs.basho.com/riak/latest/
> > > > > > > > > >
> > > > > > > > > >
> > > > > > > > > >
> > > > > > > > >
> > > > > > > >
> > > > > > >
> > > > > >
> > > > >
> > > >
> > >
> >
>
Re: A face-lift for 1.0
Posted by Dima Spivak <ds...@cloudera.com>.
Ooh, good call, guys. Yeah, looks like all we'd need to do is move
bootstrap.min.css and bootstrap-responsive.min.css onto our server and link
to it relatively instead of with absolute links it has now. Seeing as how
both of those CSS files are Apache License, should be easy.
-Dima
On Tue, Dec 30, 2014 at 11:54 AM, Elliott Clark <ec...@apache.org> wrote:
> Yeah the js and css are all loaded though a cdn. It should be pretty easy
> to change the urls to be protocol relative and then things should work.
>
> On Tue, Dec 30, 2014 at 11:17 AM, Enis Söztutar <en...@gmail.com>
> wrote:
>
> > I had the same problem. We link to CSS which is http instead of forking
> and
> > serving it in the site (I believe this is the default practice). My
> chrome
> > extension refuses to connect to http links causing rendering problems.
> >
> > Enis
> >
> > On Tue, Dec 30, 2014 at 11:00 AM, Dima Spivak <ds...@cloudera.com>
> > wrote:
> >
> > > Not sure if this is something to address in this thread or if I should
> > file
> > > a separate JIRA, but for some reason, accessing the site over https
> gets
> > > rid of the pretty CSS. Seems to happen in Chrome and Firefox. Anyone
> > have a
> > > clue why?
> > >
> > > -Dima
> > >
> > > On Wed, Dec 17, 2014 at 10:53 AM, Nick Dimiduk <nd...@gmail.com>
> > wrote:
> > >
> > > > Tweaking the layout of the website goes one of two ways. Either
> > there's a
> > > > configuration point exposed from the maven skin or there isn't. If
> > there
> > > > is, it's simply editing the appropriate custom tag in site.xml. If
> not,
> > > > we'll need to bring back the velocity site.vm template.
> Configurations
> > > are
> > > > documented here:
> > > > http://andriusvelykis.github.io/reflow-maven-skin/skin/config.html
> > > >
> > > > Tweaking visuals is now based on the theme. We can either choose
> > another
> > > > bootswatch theme, or write our own. That stuff is documented here:
> > > > http://andriusvelykis.github.io/reflow-maven-skin/skin/themes/
> > > >
> > > > Right now the site is separate from the book. In theory we could move
> > > book
> > > > content over to become site content, in which case it would be
> managed
> > by
> > > > this same plugin. Short of that, we get into applying style via the
> > > docbook
> > > > plugin. I've looked into this a bit; it's not nearly as easy as
> > applying
> > > > reflow-maven-skin. The current leads I have for this are
> > > > https://github.com/lcahlander/docbook and
> > > >
> > > >
> > >
> >
> https://github.com/pmartin/phing-documentation-docbook/commit/8d8f0b81951c4e07420083b204599a6b9ef00537
> > > > .
> > > >
> > > > Honestly though, if we're looking at moving away from docbook, I
> think
> > we
> > > > should consider a more modern toolset, Sphinx-doc, for example:
> > > > http://sphinx-doc.org
> > > >
> > > > On Tue, Dec 16, 2014 at 8:21 PM, Misty Stanley-Jones <
> > > > mstanleyjones@cloudera.com> wrote:
> > > > >
> > > > > Absolutely fantastic!!! Got pointers to how tweaking the website
> > would
> > > > > work?
> > > > >
> > > > > In the new year I hope to really get started on a restructure of
> the
> > > Ref
> > > > > Guide. I've thought about asking to move to AsciiDOC or MarkDown
> but
> > > I'd
> > > > > like to do a proof-of-concept and see if it really gets us anything
> > we
> > > > > don't already have with Docbook. It's less of a potential value
> since
> > > we
> > > > > are not hosted on Github, which has great integration with AsciiDOC
> > and
> > > > > MarkDown. I'm very interested in improving the look and feel of the
> > > doc.
> > > > I
> > > > > think a lot of it will be structural -- reorganizing and
> re-chunking
> > > > > content.
> > > > >
> > > > > In the meantime, theming the Docbook is not as hard as you might
> > think.
> > > > > Have a look at the XSLT files. (I know, famous last words).
> > > > >
> > > > > On Wed, Dec 17, 2014 at 1:21 PM, Nick Dimiduk <nd...@gmail.com>
> > > > wrote:
> > > > >
> > > > > > For those not following closely in JIRAland, I've two changes
> that
> > > are
> > > > > > ready to go. First, there's transition over to a bootstrap-based
> > > layout
> > > > > for
> > > > > > our home page. This work is done in HBASE-12688. This improves
> the
> > > > looks
> > > > > of
> > > > > > things and will make it pretty easy to update our look-and-feel
> in
> > > the
> > > > > > future. Second, I fixed a build problem where the online book
> > wasn't
> > > > > > getting its intended styling. This is done in HBASE-12687. I'd
> like
> > > to
> > > > > > update the book to look the same as the front-page, but getting
> > > styles
> > > > > into
> > > > > > docbook is proving non-trivial.
> > > > > >
> > > > > > Anyway, both of these changes are pushed to master and we're
> ready
> > > for
> > > > a
> > > > > > site re-build with the new look. I'll make that happen tomorrow
> > > morning
> > > > > > unless I hear actionable objections.
> > > > > >
> > > > > > You can get a preview of things to come over one
> > > > > > http://people.apache.org/~ndimiduk/site/
> > > > > >
> > > > > > Thanks,
> > > > > > Nick
> > > > > >
> > > > > > On Fri, Dec 5, 2014 at 12:29 PM, Stack <st...@duboce.net> wrote:
> > > > > > >
> > > > > > > Thanks. I've been having a dialog w/ your crew that has been
> > going
> > > > on a
> > > > > > > while... was wondering if any progress.
> > > > > > > Grand,
> > > > > > > St.Ack
> > > > > > >
> > > > > > > On Fri, Dec 5, 2014 at 11:55 AM, Ryan Rawson <
> ryanobjc@gmail.com
> > >
> > > > > wrote:
> > > > > > >
> > > > > > > > I'm checking to see if our marketing and web team can help.
> > The
> > > > > > > > primary requirement is going to be ditching the mvn:site from
> > the
> > > > > > > > front page. "reskinning it" might not be so easy.
> > > > > > > >
> > > > > > > > -ryan
> > > > > > > >
> > > > > > > > On Thu, Dec 4, 2014 at 9:52 AM, lars hofhansl <
> > larsh@apache.org>
> > > > > > wrote:
> > > > > > > > > +1
> > > > > > > > > I just came across one of the various HBase vs. Cassandra
> > > > articles,
> > > > > > and
> > > > > > > > one of the main tenants of the articles was how much better
> the
> > > > > > Cassandra
> > > > > > > > documentation was.Thank god we have Misty now. :)
> > > > > > > > >
> > > > > > > > > (not sure how much just a skin would help, but it surely
> > won't
> > > > > hurt)
> > > > > > > > >
> > > > > > > > > -- Lars
> > > > > > > > > From: Nick Dimiduk <nd...@gmail.com>
> > > > > > > > > To: hbase-dev <de...@hbase.apache.org>
> > > > > > > > > Sent: Tuesday, December 2, 2014 9:46 AM
> > > > > > > > > Subject: A face-lift for 1.0
> > > > > > > > >
> > > > > > > > > Heya,
> > > > > > > > >
> > > > > > > > > In mind of the new release, I was thinking we should clean
> up
> > > our
> > > > > > act a
> > > > > > > > > little bit in regard to hbase.apache.org and our book.
> Just
> > > > > because
> > > > > > > the
> > > > > > > > > project started in 2007 doesn't mean we need a site that
> > looks
> > > > like
> > > > > > > it's
> > > > > > > > > from 2007. Phoenix's site looks great in this regard.
> > > > > > > > >
> > > > > > > > > For the home page, I was thinking of converting it over to
> > > > > bootstrap
> > > > > > > [0]
> > > > > > > > so
> > > > > > > > > that it'll be easier to pick up theme, either on of our own
> > or
> > > > > > > something
> > > > > > > > > pre-canned [1]. I'm no web designer, but the idea is this
> > would
> > > > > make
> > > > > > it
> > > > > > > > > easier for someone who is to help us out.
> > > > > > > > >
> > > > > > > > > For the book, I just want to skin it -- no intention of
> > > changing
> > > > > > > docbook
> > > > > > > > > part (such a decision I'll leave up to Misty). I'm less
> sure
> > on
> > > > > this
> > > > > > > > > project, but Riak's docs are a nice inspiration.
> > > > > > > > >
> > > > > > > > > What do you think? Do we know any web designers who can
> help
> > > out
> > > > > with
> > > > > > > the
> > > > > > > > > CSS?
> > > > > > > > >
> > > > > > > > > -n
> > > > > > > > >
> > > > > > > > > [0]: http://getbootstrap.com
> > > > > > > > > [1]: https://wrapbootstrap.com/
> > > > > > > > > [2]: http://docs.basho.com/riak/latest/
> > > > > > > > >
> > > > > > > > >
> > > > > > > > >
> > > > > > > >
> > > > > > >
> > > > > >
> > > > >
> > > >
> > >
> >
>
Re: A face-lift for 1.0
Posted by Elliott Clark <ec...@apache.org>.
Yeah the js and css are all loaded though a cdn. It should be pretty easy
to change the urls to be protocol relative and then things should work.
On Tue, Dec 30, 2014 at 11:17 AM, Enis Söztutar <en...@gmail.com> wrote:
> I had the same problem. We link to CSS which is http instead of forking and
> serving it in the site (I believe this is the default practice). My chrome
> extension refuses to connect to http links causing rendering problems.
>
> Enis
>
> On Tue, Dec 30, 2014 at 11:00 AM, Dima Spivak <ds...@cloudera.com>
> wrote:
>
> > Not sure if this is something to address in this thread or if I should
> file
> > a separate JIRA, but for some reason, accessing the site over https gets
> > rid of the pretty CSS. Seems to happen in Chrome and Firefox. Anyone
> have a
> > clue why?
> >
> > -Dima
> >
> > On Wed, Dec 17, 2014 at 10:53 AM, Nick Dimiduk <nd...@gmail.com>
> wrote:
> >
> > > Tweaking the layout of the website goes one of two ways. Either
> there's a
> > > configuration point exposed from the maven skin or there isn't. If
> there
> > > is, it's simply editing the appropriate custom tag in site.xml. If not,
> > > we'll need to bring back the velocity site.vm template. Configurations
> > are
> > > documented here:
> > > http://andriusvelykis.github.io/reflow-maven-skin/skin/config.html
> > >
> > > Tweaking visuals is now based on the theme. We can either choose
> another
> > > bootswatch theme, or write our own. That stuff is documented here:
> > > http://andriusvelykis.github.io/reflow-maven-skin/skin/themes/
> > >
> > > Right now the site is separate from the book. In theory we could move
> > book
> > > content over to become site content, in which case it would be managed
> by
> > > this same plugin. Short of that, we get into applying style via the
> > docbook
> > > plugin. I've looked into this a bit; it's not nearly as easy as
> applying
> > > reflow-maven-skin. The current leads I have for this are
> > > https://github.com/lcahlander/docbook and
> > >
> > >
> >
> https://github.com/pmartin/phing-documentation-docbook/commit/8d8f0b81951c4e07420083b204599a6b9ef00537
> > > .
> > >
> > > Honestly though, if we're looking at moving away from docbook, I think
> we
> > > should consider a more modern toolset, Sphinx-doc, for example:
> > > http://sphinx-doc.org
> > >
> > > On Tue, Dec 16, 2014 at 8:21 PM, Misty Stanley-Jones <
> > > mstanleyjones@cloudera.com> wrote:
> > > >
> > > > Absolutely fantastic!!! Got pointers to how tweaking the website
> would
> > > > work?
> > > >
> > > > In the new year I hope to really get started on a restructure of the
> > Ref
> > > > Guide. I've thought about asking to move to AsciiDOC or MarkDown but
> > I'd
> > > > like to do a proof-of-concept and see if it really gets us anything
> we
> > > > don't already have with Docbook. It's less of a potential value since
> > we
> > > > are not hosted on Github, which has great integration with AsciiDOC
> and
> > > > MarkDown. I'm very interested in improving the look and feel of the
> > doc.
> > > I
> > > > think a lot of it will be structural -- reorganizing and re-chunking
> > > > content.
> > > >
> > > > In the meantime, theming the Docbook is not as hard as you might
> think.
> > > > Have a look at the XSLT files. (I know, famous last words).
> > > >
> > > > On Wed, Dec 17, 2014 at 1:21 PM, Nick Dimiduk <nd...@gmail.com>
> > > wrote:
> > > >
> > > > > For those not following closely in JIRAland, I've two changes that
> > are
> > > > > ready to go. First, there's transition over to a bootstrap-based
> > layout
> > > > for
> > > > > our home page. This work is done in HBASE-12688. This improves the
> > > looks
> > > > of
> > > > > things and will make it pretty easy to update our look-and-feel in
> > the
> > > > > future. Second, I fixed a build problem where the online book
> wasn't
> > > > > getting its intended styling. This is done in HBASE-12687. I'd like
> > to
> > > > > update the book to look the same as the front-page, but getting
> > styles
> > > > into
> > > > > docbook is proving non-trivial.
> > > > >
> > > > > Anyway, both of these changes are pushed to master and we're ready
> > for
> > > a
> > > > > site re-build with the new look. I'll make that happen tomorrow
> > morning
> > > > > unless I hear actionable objections.
> > > > >
> > > > > You can get a preview of things to come over one
> > > > > http://people.apache.org/~ndimiduk/site/
> > > > >
> > > > > Thanks,
> > > > > Nick
> > > > >
> > > > > On Fri, Dec 5, 2014 at 12:29 PM, Stack <st...@duboce.net> wrote:
> > > > > >
> > > > > > Thanks. I've been having a dialog w/ your crew that has been
> going
> > > on a
> > > > > > while... was wondering if any progress.
> > > > > > Grand,
> > > > > > St.Ack
> > > > > >
> > > > > > On Fri, Dec 5, 2014 at 11:55 AM, Ryan Rawson <ryanobjc@gmail.com
> >
> > > > wrote:
> > > > > >
> > > > > > > I'm checking to see if our marketing and web team can help.
> The
> > > > > > > primary requirement is going to be ditching the mvn:site from
> the
> > > > > > > front page. "reskinning it" might not be so easy.
> > > > > > >
> > > > > > > -ryan
> > > > > > >
> > > > > > > On Thu, Dec 4, 2014 at 9:52 AM, lars hofhansl <
> larsh@apache.org>
> > > > > wrote:
> > > > > > > > +1
> > > > > > > > I just came across one of the various HBase vs. Cassandra
> > > articles,
> > > > > and
> > > > > > > one of the main tenants of the articles was how much better the
> > > > > Cassandra
> > > > > > > documentation was.Thank god we have Misty now. :)
> > > > > > > >
> > > > > > > > (not sure how much just a skin would help, but it surely
> won't
> > > > hurt)
> > > > > > > >
> > > > > > > > -- Lars
> > > > > > > > From: Nick Dimiduk <nd...@gmail.com>
> > > > > > > > To: hbase-dev <de...@hbase.apache.org>
> > > > > > > > Sent: Tuesday, December 2, 2014 9:46 AM
> > > > > > > > Subject: A face-lift for 1.0
> > > > > > > >
> > > > > > > > Heya,
> > > > > > > >
> > > > > > > > In mind of the new release, I was thinking we should clean up
> > our
> > > > > act a
> > > > > > > > little bit in regard to hbase.apache.org and our book. Just
> > > > because
> > > > > > the
> > > > > > > > project started in 2007 doesn't mean we need a site that
> looks
> > > like
> > > > > > it's
> > > > > > > > from 2007. Phoenix's site looks great in this regard.
> > > > > > > >
> > > > > > > > For the home page, I was thinking of converting it over to
> > > > bootstrap
> > > > > > [0]
> > > > > > > so
> > > > > > > > that it'll be easier to pick up theme, either on of our own
> or
> > > > > > something
> > > > > > > > pre-canned [1]. I'm no web designer, but the idea is this
> would
> > > > make
> > > > > it
> > > > > > > > easier for someone who is to help us out.
> > > > > > > >
> > > > > > > > For the book, I just want to skin it -- no intention of
> > changing
> > > > > > docbook
> > > > > > > > part (such a decision I'll leave up to Misty). I'm less sure
> on
> > > > this
> > > > > > > > project, but Riak's docs are a nice inspiration.
> > > > > > > >
> > > > > > > > What do you think? Do we know any web designers who can help
> > out
> > > > with
> > > > > > the
> > > > > > > > CSS?
> > > > > > > >
> > > > > > > > -n
> > > > > > > >
> > > > > > > > [0]: http://getbootstrap.com
> > > > > > > > [1]: https://wrapbootstrap.com/
> > > > > > > > [2]: http://docs.basho.com/riak/latest/
> > > > > > > >
> > > > > > > >
> > > > > > > >
> > > > > > >
> > > > > >
> > > > >
> > > >
> > >
> >
>
Re: A face-lift for 1.0
Posted by Enis Söztutar <en...@gmail.com>.
I had the same problem. We link to CSS which is http instead of forking and
serving it in the site (I believe this is the default practice). My chrome
extension refuses to connect to http links causing rendering problems.
Enis
On Tue, Dec 30, 2014 at 11:00 AM, Dima Spivak <ds...@cloudera.com> wrote:
> Not sure if this is something to address in this thread or if I should file
> a separate JIRA, but for some reason, accessing the site over https gets
> rid of the pretty CSS. Seems to happen in Chrome and Firefox. Anyone have a
> clue why?
>
> -Dima
>
> On Wed, Dec 17, 2014 at 10:53 AM, Nick Dimiduk <nd...@gmail.com> wrote:
>
> > Tweaking the layout of the website goes one of two ways. Either there's a
> > configuration point exposed from the maven skin or there isn't. If there
> > is, it's simply editing the appropriate custom tag in site.xml. If not,
> > we'll need to bring back the velocity site.vm template. Configurations
> are
> > documented here:
> > http://andriusvelykis.github.io/reflow-maven-skin/skin/config.html
> >
> > Tweaking visuals is now based on the theme. We can either choose another
> > bootswatch theme, or write our own. That stuff is documented here:
> > http://andriusvelykis.github.io/reflow-maven-skin/skin/themes/
> >
> > Right now the site is separate from the book. In theory we could move
> book
> > content over to become site content, in which case it would be managed by
> > this same plugin. Short of that, we get into applying style via the
> docbook
> > plugin. I've looked into this a bit; it's not nearly as easy as applying
> > reflow-maven-skin. The current leads I have for this are
> > https://github.com/lcahlander/docbook and
> >
> >
> https://github.com/pmartin/phing-documentation-docbook/commit/8d8f0b81951c4e07420083b204599a6b9ef00537
> > .
> >
> > Honestly though, if we're looking at moving away from docbook, I think we
> > should consider a more modern toolset, Sphinx-doc, for example:
> > http://sphinx-doc.org
> >
> > On Tue, Dec 16, 2014 at 8:21 PM, Misty Stanley-Jones <
> > mstanleyjones@cloudera.com> wrote:
> > >
> > > Absolutely fantastic!!! Got pointers to how tweaking the website would
> > > work?
> > >
> > > In the new year I hope to really get started on a restructure of the
> Ref
> > > Guide. I've thought about asking to move to AsciiDOC or MarkDown but
> I'd
> > > like to do a proof-of-concept and see if it really gets us anything we
> > > don't already have with Docbook. It's less of a potential value since
> we
> > > are not hosted on Github, which has great integration with AsciiDOC and
> > > MarkDown. I'm very interested in improving the look and feel of the
> doc.
> > I
> > > think a lot of it will be structural -- reorganizing and re-chunking
> > > content.
> > >
> > > In the meantime, theming the Docbook is not as hard as you might think.
> > > Have a look at the XSLT files. (I know, famous last words).
> > >
> > > On Wed, Dec 17, 2014 at 1:21 PM, Nick Dimiduk <nd...@gmail.com>
> > wrote:
> > >
> > > > For those not following closely in JIRAland, I've two changes that
> are
> > > > ready to go. First, there's transition over to a bootstrap-based
> layout
> > > for
> > > > our home page. This work is done in HBASE-12688. This improves the
> > looks
> > > of
> > > > things and will make it pretty easy to update our look-and-feel in
> the
> > > > future. Second, I fixed a build problem where the online book wasn't
> > > > getting its intended styling. This is done in HBASE-12687. I'd like
> to
> > > > update the book to look the same as the front-page, but getting
> styles
> > > into
> > > > docbook is proving non-trivial.
> > > >
> > > > Anyway, both of these changes are pushed to master and we're ready
> for
> > a
> > > > site re-build with the new look. I'll make that happen tomorrow
> morning
> > > > unless I hear actionable objections.
> > > >
> > > > You can get a preview of things to come over one
> > > > http://people.apache.org/~ndimiduk/site/
> > > >
> > > > Thanks,
> > > > Nick
> > > >
> > > > On Fri, Dec 5, 2014 at 12:29 PM, Stack <st...@duboce.net> wrote:
> > > > >
> > > > > Thanks. I've been having a dialog w/ your crew that has been going
> > on a
> > > > > while... was wondering if any progress.
> > > > > Grand,
> > > > > St.Ack
> > > > >
> > > > > On Fri, Dec 5, 2014 at 11:55 AM, Ryan Rawson <ry...@gmail.com>
> > > wrote:
> > > > >
> > > > > > I'm checking to see if our marketing and web team can help. The
> > > > > > primary requirement is going to be ditching the mvn:site from the
> > > > > > front page. "reskinning it" might not be so easy.
> > > > > >
> > > > > > -ryan
> > > > > >
> > > > > > On Thu, Dec 4, 2014 at 9:52 AM, lars hofhansl <la...@apache.org>
> > > > wrote:
> > > > > > > +1
> > > > > > > I just came across one of the various HBase vs. Cassandra
> > articles,
> > > > and
> > > > > > one of the main tenants of the articles was how much better the
> > > > Cassandra
> > > > > > documentation was.Thank god we have Misty now. :)
> > > > > > >
> > > > > > > (not sure how much just a skin would help, but it surely won't
> > > hurt)
> > > > > > >
> > > > > > > -- Lars
> > > > > > > From: Nick Dimiduk <nd...@gmail.com>
> > > > > > > To: hbase-dev <de...@hbase.apache.org>
> > > > > > > Sent: Tuesday, December 2, 2014 9:46 AM
> > > > > > > Subject: A face-lift for 1.0
> > > > > > >
> > > > > > > Heya,
> > > > > > >
> > > > > > > In mind of the new release, I was thinking we should clean up
> our
> > > > act a
> > > > > > > little bit in regard to hbase.apache.org and our book. Just
> > > because
> > > > > the
> > > > > > > project started in 2007 doesn't mean we need a site that looks
> > like
> > > > > it's
> > > > > > > from 2007. Phoenix's site looks great in this regard.
> > > > > > >
> > > > > > > For the home page, I was thinking of converting it over to
> > > bootstrap
> > > > > [0]
> > > > > > so
> > > > > > > that it'll be easier to pick up theme, either on of our own or
> > > > > something
> > > > > > > pre-canned [1]. I'm no web designer, but the idea is this would
> > > make
> > > > it
> > > > > > > easier for someone who is to help us out.
> > > > > > >
> > > > > > > For the book, I just want to skin it -- no intention of
> changing
> > > > > docbook
> > > > > > > part (such a decision I'll leave up to Misty). I'm less sure on
> > > this
> > > > > > > project, but Riak's docs are a nice inspiration.
> > > > > > >
> > > > > > > What do you think? Do we know any web designers who can help
> out
> > > with
> > > > > the
> > > > > > > CSS?
> > > > > > >
> > > > > > > -n
> > > > > > >
> > > > > > > [0]: http://getbootstrap.com
> > > > > > > [1]: https://wrapbootstrap.com/
> > > > > > > [2]: http://docs.basho.com/riak/latest/
> > > > > > >
> > > > > > >
> > > > > > >
> > > > > >
> > > > >
> > > >
> > >
> >
>
Re: A face-lift for 1.0
Posted by Dima Spivak <ds...@cloudera.com>.
Not sure if this is something to address in this thread or if I should file
a separate JIRA, but for some reason, accessing the site over https gets
rid of the pretty CSS. Seems to happen in Chrome and Firefox. Anyone have a
clue why?
-Dima
On Wed, Dec 17, 2014 at 10:53 AM, Nick Dimiduk <nd...@gmail.com> wrote:
> Tweaking the layout of the website goes one of two ways. Either there's a
> configuration point exposed from the maven skin or there isn't. If there
> is, it's simply editing the appropriate custom tag in site.xml. If not,
> we'll need to bring back the velocity site.vm template. Configurations are
> documented here:
> http://andriusvelykis.github.io/reflow-maven-skin/skin/config.html
>
> Tweaking visuals is now based on the theme. We can either choose another
> bootswatch theme, or write our own. That stuff is documented here:
> http://andriusvelykis.github.io/reflow-maven-skin/skin/themes/
>
> Right now the site is separate from the book. In theory we could move book
> content over to become site content, in which case it would be managed by
> this same plugin. Short of that, we get into applying style via the docbook
> plugin. I've looked into this a bit; it's not nearly as easy as applying
> reflow-maven-skin. The current leads I have for this are
> https://github.com/lcahlander/docbook and
>
> https://github.com/pmartin/phing-documentation-docbook/commit/8d8f0b81951c4e07420083b204599a6b9ef00537
> .
>
> Honestly though, if we're looking at moving away from docbook, I think we
> should consider a more modern toolset, Sphinx-doc, for example:
> http://sphinx-doc.org
>
> On Tue, Dec 16, 2014 at 8:21 PM, Misty Stanley-Jones <
> mstanleyjones@cloudera.com> wrote:
> >
> > Absolutely fantastic!!! Got pointers to how tweaking the website would
> > work?
> >
> > In the new year I hope to really get started on a restructure of the Ref
> > Guide. I've thought about asking to move to AsciiDOC or MarkDown but I'd
> > like to do a proof-of-concept and see if it really gets us anything we
> > don't already have with Docbook. It's less of a potential value since we
> > are not hosted on Github, which has great integration with AsciiDOC and
> > MarkDown. I'm very interested in improving the look and feel of the doc.
> I
> > think a lot of it will be structural -- reorganizing and re-chunking
> > content.
> >
> > In the meantime, theming the Docbook is not as hard as you might think.
> > Have a look at the XSLT files. (I know, famous last words).
> >
> > On Wed, Dec 17, 2014 at 1:21 PM, Nick Dimiduk <nd...@gmail.com>
> wrote:
> >
> > > For those not following closely in JIRAland, I've two changes that are
> > > ready to go. First, there's transition over to a bootstrap-based layout
> > for
> > > our home page. This work is done in HBASE-12688. This improves the
> looks
> > of
> > > things and will make it pretty easy to update our look-and-feel in the
> > > future. Second, I fixed a build problem where the online book wasn't
> > > getting its intended styling. This is done in HBASE-12687. I'd like to
> > > update the book to look the same as the front-page, but getting styles
> > into
> > > docbook is proving non-trivial.
> > >
> > > Anyway, both of these changes are pushed to master and we're ready for
> a
> > > site re-build with the new look. I'll make that happen tomorrow morning
> > > unless I hear actionable objections.
> > >
> > > You can get a preview of things to come over one
> > > http://people.apache.org/~ndimiduk/site/
> > >
> > > Thanks,
> > > Nick
> > >
> > > On Fri, Dec 5, 2014 at 12:29 PM, Stack <st...@duboce.net> wrote:
> > > >
> > > > Thanks. I've been having a dialog w/ your crew that has been going
> on a
> > > > while... was wondering if any progress.
> > > > Grand,
> > > > St.Ack
> > > >
> > > > On Fri, Dec 5, 2014 at 11:55 AM, Ryan Rawson <ry...@gmail.com>
> > wrote:
> > > >
> > > > > I'm checking to see if our marketing and web team can help. The
> > > > > primary requirement is going to be ditching the mvn:site from the
> > > > > front page. "reskinning it" might not be so easy.
> > > > >
> > > > > -ryan
> > > > >
> > > > > On Thu, Dec 4, 2014 at 9:52 AM, lars hofhansl <la...@apache.org>
> > > wrote:
> > > > > > +1
> > > > > > I just came across one of the various HBase vs. Cassandra
> articles,
> > > and
> > > > > one of the main tenants of the articles was how much better the
> > > Cassandra
> > > > > documentation was.Thank god we have Misty now. :)
> > > > > >
> > > > > > (not sure how much just a skin would help, but it surely won't
> > hurt)
> > > > > >
> > > > > > -- Lars
> > > > > > From: Nick Dimiduk <nd...@gmail.com>
> > > > > > To: hbase-dev <de...@hbase.apache.org>
> > > > > > Sent: Tuesday, December 2, 2014 9:46 AM
> > > > > > Subject: A face-lift for 1.0
> > > > > >
> > > > > > Heya,
> > > > > >
> > > > > > In mind of the new release, I was thinking we should clean up our
> > > act a
> > > > > > little bit in regard to hbase.apache.org and our book. Just
> > because
> > > > the
> > > > > > project started in 2007 doesn't mean we need a site that looks
> like
> > > > it's
> > > > > > from 2007. Phoenix's site looks great in this regard.
> > > > > >
> > > > > > For the home page, I was thinking of converting it over to
> > bootstrap
> > > > [0]
> > > > > so
> > > > > > that it'll be easier to pick up theme, either on of our own or
> > > > something
> > > > > > pre-canned [1]. I'm no web designer, but the idea is this would
> > make
> > > it
> > > > > > easier for someone who is to help us out.
> > > > > >
> > > > > > For the book, I just want to skin it -- no intention of changing
> > > > docbook
> > > > > > part (such a decision I'll leave up to Misty). I'm less sure on
> > this
> > > > > > project, but Riak's docs are a nice inspiration.
> > > > > >
> > > > > > What do you think? Do we know any web designers who can help out
> > with
> > > > the
> > > > > > CSS?
> > > > > >
> > > > > > -n
> > > > > >
> > > > > > [0]: http://getbootstrap.com
> > > > > > [1]: https://wrapbootstrap.com/
> > > > > > [2]: http://docs.basho.com/riak/latest/
> > > > > >
> > > > > >
> > > > > >
> > > > >
> > > >
> > >
> >
>
Re: A face-lift for 1.0
Posted by Nick Dimiduk <nd...@gmail.com>.
Tweaking the layout of the website goes one of two ways. Either there's a
configuration point exposed from the maven skin or there isn't. If there
is, it's simply editing the appropriate custom tag in site.xml. If not,
we'll need to bring back the velocity site.vm template. Configurations are
documented here:
http://andriusvelykis.github.io/reflow-maven-skin/skin/config.html
Tweaking visuals is now based on the theme. We can either choose another
bootswatch theme, or write our own. That stuff is documented here:
http://andriusvelykis.github.io/reflow-maven-skin/skin/themes/
Right now the site is separate from the book. In theory we could move book
content over to become site content, in which case it would be managed by
this same plugin. Short of that, we get into applying style via the docbook
plugin. I've looked into this a bit; it's not nearly as easy as applying
reflow-maven-skin. The current leads I have for this are
https://github.com/lcahlander/docbook and
https://github.com/pmartin/phing-documentation-docbook/commit/8d8f0b81951c4e07420083b204599a6b9ef00537
.
Honestly though, if we're looking at moving away from docbook, I think we
should consider a more modern toolset, Sphinx-doc, for example:
http://sphinx-doc.org
On Tue, Dec 16, 2014 at 8:21 PM, Misty Stanley-Jones <
mstanleyjones@cloudera.com> wrote:
>
> Absolutely fantastic!!! Got pointers to how tweaking the website would
> work?
>
> In the new year I hope to really get started on a restructure of the Ref
> Guide. I've thought about asking to move to AsciiDOC or MarkDown but I'd
> like to do a proof-of-concept and see if it really gets us anything we
> don't already have with Docbook. It's less of a potential value since we
> are not hosted on Github, which has great integration with AsciiDOC and
> MarkDown. I'm very interested in improving the look and feel of the doc. I
> think a lot of it will be structural -- reorganizing and re-chunking
> content.
>
> In the meantime, theming the Docbook is not as hard as you might think.
> Have a look at the XSLT files. (I know, famous last words).
>
> On Wed, Dec 17, 2014 at 1:21 PM, Nick Dimiduk <nd...@gmail.com> wrote:
>
> > For those not following closely in JIRAland, I've two changes that are
> > ready to go. First, there's transition over to a bootstrap-based layout
> for
> > our home page. This work is done in HBASE-12688. This improves the looks
> of
> > things and will make it pretty easy to update our look-and-feel in the
> > future. Second, I fixed a build problem where the online book wasn't
> > getting its intended styling. This is done in HBASE-12687. I'd like to
> > update the book to look the same as the front-page, but getting styles
> into
> > docbook is proving non-trivial.
> >
> > Anyway, both of these changes are pushed to master and we're ready for a
> > site re-build with the new look. I'll make that happen tomorrow morning
> > unless I hear actionable objections.
> >
> > You can get a preview of things to come over one
> > http://people.apache.org/~ndimiduk/site/
> >
> > Thanks,
> > Nick
> >
> > On Fri, Dec 5, 2014 at 12:29 PM, Stack <st...@duboce.net> wrote:
> > >
> > > Thanks. I've been having a dialog w/ your crew that has been going on a
> > > while... was wondering if any progress.
> > > Grand,
> > > St.Ack
> > >
> > > On Fri, Dec 5, 2014 at 11:55 AM, Ryan Rawson <ry...@gmail.com>
> wrote:
> > >
> > > > I'm checking to see if our marketing and web team can help. The
> > > > primary requirement is going to be ditching the mvn:site from the
> > > > front page. "reskinning it" might not be so easy.
> > > >
> > > > -ryan
> > > >
> > > > On Thu, Dec 4, 2014 at 9:52 AM, lars hofhansl <la...@apache.org>
> > wrote:
> > > > > +1
> > > > > I just came across one of the various HBase vs. Cassandra articles,
> > and
> > > > one of the main tenants of the articles was how much better the
> > Cassandra
> > > > documentation was.Thank god we have Misty now. :)
> > > > >
> > > > > (not sure how much just a skin would help, but it surely won't
> hurt)
> > > > >
> > > > > -- Lars
> > > > > From: Nick Dimiduk <nd...@gmail.com>
> > > > > To: hbase-dev <de...@hbase.apache.org>
> > > > > Sent: Tuesday, December 2, 2014 9:46 AM
> > > > > Subject: A face-lift for 1.0
> > > > >
> > > > > Heya,
> > > > >
> > > > > In mind of the new release, I was thinking we should clean up our
> > act a
> > > > > little bit in regard to hbase.apache.org and our book. Just
> because
> > > the
> > > > > project started in 2007 doesn't mean we need a site that looks like
> > > it's
> > > > > from 2007. Phoenix's site looks great in this regard.
> > > > >
> > > > > For the home page, I was thinking of converting it over to
> bootstrap
> > > [0]
> > > > so
> > > > > that it'll be easier to pick up theme, either on of our own or
> > > something
> > > > > pre-canned [1]. I'm no web designer, but the idea is this would
> make
> > it
> > > > > easier for someone who is to help us out.
> > > > >
> > > > > For the book, I just want to skin it -- no intention of changing
> > > docbook
> > > > > part (such a decision I'll leave up to Misty). I'm less sure on
> this
> > > > > project, but Riak's docs are a nice inspiration.
> > > > >
> > > > > What do you think? Do we know any web designers who can help out
> with
> > > the
> > > > > CSS?
> > > > >
> > > > > -n
> > > > >
> > > > > [0]: http://getbootstrap.com
> > > > > [1]: https://wrapbootstrap.com/
> > > > > [2]: http://docs.basho.com/riak/latest/
> > > > >
> > > > >
> > > > >
> > > >
> > >
> >
>
Re: A face-lift for 1.0
Posted by Stack <st...@duboce.net>.
On Tue, Dec 16, 2014 at 11:04 PM, Misty Stanley-Jones <
mstanleyjones@cloudera.com> wrote:
>
> The beautiful new site is live! Thanks, Nick!
>
>
Thanks Nick -- looks good (and Misty for pushing).
St.Ack
Re: A face-lift for 1.0
Posted by Misty Stanley-Jones <ms...@cloudera.com>.
The beautiful new site is live! Thanks, Nick!
On Wed, Dec 17, 2014 at 2:21 PM, Misty Stanley-Jones <
mstanleyjones@cloudera.com> wrote:
> Absolutely fantastic!!! Got pointers to how tweaking the website would
> work?
>
> In the new year I hope to really get started on a restructure of the Ref
> Guide. I've thought about asking to move to AsciiDOC or MarkDown but I'd
> like to do a proof-of-concept and see if it really gets us anything we
> don't already have with Docbook. It's less of a potential value since we
> are not hosted on Github, which has great integration with AsciiDOC and
> MarkDown. I'm very interested in improving the look and feel of the doc. I
> think a lot of it will be structural -- reorganizing and re-chunking
> content.
>
> In the meantime, theming the Docbook is not as hard as you might think.
> Have a look at the XSLT files. (I know, famous last words).
>
> On Wed, Dec 17, 2014 at 1:21 PM, Nick Dimiduk <nd...@gmail.com> wrote:
>
>> For those not following closely in JIRAland, I've two changes that are
>> ready to go. First, there's transition over to a bootstrap-based layout
>> for
>> our home page. This work is done in HBASE-12688. This improves the looks
>> of
>> things and will make it pretty easy to update our look-and-feel in the
>> future. Second, I fixed a build problem where the online book wasn't
>> getting its intended styling. This is done in HBASE-12687. I'd like to
>> update the book to look the same as the front-page, but getting styles
>> into
>> docbook is proving non-trivial.
>>
>> Anyway, both of these changes are pushed to master and we're ready for a
>> site re-build with the new look. I'll make that happen tomorrow morning
>> unless I hear actionable objections.
>>
>> You can get a preview of things to come over one
>> http://people.apache.org/~ndimiduk/site/
>>
>> Thanks,
>> Nick
>>
>> On Fri, Dec 5, 2014 at 12:29 PM, Stack <st...@duboce.net> wrote:
>> >
>> > Thanks. I've been having a dialog w/ your crew that has been going on a
>> > while... was wondering if any progress.
>> > Grand,
>> > St.Ack
>> >
>> > On Fri, Dec 5, 2014 at 11:55 AM, Ryan Rawson <ry...@gmail.com>
>> wrote:
>> >
>> > > I'm checking to see if our marketing and web team can help. The
>> > > primary requirement is going to be ditching the mvn:site from the
>> > > front page. "reskinning it" might not be so easy.
>> > >
>> > > -ryan
>> > >
>> > > On Thu, Dec 4, 2014 at 9:52 AM, lars hofhansl <la...@apache.org>
>> wrote:
>> > > > +1
>> > > > I just came across one of the various HBase vs. Cassandra articles,
>> and
>> > > one of the main tenants of the articles was how much better the
>> Cassandra
>> > > documentation was.Thank god we have Misty now. :)
>> > > >
>> > > > (not sure how much just a skin would help, but it surely won't hurt)
>> > > >
>> > > > -- Lars
>> > > > From: Nick Dimiduk <nd...@gmail.com>
>> > > > To: hbase-dev <de...@hbase.apache.org>
>> > > > Sent: Tuesday, December 2, 2014 9:46 AM
>> > > > Subject: A face-lift for 1.0
>> > > >
>> > > > Heya,
>> > > >
>> > > > In mind of the new release, I was thinking we should clean up our
>> act a
>> > > > little bit in regard to hbase.apache.org and our book. Just because
>> > the
>> > > > project started in 2007 doesn't mean we need a site that looks like
>> > it's
>> > > > from 2007. Phoenix's site looks great in this regard.
>> > > >
>> > > > For the home page, I was thinking of converting it over to bootstrap
>> > [0]
>> > > so
>> > > > that it'll be easier to pick up theme, either on of our own or
>> > something
>> > > > pre-canned [1]. I'm no web designer, but the idea is this would
>> make it
>> > > > easier for someone who is to help us out.
>> > > >
>> > > > For the book, I just want to skin it -- no intention of changing
>> > docbook
>> > > > part (such a decision I'll leave up to Misty). I'm less sure on this
>> > > > project, but Riak's docs are a nice inspiration.
>> > > >
>> > > > What do you think? Do we know any web designers who can help out
>> with
>> > the
>> > > > CSS?
>> > > >
>> > > > -n
>> > > >
>> > > > [0]: http://getbootstrap.com
>> > > > [1]: https://wrapbootstrap.com/
>> > > > [2]: http://docs.basho.com/riak/latest/
>> > > >
>> > > >
>> > > >
>> > >
>> >
>>
>
>
Re: A face-lift for 1.0
Posted by Misty Stanley-Jones <ms...@cloudera.com>.
Absolutely fantastic!!! Got pointers to how tweaking the website would work?
In the new year I hope to really get started on a restructure of the Ref
Guide. I've thought about asking to move to AsciiDOC or MarkDown but I'd
like to do a proof-of-concept and see if it really gets us anything we
don't already have with Docbook. It's less of a potential value since we
are not hosted on Github, which has great integration with AsciiDOC and
MarkDown. I'm very interested in improving the look and feel of the doc. I
think a lot of it will be structural -- reorganizing and re-chunking
content.
In the meantime, theming the Docbook is not as hard as you might think.
Have a look at the XSLT files. (I know, famous last words).
On Wed, Dec 17, 2014 at 1:21 PM, Nick Dimiduk <nd...@gmail.com> wrote:
> For those not following closely in JIRAland, I've two changes that are
> ready to go. First, there's transition over to a bootstrap-based layout for
> our home page. This work is done in HBASE-12688. This improves the looks of
> things and will make it pretty easy to update our look-and-feel in the
> future. Second, I fixed a build problem where the online book wasn't
> getting its intended styling. This is done in HBASE-12687. I'd like to
> update the book to look the same as the front-page, but getting styles into
> docbook is proving non-trivial.
>
> Anyway, both of these changes are pushed to master and we're ready for a
> site re-build with the new look. I'll make that happen tomorrow morning
> unless I hear actionable objections.
>
> You can get a preview of things to come over one
> http://people.apache.org/~ndimiduk/site/
>
> Thanks,
> Nick
>
> On Fri, Dec 5, 2014 at 12:29 PM, Stack <st...@duboce.net> wrote:
> >
> > Thanks. I've been having a dialog w/ your crew that has been going on a
> > while... was wondering if any progress.
> > Grand,
> > St.Ack
> >
> > On Fri, Dec 5, 2014 at 11:55 AM, Ryan Rawson <ry...@gmail.com> wrote:
> >
> > > I'm checking to see if our marketing and web team can help. The
> > > primary requirement is going to be ditching the mvn:site from the
> > > front page. "reskinning it" might not be so easy.
> > >
> > > -ryan
> > >
> > > On Thu, Dec 4, 2014 at 9:52 AM, lars hofhansl <la...@apache.org>
> wrote:
> > > > +1
> > > > I just came across one of the various HBase vs. Cassandra articles,
> and
> > > one of the main tenants of the articles was how much better the
> Cassandra
> > > documentation was.Thank god we have Misty now. :)
> > > >
> > > > (not sure how much just a skin would help, but it surely won't hurt)
> > > >
> > > > -- Lars
> > > > From: Nick Dimiduk <nd...@gmail.com>
> > > > To: hbase-dev <de...@hbase.apache.org>
> > > > Sent: Tuesday, December 2, 2014 9:46 AM
> > > > Subject: A face-lift for 1.0
> > > >
> > > > Heya,
> > > >
> > > > In mind of the new release, I was thinking we should clean up our
> act a
> > > > little bit in regard to hbase.apache.org and our book. Just because
> > the
> > > > project started in 2007 doesn't mean we need a site that looks like
> > it's
> > > > from 2007. Phoenix's site looks great in this regard.
> > > >
> > > > For the home page, I was thinking of converting it over to bootstrap
> > [0]
> > > so
> > > > that it'll be easier to pick up theme, either on of our own or
> > something
> > > > pre-canned [1]. I'm no web designer, but the idea is this would make
> it
> > > > easier for someone who is to help us out.
> > > >
> > > > For the book, I just want to skin it -- no intention of changing
> > docbook
> > > > part (such a decision I'll leave up to Misty). I'm less sure on this
> > > > project, but Riak's docs are a nice inspiration.
> > > >
> > > > What do you think? Do we know any web designers who can help out with
> > the
> > > > CSS?
> > > >
> > > > -n
> > > >
> > > > [0]: http://getbootstrap.com
> > > > [1]: https://wrapbootstrap.com/
> > > > [2]: http://docs.basho.com/riak/latest/
> > > >
> > > >
> > > >
> > >
> >
>
Re: A face-lift for 1.0
Posted by Nick Dimiduk <nd...@gmail.com>.
For those not following closely in JIRAland, I've two changes that are
ready to go. First, there's transition over to a bootstrap-based layout for
our home page. This work is done in HBASE-12688. This improves the looks of
things and will make it pretty easy to update our look-and-feel in the
future. Second, I fixed a build problem where the online book wasn't
getting its intended styling. This is done in HBASE-12687. I'd like to
update the book to look the same as the front-page, but getting styles into
docbook is proving non-trivial.
Anyway, both of these changes are pushed to master and we're ready for a
site re-build with the new look. I'll make that happen tomorrow morning
unless I hear actionable objections.
You can get a preview of things to come over one
http://people.apache.org/~ndimiduk/site/
Thanks,
Nick
On Fri, Dec 5, 2014 at 12:29 PM, Stack <st...@duboce.net> wrote:
>
> Thanks. I've been having a dialog w/ your crew that has been going on a
> while... was wondering if any progress.
> Grand,
> St.Ack
>
> On Fri, Dec 5, 2014 at 11:55 AM, Ryan Rawson <ry...@gmail.com> wrote:
>
> > I'm checking to see if our marketing and web team can help. The
> > primary requirement is going to be ditching the mvn:site from the
> > front page. "reskinning it" might not be so easy.
> >
> > -ryan
> >
> > On Thu, Dec 4, 2014 at 9:52 AM, lars hofhansl <la...@apache.org> wrote:
> > > +1
> > > I just came across one of the various HBase vs. Cassandra articles, and
> > one of the main tenants of the articles was how much better the Cassandra
> > documentation was.Thank god we have Misty now. :)
> > >
> > > (not sure how much just a skin would help, but it surely won't hurt)
> > >
> > > -- Lars
> > > From: Nick Dimiduk <nd...@gmail.com>
> > > To: hbase-dev <de...@hbase.apache.org>
> > > Sent: Tuesday, December 2, 2014 9:46 AM
> > > Subject: A face-lift for 1.0
> > >
> > > Heya,
> > >
> > > In mind of the new release, I was thinking we should clean up our act a
> > > little bit in regard to hbase.apache.org and our book. Just because
> the
> > > project started in 2007 doesn't mean we need a site that looks like
> it's
> > > from 2007. Phoenix's site looks great in this regard.
> > >
> > > For the home page, I was thinking of converting it over to bootstrap
> [0]
> > so
> > > that it'll be easier to pick up theme, either on of our own or
> something
> > > pre-canned [1]. I'm no web designer, but the idea is this would make it
> > > easier for someone who is to help us out.
> > >
> > > For the book, I just want to skin it -- no intention of changing
> docbook
> > > part (such a decision I'll leave up to Misty). I'm less sure on this
> > > project, but Riak's docs are a nice inspiration.
> > >
> > > What do you think? Do we know any web designers who can help out with
> the
> > > CSS?
> > >
> > > -n
> > >
> > > [0]: http://getbootstrap.com
> > > [1]: https://wrapbootstrap.com/
> > > [2]: http://docs.basho.com/riak/latest/
> > >
> > >
> > >
> >
>
Re: A face-lift for 1.0
Posted by Stack <st...@duboce.net>.
Thanks. I've been having a dialog w/ your crew that has been going on a
while... was wondering if any progress.
Grand,
St.Ack
On Fri, Dec 5, 2014 at 11:55 AM, Ryan Rawson <ry...@gmail.com> wrote:
> I'm checking to see if our marketing and web team can help. The
> primary requirement is going to be ditching the mvn:site from the
> front page. "reskinning it" might not be so easy.
>
> -ryan
>
> On Thu, Dec 4, 2014 at 9:52 AM, lars hofhansl <la...@apache.org> wrote:
> > +1
> > I just came across one of the various HBase vs. Cassandra articles, and
> one of the main tenants of the articles was how much better the Cassandra
> documentation was.Thank god we have Misty now. :)
> >
> > (not sure how much just a skin would help, but it surely won't hurt)
> >
> > -- Lars
> > From: Nick Dimiduk <nd...@gmail.com>
> > To: hbase-dev <de...@hbase.apache.org>
> > Sent: Tuesday, December 2, 2014 9:46 AM
> > Subject: A face-lift for 1.0
> >
> > Heya,
> >
> > In mind of the new release, I was thinking we should clean up our act a
> > little bit in regard to hbase.apache.org and our book. Just because the
> > project started in 2007 doesn't mean we need a site that looks like it's
> > from 2007. Phoenix's site looks great in this regard.
> >
> > For the home page, I was thinking of converting it over to bootstrap [0]
> so
> > that it'll be easier to pick up theme, either on of our own or something
> > pre-canned [1]. I'm no web designer, but the idea is this would make it
> > easier for someone who is to help us out.
> >
> > For the book, I just want to skin it -- no intention of changing docbook
> > part (such a decision I'll leave up to Misty). I'm less sure on this
> > project, but Riak's docs are a nice inspiration.
> >
> > What do you think? Do we know any web designers who can help out with the
> > CSS?
> >
> > -n
> >
> > [0]: http://getbootstrap.com
> > [1]: https://wrapbootstrap.com/
> > [2]: http://docs.basho.com/riak/latest/
> >
> >
> >
>
Re: A face-lift for 1.0
Posted by Ryan Rawson <ry...@gmail.com>.
I'm checking to see if our marketing and web team can help. The
primary requirement is going to be ditching the mvn:site from the
front page. "reskinning it" might not be so easy.
-ryan
On Thu, Dec 4, 2014 at 9:52 AM, lars hofhansl <la...@apache.org> wrote:
> +1
> I just came across one of the various HBase vs. Cassandra articles, and one of the main tenants of the articles was how much better the Cassandra documentation was.Thank god we have Misty now. :)
>
> (not sure how much just a skin would help, but it surely won't hurt)
>
> -- Lars
> From: Nick Dimiduk <nd...@gmail.com>
> To: hbase-dev <de...@hbase.apache.org>
> Sent: Tuesday, December 2, 2014 9:46 AM
> Subject: A face-lift for 1.0
>
> Heya,
>
> In mind of the new release, I was thinking we should clean up our act a
> little bit in regard to hbase.apache.org and our book. Just because the
> project started in 2007 doesn't mean we need a site that looks like it's
> from 2007. Phoenix's site looks great in this regard.
>
> For the home page, I was thinking of converting it over to bootstrap [0] so
> that it'll be easier to pick up theme, either on of our own or something
> pre-canned [1]. I'm no web designer, but the idea is this would make it
> easier for someone who is to help us out.
>
> For the book, I just want to skin it -- no intention of changing docbook
> part (such a decision I'll leave up to Misty). I'm less sure on this
> project, but Riak's docs are a nice inspiration.
>
> What do you think? Do we know any web designers who can help out with the
> CSS?
>
> -n
>
> [0]: http://getbootstrap.com
> [1]: https://wrapbootstrap.com/
> [2]: http://docs.basho.com/riak/latest/
>
>
>
Re: A face-lift for 1.0
Posted by lars hofhansl <la...@apache.org>.
+1
I just came across one of the various HBase vs. Cassandra articles, and one of the main tenants of the articles was how much better the Cassandra documentation was.Thank god we have Misty now. :)
(not sure how much just a skin would help, but it surely won't hurt)
-- Lars
From: Nick Dimiduk <nd...@gmail.com>
To: hbase-dev <de...@hbase.apache.org>
Sent: Tuesday, December 2, 2014 9:46 AM
Subject: A face-lift for 1.0
Heya,
In mind of the new release, I was thinking we should clean up our act a
little bit in regard to hbase.apache.org and our book. Just because the
project started in 2007 doesn't mean we need a site that looks like it's
from 2007. Phoenix's site looks great in this regard.
For the home page, I was thinking of converting it over to bootstrap [0] so
that it'll be easier to pick up theme, either on of our own or something
pre-canned [1]. I'm no web designer, but the idea is this would make it
easier for someone who is to help us out.
For the book, I just want to skin it -- no intention of changing docbook
part (such a decision I'll leave up to Misty). I'm less sure on this
project, but Riak's docs are a nice inspiration.
What do you think? Do we know any web designers who can help out with the
CSS?
-n
[0]: http://getbootstrap.com
[1]: https://wrapbootstrap.com/
[2]: http://docs.basho.com/riak/latest/