[Mesa-dev] [PATCH 00/16] Move the Mesa Website to Sphinx

Thu Jun 7 11:37:12 UTC 2018

On Thursday, 2018-06-07 13:42:06 +1000, Stuart Young wrote:
> I see that the theme and logo is now on the test site! All looks good.
> 
> As a test, I threw the site at WebSiteTest, Pingdom, GTMetrix and Google
> PageSpeed Insights and all came back with great results.
> 
> There's a few things like client caching times of static resources like
> css/js/tff/woff/etc and Vary: Accept Encoding, but that's usually all
> server setup (existing mesa site isn't much better).
> 
> Things missing that probably should be addressed:
> 1. favicon.ico - I can see it in the v2 repo, but looks like it's still not
> loading. Not sure what's going on there. Permissions issue (world readable)?

conf.py just needs an added `html_favicon = "favicon.ico"`
(really, sphinx should detect that one)

> 2. _static/fonts/fontawesome-webfont.woff2?v=4.6.3 seems to fail to load.
> Definitely not there at
> https://gitlab.freedesktop.org/ldeks/mesa/tree/website1_75_v2/docs/ which
> I'm assuming is the latest update out there?

That's provided by the sphinx theme, not us, so it wouldn't appear there
anyway.

Laura/Daniel, could it be that the container shipping an old version of
the theme, one which is missing this fix [1]?

[1] https://github.com/rtfd/sphinx_rtd_theme/commit/e1e317edb8137be1e0850195e625607821bbf00e

> 
> FWIW: Both of those 404.
> 
> Beyond that, I can't see anything that's a showstopper IMO (major or minor).
> 
> Guess the main thing now is sorting out the archives/ directory.

I think for that the git-lfs suggesting was the best: have an external
repo that contains the archives, and have the .gitlab-ci.yml copy them
after the sphinx build.

> 
> 
> On 3 June 2018 at 09:49, Jason Ekstrand <jason at jlekstrand.net> wrote:
> 
> > With all this talk of fancy looking new websites, I decided to take a
> > crack at being artsy and coming up with a fancy-looking logo to put on it.
> > Here's a first rough draft:
> >
> > https://people.freedesktop.org/~jekstrand/gears-logo-bold.png
> >
> > It's not great but it turned out better than I expected.  That version
> > looks good on a light background but it could probably be tweaked to look
> > good on dark/black if we want.
> >
> > --Jason
> >
> >
> >
> > On Fri, Jun 1, 2018 at 2:46 AM, Eric Engestrom <eric.engestrom at intel.com>
> > wrote:
> >
> >> On Thursday, 2018-05-31 21:33:16 -0400, mesa-dev-bounces at lists.freedes
> >> ktop.org wrote:
> >> > On Thu, May 31, 2018 at 8:31 PM, Jordan Justen
> >> > <jordan.l.justen at intel.com> wrote:
> >> > > On 2018-05-31 16:06:13, Laura Ekstrand wrote:
> >> > >> A little bit of messing around this afternoon, led to this:
> >> > >> https://drive.google.com/file/d/1rteTv9415XEMN1E11fyN0l3hTUC
> >> Cbgwz/view?usp=sharing
> >> > >
> >> > > Nice. That confirms we can easily get back to a something closer to
> >> > > the older look in short order. (Unless the consensus is to actually
> >> > > stay with the generic look.)
> >> > >
> >> > >> The gears are from Font Awesome, which comes with the RTD format.
> >> > >
> >> > > It'd be nice to get the icon back, but the gear glyph is an
> >> > > improvement compared to the house glyph.
> >> > >
> >> > > Anyway, I stick by what I said below too in reply to Eric about
> >> > > withdrawing my feedback.
> >> >
> >> > my $0.02 (which is probably worth even less when it comes to the topic
> >> > of aesthetics), Laura's new proposal looks much nicer than generic rtd
> >> > which looks better than current site..
> >> >
> >> > I mostly don't want to get a much needed infrastructure/process
> >> > improvement derailed with a bikeshed discussion about themes.  Nothing
> >> > against playing with theme options and seeing what people (with better
> >> > taste than me) like, just don't want that to be something that derails
> >> > the bigger picture ;-)
> >>
> >> Entirely agreed. I also think the old style was distinctive and had
> >> become part of the "personality" of our website, and I would like the
> >> new website to look similar, but this is a minor detail that we can
> >> trivially alter later.
> >>
> >> For now let's focus on the infrastructure changes, discussing the style
> >> can be done in parallel or later, but shouldn't block this.
> >>
> >> >
> >> > BR,
> >> > -R
> >> >
> >> >
> >> > >
> >> > > Thanks,
> >> > >
> >> > > -Jordan
> >> > >
> >> > >> On Thu, May 31, 2018 at 1:55 PM, Jordan Justen <
> >> jordan.l.justen at intel.com>
> >> > >> wrote:
> >> > >>
> >> > >> > On 2018-05-31 12:27:04, Eric Anholt wrote:
> >> > >> > > Jordan Justen <jordan.l.justen at intel.com> writes:
> >> > >> > >
> >> > >> > > > On 2018-05-24 17:37:09, Laura Ekstrand wrote:
> >> > >> > > >> A few of the commits are quite large and awaiting list
> >> approval.  I
> >> > >> > suggest
> >> > >> > > >> that you take a look at the code here:
> >> > >> > > >> https://gitlab.freedesktop.org/ldeks/mesa/tree/website1_75,
> >> > >> > > >> and the new website here: https://mesa-test.freedesktop.
> >> > >> > org/index.html
> >> > >> > > >
> >> > >> > > > I think the theme should be changed to look somewhat close to
> >> the
> >> > >> > > > current mesa3d.org website before changing the main site.
> >> (Color
> >> > >> > > > scheme and missing icons.)
> >> > >> > > >
> >> > >> > > > Right now the test website looks like a million other sphinx
> >> websites,
> >> > >> > > > including every readthedocs book.
> >> > >> > > >
> >> > >> > > > Based on http://www.sphinx-doc.org/en/master/ and
> >> > >> > > > https://www.python.org/, I would say sphinx gives a lot of
> >> > >> > > > opportunities for a custom look.
> >> > >> > >
> >> > >> > > I think looking like a generic other sphinx website is a step
> >> forward,
> >> > >> > > and I look forward to this series landing.  No need for
> >> continuity with
> >> > >> > > the old theme.
> >> > >> >
> >> > >> > I think it is 1 step forward, 1 step back. As no else appears to
> >> > >> > agree, I'll withdraw my feedback.
> >> > >> >
> >> > >> > -Jordan
> >> > >> >
> >> > > _______________________________________________
> >> > > mesa-dev mailing list
> >> > > mesa-dev at lists.freedesktop.org
> >> > > https://lists.freedesktop.org/mailman/listinfo/mesa-dev
> >> > _______________________________________________
> >> > mesa-dev mailing list
> >> > mesa-dev at lists.freedesktop.org
> >> > https://lists.freedesktop.org/mailman/listinfo/mesa-dev
> >> _______________________________________________
> >> mesa-dev mailing list
> >> mesa-dev at lists.freedesktop.org
> >> https://lists.freedesktop.org/mailman/listinfo/mesa-dev
> >>
> >
> >
> > _______________________________________________
> > mesa-dev mailing list
> > mesa-dev at lists.freedesktop.org
> > https://lists.freedesktop.org/mailman/listinfo/mesa-dev
> >
> >
> 
> 
> -- 
> Stuart Young (aka Cefiar)

> _______________________________________________
> mesa-dev mailing list
> mesa-dev at lists.freedesktop.org
> https://lists.freedesktop.org/mailman/listinfo/mesa-dev