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

[Ilia Mirkin]

On Tue, Jun 19, 2018 at 11:00 PM, Jordan Justen
 wrote:
> On 2018-06-18 17:48:26, Ilia Mirkin wrote:
>> On Mon, Jun 18, 2018 at 7:19 PM, Jason Ekstrand  wrote:
>> > On Mon, Jun 18, 2018 at 3:57 PM, Ilia Mirkin  wrote:
>> >>
>> >> Not sure how much voting power I have, but I really like Erik's version at
>> >>
>> >> https://codepen.io/kusma/pen/vrXppL
>> >>
>> >> It uses CSS3 animation on hover, so it's pretty low impact. Some
>> >> slight cleverness could even include a fallback for a browser that
>> >> doesn't support SVG.
>> >
>> >
>> > Could you be more specific about what exactly it is that you like?  Do you
>> > like the font? colors? style? the fact that it uses css? the fact that it
>> > doesn't use JS?  To me, the later two are immaterial and pretty trivial to
>> > put into any logo design.  Using WebGL is a bit less trivial, obviously.
>>
>> For reference, I'm comparing these two versions:
>>
>> Erik's: https://codepen.io/kusma/pen/vrXppL
>> Jason's: https://codepen.io/anon/pen/gKXobw
>>
>> I like both the aesthetic and the tech in Erik's variant. In general I
>> prefer serif fonts for readability, but I think in this case, a
>> sans-serif font lends itself better to lining up with the holes (I
>> believe others have commented on this). Placing the biggest gear below
>> the M (as in Erik's variant) gives it better weighting than above the
>> M (as in Jason's), since the M is also taller than the other letters,
>> that red gear is further above the "esa" in that version. Also the top
>> right serif from the M covers an awkward portion of the blue gear in
>> Jason's version. I do like the fact that Jason's version has a heavier
>> font, so if it's an option, Erik, I'd suggest trying to increase the
>> font weight on yours to see what happens.
>>
>> Regarding the tech, svg animations appear to be on their way out:
>> https://css-tricks.com/smil-is-dead-long-live-smil-a-guide-to-alternatives-to-smil-features/
>> (apparently it's not supported in IE or Edge[1]). So CSS3 animations
>> seem like the accepted thing to use all over.
>
> Does Erik or Jason's version use CSS3? Thus they should work 'all
> over' include Edge/IE11?

Erik's version is the CSS3 one. His earlier version used the 
element, but I suggested he implement with CSS3 which he adopted.
Jason's uses the  still, but would easily be convertable to
the CSS3 way.

>
> I tried them on Edge/IE11:
>
>> Erik's: https://codepen.io/kusma/pen/vrXppL
>
> The 'Mesa' text overflowed the box. (Should be easy to fix.)
>
> The gears did not turn.

Wow, massive fail (I should have seen this coming... it's IE after all):

https://stackoverflow.com/questions/33812303/svg-animation-is-not-working-on-ie11

Looks like you can do it if you split it up into a bunch of separate SVG's.

>
>> Jason's: https://codepen.io/anon/pen/gKXobw
>
> It appeared to render correctly on Windows and Linux.
>
> The gears did not turn.

I think that's the lack of SMIL issue.

> I also fixed the Edge/IE11 issue with:
>
> https://people.freedesktop.org/~jljusten/webgl-logo/gears.html
>
> Now the webgl works and looks the same on Linux (Firefox, Chrome,
> WebKit), and Windows (Chrome, Edge, IE11).

Double-checked on IE11 on Win7, can confirm it renders OK.

  -ilia
___
mesa-dev mailing list
mesa-dev@lists.freedesktop.org
https://lists.freedesktop.org/mailman/listinfo/mesa-dev

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

[Jordan Justen]

On 2018-06-18 17:48:26, Ilia Mirkin wrote:
> On Mon, Jun 18, 2018 at 7:19 PM, Jason Ekstrand  wrote:
> > On Mon, Jun 18, 2018 at 3:57 PM, Ilia Mirkin  wrote:
> >>
> >> Not sure how much voting power I have, but I really like Erik's version at
> >>
> >> https://codepen.io/kusma/pen/vrXppL
> >>
> >> It uses CSS3 animation on hover, so it's pretty low impact. Some
> >> slight cleverness could even include a fallback for a browser that
> >> doesn't support SVG.
> >
> >
> > Could you be more specific about what exactly it is that you like?  Do you
> > like the font? colors? style? the fact that it uses css? the fact that it
> > doesn't use JS?  To me, the later two are immaterial and pretty trivial to
> > put into any logo design.  Using WebGL is a bit less trivial, obviously.
> 
> For reference, I'm comparing these two versions:
> 
> Erik's: https://codepen.io/kusma/pen/vrXppL
> Jason's: https://codepen.io/anon/pen/gKXobw
> 
> I like both the aesthetic and the tech in Erik's variant. In general I
> prefer serif fonts for readability, but I think in this case, a
> sans-serif font lends itself better to lining up with the holes (I
> believe others have commented on this). Placing the biggest gear below
> the M (as in Erik's variant) gives it better weighting than above the
> M (as in Jason's), since the M is also taller than the other letters,
> that red gear is further above the "esa" in that version. Also the top
> right serif from the M covers an awkward portion of the blue gear in
> Jason's version. I do like the fact that Jason's version has a heavier
> font, so if it's an option, Erik, I'd suggest trying to increase the
> font weight on yours to see what happens.
> 
> Regarding the tech, svg animations appear to be on their way out:
> https://css-tricks.com/smil-is-dead-long-live-smil-a-guide-to-alternatives-to-smil-features/
> (apparently it's not supported in IE or Edge[1]). So CSS3 animations
> seem like the accepted thing to use all over.

Does Erik or Jason's version use CSS3? Thus they should work 'all
over' include Edge/IE11?

I tried them on Edge/IE11:

> Erik's: https://codepen.io/kusma/pen/vrXppL

The 'Mesa' text overflowed the box. (Should be easy to fix.)

The gears did not turn.

> Jason's: https://codepen.io/anon/pen/gKXobw

It appeared to render correctly on Windows and Linux.

The gears did not turn.

--

I also fixed the Edge/IE11 issue with:

https://people.freedesktop.org/~jljusten/webgl-logo/gears.html

Now the webgl works and looks the same on Linux (Firefox, Chrome,
WebKit), and Windows (Chrome, Edge, IE11).

-Jordan

> Now triggering with js
> vs a hover style -- not hugely important, but IME the
> mouseover/mouseout stuff is pretty unreliable. Maybe it actually works
> now, who knows, but I've never had issues with :hover. Note that it's
> also easy with CSS3 to do something like animate for 5s on load and
> then stop (until the mouseover). (Yeah, you can do this with JS as
> well...(most) )
> 
> Having some easter egg, as Rob Clark suggests, which flips it to a
> full webgl thing would be cool, but seems like a separate endeavor.
> 
> [1] The annoying thing one has to deal with in web development ...
> browser support. Animation is an "extra" feature, but why not just
> make it work? IE11 has no trouble with (most?) CSS3 animation
> features.
> ___
> mesa-dev mailing list
> mesa-dev@lists.freedesktop.org
> https://lists.freedesktop.org/mailman/listinfo/mesa-dev
___
mesa-dev mailing list
mesa-dev@lists.freedesktop.org
https://lists.freedesktop.org/mailman/listinfo/mesa-dev

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

[Ilia Mirkin]

On Mon, Jun 18, 2018 at 7:19 PM, Jason Ekstrand  wrote:
> On Mon, Jun 18, 2018 at 3:57 PM, Ilia Mirkin  wrote:
>>
>> Not sure how much voting power I have, but I really like Erik's version at
>>
>> https://codepen.io/kusma/pen/vrXppL
>>
>> It uses CSS3 animation on hover, so it's pretty low impact. Some
>> slight cleverness could even include a fallback for a browser that
>> doesn't support SVG.
>
>
> Could you be more specific about what exactly it is that you like?  Do you
> like the font? colors? style? the fact that it uses css? the fact that it
> doesn't use JS?  To me, the later two are immaterial and pretty trivial to
> put into any logo design.  Using WebGL is a bit less trivial, obviously.

For reference, I'm comparing these two versions:

Erik's: https://codepen.io/kusma/pen/vrXppL
Jason's: https://codepen.io/anon/pen/gKXobw

I like both the aesthetic and the tech in Erik's variant. In general I
prefer serif fonts for readability, but I think in this case, a
sans-serif font lends itself better to lining up with the holes (I
believe others have commented on this). Placing the biggest gear below
the M (as in Erik's variant) gives it better weighting than above the
M (as in Jason's), since the M is also taller than the other letters,
that red gear is further above the "esa" in that version. Also the top
right serif from the M covers an awkward portion of the blue gear in
Jason's version. I do like the fact that Jason's version has a heavier
font, so if it's an option, Erik, I'd suggest trying to increase the
font weight on yours to see what happens.

Regarding the tech, svg animations appear to be on their way out:
https://css-tricks.com/smil-is-dead-long-live-smil-a-guide-to-alternatives-to-smil-features/
(apparently it's not supported in IE or Edge[1]). So CSS3 animations
seem like the accepted thing to use all over. Now triggering with js
vs a hover style -- not hugely important, but IME the
mouseover/mouseout stuff is pretty unreliable. Maybe it actually works
now, who knows, but I've never had issues with :hover. Note that it's
also easy with CSS3 to do something like animate for 5s on load and
then stop (until the mouseover). (Yeah, you can do this with JS as
well...(most) )

Having some easter egg, as Rob Clark suggests, which flips it to a
full webgl thing would be cool, but seems like a separate endeavor.

[1] The annoying thing one has to deal with in web development ...
browser support. Animation is an "extra" feature, but why not just
make it work? IE11 has no trouble with (most?) CSS3 animation
features.
___
mesa-dev mailing list
mesa-dev@lists.freedesktop.org
https://lists.freedesktop.org/mailman/listinfo/mesa-dev

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

[Jason Ekstrand]

On Mon, Jun 18, 2018 at 5:36 PM, Jordan Justen 
wrote:

> On 2018-06-18 15:57:50, Ilia Mirkin wrote:
> > Not sure how much voting power I have, but I really like Erik's version
> at
> >
> > https://codepen.io/kusma/pen/vrXppL
>
> I think it's unfortunate that the logo says "3D Graphics Library",
> while simultaneously showing an image that couldn't look more 2D. :)
>

The OpenGL, OpenGL ES, and Vulkan logos are all very much 2D. :-P
___
mesa-dev mailing list
mesa-dev@lists.freedesktop.org
https://lists.freedesktop.org/mailman/listinfo/mesa-dev

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

[Jordan Justen]

On 2018-06-18 15:57:50, Ilia Mirkin wrote:
> Not sure how much voting power I have, but I really like Erik's version at
> 
> https://codepen.io/kusma/pen/vrXppL

I think it's unfortunate that the logo says "3D Graphics Library",
while simultaneously showing an image that couldn't look more 2D. :)

I think webgl is cool because of the obvious tie in with what Mesa
does, but maybe webgl is too concerning because it's crashing
browsers. Well, for one, that's not great. :) But, another option
would be to make an animated gif of the 3D gears to place behind the
svg text. (Sample animated gif: https://gitlab.com/gears3d)

-Jordan

> It uses CSS3 animation on hover, so it's pretty low impact. Some
> slight cleverness could even include a fallback for a browser that
> doesn't support SVG.
> 
> IMO solutions like three.js and so on are non-starters for something
> as trivial as a logo. Having some mesa-demos ported using it might be
> neat, but the logo should be kept simple and accessible.
> 
>   -ilia
___
mesa-dev mailing list
mesa-dev@lists.freedesktop.org
https://lists.freedesktop.org/mailman/listinfo/mesa-dev

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

[Rob Clark]

On Mon, Jun 18, 2018 at 7:19 PM, Jason Ekstrand  wrote:
> On Mon, Jun 18, 2018 at 3:57 PM, Ilia Mirkin  wrote:
>>
>> Not sure how much voting power I have, but I really like Erik's version at
>>
>> https://codepen.io/kusma/pen/vrXppL
>>
>> It uses CSS3 animation on hover, so it's pretty low impact. Some
>> slight cleverness could even include a fallback for a browser that
>> doesn't support SVG.
>
>
> Could you be more specific about what exactly it is that you like?  Do you
> like the font? colors? style? the fact that it uses css? the fact that it
> doesn't use JS?  To me, the later two are immaterial and pretty trivial to
> put into any logo design.  Using WebGL is a bit less trivial, obviously.
>

personally (for how ever little it should count), with Erik's version,
I like the fact that the "M" lines up well with the gears, and not
using webgl, since that seems pretty heavy handed for a logo.

But it would be really nice to see some sort of easter egg that takes
you to page w/ webgl thing w/ same logo that you could rotate, w/ the
"Mesa" text rotating with the gears.. I like the idea of gears
spinning on axles extending from "M" and the whole connection between
the gears and mesa ("mesa is what makes the gears spin").

I do like the font in your version a bit better, so if that could be
made to line up w/ gears by tweaking size of the individual gears or
stretching the M in different directions, that might be better.

BR,
-R

> --Jason
>
>
>>
>> IMO solutions like three.js and so on are non-starters for something
>> as trivial as a logo. Having some mesa-demos ported using it might be
>> neat, but the logo should be kept simple and accessible.
>>
>>   -ilia
>>
>>
>> On Mon, Jun 18, 2018 at 6:52 PM, Laura Ekstrand 
>> wrote:
>> > This looks like a useful check for WebGL compatibility:
>> >
>> > https://threejs.org/docs/index.html#manual/introduction/WebGL-compatibility-check
>> >
>> > On Mon, Jun 18, 2018, 3:50 PM Laura Ekstrand 
>> > wrote:
>> >>
>> >> Jordan's version is awesome.  But in general most people are concerned
>> >> that WebGL will crash browsers.
>> >>
>> >> One idea is to look into using three.js, which is a front-end library
>> >> for
>> >> web graphics.  It's backed by multiple frameworks including WebGL.
>> >>
>> >> On Sun, Jun 17, 2018, 9:23 PM Jordan Justen 
>> >> wrote:
>> >>>
>> >>> On 2018-06-17 17:43:37, Jason Ekstrand wrote:
>> >>> > On Sun, Jun 17, 2018 at 5:34 PM, Jordan Justen
>> >>> > 
>> >>> > wrote:
>> >>> >
>> >>> > > On 2018-06-17 16:42:13, Jason Ekstrand wrote:
>> >>> > > > On Sun, Jun 17, 2018 at 4:21 PM, Matt Turner
>> >>> > > > 
>> >>> > > > wrote:
>> >>> > > >
>> >>> > > > > Also, Erik's is animated not with JavaScript at all, but just
>> >>> > > > > CSS.
>> >>> > > > > That's really cool.
>> >>> > > > >
>> >>> > > >
>> >>> > > > The only thing the JS does is turn the animation on and off.
>> >>> > > > The
>> >>> > > > actual
>> >>> > > > animation is pure SVG. The main reason (as I understood it) for
>> >>> > > > the
>> >>> > > > JavaScript is to make the gears *not* turn if someone has
>> >>> > > > disabled
>> >>> > > > JavaScript.  I'm sure people will disagree as to whether or not
>> >>> > > > that's a
>> >>> > > > feature. :-)  I'm not sure if you can get the turn-on-hover
>> >>> > > > thing
>> >>> > > > with
>> >>> > > just
>> >>> > > > SVG and not JS though... /me doesn't know either all that well.
>> >>> > >
>> >>> > > All the JS and webgl. :)
>> >>> > >
>> >>> > > https://people.freedesktop.org/~jljusten/webgl-logo/gears.html
>> >>> > >
>> >>> > > Actually, it doesn't start webgl until you move your mouse over
>> >>> > > the
>> >>> > > logo. Before that it is displaying a jpg of the gears.
>> >>> > >
>> >>> >
>> >>> > I like how the gears smoothly spin up and slow to a stop.  Not sure
>> >>> > what I
>> >>> > think of the font.
>> >>>
>> >>> I changed the font to Roboto Slab, which I saw you mentioned earlier.
>> >>>
>> >>> -Jordan
>> >>> ___
>> >>> mesa-dev mailing list
>> >>> mesa-dev@lists.freedesktop.org
>> >>> https://lists.freedesktop.org/mailman/listinfo/mesa-dev
>> >
>> >
>> > ___
>> > mesa-dev mailing list
>> > mesa-dev@lists.freedesktop.org
>> > https://lists.freedesktop.org/mailman/listinfo/mesa-dev
>> >
>> ___
>> mesa-dev mailing list
>> mesa-dev@lists.freedesktop.org
>> https://lists.freedesktop.org/mailman/listinfo/mesa-dev
>
>
>
> ___
> mesa-dev mailing list
> mesa-dev@lists.freedesktop.org
> https://lists.freedesktop.org/mailman/listinfo/mesa-dev
>
___
mesa-dev mailing list
mesa-dev@lists.freedesktop.org
https://lists.freedesktop.org/mailman/listinfo/mesa-dev

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

[Jason Ekstrand]

On Mon, Jun 18, 2018 at 3:57 PM, Ilia Mirkin  wrote:

> Not sure how much voting power I have, but I really like Erik's version at
>
> https://codepen.io/kusma/pen/vrXppL
>
> It uses CSS3 animation on hover, so it's pretty low impact. Some
> slight cleverness could even include a fallback for a browser that
> doesn't support SVG.
>

Could you be more specific about what exactly it is that you like?  Do you
like the font? colors? style? the fact that it uses css? the fact that it
doesn't use JS?  To me, the later two are immaterial and pretty trivial to
put into any logo design.  Using WebGL is a bit less trivial, obviously.

--Jason



> IMO solutions like three.js and so on are non-starters for something
> as trivial as a logo. Having some mesa-demos ported using it might be
> neat, but the logo should be kept simple and accessible.
>
>   -ilia
>
>
> On Mon, Jun 18, 2018 at 6:52 PM, Laura Ekstrand 
> wrote:
> > This looks like a useful check for WebGL compatibility:
> > https://threejs.org/docs/index.html#manual/introduction/WebGL-
> compatibility-check
> >
> > On Mon, Jun 18, 2018, 3:50 PM Laura Ekstrand 
> wrote:
> >>
> >> Jordan's version is awesome.  But in general most people are concerned
> >> that WebGL will crash browsers.
> >>
> >> One idea is to look into using three.js, which is a front-end library
> for
> >> web graphics.  It's backed by multiple frameworks including WebGL.
> >>
> >> On Sun, Jun 17, 2018, 9:23 PM Jordan Justen 
> >> wrote:
> >>>
> >>> On 2018-06-17 17:43:37, Jason Ekstrand wrote:
> >>> > On Sun, Jun 17, 2018 at 5:34 PM, Jordan Justen
> >>> > 
> >>> > wrote:
> >>> >
> >>> > > On 2018-06-17 16:42:13, Jason Ekstrand wrote:
> >>> > > > On Sun, Jun 17, 2018 at 4:21 PM, Matt Turner  >
> >>> > > > wrote:
> >>> > > >
> >>> > > > > Also, Erik's is animated not with JavaScript at all, but just
> >>> > > > > CSS.
> >>> > > > > That's really cool.
> >>> > > > >
> >>> > > >
> >>> > > > The only thing the JS does is turn the animation on and off.  The
> >>> > > > actual
> >>> > > > animation is pure SVG. The main reason (as I understood it) for
> the
> >>> > > > JavaScript is to make the gears *not* turn if someone has
> disabled
> >>> > > > JavaScript.  I'm sure people will disagree as to whether or not
> >>> > > > that's a
> >>> > > > feature. :-)  I'm not sure if you can get the turn-on-hover thing
> >>> > > > with
> >>> > > just
> >>> > > > SVG and not JS though... /me doesn't know either all that well.
> >>> > >
> >>> > > All the JS and webgl. :)
> >>> > >
> >>> > > https://people.freedesktop.org/~jljusten/webgl-logo/gears.html
> >>> > >
> >>> > > Actually, it doesn't start webgl until you move your mouse over the
> >>> > > logo. Before that it is displaying a jpg of the gears.
> >>> > >
> >>> >
> >>> > I like how the gears smoothly spin up and slow to a stop.  Not sure
> >>> > what I
> >>> > think of the font.
> >>>
> >>> I changed the font to Roboto Slab, which I saw you mentioned earlier.
> >>>
> >>> -Jordan
> >>> ___
> >>> mesa-dev mailing list
> >>> mesa-dev@lists.freedesktop.org
> >>> https://lists.freedesktop.org/mailman/listinfo/mesa-dev
> >
> >
> > ___
> > mesa-dev mailing list
> > mesa-dev@lists.freedesktop.org
> > https://lists.freedesktop.org/mailman/listinfo/mesa-dev
> >
> ___
> mesa-dev mailing list
> mesa-dev@lists.freedesktop.org
> https://lists.freedesktop.org/mailman/listinfo/mesa-dev
>
___
mesa-dev mailing list
mesa-dev@lists.freedesktop.org
https://lists.freedesktop.org/mailman/listinfo/mesa-dev

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

[Ilia Mirkin]

Not sure how much voting power I have, but I really like Erik's version at

https://codepen.io/kusma/pen/vrXppL

It uses CSS3 animation on hover, so it's pretty low impact. Some
slight cleverness could even include a fallback for a browser that
doesn't support SVG.

IMO solutions like three.js and so on are non-starters for something
as trivial as a logo. Having some mesa-demos ported using it might be
neat, but the logo should be kept simple and accessible.

  -ilia


On Mon, Jun 18, 2018 at 6:52 PM, Laura Ekstrand  wrote:
> This looks like a useful check for WebGL compatibility:
> https://threejs.org/docs/index.html#manual/introduction/WebGL-compatibility-check
>
> On Mon, Jun 18, 2018, 3:50 PM Laura Ekstrand  wrote:
>>
>> Jordan's version is awesome.  But in general most people are concerned
>> that WebGL will crash browsers.
>>
>> One idea is to look into using three.js, which is a front-end library for
>> web graphics.  It's backed by multiple frameworks including WebGL.
>>
>> On Sun, Jun 17, 2018, 9:23 PM Jordan Justen 
>> wrote:
>>>
>>> On 2018-06-17 17:43:37, Jason Ekstrand wrote:
>>> > On Sun, Jun 17, 2018 at 5:34 PM, Jordan Justen
>>> > 
>>> > wrote:
>>> >
>>> > > On 2018-06-17 16:42:13, Jason Ekstrand wrote:
>>> > > > On Sun, Jun 17, 2018 at 4:21 PM, Matt Turner 
>>> > > > wrote:
>>> > > >
>>> > > > > Also, Erik's is animated not with JavaScript at all, but just
>>> > > > > CSS.
>>> > > > > That's really cool.
>>> > > > >
>>> > > >
>>> > > > The only thing the JS does is turn the animation on and off.  The
>>> > > > actual
>>> > > > animation is pure SVG. The main reason (as I understood it) for the
>>> > > > JavaScript is to make the gears *not* turn if someone has disabled
>>> > > > JavaScript.  I'm sure people will disagree as to whether or not
>>> > > > that's a
>>> > > > feature. :-)  I'm not sure if you can get the turn-on-hover thing
>>> > > > with
>>> > > just
>>> > > > SVG and not JS though... /me doesn't know either all that well.
>>> > >
>>> > > All the JS and webgl. :)
>>> > >
>>> > > https://people.freedesktop.org/~jljusten/webgl-logo/gears.html
>>> > >
>>> > > Actually, it doesn't start webgl until you move your mouse over the
>>> > > logo. Before that it is displaying a jpg of the gears.
>>> > >
>>> >
>>> > I like how the gears smoothly spin up and slow to a stop.  Not sure
>>> > what I
>>> > think of the font.
>>>
>>> I changed the font to Roboto Slab, which I saw you mentioned earlier.
>>>
>>> -Jordan
>>> ___
>>> mesa-dev mailing list
>>> mesa-dev@lists.freedesktop.org
>>> https://lists.freedesktop.org/mailman/listinfo/mesa-dev
>
>
> ___
> mesa-dev mailing list
> mesa-dev@lists.freedesktop.org
> https://lists.freedesktop.org/mailman/listinfo/mesa-dev
>
___
mesa-dev mailing list
mesa-dev@lists.freedesktop.org
https://lists.freedesktop.org/mailman/listinfo/mesa-dev

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

[Laura Ekstrand]

This looks like a useful check for WebGL compatibility:
https://threejs.org/docs/index.html#manual/introduction/WebGL-compatibility-check

On Mon, Jun 18, 2018, 3:50 PM Laura Ekstrand  wrote:

> Jordan's version is awesome.  But in general most people are concerned
> that WebGL will crash browsers.
>
> One idea is to look into using three.js, which is a front-end library for
> web graphics.  It's backed by multiple frameworks including WebGL.
>
> On Sun, Jun 17, 2018, 9:23 PM Jordan Justen 
> wrote:
>
>> On 2018-06-17 17:43:37, Jason Ekstrand wrote:
>> > On Sun, Jun 17, 2018 at 5:34 PM, Jordan Justen <
>> jordan.l.jus...@intel.com>
>> > wrote:
>> >
>> > > On 2018-06-17 16:42:13, Jason Ekstrand wrote:
>> > > > On Sun, Jun 17, 2018 at 4:21 PM, Matt Turner 
>> wrote:
>> > > >
>> > > > > Also, Erik's is animated not with JavaScript at all, but just CSS.
>> > > > > That's really cool.
>> > > > >
>> > > >
>> > > > The only thing the JS does is turn the animation on and off.  The
>> actual
>> > > > animation is pure SVG. The main reason (as I understood it) for the
>> > > > JavaScript is to make the gears *not* turn if someone has disabled
>> > > > JavaScript.  I'm sure people will disagree as to whether or not
>> that's a
>> > > > feature. :-)  I'm not sure if you can get the turn-on-hover thing
>> with
>> > > just
>> > > > SVG and not JS though... /me doesn't know either all that well.
>> > >
>> > > All the JS and webgl. :)
>> > >
>> > > https://people.freedesktop.org/~jljusten/webgl-logo/gears.html
>> > >
>> > > Actually, it doesn't start webgl until you move your mouse over the
>> > > logo. Before that it is displaying a jpg of the gears.
>> > >
>> >
>> > I like how the gears smoothly spin up and slow to a stop.  Not sure
>> what I
>> > think of the font.
>>
>> I changed the font to Roboto Slab, which I saw you mentioned earlier.
>>
>> -Jordan
>> ___
>> mesa-dev mailing list
>> mesa-dev@lists.freedesktop.org
>> https://lists.freedesktop.org/mailman/listinfo/mesa-dev
>>
>
___
mesa-dev mailing list
mesa-dev@lists.freedesktop.org
https://lists.freedesktop.org/mailman/listinfo/mesa-dev

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

[Laura Ekstrand]

Jordan's version is awesome.  But in general most people are concerned that
WebGL will crash browsers.

One idea is to look into using three.js, which is a front-end library for
web graphics.  It's backed by multiple frameworks including WebGL.

On Sun, Jun 17, 2018, 9:23 PM Jordan Justen 
wrote:

> On 2018-06-17 17:43:37, Jason Ekstrand wrote:
> > On Sun, Jun 17, 2018 at 5:34 PM, Jordan Justen <
> jordan.l.jus...@intel.com>
> > wrote:
> >
> > > On 2018-06-17 16:42:13, Jason Ekstrand wrote:
> > > > On Sun, Jun 17, 2018 at 4:21 PM, Matt Turner 
> wrote:
> > > >
> > > > > Also, Erik's is animated not with JavaScript at all, but just CSS.
> > > > > That's really cool.
> > > > >
> > > >
> > > > The only thing the JS does is turn the animation on and off.  The
> actual
> > > > animation is pure SVG. The main reason (as I understood it) for the
> > > > JavaScript is to make the gears *not* turn if someone has disabled
> > > > JavaScript.  I'm sure people will disagree as to whether or not
> that's a
> > > > feature. :-)  I'm not sure if you can get the turn-on-hover thing
> with
> > > just
> > > > SVG and not JS though... /me doesn't know either all that well.
> > >
> > > All the JS and webgl. :)
> > >
> > > https://people.freedesktop.org/~jljusten/webgl-logo/gears.html
> > >
> > > Actually, it doesn't start webgl until you move your mouse over the
> > > logo. Before that it is displaying a jpg of the gears.
> > >
> >
> > I like how the gears smoothly spin up and slow to a stop.  Not sure what
> I
> > think of the font.
>
> I changed the font to Roboto Slab, which I saw you mentioned earlier.
>
> -Jordan
> ___
> mesa-dev mailing list
> mesa-dev@lists.freedesktop.org
> https://lists.freedesktop.org/mailman/listinfo/mesa-dev
>
___
mesa-dev mailing list
mesa-dev@lists.freedesktop.org
https://lists.freedesktop.org/mailman/listinfo/mesa-dev

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

[Jordan Justen]

On 2018-06-17 17:43:37, Jason Ekstrand wrote:
> On Sun, Jun 17, 2018 at 5:34 PM, Jordan Justen 
> wrote:
> 
> > On 2018-06-17 16:42:13, Jason Ekstrand wrote:
> > > On Sun, Jun 17, 2018 at 4:21 PM, Matt Turner  wrote:
> > >
> > > > Also, Erik's is animated not with JavaScript at all, but just CSS.
> > > > That's really cool.
> > > >
> > >
> > > The only thing the JS does is turn the animation on and off.  The actual
> > > animation is pure SVG. The main reason (as I understood it) for the
> > > JavaScript is to make the gears *not* turn if someone has disabled
> > > JavaScript.  I'm sure people will disagree as to whether or not that's a
> > > feature. :-)  I'm not sure if you can get the turn-on-hover thing with
> > just
> > > SVG and not JS though... /me doesn't know either all that well.
> >
> > All the JS and webgl. :)
> >
> > https://people.freedesktop.org/~jljusten/webgl-logo/gears.html
> >
> > Actually, it doesn't start webgl until you move your mouse over the
> > logo. Before that it is displaying a jpg of the gears.
> >
> 
> I like how the gears smoothly spin up and slow to a stop.  Not sure what I
> think of the font.

I changed the font to Roboto Slab, which I saw you mentioned earlier.

-Jordan
___
mesa-dev mailing list
mesa-dev@lists.freedesktop.org
https://lists.freedesktop.org/mailman/listinfo/mesa-dev

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

[Jason Ekstrand]

On Sun, Jun 17, 2018 at 5:34 PM, Jordan Justen 
wrote:

> On 2018-06-17 16:42:13, Jason Ekstrand wrote:
> > On Sun, Jun 17, 2018 at 4:21 PM, Matt Turner  wrote:
> >
> > > Also, Erik's is animated not with JavaScript at all, but just CSS.
> > > That's really cool.
> > >
> >
> > The only thing the JS does is turn the animation on and off.  The actual
> > animation is pure SVG. The main reason (as I understood it) for the
> > JavaScript is to make the gears *not* turn if someone has disabled
> > JavaScript.  I'm sure people will disagree as to whether or not that's a
> > feature. :-)  I'm not sure if you can get the turn-on-hover thing with
> just
> > SVG and not JS though... /me doesn't know either all that well.
>
> All the JS and webgl. :)
>
> https://people.freedesktop.org/~jljusten/webgl-logo/gears.html
>
> Actually, it doesn't start webgl until you move your mouse over the
> logo. Before that it is displaying a jpg of the gears.
>

I like how the gears smoothly spin up and slow to a stop.  Not sure what I
think of the font.

--Jason
___
mesa-dev mailing list
mesa-dev@lists.freedesktop.org
https://lists.freedesktop.org/mailman/listinfo/mesa-dev

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

[Jordan Justen]

On 2018-06-17 16:42:13, Jason Ekstrand wrote:
> On Sun, Jun 17, 2018 at 4:21 PM, Matt Turner  wrote:
> 
> > Also, Erik's is animated not with JavaScript at all, but just CSS.
> > That's really cool.
> >
> 
> The only thing the JS does is turn the animation on and off.  The actual
> animation is pure SVG. The main reason (as I understood it) for the
> JavaScript is to make the gears *not* turn if someone has disabled
> JavaScript.  I'm sure people will disagree as to whether or not that's a
> feature. :-)  I'm not sure if you can get the turn-on-hover thing with just
> SVG and not JS though... /me doesn't know either all that well.

All the JS and webgl. :)

https://people.freedesktop.org/~jljusten/webgl-logo/gears.html

Actually, it doesn't start webgl until you move your mouse over the
logo. Before that it is displaying a jpg of the gears.

(Not to say there are not issues. On windows the svg overlay image
looks a bit off. It also didn't work on the Edge browser, but I
thought Edge supported webgl.)

-Jordan
___
mesa-dev mailing list
mesa-dev@lists.freedesktop.org
https://lists.freedesktop.org/mailman/listinfo/mesa-dev

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

[Jason Ekstrand]

On Sun, Jun 17, 2018 at 4:21 PM, Matt Turner  wrote:

> On Sun, Jun 17, 2018 at 4:09 PM Jason Ekstrand 
> wrote:
> >
> > On Sun, Jun 17, 2018 at 11:40 AM, Matt Turner 
> wrote:
> >>
> >> On Sun, Jun 17, 2018 at 10:03 AM Jason Ekstrand 
> wrote:
> >> >
> >> > On June 17, 2018 08:25:07 Rob Clark  wrote:
> >> >
> >> > > On Sun, Jun 17, 2018 at 2:55 AM, Jordan Justen
> >> > >  wrote:
> >> > >> On 2018-06-15 15:16:50, Laura Ekstrand wrote:
> >> > >>>
> >> > >>> We are now running on our own Docker image:
> >> > >>> https://mesa-test.freedesktop.org/.
> >> > >>
> >> > >> FWIW, I think the test site now looks better than mesa3d.org and
> >> > >> retains some consistency with it, so for the new site:
> >> > >>
> >> > >> Acked-by: Jordan Justen 
> >> > >>
> >> > >> Personally, I'm not sure about the flat gears vs the 3d ones. But
> the
> >> > >> flat ones still maintain some consistency with the old site, and
> they
> >> > >> look pretty good.
> >> > >
> >> > > I do kinda prefer Erik's logo (with gears lined up better
> to
> >> > > the corners of the 'M' and hover-over animation).. although maybe
> the
> >> > > font in the static logo is a bit nicer.  Either I prefer to the old
> >> > > logo since they look somehow more modern and nicely work the name
> >> > > "Mesa" into the logo.
> >> >
> >> > I've been meaning to rework my version of the logo to use Erik's
> gears that
> >> > he generated with python as opposed to my terrible screenshot hack.
> I'll
> >> > add the hover spin animation while I'm at it.
> >>
> >> Maybe I've misunderstood, but why not just use Erik's logo as is?
> >
> >
> > I prefer the font, colors, style, etc. of the one I posted originally.
> So I reworked it to pull in what I think are the best parts of the others
> that have been posted.  If most people still like Erik's better, then
> that's fine.
>
> FWIW, I really prefer Erik's because the corners of the 'M' align so
> perfectly with the centers of the gears. It says "Mesa is what makes
> the gears turn" to me :)
>

Fair enough. :-)


> In general I like your font better, but I don't think it can align
> with the centers of the gears.
>

Yeah, I really like Roboto Slab.  For one thing it looks kind of retro;
almost like a monospace font but without the visual imbalance that usually
comes with monospace fonts.  It's also the standard font on the RTD Sphinx
theme so it fits nicely with the rest of the page.  Sadly, the gears don't
align with it as nicely; the serifs make that very difficult.


> Also, Erik's is animated not with JavaScript at all, but just CSS.
> That's really cool.
>

The only thing the JS does is turn the animation on and off.  The actual
animation is pure SVG. The main reason (as I understood it) for the
JavaScript is to make the gears *not* turn if someone has disabled
JavaScript.  I'm sure people will disagree as to whether or not that's a
feature. :-)  I'm not sure if you can get the turn-on-hover thing with just
SVG and not JS though... /me doesn't know either all that well.
___
mesa-dev mailing list
mesa-dev@lists.freedesktop.org
https://lists.freedesktop.org/mailman/listinfo/mesa-dev

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

[Matt Turner]

On Sun, Jun 17, 2018 at 4:09 PM Jason Ekstrand  wrote:
>
> On Sun, Jun 17, 2018 at 11:40 AM, Matt Turner  wrote:
>>
>> On Sun, Jun 17, 2018 at 10:03 AM Jason Ekstrand  wrote:
>> >
>> > On June 17, 2018 08:25:07 Rob Clark  wrote:
>> >
>> > > On Sun, Jun 17, 2018 at 2:55 AM, Jordan Justen
>> > >  wrote:
>> > >> On 2018-06-15 15:16:50, Laura Ekstrand wrote:
>> > >>>
>> > >>> We are now running on our own Docker image:
>> > >>> https://mesa-test.freedesktop.org/.
>> > >>
>> > >> FWIW, I think the test site now looks better than mesa3d.org and
>> > >> retains some consistency with it, so for the new site:
>> > >>
>> > >> Acked-by: Jordan Justen 
>> > >>
>> > >> Personally, I'm not sure about the flat gears vs the 3d ones. But the
>> > >> flat ones still maintain some consistency with the old site, and they
>> > >> look pretty good.
>> > >
>> > > I do kinda prefer Erik's logo (with gears lined up better to
>> > > the corners of the 'M' and hover-over animation).. although maybe the
>> > > font in the static logo is a bit nicer.  Either I prefer to the old
>> > > logo since they look somehow more modern and nicely work the name
>> > > "Mesa" into the logo.
>> >
>> > I've been meaning to rework my version of the logo to use Erik's gears that
>> > he generated with python as opposed to my terrible screenshot hack.  I'll
>> > add the hover spin animation while I'm at it.
>>
>> Maybe I've misunderstood, but why not just use Erik's logo as is?
>
>
> I prefer the font, colors, style, etc. of the one I posted originally.  So I 
> reworked it to pull in what I think are the best parts of the others that 
> have been posted.  If most people still like Erik's better, then that's fine.

FWIW, I really prefer Erik's because the corners of the 'M' align so
perfectly with the centers of the gears. It says "Mesa is what makes
the gears turn" to me :)

In general I like your font better, but I don't think it can align
with the centers of the gears.

Also, Erik's is animated not with JavaScript at all, but just CSS.
That's really cool.
___
mesa-dev mailing list
mesa-dev@lists.freedesktop.org
https://lists.freedesktop.org/mailman/listinfo/mesa-dev

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

[Jason Ekstrand]

On Sun, Jun 17, 2018 at 11:40 AM, Matt Turner  wrote:

> On Sun, Jun 17, 2018 at 10:03 AM Jason Ekstrand 
> wrote:
> >
> > On June 17, 2018 08:25:07 Rob Clark  wrote:
> >
> > > On Sun, Jun 17, 2018 at 2:55 AM, Jordan Justen
> > >  wrote:
> > >> On 2018-06-15 15:16:50, Laura Ekstrand wrote:
> > >>>
> > >>> We are now running on our own Docker image:
> > >>> https://mesa-test.freedesktop.org/.
> > >>
> > >> FWIW, I think the test site now looks better than mesa3d.org and
> > >> retains some consistency with it, so for the new site:
> > >>
> > >> Acked-by: Jordan Justen 
> > >>
> > >> Personally, I'm not sure about the flat gears vs the 3d ones. But the
> > >> flat ones still maintain some consistency with the old site, and they
> > >> look pretty good.
> > >
> > > I do kinda prefer Erik's logo (with gears lined up better to
> > > the corners of the 'M' and hover-over animation).. although maybe the
> > > font in the static logo is a bit nicer.  Either I prefer to the old
> > > logo since they look somehow more modern and nicely work the name
> > > "Mesa" into the logo.
> >
> > I've been meaning to rework my version of the logo to use Erik's gears
> that
> > he generated with python as opposed to my terrible screenshot hack.  I'll
> > add the hover spin animation while I'm at it.
>
> Maybe I've misunderstood, but why not just use Erik's logo as is?
>

I prefer the font, colors, style, etc. of the one I posted originally.  So
I reworked it to pull in what I think are the best parts of the others that
have been posted.  If most people still like Erik's better, then that's
fine.

--Jason
___
mesa-dev mailing list
mesa-dev@lists.freedesktop.org
https://lists.freedesktop.org/mailman/listinfo/mesa-dev

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

[Jason Ekstrand]

On Sun, Jun 17, 2018 at 10:46 AM, Rob Clark  wrote:

> On Sun, Jun 17, 2018 at 1:00 PM, Jason Ekstrand 
> wrote:
> > On June 17, 2018 08:25:07 Rob Clark  wrote:
> >
> >> On Sun, Jun 17, 2018 at 2:55 AM, Jordan Justen
> >>  wrote:
> >>>
> >>> On 2018-06-15 15:16:50, Laura Ekstrand wrote:
> 
> 
>  We are now running on our own Docker image:
>  https://mesa-test.freedesktop.org/.
> >>>
> >>>
> >>> FWIW, I think the test site now looks better than mesa3d.org and
> >>> retains some consistency with it, so for the new site:
> >>>
> >>> Acked-by: Jordan Justen 
> >>>
> >>> Personally, I'm not sure about the flat gears vs the 3d ones. But the
> >>> flat ones still maintain some consistency with the old site, and they
> >>> look pretty good.
> >>
> >>
> >> I do kinda prefer Erik's logo (with gears lined up better to
> >> the corners of the 'M' and hover-over animation).. although maybe the
> >> font in the static logo is a bit nicer.  Either I prefer to the old
> >> logo since they look somehow more modern and nicely work the name
> >> "Mesa" into the logo.
> >
> >
> > I've been meaning to rework my version of the logo to use Erik's gears
> that
> > he generated with python as opposed to my terrible screenshot hack.  I'll
> > add the hover spin animation while I'm at it.
> >
>
> \o/ for spinning gears :-)
>

Spinny version of my logo:

https://people.freedesktop.org/~jekstrand/gears-logo-spinning.svg

https://codepen.io/anon/pen/gKXobw

I borrowed Rhys' javascript and embedded it directly in the SVG so we don't
have to figure out how to inject JS into a sphinx theme.

--Jason
___
mesa-dev mailing list
mesa-dev@lists.freedesktop.org
https://lists.freedesktop.org/mailman/listinfo/mesa-dev

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

[Matt Turner]

On Sun, Jun 17, 2018 at 10:03 AM Jason Ekstrand  wrote:
>
> On June 17, 2018 08:25:07 Rob Clark  wrote:
>
> > On Sun, Jun 17, 2018 at 2:55 AM, Jordan Justen
> >  wrote:
> >> On 2018-06-15 15:16:50, Laura Ekstrand wrote:
> >>>
> >>> We are now running on our own Docker image:
> >>> https://mesa-test.freedesktop.org/.
> >>
> >> FWIW, I think the test site now looks better than mesa3d.org and
> >> retains some consistency with it, so for the new site:
> >>
> >> Acked-by: Jordan Justen 
> >>
> >> Personally, I'm not sure about the flat gears vs the 3d ones. But the
> >> flat ones still maintain some consistency with the old site, and they
> >> look pretty good.
> >
> > I do kinda prefer Erik's logo (with gears lined up better to
> > the corners of the 'M' and hover-over animation).. although maybe the
> > font in the static logo is a bit nicer.  Either I prefer to the old
> > logo since they look somehow more modern and nicely work the name
> > "Mesa" into the logo.
>
> I've been meaning to rework my version of the logo to use Erik's gears that
> he generated with python as opposed to my terrible screenshot hack.  I'll
> add the hover spin animation while I'm at it.

Maybe I've misunderstood, but why not just use Erik's logo as is?
___
mesa-dev mailing list
mesa-dev@lists.freedesktop.org
https://lists.freedesktop.org/mailman/listinfo/mesa-dev

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

[Rob Clark]

On Sun, Jun 17, 2018 at 1:00 PM, Jason Ekstrand  wrote:
> On June 17, 2018 08:25:07 Rob Clark  wrote:
>
>> On Sun, Jun 17, 2018 at 2:55 AM, Jordan Justen
>>  wrote:
>>>
>>> On 2018-06-15 15:16:50, Laura Ekstrand wrote:


 We are now running on our own Docker image:
 https://mesa-test.freedesktop.org/.
>>>
>>>
>>> FWIW, I think the test site now looks better than mesa3d.org and
>>> retains some consistency with it, so for the new site:
>>>
>>> Acked-by: Jordan Justen 
>>>
>>> Personally, I'm not sure about the flat gears vs the 3d ones. But the
>>> flat ones still maintain some consistency with the old site, and they
>>> look pretty good.
>>
>>
>> I do kinda prefer Erik's logo (with gears lined up better to
>> the corners of the 'M' and hover-over animation).. although maybe the
>> font in the static logo is a bit nicer.  Either I prefer to the old
>> logo since they look somehow more modern and nicely work the name
>> "Mesa" into the logo.
>
>
> I've been meaning to rework my version of the logo to use Erik's gears that
> he generated with python as opposed to my terrible screenshot hack.  I'll
> add the hover spin animation while I'm at it.
>

\o/ for spinning gears :-)

> --Jason
>
>
___
mesa-dev mailing list
mesa-dev@lists.freedesktop.org
https://lists.freedesktop.org/mailman/listinfo/mesa-dev

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

[Jason Ekstrand]

On June 17, 2018 08:25:07 Rob Clark  wrote:


On Sun, Jun 17, 2018 at 2:55 AM, Jordan Justen
 wrote:

On 2018-06-15 15:16:50, Laura Ekstrand wrote:


We are now running on our own Docker image:
https://mesa-test.freedesktop.org/.


FWIW, I think the test site now looks better than mesa3d.org and
retains some consistency with it, so for the new site:

Acked-by: Jordan Justen 

Personally, I'm not sure about the flat gears vs the 3d ones. But the
flat ones still maintain some consistency with the old site, and they
look pretty good.


I do kinda prefer Erik's logo (with gears lined up better to
the corners of the 'M' and hover-over animation).. although maybe the
font in the static logo is a bit nicer.  Either I prefer to the old
logo since they look somehow more modern and nicely work the name
"Mesa" into the logo.


I've been meaning to rework my version of the logo to use Erik's gears that 
he generated with python as opposed to my terrible screenshot hack.  I'll 
add the hover spin animation while I'm at it.


--Jason


___
mesa-dev mailing list
mesa-dev@lists.freedesktop.org
https://lists.freedesktop.org/mailman/listinfo/mesa-dev

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

[Rob Clark]

On Sun, Jun 17, 2018 at 2:55 AM, Jordan Justen
 wrote:
> On 2018-06-15 15:16:50, Laura Ekstrand wrote:
>>
>> We are now running on our own Docker image:
>> https://mesa-test.freedesktop.org/.
>>
>
> FWIW, I think the test site now looks better than mesa3d.org and
> retains some consistency with it, so for the new site:
>
> Acked-by: Jordan Justen 
>
> Personally, I'm not sure about the flat gears vs the 3d ones. But the
> flat ones still maintain some consistency with the old site, and they
> look pretty good.
>

I do kinda prefer Erik's logo (with gears lined up better to
the corners of the 'M' and hover-over animation).. although maybe the
font in the static logo is a bit nicer.  Either I prefer to the old
logo since they look somehow more modern and nicely work the name
"Mesa" into the logo.

> Thanks for all your work on this!

yes, for sure, the new site looks so much nicer

BR,
-R

> -Jordan
>
___
mesa-dev mailing list
mesa-dev@lists.freedesktop.org
https://lists.freedesktop.org/mailman/listinfo/mesa-dev

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

[Jordan Justen]

On 2018-06-15 15:16:50, Laura Ekstrand wrote:
> 
> We are now running on our own Docker image:
> https://mesa-test.freedesktop.org/.
> 

FWIW, I think the test site now looks better than mesa3d.org and
retains some consistency with it, so for the new site:

Acked-by: Jordan Justen 

Personally, I'm not sure about the flat gears vs the 3d ones. But the
flat ones still maintain some consistency with the old site, and they
look pretty good.

Thanks for all your work on this!

-Jordan

> 
> On Mon, Jun 11, 2018 at 3:24 PM, Laura Ekstrand 
> wrote:
> 
> > I really like the rotate on hover effect for the gears.  I would rather
> > that we use 2D WebGL for it if we could, though, since Mesa enables WebGL
> > on certain platforms.
> >
> > Stuart, I will try to get the favicon and rtd_theme fixed.  We may have to
> > make our Docker image.
> >
> > Thanks.
> >
> > Laura
> >
> > On Fri, Jun 8, 2018 at 7:23 AM, Erik Faye-Lund 
> > wrote:
> >
> >> On Fri, Jun 8, 2018 at 4:09 PM Rhys Perry 
> >> wrote:
> >> >
> >> > Might be good to do something like this: https://codepen.io/anon/pen/ER
> >> NdYJ
> >> > So that those with NoScript or something won't have gears constantly
> >> > rotating on their screen.
> >> >
> >>
> >> Yeah, good point.
> >> ___
> >> mesa-dev mailing list
> >> mesa-dev@lists.freedesktop.org
> >> https://lists.freedesktop.org/mailman/listinfo/mesa-dev
> >>
> >
> >
> 
> 
> ___
> mesa-dev mailing list
> mesa-dev@lists.freedesktop.org
> https://lists.freedesktop.org/mailman/listinfo/mesa-dev
___
mesa-dev mailing list
mesa-dev@lists.freedesktop.org
https://lists.freedesktop.org/mailman/listinfo/mesa-dev

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

[Stuart Young]

Definitely looks to be the case that those issues have been addressed.

I see that you updated font-awesome while you were at it. :D

Once again, thanks for all the work on this (plus all those in the
background). It's much appreciated.

After it's live I'll see if I can review the content side of things and
will (hopefully) send patches as necessary. I definitely feel this is going
to make reviewing and working on the content much easier.

The series as per the above branch is
Acked-by: Stuart Young 


On Sat, 16 Jun 2018 at 08:41, Laura Ekstrand  wrote:

> Stuart,
>
> We are now running on our own Docker image:
> https://mesa-test.freedesktop.org/.
>
> This should have fixed both of the issues you encountered.
>
> Thanks.
>
> Laura
>
> On Mon, Jun 11, 2018 at 3:24 PM, Laura Ekstrand 
> wrote:
>
>> I really like the rotate on hover effect for the gears.  I would rather
>> that we use 2D WebGL for it if we could, though, since Mesa enables WebGL
>> on certain platforms.
>>
>> Stuart, I will try to get the favicon and rtd_theme fixed.  We may have
>> to make our Docker image.
>>
>> Thanks.
>>
>> Laura
>>
>> On Fri, Jun 8, 2018 at 7:23 AM, Erik Faye-Lund 
>> wrote:
>>
>>> On Fri, Jun 8, 2018 at 4:09 PM Rhys Perry 
>>> wrote:
>>> >
>>> > Might be good to do something like this:
>>> https://codepen.io/anon/pen/ERNdYJ
>>> > So that those with NoScript or something won't have gears constantly
>>> > rotating on their screen.
>>> >
>>>
>>> Yeah, good point.
>>> ___
>>> mesa-dev mailing list
>>> mesa-dev@lists.freedesktop.org
>>> https://lists.freedesktop.org/mailman/listinfo/mesa-dev
>>>
>>
>>
> ___
> mesa-dev mailing list
> mesa-dev@lists.freedesktop.org
> https://lists.freedesktop.org/mailman/listinfo/mesa-dev
>


-- 
Stuart Young (aka Cefiar)
___
mesa-dev mailing list
mesa-dev@lists.freedesktop.org
https://lists.freedesktop.org/mailman/listinfo/mesa-dev

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

[Laura Ekstrand]

Stuart,

We are now running on our own Docker image:
https://mesa-test.freedesktop.org/.

This should have fixed both of the issues you encountered.

Thanks.

Laura

On Mon, Jun 11, 2018 at 3:24 PM, Laura Ekstrand 
wrote:

> I really like the rotate on hover effect for the gears.  I would rather
> that we use 2D WebGL for it if we could, though, since Mesa enables WebGL
> on certain platforms.
>
> Stuart, I will try to get the favicon and rtd_theme fixed.  We may have to
> make our Docker image.
>
> Thanks.
>
> Laura
>
> On Fri, Jun 8, 2018 at 7:23 AM, Erik Faye-Lund 
> wrote:
>
>> On Fri, Jun 8, 2018 at 4:09 PM Rhys Perry 
>> wrote:
>> >
>> > Might be good to do something like this: https://codepen.io/anon/pen/ER
>> NdYJ
>> > So that those with NoScript or something won't have gears constantly
>> > rotating on their screen.
>> >
>>
>> Yeah, good point.
>> ___
>> mesa-dev mailing list
>> mesa-dev@lists.freedesktop.org
>> https://lists.freedesktop.org/mailman/listinfo/mesa-dev
>>
>
>
___
mesa-dev mailing list
mesa-dev@lists.freedesktop.org
https://lists.freedesktop.org/mailman/listinfo/mesa-dev

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

[Emil Velikov]

On 12 June 2018 at 01:21, Laura Ekstrand  wrote:
> It's done already, it was a one-liner:
> https://gitlab.freedesktop.org/ldeks/mesa/commits/website1_75_v2
>
Thanks for the great work Laura and thanks to Jean for the initial
poke in this direction.

I'm a huge fan of the script and separate steps - beatify, rename,
convert to markdown.

In a few places pandadoc did produce some strange markdown, but meh.
They are fairly hard to find and nitpicky, so it's something that we
can address at later stage.

The series in the above branch is
Reviewed-by: Emil Velikov 

-Emil
___
mesa-dev mailing list
mesa-dev@lists.freedesktop.org
https://lists.freedesktop.org/mailman/listinfo/mesa-dev

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

[Erik Faye-Lund]

On Tue, Jun 12, 2018 at 2:12 PM Erik Faye-Lund  wrote:
>
> On Tue, Jun 12, 2018 at 1:59 PM Ilia Mirkin  wrote:
> >
> > On Tue, Jun 12, 2018 at 7:04 AM, Erik Faye-Lund  wrote:
> > > I've updated my attempt here, to now have the original colors, and
> > > centered the M-corners on the text a bit more properly:
> > >
> > > https://codepen.io/kusma/pen/vrXppL
> > >
> > Erik - 
> > https://stackoverflow.com/questions/35124550/animating-an-svg-on-hover
> > - might want to do it the CSS way to avoid the onmouseover/etc stuff,
> > which IME is somewhat imperfect.
>
> Sure, I can give that a go.

Yeah, that was easy:

https://codepen.io/kusma/pen/vrXppL

Much nicer than the JS solution :)
___
mesa-dev mailing list
mesa-dev@lists.freedesktop.org
https://lists.freedesktop.org/mailman/listinfo/mesa-dev

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

[Rob Clark]

On Tue, Jun 12, 2018 at 7:04 AM, Erik Faye-Lund  wrote:
> I've updated my attempt here, to now have the original colors, and
> centered the M-corners on the text a bit more properly:
>
> https://codepen.io/kusma/pen/vrXppL

very nice :-)

BR,
-R

>
> On Tue, Jun 12, 2018 at 2:51 AM Rob Clark  wrote:
>>
>> On Mon, Jun 11, 2018 at 6:24 PM, Laura Ekstrand  wrote:
>> > I really like the rotate on hover effect for the gears.  I would rather 
>> > that
>> > we use 2D WebGL for it if we could, though, since Mesa enables WebGL on
>> > certain platforms.
>> >
>>
>> webgl can be a bit heavy for startup time although it might be kinda
>> nice if clicking the logo enough times launched an interactive webgl
>> version of the logo where you could rotate the logo..
>
> While a 3D WebGL logo would indeed be cool, I'm thinking that it's
> probably a relatively "heavy" solution for the use-case.
>
> I'm not particularly interested in trying out that direction, but if
> someone else is, I'd love to see it worked on, and maybe measure what
> kind of impact it would have on load-times etc?
___
mesa-dev mailing list
mesa-dev@lists.freedesktop.org
https://lists.freedesktop.org/mailman/listinfo/mesa-dev

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

[Erik Faye-Lund]

On Tue, Jun 12, 2018 at 1:59 PM Ilia Mirkin  wrote:
>
> On Tue, Jun 12, 2018 at 7:04 AM, Erik Faye-Lund  wrote:
> > I've updated my attempt here, to now have the original colors, and
> > centered the M-corners on the text a bit more properly:
> >
> > https://codepen.io/kusma/pen/vrXppL
> >
> Erik - https://stackoverflow.com/questions/35124550/animating-an-svg-on-hover
> - might want to do it the CSS way to avoid the onmouseover/etc stuff,
> which IME is somewhat imperfect.

Sure, I can give that a go.

On a side-note, I've also created a new favicon from the gears SVG,
and it looks quite a bit cleaner than the current one IMO:

https://gitlab.freedesktop.org/kusma/mesa/tree/new-favicon

We should probably just do that imagemagick-line on CI instead of
checking in the ICO-file, though.
___
mesa-dev mailing list
mesa-dev@lists.freedesktop.org
https://lists.freedesktop.org/mailman/listinfo/mesa-dev

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

[Ilia Mirkin]

On Tue, Jun 12, 2018 at 7:04 AM, Erik Faye-Lund  wrote:
> I've updated my attempt here, to now have the original colors, and
> centered the M-corners on the text a bit more properly:
>
> https://codepen.io/kusma/pen/vrXppL
>
> On Tue, Jun 12, 2018 at 2:51 AM Rob Clark  wrote:
>>
>> On Mon, Jun 11, 2018 at 6:24 PM, Laura Ekstrand  wrote:
>> > I really like the rotate on hover effect for the gears.  I would rather 
>> > that
>> > we use 2D WebGL for it if we could, though, since Mesa enables WebGL on
>> > certain platforms.
>> >
>>
>> webgl can be a bit heavy for startup time although it might be kinda
>> nice if clicking the logo enough times launched an interactive webgl
>> version of the logo where you could rotate the logo..
>
> While a 3D WebGL logo would indeed be cool, I'm thinking that it's
> probably a relatively "heavy" solution for the use-case.
>
> I'm not particularly interested in trying out that direction, but if
> someone else is, I'd love to see it worked on, and maybe measure what
> kind of impact it would have on load-times etc?

I tend to agree - svg seems like the natural fit for web, while WebGL
is cool-but-too-heavy for a logo. Cool to have a demo page with it,
but I don't know if it should be in the logo on every page, esp given
WebGL's propensity to crash things.

Erik - https://stackoverflow.com/questions/35124550/animating-an-svg-on-hover
- might want to do it the CSS way to avoid the onmouseover/etc stuff,
which IME is somewhat imperfect.
___
mesa-dev mailing list
mesa-dev@lists.freedesktop.org
https://lists.freedesktop.org/mailman/listinfo/mesa-dev

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

[Erik Faye-Lund]

I've updated my attempt here, to now have the original colors, and
centered the M-corners on the text a bit more properly:

https://codepen.io/kusma/pen/vrXppL

On Tue, Jun 12, 2018 at 2:51 AM Rob Clark  wrote:
>
> On Mon, Jun 11, 2018 at 6:24 PM, Laura Ekstrand  wrote:
> > I really like the rotate on hover effect for the gears.  I would rather that
> > we use 2D WebGL for it if we could, though, since Mesa enables WebGL on
> > certain platforms.
> >
>
> webgl can be a bit heavy for startup time although it might be kinda
> nice if clicking the logo enough times launched an interactive webgl
> version of the logo where you could rotate the logo..

While a 3D WebGL logo would indeed be cool, I'm thinking that it's
probably a relatively "heavy" solution for the use-case.

I'm not particularly interested in trying out that direction, but if
someone else is, I'd love to see it worked on, and maybe measure what
kind of impact it would have on load-times etc?
___
mesa-dev mailing list
mesa-dev@lists.freedesktop.org
https://lists.freedesktop.org/mailman/listinfo/mesa-dev

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

[Rob Clark]

On Mon, Jun 11, 2018 at 6:24 PM, Laura Ekstrand  wrote:
> I really like the rotate on hover effect for the gears.  I would rather that
> we use 2D WebGL for it if we could, though, since Mesa enables WebGL on
> certain platforms.
>

webgl can be a bit heavy for startup time although it might be kinda
nice if clicking the logo enough times launched an interactive webgl
version of the logo where you could rotate the logo..

(and either way, it would be nice to see a mesa-gears version of the
gears+mesa logo in mesa-demos)

BR,
-R


> Stuart, I will try to get the favicon and rtd_theme fixed.  We may have to
> make our Docker image.
>
> Thanks.
>
> Laura
>
> On Fri, Jun 8, 2018 at 7:23 AM, Erik Faye-Lund  wrote:
>>
>> On Fri, Jun 8, 2018 at 4:09 PM Rhys Perry 
>> wrote:
>> >
>> > Might be good to do something like this:
>> > https://codepen.io/anon/pen/ERNdYJ
>> > So that those with NoScript or something won't have gears constantly
>> > rotating on their screen.
>> >
>>
>> Yeah, good point.
>> ___
>> mesa-dev mailing list
>> mesa-dev@lists.freedesktop.org
>> https://lists.freedesktop.org/mailman/listinfo/mesa-dev
>
>
>
> ___
> mesa-dev mailing list
> mesa-dev@lists.freedesktop.org
> https://lists.freedesktop.org/mailman/listinfo/mesa-dev
>
___
mesa-dev mailing list
mesa-dev@lists.freedesktop.org
https://lists.freedesktop.org/mailman/listinfo/mesa-dev

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

[Laura Ekstrand]

It's done already, it was a one-liner:
https://gitlab.freedesktop.org/ldeks/mesa/commits/website1_75_v2

On Mon, Jun 11, 2018 at 5:15 PM, Stuart Young  wrote:

> Laura: Brilliant. Don't let it hang any deployment though. There's so much
> more good in this that losing the favicon for a while is definitely worth
> it.
>
> On Tue, 12 Jun 2018 at 08:27, Laura Ekstrand  wrote:
>
>> I really like the rotate on hover effect for the gears.  I would rather
>> that we use 2D WebGL for it if we could, though, since Mesa enables WebGL
>> on certain platforms.
>>
>> Stuart, I will try to get the favicon and rtd_theme fixed.  We may have
>> to make our Docker image.
>>
>> Thanks.
>>
>> Laura
>>
>> On Fri, Jun 8, 2018 at 7:23 AM, Erik Faye-Lund 
>> wrote:
>>
>>> On Fri, Jun 8, 2018 at 4:09 PM Rhys Perry 
>>> wrote:
>>> >
>>> > Might be good to do something like this: https://codepen.io/anon/pen/
>>> ERNdYJ
>>> > So that those with NoScript or something won't have gears constantly
>>> > rotating on their screen.
>>> >
>>>
>>> Yeah, good point.
>>> ___
>>> mesa-dev mailing list
>>> mesa-dev@lists.freedesktop.org
>>> https://lists.freedesktop.org/mailman/listinfo/mesa-dev
>>>
>>
>> ___
>> mesa-dev mailing list
>> mesa-dev@lists.freedesktop.org
>> https://lists.freedesktop.org/mailman/listinfo/mesa-dev
>>
>
>
> --
> Stuart Young (aka Cefiar)
>
___
mesa-dev mailing list
mesa-dev@lists.freedesktop.org
https://lists.freedesktop.org/mailman/listinfo/mesa-dev

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

[Stuart Young]

Laura: Brilliant. Don't let it hang any deployment though. There's so much
more good in this that losing the favicon for a while is definitely worth
it.

On Tue, 12 Jun 2018 at 08:27, Laura Ekstrand  wrote:

> I really like the rotate on hover effect for the gears.  I would rather
> that we use 2D WebGL for it if we could, though, since Mesa enables WebGL
> on certain platforms.
>
> Stuart, I will try to get the favicon and rtd_theme fixed.  We may have to
> make our Docker image.
>
> Thanks.
>
> Laura
>
> On Fri, Jun 8, 2018 at 7:23 AM, Erik Faye-Lund 
> wrote:
>
>> On Fri, Jun 8, 2018 at 4:09 PM Rhys Perry 
>> wrote:
>> >
>> > Might be good to do something like this:
>> https://codepen.io/anon/pen/ERNdYJ
>> > So that those with NoScript or something won't have gears constantly
>> > rotating on their screen.
>> >
>>
>> Yeah, good point.
>> ___
>> mesa-dev mailing list
>> mesa-dev@lists.freedesktop.org
>> https://lists.freedesktop.org/mailman/listinfo/mesa-dev
>>
>
> ___
> mesa-dev mailing list
> mesa-dev@lists.freedesktop.org
> https://lists.freedesktop.org/mailman/listinfo/mesa-dev
>


-- 
Stuart Young (aka Cefiar)
___
mesa-dev mailing list
mesa-dev@lists.freedesktop.org
https://lists.freedesktop.org/mailman/listinfo/mesa-dev

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

[Laura Ekstrand]

I really like the rotate on hover effect for the gears.  I would rather
that we use 2D WebGL for it if we could, though, since Mesa enables WebGL
on certain platforms.

Stuart, I will try to get the favicon and rtd_theme fixed.  We may have to
make our Docker image.

Thanks.

Laura

On Fri, Jun 8, 2018 at 7:23 AM, Erik Faye-Lund  wrote:

> On Fri, Jun 8, 2018 at 4:09 PM Rhys Perry 
> wrote:
> >
> > Might be good to do something like this: https://codepen.io/anon/pen/
> ERNdYJ
> > So that those with NoScript or something won't have gears constantly
> > rotating on their screen.
> >
>
> Yeah, good point.
> ___
> mesa-dev mailing list
> mesa-dev@lists.freedesktop.org
> https://lists.freedesktop.org/mailman/listinfo/mesa-dev
>
___
mesa-dev mailing list
mesa-dev@lists.freedesktop.org
https://lists.freedesktop.org/mailman/listinfo/mesa-dev

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

[Erik Faye-Lund]

On Fri, Jun 8, 2018 at 4:09 PM Rhys Perry  wrote:
>
> Might be good to do something like this: https://codepen.io/anon/pen/ERNdYJ
> So that those with NoScript or something won't have gears constantly
> rotating on their screen.
>

Yeah, good point.
___
mesa-dev mailing list
mesa-dev@lists.freedesktop.org
https://lists.freedesktop.org/mailman/listinfo/mesa-dev

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

[Rhys Perry]

Might be good to do something like this: https://codepen.io/anon/pen/ERNdYJ
So that those with NoScript or something won't have gears constantly
rotating on their screen.

On Fri, Jun 8, 2018 at 2:25 PM, Erik Faye-Lund  wrote:
> On Fri, Jun 8, 2018 at 2:06 PM, Rob Clark  wrote:
>> On Fri, Jun 8, 2018 at 3:02 AM, Jordan Justen  wrote:
>>> On Thu, Jun 7, 2018 at 2:56 AM Eero Tamminen  
>>> wrote:
 On 07.06.2018 12:01, Erik Faye-Lund wrote:
 > Just as a fun toy, I decided to give an animated SVG "variation" of
 > this a go myself:
 >
 > https://codepen.io/kusma/pen/vrXppL
 >
 > The actual SVG can be found here:
 >
 > https://gitlab.freedesktop.org/snippets/492
 >
 > The gears were generated by this python script, based on the glxgears
 > source code:
 >
 > https://gitlab.freedesktop.org/snippets/491
 >
 > Now, dropping this onto the black background doesn't work that well,
 > as it gets a bit bland, so it's probably better to add back the colors
 > then.
 >
 > Also, I'm not really sure if animation is a good idea or not.

 Maybe it could be a link target for the static logo?

 (Kind of website "easter egg").

 > But I definitely think logos should be vector rather than raster ;)

 For Mesa, WebGL would be more fitting implementation than SVG though...
>>>
>>> https://github.com/gears3d/gears3d.github.io/blob/master/webgl10.js
>>>
>>> One comment I would have for any animation on the main pages (as
>>> opposed to a separate 'easter egg' page), it probably should be
>>> significantly slower moving than the traditional 70 degrees / second.
>>> The faster animation would be distracting on the main pages.
>>>
>>
>> so one idea, which I think isn't too over the top, is to have the
>> static mesa-gears logo in top corner, but clicking on it starts/stops
>> the animation (just toggle between static and animated svg, I guess?)
>
> Good idea. I updated the codepen to do a variation of that; it rotates
> as long as the mouse hovers it.
> ___
> mesa-dev mailing list
> mesa-dev@lists.freedesktop.org
> https://lists.freedesktop.org/mailman/listinfo/mesa-dev
___
mesa-dev mailing list
mesa-dev@lists.freedesktop.org
https://lists.freedesktop.org/mailman/listinfo/mesa-dev

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

[Erik Faye-Lund]

On Fri, Jun 8, 2018 at 2:06 PM, Rob Clark  wrote:
> On Fri, Jun 8, 2018 at 3:02 AM, Jordan Justen  wrote:
>> On Thu, Jun 7, 2018 at 2:56 AM Eero Tamminen  
>> wrote:
>>> On 07.06.2018 12:01, Erik Faye-Lund wrote:
>>> > Just as a fun toy, I decided to give an animated SVG "variation" of
>>> > this a go myself:
>>> >
>>> > https://codepen.io/kusma/pen/vrXppL
>>> >
>>> > The actual SVG can be found here:
>>> >
>>> > https://gitlab.freedesktop.org/snippets/492
>>> >
>>> > The gears were generated by this python script, based on the glxgears
>>> > source code:
>>> >
>>> > https://gitlab.freedesktop.org/snippets/491
>>> >
>>> > Now, dropping this onto the black background doesn't work that well,
>>> > as it gets a bit bland, so it's probably better to add back the colors
>>> > then.
>>> >
>>> > Also, I'm not really sure if animation is a good idea or not.
>>>
>>> Maybe it could be a link target for the static logo?
>>>
>>> (Kind of website "easter egg").
>>>
>>> > But I definitely think logos should be vector rather than raster ;)
>>>
>>> For Mesa, WebGL would be more fitting implementation than SVG though...
>>
>> https://github.com/gears3d/gears3d.github.io/blob/master/webgl10.js
>>
>> One comment I would have for any animation on the main pages (as
>> opposed to a separate 'easter egg' page), it probably should be
>> significantly slower moving than the traditional 70 degrees / second.
>> The faster animation would be distracting on the main pages.
>>
>
> so one idea, which I think isn't too over the top, is to have the
> static mesa-gears logo in top corner, but clicking on it starts/stops
> the animation (just toggle between static and animated svg, I guess?)

Good idea. I updated the codepen to do a variation of that; it rotates
as long as the mouse hovers it.
___
mesa-dev mailing list
mesa-dev@lists.freedesktop.org
https://lists.freedesktop.org/mailman/listinfo/mesa-dev

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

[Rob Clark]

On Fri, Jun 8, 2018 at 3:02 AM, Jordan Justen  wrote:
> On Thu, Jun 7, 2018 at 2:56 AM Eero Tamminen  
> wrote:
>> On 07.06.2018 12:01, Erik Faye-Lund wrote:
>> > Just as a fun toy, I decided to give an animated SVG "variation" of
>> > this a go myself:
>> >
>> > https://codepen.io/kusma/pen/vrXppL
>> >
>> > The actual SVG can be found here:
>> >
>> > https://gitlab.freedesktop.org/snippets/492
>> >
>> > The gears were generated by this python script, based on the glxgears
>> > source code:
>> >
>> > https://gitlab.freedesktop.org/snippets/491
>> >
>> > Now, dropping this onto the black background doesn't work that well,
>> > as it gets a bit bland, so it's probably better to add back the colors
>> > then.
>> >
>> > Also, I'm not really sure if animation is a good idea or not.
>>
>> Maybe it could be a link target for the static logo?
>>
>> (Kind of website "easter egg").
>>
>> > But I definitely think logos should be vector rather than raster ;)
>>
>> For Mesa, WebGL would be more fitting implementation than SVG though...
>
> https://github.com/gears3d/gears3d.github.io/blob/master/webgl10.js
>
> One comment I would have for any animation on the main pages (as
> opposed to a separate 'easter egg' page), it probably should be
> significantly slower moving than the traditional 70 degrees / second.
> The faster animation would be distracting on the main pages.
>

so one idea, which I think isn't too over the top, is to have the
static mesa-gears logo in top corner, but clicking on it starts/stops
the animation (just toggle between static and animated svg, I guess?)

BR,
-R
___
mesa-dev mailing list
mesa-dev@lists.freedesktop.org
https://lists.freedesktop.org/mailman/listinfo/mesa-dev

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

[Jordan Justen]

On Thu, Jun 7, 2018 at 2:56 AM Eero Tamminen  wrote:
> On 07.06.2018 12:01, Erik Faye-Lund wrote:
> > Just as a fun toy, I decided to give an animated SVG "variation" of
> > this a go myself:
> >
> > https://codepen.io/kusma/pen/vrXppL
> >
> > The actual SVG can be found here:
> >
> > https://gitlab.freedesktop.org/snippets/492
> >
> > The gears were generated by this python script, based on the glxgears
> > source code:
> >
> > https://gitlab.freedesktop.org/snippets/491
> >
> > Now, dropping this onto the black background doesn't work that well,
> > as it gets a bit bland, so it's probably better to add back the colors
> > then.
> >
> > Also, I'm not really sure if animation is a good idea or not.
>
> Maybe it could be a link target for the static logo?
>
> (Kind of website "easter egg").
>
> > But I definitely think logos should be vector rather than raster ;)
>
> For Mesa, WebGL would be more fitting implementation than SVG though...

https://github.com/gears3d/gears3d.github.io/blob/master/webgl10.js

One comment I would have for any animation on the main pages (as
opposed to a separate 'easter egg' page), it probably should be
significantly slower moving than the traditional 70 degrees / second.
The faster animation would be distracting on the main pages.

-Jordan
___
mesa-dev mailing list
mesa-dev@lists.freedesktop.org
https://lists.freedesktop.org/mailman/listinfo/mesa-dev

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

[Matt Turner]

On Thu, Jun 7, 2018 at 2:01 AM, Erik Faye-Lund  wrote:
> Just as a fun toy, I decided to give an animated SVG "variation" of
> this a go myself:
>
> https://codepen.io/kusma/pen/vrXppL
>
> The actual SVG can be found here:
>
> https://gitlab.freedesktop.org/snippets/492
>
> The gears were generated by this python script, based on the glxgears
> source code:
>
> https://gitlab.freedesktop.org/snippets/491
>
> Now, dropping this onto the black background doesn't work that well,
> as it gets a bit bland, so it's probably better to add back the colors
> then.
>
> Also, I'm not really sure if animation is a good idea or not. But I
> definitely think logos should be vector rather than raster ;)

Now it just needs to print an FPS! :)

That's super neat!
___
mesa-dev mailing list
mesa-dev@lists.freedesktop.org
https://lists.freedesktop.org/mailman/listinfo/mesa-dev

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

[Eric Engestrom]

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  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 
> > wrote:
> >
> >> On Thursday, 2018-05-31 21:33:16 -0400, mesa-dev-bounces@lists.freedes
> >> ktop.org wrote:
> >> > On Thu, May 31, 2018 at 8:31 PM, Jordan Justen
> >> >  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.jus...@intel.com>
> >> > >> wrote:
> >> > >>
> >> > >> > On 2018-05-31 12:27:04, Eric Anholt wrote:
> >> > >> > > Jordan Justen  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 

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

[Eero Tamminen]

Hi,

On 07.06.2018 12:01, Erik Faye-Lund wrote:

Just as a fun toy, I decided to give an animated SVG "variation" of
this a go myself:

https://codepen.io/kusma/pen/vrXppL

The actual SVG can be found here:

https://gitlab.freedesktop.org/snippets/492

The gears were generated by this python script, based on the glxgears
source code:

https://gitlab.freedesktop.org/snippets/491

Now, dropping this onto the black background doesn't work that well,
as it gets a bit bland, so it's probably better to add back the colors
then.

Also, I'm not really sure if animation is a good idea or not.


Maybe it could be a link target for the static logo?

(Kind of website "easter egg").



But I definitely think logos should be vector rather than raster ;)


For Mesa, WebGL would be more fitting implementation than SVG though...


- Eero



On Sun, Jun 3, 2018 at 1:49 AM, Jason Ekstrand  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 
wrote:


On Thursday, 2018-05-31 21:33:16 -0400,
mesa-dev-boun...@lists.freedesktop.org wrote:

On Thu, May 31, 2018 at 8:31 PM, Jordan Justen
 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/1rteTv9415XEMN1E11fyN0l3hTUCCbgwz/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

wrote:


On 2018-05-31 12:27:04, Eric Anholt wrote:

Jordan Justen  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@lists.freedesktop.org
https://lists.freedesktop.org/mailman/listinfo/mesa-dev

___
mesa-dev mailing list
mesa-dev@lists.freedesktop.org
https://lists.freedesktop.org/mailman/listinfo/mesa-dev

___
mesa-dev mailing list
mesa-dev@lists.freedesktop.org
https://lists.freedesktop.org/mailman/listinfo/mesa-dev




___
mesa-dev mailing list
mesa-dev@lists.freedesktop.org
https://lists.freedesktop.org/mailman/listinfo/mesa-dev


___
mesa-dev mailing list
mesa-dev@lists.freedesktop.org
https://lists.freedesktop.org/mailman/listinfo/mesa-dev



___
mesa-dev mailing list

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

[Erik Faye-Lund]

On Thu, Jun 7, 2018 at 11:14 AM, Mike Lothian  wrote:
> Hi
>
> Is it possible to get all 3 gears lined up under the points of the "M" and
> have the 3rd gear go under the "e" if need be

There's certainly room for improvement here, yeah.

I tried to get the gears lined up, but when throwing animation of them
on top, it gets a bit harder. Perhaps if I modified the M a bit... ?

I can keep working on it, if people thinks the direction is
interesting. I just wanted to share what I did so far, and check if
the animated gears idea had the right of life ;)

> Cheers
>
> Mike
>
> On Thu, 7 Jun 2018 at 10:02 Erik Faye-Lund  wrote:
>>
>> Just as a fun toy, I decided to give an animated SVG "variation" of
>> this a go myself:
>>
>> https://codepen.io/kusma/pen/vrXppL
>>
>> The actual SVG can be found here:
>>
>> https://gitlab.freedesktop.org/snippets/492
>>
>> The gears were generated by this python script, based on the glxgears
>> source code:
>>
>> https://gitlab.freedesktop.org/snippets/491
>>
>> Now, dropping this onto the black background doesn't work that well,
>> as it gets a bit bland, so it's probably better to add back the colors
>> then.
>>
>> Also, I'm not really sure if animation is a good idea or not. But I
>> definitely think logos should be vector rather than raster ;)
>>
>> On Sun, Jun 3, 2018 at 1:49 AM, Jason Ekstrand 
>> 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
>> > 
>> > wrote:
>> >>
>> >> On Thursday, 2018-05-31 21:33:16 -0400,
>> >> mesa-dev-boun...@lists.freedesktop.org wrote:
>> >> > On Thu, May 31, 2018 at 8:31 PM, Jordan Justen
>> >> >  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/1rteTv9415XEMN1E11fyN0l3hTUCCbgwz/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
>> >> > >> 
>> >> > >> wrote:
>> >> > >>
>> >> > >> > On 2018-05-31 12:27:04, Eric Anholt wrote:
>> >> > >> > > Jordan Justen  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 

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

[Mike Lothian]

Hi

Is it possible to get all 3 gears lined up under the points of the "M" and
have the 3rd gear go under the "e" if need be

Cheers

Mike

On Thu, 7 Jun 2018 at 10:02 Erik Faye-Lund  wrote:

> Just as a fun toy, I decided to give an animated SVG "variation" of
> this a go myself:
>
> https://codepen.io/kusma/pen/vrXppL
>
> The actual SVG can be found here:
>
> https://gitlab.freedesktop.org/snippets/492
>
> The gears were generated by this python script, based on the glxgears
> source code:
>
> https://gitlab.freedesktop.org/snippets/491
>
> Now, dropping this onto the black background doesn't work that well,
> as it gets a bit bland, so it's probably better to add back the colors
> then.
>
> Also, I'm not really sure if animation is a good idea or not. But I
> definitely think logos should be vector rather than raster ;)
>
> On Sun, Jun 3, 2018 at 1:49 AM, Jason Ekstrand 
> 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  >
> > wrote:
> >>
> >> On Thursday, 2018-05-31 21:33:16 -0400,
> >> mesa-dev-boun...@lists.freedesktop.org wrote:
> >> > On Thu, May 31, 2018 at 8:31 PM, Jordan Justen
> >> >  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/1rteTv9415XEMN1E11fyN0l3hTUCCbgwz/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
> >> > >> 
> >> > >> wrote:
> >> > >>
> >> > >> > On 2018-05-31 12:27:04, Eric Anholt wrote:
> >> > >> > > Jordan Justen  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 

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

[Erik Faye-Lund]

Just as a fun toy, I decided to give an animated SVG "variation" of
this a go myself:

https://codepen.io/kusma/pen/vrXppL

The actual SVG can be found here:

https://gitlab.freedesktop.org/snippets/492

The gears were generated by this python script, based on the glxgears
source code:

https://gitlab.freedesktop.org/snippets/491

Now, dropping this onto the black background doesn't work that well,
as it gets a bit bland, so it's probably better to add back the colors
then.

Also, I'm not really sure if animation is a good idea or not. But I
definitely think logos should be vector rather than raster ;)

On Sun, Jun 3, 2018 at 1:49 AM, Jason Ekstrand  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 
> wrote:
>>
>> On Thursday, 2018-05-31 21:33:16 -0400,
>> mesa-dev-boun...@lists.freedesktop.org wrote:
>> > On Thu, May 31, 2018 at 8:31 PM, Jordan Justen
>> >  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/1rteTv9415XEMN1E11fyN0l3hTUCCbgwz/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
>> > >> 
>> > >> wrote:
>> > >>
>> > >> > On 2018-05-31 12:27:04, Eric Anholt wrote:
>> > >> > > Jordan Justen  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@lists.freedesktop.org
>> > > https://lists.freedesktop.org/mailman/listinfo/mesa-dev
>> > ___
>> > mesa-dev mailing list
>> > mesa-dev@lists.freedesktop.org
>> > 

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

[Stuart Young]

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)?
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?

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.


On 3 June 2018 at 09:49, Jason Ekstrand  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 
> wrote:
>
>> On Thursday, 2018-05-31 21:33:16 -0400, mesa-dev-bounces@lists.freedes
>> ktop.org wrote:
>> > On Thu, May 31, 2018 at 8:31 PM, Jordan Justen
>> >  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.jus...@intel.com>
>> > >> wrote:
>> > >>
>> > >> > On 2018-05-31 12:27:04, Eric Anholt wrote:
>> > >> > > Jordan Justen  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
>> > >> >
>> > > 

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

[Daniel Stone]

On 4 June 2018 at 19:29, Dylan Baker  wrote:
> Quoting Daniel Stone (2018-06-04 11:20:45)
>> Is git-lfs mainly about supporting large individual files, or large
>> collections of relatively small files? The tarballs aren't massive,
>> there are just tons of them. If it does seem like a good idea, I'll
>> get it set up in our instance.
>
> It's just for dealing with binary files in general. The advantage is that the
> binaries live on a generic file server so you don't have to fetch them if you
> don't want them (they show up as a text file with a hash until you fetch 
> them).
> I don't know if it's necessary I've just had good luck with it in the past for
> handling binaries.

Yeah, that sounds exactly like what we want then! I'll get it set up
during the week.

Cheers,
Daniel
___
mesa-dev mailing list
mesa-dev@lists.freedesktop.org
https://lists.freedesktop.org/mailman/listinfo/mesa-dev

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

[Dylan Baker]

Quoting Daniel Stone (2018-06-04 11:20:45)
> Hi Dylan,
> 
> On 4 June 2018 at 19:18, Dylan Baker  wrote:
> > Quoting Daniel Stone (2018-06-03 13:19:51)
> >> One thing I've just remembered is that https://www.mesa3d.org/archive/
> >> serves all the tarballs for Mesa releases. Given how Pages is
> >> structured, we don't have a good way to redirect these to the old
> >> server, so the Pages repository needs to hold all the tarballs. This
> >> probably suggests to me that the site should live in a different repo,
> >> where we can just commit all the tarballs.
> >>
> >> I reflexively didn't love the idea of committing tarballs to a git
> >> repository, but the more I think about it, the more I like the idea.
> >> It makes it more clear where they're coming from, makes the provenance
> >> easier to verify, gives us audit logs of who put them in, and so on.
> >
> > Have you considered git-lfs? I don't know if we've got it set up, but gitlab
> > supports it and it's pretty nice for dealing with repos with large binary 
> > files.
> 
> Is git-lfs mainly about supporting large individual files, or large
> collections of relatively small files? The tarballs aren't massive,
> there are just tons of them. If it does seem like a good idea, I'll
> get it set up in our instance.
> 
> Cheers,
> Daniel

It's just for dealing with binary files in general. The advantage is that the
binaries live on a generic file server so you don't have to fetch them if you
don't want them (they show up as a text file with a hash until you fetch them).
I don't know if it's necessary I've just had good luck with it in the past for
handling binaries.

Dylan


signature.asc
Description: signature
___
mesa-dev mailing list
mesa-dev@lists.freedesktop.org
https://lists.freedesktop.org/mailman/listinfo/mesa-dev

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

[Daniel Stone]

Hi Dylan,

On 4 June 2018 at 19:18, Dylan Baker  wrote:
> Quoting Daniel Stone (2018-06-03 13:19:51)
>> One thing I've just remembered is that https://www.mesa3d.org/archive/
>> serves all the tarballs for Mesa releases. Given how Pages is
>> structured, we don't have a good way to redirect these to the old
>> server, so the Pages repository needs to hold all the tarballs. This
>> probably suggests to me that the site should live in a different repo,
>> where we can just commit all the tarballs.
>>
>> I reflexively didn't love the idea of committing tarballs to a git
>> repository, but the more I think about it, the more I like the idea.
>> It makes it more clear where they're coming from, makes the provenance
>> easier to verify, gives us audit logs of who put them in, and so on.
>
> Have you considered git-lfs? I don't know if we've got it set up, but gitlab
> supports it and it's pretty nice for dealing with repos with large binary 
> files.

Is git-lfs mainly about supporting large individual files, or large
collections of relatively small files? The tarballs aren't massive,
there are just tons of them. If it does seem like a good idea, I'll
get it set up in our instance.

Cheers,
Daniel
___
mesa-dev mailing list
mesa-dev@lists.freedesktop.org
https://lists.freedesktop.org/mailman/listinfo/mesa-dev

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

[Dylan Baker]

Quoting Daniel Stone (2018-06-03 13:19:51)
> Hi Laura,
> 
> On 25 May 2018 at 01:27, Laura Ekstrand  wrote:
> > When reviewing these patches, please note:
> > 1. This patch series does *not* touch content.  Please do not 
> > bikeshed
> >the content of webpages here.  That will be addressed in later
> >commits.
> > 2. Please do *not* bikeshed website style here.  We are using the
> >classic ReadTheDocs style for now and we will update style in a
> >future commit.
> > 3. I've done my best to make your current content look beautiful.  
> > If
> >there's a problem, please let me know.
> > 4. There were some commits to the website between when I started 
> > this
> >series and now. I've done my best to incorporate your changes.
> >So if you changed your content in the past two weeks, take a look
> >at your page.
> 
> One thing I've just remembered is that https://www.mesa3d.org/archive/
> serves all the tarballs for Mesa releases. Given how Pages is
> structured, we don't have a good way to redirect these to the old
> server, so the Pages repository needs to hold all the tarballs. This
> probably suggests to me that the site should live in a different repo,
> where we can just commit all the tarballs.
> 
> I reflexively didn't love the idea of committing tarballs to a git
> repository, but the more I think about it, the more I like the idea.
> It makes it more clear where they're coming from, makes the provenance
> easier to verify, gives us audit logs of who put them in, and so on.
> 
> Cheers,
> Daniel

Have you considered git-lfs? I don't know if we've got it set up, but gitlab
supports it and it's pretty nice for dealing with repos with large binary files.

Dylan


signature.asc
Description: signature
___
mesa-dev mailing list
mesa-dev@lists.freedesktop.org
https://lists.freedesktop.org/mailman/listinfo/mesa-dev

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

[Jason Ekstrand]

On Sun, Jun 3, 2018 at 4:36 PM, Stuart Young  wrote:

> Perhaps just have the archive as a separate repo that gets pulled in by
> the main ci yaml at build, just to populate the archives directory?
>

I was thinking something along those lines too.  It would be easy enough to
have a git repo for the tarballs and just combine the two as part of the CI
script.

--Jason



> This avoids any possible submodule breakage (just not worth it here IMO),
> with no chance of accidentally pulling down all the archives. I know a
> few people who have git shortcuts that update submodules by default for
> example, whether they exist or not.
>
> Also I personally think the archives dir needs a bit of re-org/cleanup to
> make it a bit more persistent over time (eg: like moving the old stuff into
> the older-versions dir effectively breaks links for distros, etc). That's
> getting more into content, but it'd be worth exploring if that should/would
> get done before or after the move to a git repo (ie: would it being in git
> make the process harder/a nightmare if it was to happen).
>
>
> On 4 June 2018 at 06:19, Daniel Stone  wrote:
>
>> Hi Laura,
>>
>> On 25 May 2018 at 01:27, Laura Ekstrand  wrote:
>> > When reviewing these patches, please note:
>> > 1. This patch series does *not* touch content.  Please do not
>> bikeshed
>> >the content of webpages here.  That will be addressed in
>> later
>> >commits.
>> > 2. Please do *not* bikeshed website style here.  We are using
>> the
>> >classic ReadTheDocs style for now and we will update style
>> in a
>> >future commit.
>> > 3. I've done my best to make your current content look
>> beautiful.  If
>> >there's a problem, please let me know.
>> > 4. There were some commits to the website between when I
>> started this
>> >series and now. I've done my best to incorporate your
>> changes.
>> >So if you changed your content in the past two weeks, take a
>> look
>> >at your page.
>>
>> One thing I've just remembered is that https://www.mesa3d.org/archive/
>> serves all the tarballs for Mesa releases. Given how Pages is
>> structured, we don't have a good way to redirect these to the old
>> server, so the Pages repository needs to hold all the tarballs. This
>> probably suggests to me that the site should live in a different repo,
>> where we can just commit all the tarballs.
>>
>> I reflexively didn't love the idea of committing tarballs to a git
>> repository, but the more I think about it, the more I like the idea.
>> It makes it more clear where they're coming from, makes the provenance
>> easier to verify, gives us audit logs of who put them in, and so on.
>>
>> Cheers,
>> Daniel
>> ___
>> mesa-dev mailing list
>> mesa-dev@lists.freedesktop.org
>> https://lists.freedesktop.org/mailman/listinfo/mesa-dev
>>
>
>
>
> --
> Stuart Young (aka Cefiar)
>
> ___
> mesa-dev mailing list
> mesa-dev@lists.freedesktop.org
> https://lists.freedesktop.org/mailman/listinfo/mesa-dev
>
>
___
mesa-dev mailing list
mesa-dev@lists.freedesktop.org
https://lists.freedesktop.org/mailman/listinfo/mesa-dev

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

[Stuart Young]

Perhaps just have the archive as a separate repo that gets pulled in by the
main ci yaml at build, just to populate the archives directory?

This avoids any possible submodule breakage (just not worth it here IMO),
with no chance of accidentally pulling down all the archives. I know a few
people who have git shortcuts that update submodules by default for
example, whether they exist or not.

Also I personally think the archives dir needs a bit of re-org/cleanup to
make it a bit more persistent over time (eg: like moving the old stuff into
the older-versions dir effectively breaks links for distros, etc). That's
getting more into content, but it'd be worth exploring if that should/would
get done before or after the move to a git repo (ie: would it being in git
make the process harder/a nightmare if it was to happen).


On 4 June 2018 at 06:19, Daniel Stone  wrote:

> Hi Laura,
>
> On 25 May 2018 at 01:27, Laura Ekstrand  wrote:
> > When reviewing these patches, please note:
> > 1. This patch series does *not* touch content.  Please do not
> bikeshed
> >the content of webpages here.  That will be addressed in later
> >commits.
> > 2. Please do *not* bikeshed website style here.  We are using the
> >classic ReadTheDocs style for now and we will update style in
> a
> >future commit.
> > 3. I've done my best to make your current content look
> beautiful.  If
> >there's a problem, please let me know.
> > 4. There were some commits to the website between when I started
> this
> >series and now. I've done my best to incorporate your changes.
> >So if you changed your content in the past two weeks, take a
> look
> >at your page.
>
> One thing I've just remembered is that https://www.mesa3d.org/archive/
> serves all the tarballs for Mesa releases. Given how Pages is
> structured, we don't have a good way to redirect these to the old
> server, so the Pages repository needs to hold all the tarballs. This
> probably suggests to me that the site should live in a different repo,
> where we can just commit all the tarballs.
>
> I reflexively didn't love the idea of committing tarballs to a git
> repository, but the more I think about it, the more I like the idea.
> It makes it more clear where they're coming from, makes the provenance
> easier to verify, gives us audit logs of who put them in, and so on.
>
> Cheers,
> Daniel
> ___
> mesa-dev mailing list
> mesa-dev@lists.freedesktop.org
> https://lists.freedesktop.org/mailman/listinfo/mesa-dev
>



-- 
Stuart Young (aka Cefiar)
___
mesa-dev mailing list
mesa-dev@lists.freedesktop.org
https://lists.freedesktop.org/mailman/listinfo/mesa-dev

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

[Daniel Stone]

Hi Laura,

On 25 May 2018 at 01:27, Laura Ekstrand  wrote:
> When reviewing these patches, please note:
> 1. This patch series does *not* touch content.  Please do not bikeshed
>the content of webpages here.  That will be addressed in later
>commits.
> 2. Please do *not* bikeshed website style here.  We are using the
>classic ReadTheDocs style for now and we will update style in a
>future commit.
> 3. I've done my best to make your current content look beautiful.  If
>there's a problem, please let me know.
> 4. There were some commits to the website between when I started this
>series and now. I've done my best to incorporate your changes.
>So if you changed your content in the past two weeks, take a look
>at your page.

One thing I've just remembered is that https://www.mesa3d.org/archive/
serves all the tarballs for Mesa releases. Given how Pages is
structured, we don't have a good way to redirect these to the old
server, so the Pages repository needs to hold all the tarballs. This
probably suggests to me that the site should live in a different repo,
where we can just commit all the tarballs.

I reflexively didn't love the idea of committing tarballs to a git
repository, but the more I think about it, the more I like the idea.
It makes it more clear where they're coming from, makes the provenance
easier to verify, gives us audit logs of who put them in, and so on.

Cheers,
Daniel
___
mesa-dev mailing list
mesa-dev@lists.freedesktop.org
https://lists.freedesktop.org/mailman/listinfo/mesa-dev

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

[Rob Clark]

On Sat, Jun 2, 2018 at 7:49 PM, Jason Ekstrand  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.

it almost looks like the three corners of the "M" could fit in the
holes in the gears.. not sure if that could be made to work by
tweaking the width of the "M" or size of the gears, or if that just
ends up worse..

(then someone just needs to make a 3d rotating model of mesa-gears
with the gears running on axles extending from the M .. :-P)

BR,
-R

>
> --Jason
>
>
>
> On Fri, Jun 1, 2018 at 2:46 AM, Eric Engestrom 
> wrote:
>>
>> On Thursday, 2018-05-31 21:33:16 -0400,
>> mesa-dev-boun...@lists.freedesktop.org wrote:
>> > On Thu, May 31, 2018 at 8:31 PM, Jordan Justen
>> >  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/1rteTv9415XEMN1E11fyN0l3hTUCCbgwz/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
>> > >> 
>> > >> wrote:
>> > >>
>> > >> > On 2018-05-31 12:27:04, Eric Anholt wrote:
>> > >> > > Jordan Justen  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@lists.freedesktop.org
>> > > https://lists.freedesktop.org/mailman/listinfo/mesa-dev
>> > ___
>> > mesa-dev mailing list
>> > mesa-dev@lists.freedesktop.org
>> > https://lists.freedesktop.org/mailman/listinfo/mesa-dev
>> ___
>> mesa-dev mailing list
>> mesa-dev@lists.freedesktop.org
>> https://lists.freedesktop.org/mailman/listinfo/mesa-dev
>
>
>
> ___
> mesa-dev mailing 

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

[Jason Ekstrand]

+Brian

I just want to make sure he doesn't miss the thread.

On Thu, May 24, 2018 at 5:27 PM, Laura Ekstrand 
wrote:

> It's time to move the Mesa-3d.org website into the 21st century. We have
> chosen to move to Sphinx and resStructured text for a number of reasons:
>   1. Syntax highlighting for code snippets.
>   2. Snazzy highlighting for variables and function names.
>   3. Consistency with the Gallium drivers, which host their documentation
> on
>  ReadTheDocs.
>   4. Ultimately less work for us, because writing content in reStructured
> Text
>  is simpler and Sphinx turns it into beautiful, readable pages without
> us
>  having to manually fix problems in html and css.
>   5. With Gitlab, the Sphinx website is auto-generated every time the Mesa
>  code repository is pushed to Gitlab without us having to
>  build and deploy it.
>
> The new website is currently hosted at mesa-test.freedesktop.org.  When
> these
> patches are merged, Daniel Stone will point our Gitlab CI system at
> mesa-3d.org.
>
> When reviewing these patches, please note:
> 1. This patch series does *not* touch content.  Please do not
> bikeshed
>the content of webpages here.  That will be addressed in later
>commits.
> 2. Please do *not* bikeshed website style here.  We are using the
>classic ReadTheDocs style for now and we will update style in a
>future commit.
> 3. I've done my best to make your current content look beautiful.
> If
>there's a problem, please let me know.
> 4. There were some commits to the website between when I started
> this
>series and now. I've done my best to incorporate your changes.
>So if you changed your content in the past two weeks, take a
> look
>at your page.
>
> I hope you'll agree that the resulting pages are much cleaner and easier to
> read.  I've learned a lot by reading these pages.
>
> Thanks.
>
> Laura Ekstrand
> ---
>
> Jean Hertel (3):
>   docs: Add Sphinx configuration file.
>   docs: Add a navigation sidebar.
>   docs: Add toctree to relnotes
>
> Laura Ekstrand (13):
>   Added ci yaml file for Gitlab.
>   docs: Add python script that converts html to rst.
>   docs: Remove contents.html
>   docs: Result of script fixing html with Beautiful Soup.
>   docs: Add results of script - pandoc-generated rst pages.
>   docs: Add command for Sphinx build.
>   docs: Toctree for systems.rst as in jhertel docs.
>   docs: Remove html files.
>   docs: Fix Sphinx compile errors.
>   docs: Edits to fix toctrees.
>   docs: Major manual edits to environment vars.
>   docs: Human edits to the website code for clarity.
>   docs: Remove unneeded mesa css file.
>
>  .gitlab-ci.yml   |   11 +
>  docs/application-issues.html |   83 --
>  docs/application-issues.rst  |   48 +
>  docs/autoconf.html   |  257 
>  docs/autoconf.rst|  209 +++
>  docs/bugs.html   |   64 -
>  docs/bugs.rst|   33 +
>  docs/codingstyle.html|  142 --
>  docs/codingstyle.rst |  124 ++
>  docs/conf.py |  162 +++
>  docs/conform.html|  703 --
>  docs/conform.rst |  675 ++
>  docs/contents.html   |  108 --
>  docs/debugging.html  |   47 -
>  docs/debugging.rst   |   21 +
>  docs/developers.html |   58 -
>  docs/developers.rst  |   25 +
>  docs/devinfo.html|   83 --
>  docs/devinfo.rst |   43 +
>  docs/dispatch.html   |  278 
>  docs/dispatch.rst|  257 
>  docs/download.html   |  112 --
>  docs/download.rst|   73 ++
>  docs/egl.html|  259 
>  docs/egl.rst |  117 ++
>  docs/envvars.html|  383 --
>  docs/envvars.rst |  615 +
>  docs/extensions.html |   51 -
>  docs/extensions.rst  |   31 +
>  docs/faq.html|  392 --
>  docs/faq.rst |  308 +
>  docs/helpwanted.html |   88 --
>  docs/helpwanted.rst  |   46 +
>  docs/index.html  | 2380 -
>  docs/index.rst   | 2438 ++
>  docs/install.html|  252 
>  docs/install.rst |  193 +++
>  docs/intro.html  |  404 --
>  docs/intro.rst   |  308 +
>  docs/license.html|  121 --
>  docs/license.rst |   89 ++
>  docs/lists.html  |   97 --
>  docs/lists.rst   |   62 +
>  docs/llvmpipe.html   |  330 -
>  docs/llvmpipe.rst|  277 
>  docs/mangling.html   |   37 -
>  docs/mangling.rst|   14 +
>  docs/mesa.css|   63 -
>  docs/meson.html  |  179 ---
>  docs/meson.rst   |  129 ++
>  docs/opengles.html 

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

[Jason Ekstrand]

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 
wrote:

> On Thursday, 2018-05-31 21:33:16 -0400, mesa-dev-bounces@lists.
> freedesktop.org wrote:
> > On Thu, May 31, 2018 at 8:31 PM, Jordan Justen
> >  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/1rteTv9415XEMN1E11fyN0l3hTUCCb
> gwz/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.jus...@intel.com>
> > >> wrote:
> > >>
> > >> > On 2018-05-31 12:27:04, Eric Anholt wrote:
> > >> > > Jordan Justen  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@lists.freedesktop.org
> > > https://lists.freedesktop.org/mailman/listinfo/mesa-dev
> > ___
> > mesa-dev mailing list
> > mesa-dev@lists.freedesktop.org
> > https://lists.freedesktop.org/mailman/listinfo/mesa-dev
> ___
> mesa-dev mailing list
> mesa-dev@lists.freedesktop.org
> https://lists.freedesktop.org/mailman/listinfo/mesa-dev
>
___
mesa-dev mailing list
mesa-dev@lists.freedesktop.org
https://lists.freedesktop.org/mailman/listinfo/mesa-dev

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

[Eric Engestrom]

On Thursday, 2018-05-31 21:33:16 -0400, mesa-dev-boun...@lists.freedesktop.org 
wrote:
> On Thu, May 31, 2018 at 8:31 PM, Jordan Justen
>  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/1rteTv9415XEMN1E11fyN0l3hTUCCbgwz/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 
> >> wrote:
> >>
> >> > On 2018-05-31 12:27:04, Eric Anholt wrote:
> >> > > Jordan Justen  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@lists.freedesktop.org
> > https://lists.freedesktop.org/mailman/listinfo/mesa-dev
> ___
> mesa-dev mailing list
> mesa-dev@lists.freedesktop.org
> https://lists.freedesktop.org/mailman/listinfo/mesa-dev
___
mesa-dev mailing list
mesa-dev@lists.freedesktop.org
https://lists.freedesktop.org/mailman/listinfo/mesa-dev

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

[Rob Clark]

On Thu, May 31, 2018 at 8:31 PM, Jordan Justen
 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/1rteTv9415XEMN1E11fyN0l3hTUCCbgwz/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 ;-)

BR,
-R


>
> Thanks,
>
> -Jordan
>
>> On Thu, May 31, 2018 at 1:55 PM, Jordan Justen 
>> wrote:
>>
>> > On 2018-05-31 12:27:04, Eric Anholt wrote:
>> > > Jordan Justen  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@lists.freedesktop.org
> https://lists.freedesktop.org/mailman/listinfo/mesa-dev
___
mesa-dev mailing list
mesa-dev@lists.freedesktop.org
https://lists.freedesktop.org/mailman/listinfo/mesa-dev

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

[Jordan Justen]

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/1rteTv9415XEMN1E11fyN0l3hTUCCbgwz/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.

Thanks,

-Jordan

> On Thu, May 31, 2018 at 1:55 PM, Jordan Justen 
> wrote:
> 
> > On 2018-05-31 12:27:04, Eric Anholt wrote:
> > > Jordan Justen  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@lists.freedesktop.org
https://lists.freedesktop.org/mailman/listinfo/mesa-dev

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

[Laura Ekstrand]

A little bit of messing around this afternoon, led to this:
https://drive.google.com/file/d/1rteTv9415XEMN1E11fyN0l3hTUCCbgwz/view?usp=sharing

The gears are from Font Awesome, which comes with the RTD format.

On Thu, May 31, 2018 at 1:55 PM, Jordan Justen 
wrote:

> On 2018-05-31 12:27:04, Eric Anholt wrote:
> > Jordan Justen  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@lists.freedesktop.org
https://lists.freedesktop.org/mailman/listinfo/mesa-dev

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

[Jordan Justen]

On 2018-05-31 12:27:04, Eric Anholt wrote:
> Jordan Justen  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@lists.freedesktop.org
https://lists.freedesktop.org/mailman/listinfo/mesa-dev

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

[Eric Anholt]

Jordan Justen  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.


signature.asc
Description: PGP signature
___
mesa-dev mailing list
mesa-dev@lists.freedesktop.org
https://lists.freedesktop.org/mailman/listinfo/mesa-dev

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

[Laura Ekstrand]

The current plan is that this first patch series should just update the
website.  Then we can swap out the theme easily with one or two commands in
the next series.  The goal of this series is to move the website to the new
infrastructure.  Then we can edit content and style.

On Tue, May 29, 2018 at 11:05 PM, Jordan Justen 
wrote:

> 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.
>
> -Jordan
>
> > On Thu, May 24, 2018 at 5:27 PM, Laura Ekstrand 
> > wrote:
> >
> > > It's time to move the Mesa-3d.org website into the 21st century. We
> have
> > > chosen to move to Sphinx and resStructured text for a number of
> reasons:
> > >   1. Syntax highlighting for code snippets.
> > >   2. Snazzy highlighting for variables and function names.
> > >   3. Consistency with the Gallium drivers, which host their
> documentation
> > > on
> > >  ReadTheDocs.
> > >   4. Ultimately less work for us, because writing content in
> reStructured
> > > Text
> > >  is simpler and Sphinx turns it into beautiful, readable pages
> without
> > > us
> > >  having to manually fix problems in html and css.
> > >   5. With Gitlab, the Sphinx website is auto-generated every time the
> Mesa
> > >  code repository is pushed to Gitlab without us having to
> > >  build and deploy it.
> > >
> > > The new website is currently hosted at mesa-test.freedesktop.org.
> When
> > > these
> > > patches are merged, Daniel Stone will point our Gitlab CI system at
> > > mesa-3d.org.
> > >
> > > When reviewing these patches, please note:
> > > 1. This patch series does *not* touch content.  Please do not
> > > bikeshed
> > >the content of webpages here.  That will be addressed in
> later
> > >commits.
> > > 2. Please do *not* bikeshed website style here.  We are using
> the
> > >classic ReadTheDocs style for now and we will update style
> in a
> > >future commit.
> > > 3. I've done my best to make your current content look
> beautiful.
> > > If
> > >there's a problem, please let me know.
> > > 4. There were some commits to the website between when I
> started
> > > this
> > >series and now. I've done my best to incorporate your
> changes.
> > >So if you changed your content in the past two weeks, take a
> > > look
> > >at your page.
> > >
> > > I hope you'll agree that the resulting pages are much cleaner and
> easier to
> > > read.  I've learned a lot by reading these pages.
> > >
> > > Thanks.
> > >
> > > Laura Ekstrand
> > > ---
> > >
> > > Jean Hertel (3):
> > >   docs: Add Sphinx configuration file.
> > >   docs: Add a navigation sidebar.
> > >   docs: Add toctree to relnotes
> > >
> > > Laura Ekstrand (13):
> > >   Added ci yaml file for Gitlab.
> > >   docs: Add python script that converts html to rst.
> > >   docs: Remove contents.html
> > >   docs: Result of script fixing html with Beautiful Soup.
> > >   docs: Add results of script - pandoc-generated rst pages.
> > >   docs: Add command for Sphinx build.
> > >   docs: Toctree for systems.rst as in jhertel docs.
> > >   docs: Remove html files.
> > >   docs: Fix Sphinx compile errors.
> > >   docs: Edits to fix toctrees.
> > >   docs: Major manual edits to environment vars.
> > >   docs: Human edits to the website code for clarity.
> > >   docs: Remove unneeded mesa css file.
> > >
> > >  .gitlab-ci.yml   |   11 +
> > >  docs/application-issues.html |   83 --
> > >  docs/application-issues.rst  |   48 +
> > >  docs/autoconf.html   |  257 
> > >  docs/autoconf.rst|  209 +++
> > >  docs/bugs.html   |   64 -
> > >  docs/bugs.rst|   33 +
> > >  docs/codingstyle.html|  142 --
> > >  docs/codingstyle.rst |  124 ++
> > >  docs/conf.py |  162 +++
> > >  docs/conform.html|  703 --
> > >  docs/conform.rst |  675 ++
> > >  docs/contents.html   |  108 --
> > >  docs/debugging.html  |   47 -
> > >  docs/debugging.rst   |   21 +
> > >  docs/developers.html |   58 -
> > >  docs/developers.rst  |   25 +
> > >  docs/devinfo.html|   83 --
> > >  docs/devinfo.rst |   43 +
> > >  

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

[Jordan Justen]

On 2018-05-30 17:35:11,  wrote:
> On Wed, May 30, 2018 at 7:53 PM, Jordan Justen
>  wrote:
> > On 2018-05-30 14:14:18, Laura Ekstrand wrote:
> >> The current plan is that this first patch series should just update the
> >> website.  Then we can swap out the theme easily with one or two commands in
> >> the next series.
> >
> > If it's easy to do, then why not just do it? I don't think the
> > mesa3d.org website should go through a step of looking like a generic
> > readthedocs book.
> >
> > I understand we might want to tweak the look more later on, but I'm
> > guessing with a couple more simple patches it could look somewhat like
> > the current site.
> 
> tbh, I'm not sure generic rtd look is a step backwards..

For the most part, it is better, but the blandness is a step
backwards. Say what you will about the current site (and you did
below), at least it is recognizable.

> If there were some proposals about future looks, and those could be
> pushed somewhere so others can review the result, by all means go for
> it.

My minimum proposal would be:

1. upper left background black with white text

2. retain the gears icon somewhere near the top

3. left background gray with black text

This would provide a least a minimum of continuity to the current
site.

A few other ideas, but more reasonable to be left for the future:

1. remove 'latest' in the upper left

2. change 'search docs' be 'search site'

3. might be nice to retain the black bar acress the top (maybe, maybe
   not.)

> But it doesn't seem to me like something that should hold back
> the process.

If these are "easy to change" elements of the new site, then I don't
think the comment of "holding things back" is fair. If these are not
easy to change, then it should be clear that what it currently looks
like may be what we are stuck with.

-Jordan

> I mean when was "it looks less like the late 90's" a bad
> thing?
> 
> BR,
> -R
> 
> >
> > -Jordan
> >
> >> The goal of this series is to move the website to the new
> >> infrastructure.  Then we can edit content and style.
> >>
> >> On Tue, May 29, 2018 at 11:05 PM, Jordan Justen 
> >> wrote:
> >>
> >> > 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.
> >> >
> >> > -Jordan
> >> >
> >> > > On Thu, May 24, 2018 at 5:27 PM, Laura Ekstrand 
> >> > > wrote:
> >> > >
> >> > > > It's time to move the Mesa-3d.org website into the 21st century. We
> >> > have
> >> > > > chosen to move to Sphinx and resStructured text for a number of
> >> > reasons:
> >> > > >   1. Syntax highlighting for code snippets.
> >> > > >   2. Snazzy highlighting for variables and function names.
> >> > > >   3. Consistency with the Gallium drivers, which host their
> >> > documentation
> >> > > > on
> >> > > >  ReadTheDocs.
> >> > > >   4. Ultimately less work for us, because writing content in
> >> > reStructured
> >> > > > Text
> >> > > >  is simpler and Sphinx turns it into beautiful, readable pages
> >> > without
> >> > > > us
> >> > > >  having to manually fix problems in html and css.
> >> > > >   5. With Gitlab, the Sphinx website is auto-generated every time the
> >> > Mesa
> >> > > >  code repository is pushed to Gitlab without us having to
> >> > > >  build and deploy it.
> >> > > >
> >> > > > The new website is currently hosted at mesa-test.freedesktop.org.
> >> > When
> >> > > > these
> >> > > > patches are merged, Daniel Stone will point our Gitlab CI system at
> >> > > > mesa-3d.org.
> >> > > >
> >> > > > When reviewing these patches, please note:
> >> > > > 1. This patch series does *not* touch content.  Please do not
> >> > > > bikeshed
> >> > > >the content of webpages here.  That will be addressed in
> >> > later
> >> > > >commits.
> >> > > > 2. Please do *not* bikeshed website style here.  We are using
> >> > the
> >> > > >classic ReadTheDocs style for now and we will update style
> >> > in a
> >> > > >future commit.
> >> > > > 3. I've done my best to make your current content look
> >> > beautiful.
> >> > > > If
> >> > > >there's a problem, please let me know.
> >> > > > 4. There were some commits to the website between when I
> >> > started
> >> > 

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

[Rob Clark]

On Wed, May 30, 2018 at 7:53 PM, Jordan Justen
 wrote:
> On 2018-05-30 14:14:18, Laura Ekstrand wrote:
>> The current plan is that this first patch series should just update the
>> website.  Then we can swap out the theme easily with one or two commands in
>> the next series.
>
> If it's easy to do, then why not just do it? I don't think the
> mesa3d.org website should go through a step of looking like a generic
> readthedocs book.
>
> I understand we might want to tweak the look more later on, but I'm
> guessing with a couple more simple patches it could look somewhat like
> the current site.

tbh, I'm not sure generic rtd look is a step backwards..

If there were some proposals about future looks, and those could be
pushed somewhere so others can review the result, by all means go for
it.  But it doesn't seem to me like something that should hold back
the process.  I mean when was "it looks less like the late 90's" a bad
thing?

BR,
-R

>
> -Jordan
>
>> The goal of this series is to move the website to the new
>> infrastructure.  Then we can edit content and style.
>>
>> On Tue, May 29, 2018 at 11:05 PM, Jordan Justen 
>> wrote:
>>
>> > 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.
>> >
>> > -Jordan
>> >
>> > > On Thu, May 24, 2018 at 5:27 PM, Laura Ekstrand 
>> > > wrote:
>> > >
>> > > > It's time to move the Mesa-3d.org website into the 21st century. We
>> > have
>> > > > chosen to move to Sphinx and resStructured text for a number of
>> > reasons:
>> > > >   1. Syntax highlighting for code snippets.
>> > > >   2. Snazzy highlighting for variables and function names.
>> > > >   3. Consistency with the Gallium drivers, which host their
>> > documentation
>> > > > on
>> > > >  ReadTheDocs.
>> > > >   4. Ultimately less work for us, because writing content in
>> > reStructured
>> > > > Text
>> > > >  is simpler and Sphinx turns it into beautiful, readable pages
>> > without
>> > > > us
>> > > >  having to manually fix problems in html and css.
>> > > >   5. With Gitlab, the Sphinx website is auto-generated every time the
>> > Mesa
>> > > >  code repository is pushed to Gitlab without us having to
>> > > >  build and deploy it.
>> > > >
>> > > > The new website is currently hosted at mesa-test.freedesktop.org.
>> > When
>> > > > these
>> > > > patches are merged, Daniel Stone will point our Gitlab CI system at
>> > > > mesa-3d.org.
>> > > >
>> > > > When reviewing these patches, please note:
>> > > > 1. This patch series does *not* touch content.  Please do not
>> > > > bikeshed
>> > > >the content of webpages here.  That will be addressed in
>> > later
>> > > >commits.
>> > > > 2. Please do *not* bikeshed website style here.  We are using
>> > the
>> > > >classic ReadTheDocs style for now and we will update style
>> > in a
>> > > >future commit.
>> > > > 3. I've done my best to make your current content look
>> > beautiful.
>> > > > If
>> > > >there's a problem, please let me know.
>> > > > 4. There were some commits to the website between when I
>> > started
>> > > > this
>> > > >series and now. I've done my best to incorporate your
>> > changes.
>> > > >So if you changed your content in the past two weeks, take a
>> > > > look
>> > > >at your page.
>> > > >
>> > > > I hope you'll agree that the resulting pages are much cleaner and
>> > easier to
>> > > > read.  I've learned a lot by reading these pages.
>> > > >
>> > > > Thanks.
>> > > >
>> > > > Laura Ekstrand
>> > > > ---
>> > > >
>> > > > Jean Hertel (3):
>> > > >   docs: Add Sphinx configuration file.
>> > > >   docs: Add a navigation sidebar.
>> > > >   docs: Add toctree to relnotes
>> > > >
>> > > > Laura Ekstrand (13):
>> > > >   Added ci yaml file for Gitlab.
>> > > >   docs: Add python script that converts html to rst.
>> > > >   docs: Remove contents.html
>> > > >   docs: Result of script fixing html with Beautiful Soup.
>> > > >   docs: Add results of script - pandoc-generated rst pages.
>> > > >   docs: Add command for Sphinx build.
>> > > >   docs: Toctree for systems.rst as in jhertel docs.
>> > > >   docs: Remove html files.
>> > > >   docs: Fix Sphinx 

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

[Jordan Justen]

On 2018-05-30 14:14:18, Laura Ekstrand wrote:
> The current plan is that this first patch series should just update the
> website.  Then we can swap out the theme easily with one or two commands in
> the next series.

If it's easy to do, then why not just do it? I don't think the
mesa3d.org website should go through a step of looking like a generic
readthedocs book.

I understand we might want to tweak the look more later on, but I'm
guessing with a couple more simple patches it could look somewhat like
the current site.

-Jordan

> The goal of this series is to move the website to the new
> infrastructure.  Then we can edit content and style.
> 
> On Tue, May 29, 2018 at 11:05 PM, Jordan Justen 
> wrote:
> 
> > 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.
> >
> > -Jordan
> >
> > > On Thu, May 24, 2018 at 5:27 PM, Laura Ekstrand 
> > > wrote:
> > >
> > > > It's time to move the Mesa-3d.org website into the 21st century. We
> > have
> > > > chosen to move to Sphinx and resStructured text for a number of
> > reasons:
> > > >   1. Syntax highlighting for code snippets.
> > > >   2. Snazzy highlighting for variables and function names.
> > > >   3. Consistency with the Gallium drivers, which host their
> > documentation
> > > > on
> > > >  ReadTheDocs.
> > > >   4. Ultimately less work for us, because writing content in
> > reStructured
> > > > Text
> > > >  is simpler and Sphinx turns it into beautiful, readable pages
> > without
> > > > us
> > > >  having to manually fix problems in html and css.
> > > >   5. With Gitlab, the Sphinx website is auto-generated every time the
> > Mesa
> > > >  code repository is pushed to Gitlab without us having to
> > > >  build and deploy it.
> > > >
> > > > The new website is currently hosted at mesa-test.freedesktop.org.
> > When
> > > > these
> > > > patches are merged, Daniel Stone will point our Gitlab CI system at
> > > > mesa-3d.org.
> > > >
> > > > When reviewing these patches, please note:
> > > > 1. This patch series does *not* touch content.  Please do not
> > > > bikeshed
> > > >the content of webpages here.  That will be addressed in
> > later
> > > >commits.
> > > > 2. Please do *not* bikeshed website style here.  We are using
> > the
> > > >classic ReadTheDocs style for now and we will update style
> > in a
> > > >future commit.
> > > > 3. I've done my best to make your current content look
> > beautiful.
> > > > If
> > > >there's a problem, please let me know.
> > > > 4. There were some commits to the website between when I
> > started
> > > > this
> > > >series and now. I've done my best to incorporate your
> > changes.
> > > >So if you changed your content in the past two weeks, take a
> > > > look
> > > >at your page.
> > > >
> > > > I hope you'll agree that the resulting pages are much cleaner and
> > easier to
> > > > read.  I've learned a lot by reading these pages.
> > > >
> > > > Thanks.
> > > >
> > > > Laura Ekstrand
> > > > ---
> > > >
> > > > Jean Hertel (3):
> > > >   docs: Add Sphinx configuration file.
> > > >   docs: Add a navigation sidebar.
> > > >   docs: Add toctree to relnotes
> > > >
> > > > Laura Ekstrand (13):
> > > >   Added ci yaml file for Gitlab.
> > > >   docs: Add python script that converts html to rst.
> > > >   docs: Remove contents.html
> > > >   docs: Result of script fixing html with Beautiful Soup.
> > > >   docs: Add results of script - pandoc-generated rst pages.
> > > >   docs: Add command for Sphinx build.
> > > >   docs: Toctree for systems.rst as in jhertel docs.
> > > >   docs: Remove html files.
> > > >   docs: Fix Sphinx compile errors.
> > > >   docs: Edits to fix toctrees.
> > > >   docs: Major manual edits to environment vars.
> > > >   docs: Human edits to the website code for clarity.
> > > >   docs: Remove unneeded mesa css file.
> > > >
> > > >  .gitlab-ci.yml   |   11 +
> > > >  docs/application-issues.html |   83 --
> > > >  docs/application-issues.rst  |   48 +
> > > >  docs/autoconf.html   |  257 
> > > >  docs/autoconf.rst|  209 +++
> > > >  docs/bugs.html   |   64 -
> > > >  

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

[Jordan Justen]

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.

-Jordan

> On Thu, May 24, 2018 at 5:27 PM, Laura Ekstrand 
> wrote:
> 
> > It's time to move the Mesa-3d.org website into the 21st century. We have
> > chosen to move to Sphinx and resStructured text for a number of reasons:
> >   1. Syntax highlighting for code snippets.
> >   2. Snazzy highlighting for variables and function names.
> >   3. Consistency with the Gallium drivers, which host their documentation
> > on
> >  ReadTheDocs.
> >   4. Ultimately less work for us, because writing content in reStructured
> > Text
> >  is simpler and Sphinx turns it into beautiful, readable pages without
> > us
> >  having to manually fix problems in html and css.
> >   5. With Gitlab, the Sphinx website is auto-generated every time the Mesa
> >  code repository is pushed to Gitlab without us having to
> >  build and deploy it.
> >
> > The new website is currently hosted at mesa-test.freedesktop.org.  When
> > these
> > patches are merged, Daniel Stone will point our Gitlab CI system at
> > mesa-3d.org.
> >
> > When reviewing these patches, please note:
> > 1. This patch series does *not* touch content.  Please do not
> > bikeshed
> >the content of webpages here.  That will be addressed in later
> >commits.
> > 2. Please do *not* bikeshed website style here.  We are using the
> >classic ReadTheDocs style for now and we will update style in a
> >future commit.
> > 3. I've done my best to make your current content look beautiful.
> > If
> >there's a problem, please let me know.
> > 4. There were some commits to the website between when I started
> > this
> >series and now. I've done my best to incorporate your changes.
> >So if you changed your content in the past two weeks, take a
> > look
> >at your page.
> >
> > I hope you'll agree that the resulting pages are much cleaner and easier to
> > read.  I've learned a lot by reading these pages.
> >
> > Thanks.
> >
> > Laura Ekstrand
> > ---
> >
> > Jean Hertel (3):
> >   docs: Add Sphinx configuration file.
> >   docs: Add a navigation sidebar.
> >   docs: Add toctree to relnotes
> >
> > Laura Ekstrand (13):
> >   Added ci yaml file for Gitlab.
> >   docs: Add python script that converts html to rst.
> >   docs: Remove contents.html
> >   docs: Result of script fixing html with Beautiful Soup.
> >   docs: Add results of script - pandoc-generated rst pages.
> >   docs: Add command for Sphinx build.
> >   docs: Toctree for systems.rst as in jhertel docs.
> >   docs: Remove html files.
> >   docs: Fix Sphinx compile errors.
> >   docs: Edits to fix toctrees.
> >   docs: Major manual edits to environment vars.
> >   docs: Human edits to the website code for clarity.
> >   docs: Remove unneeded mesa css file.
> >
> >  .gitlab-ci.yml   |   11 +
> >  docs/application-issues.html |   83 --
> >  docs/application-issues.rst  |   48 +
> >  docs/autoconf.html   |  257 
> >  docs/autoconf.rst|  209 +++
> >  docs/bugs.html   |   64 -
> >  docs/bugs.rst|   33 +
> >  docs/codingstyle.html|  142 --
> >  docs/codingstyle.rst |  124 ++
> >  docs/conf.py |  162 +++
> >  docs/conform.html|  703 --
> >  docs/conform.rst |  675 ++
> >  docs/contents.html   |  108 --
> >  docs/debugging.html  |   47 -
> >  docs/debugging.rst   |   21 +
> >  docs/developers.html |   58 -
> >  docs/developers.rst  |   25 +
> >  docs/devinfo.html|   83 --
> >  docs/devinfo.rst |   43 +
> >  docs/dispatch.html   |  278 
> >  docs/dispatch.rst|  257 
> >  docs/download.html   |  112 --
> >  docs/download.rst|   73 ++
> >  docs/egl.html|  259 
> >  docs/egl.rst |  117 ++
> >  docs/envvars.html|  383 --
> >  docs/envvars.rst |  615 +
> >  docs/extensions.html |   51 -
> >  docs/extensions.rst  |   31 +
> >  docs/faq.html|  392 --
> >  docs/faq.rst |  308 +
> >  docs/helpwanted.html |   

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

[Laura Ekstrand]

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

Laura

On Thu, May 24, 2018 at 5:27 PM, Laura Ekstrand 
wrote:

> It's time to move the Mesa-3d.org website into the 21st century. We have
> chosen to move to Sphinx and resStructured text for a number of reasons:
>   1. Syntax highlighting for code snippets.
>   2. Snazzy highlighting for variables and function names.
>   3. Consistency with the Gallium drivers, which host their documentation
> on
>  ReadTheDocs.
>   4. Ultimately less work for us, because writing content in reStructured
> Text
>  is simpler and Sphinx turns it into beautiful, readable pages without
> us
>  having to manually fix problems in html and css.
>   5. With Gitlab, the Sphinx website is auto-generated every time the Mesa
>  code repository is pushed to Gitlab without us having to
>  build and deploy it.
>
> The new website is currently hosted at mesa-test.freedesktop.org.  When
> these
> patches are merged, Daniel Stone will point our Gitlab CI system at
> mesa-3d.org.
>
> When reviewing these patches, please note:
> 1. This patch series does *not* touch content.  Please do not
> bikeshed
>the content of webpages here.  That will be addressed in later
>commits.
> 2. Please do *not* bikeshed website style here.  We are using the
>classic ReadTheDocs style for now and we will update style in a
>future commit.
> 3. I've done my best to make your current content look beautiful.
> If
>there's a problem, please let me know.
> 4. There were some commits to the website between when I started
> this
>series and now. I've done my best to incorporate your changes.
>So if you changed your content in the past two weeks, take a
> look
>at your page.
>
> I hope you'll agree that the resulting pages are much cleaner and easier to
> read.  I've learned a lot by reading these pages.
>
> Thanks.
>
> Laura Ekstrand
> ---
>
> Jean Hertel (3):
>   docs: Add Sphinx configuration file.
>   docs: Add a navigation sidebar.
>   docs: Add toctree to relnotes
>
> Laura Ekstrand (13):
>   Added ci yaml file for Gitlab.
>   docs: Add python script that converts html to rst.
>   docs: Remove contents.html
>   docs: Result of script fixing html with Beautiful Soup.
>   docs: Add results of script - pandoc-generated rst pages.
>   docs: Add command for Sphinx build.
>   docs: Toctree for systems.rst as in jhertel docs.
>   docs: Remove html files.
>   docs: Fix Sphinx compile errors.
>   docs: Edits to fix toctrees.
>   docs: Major manual edits to environment vars.
>   docs: Human edits to the website code for clarity.
>   docs: Remove unneeded mesa css file.
>
>  .gitlab-ci.yml   |   11 +
>  docs/application-issues.html |   83 --
>  docs/application-issues.rst  |   48 +
>  docs/autoconf.html   |  257 
>  docs/autoconf.rst|  209 +++
>  docs/bugs.html   |   64 -
>  docs/bugs.rst|   33 +
>  docs/codingstyle.html|  142 --
>  docs/codingstyle.rst |  124 ++
>  docs/conf.py |  162 +++
>  docs/conform.html|  703 --
>  docs/conform.rst |  675 ++
>  docs/contents.html   |  108 --
>  docs/debugging.html  |   47 -
>  docs/debugging.rst   |   21 +
>  docs/developers.html |   58 -
>  docs/developers.rst  |   25 +
>  docs/devinfo.html|   83 --
>  docs/devinfo.rst |   43 +
>  docs/dispatch.html   |  278 
>  docs/dispatch.rst|  257 
>  docs/download.html   |  112 --
>  docs/download.rst|   73 ++
>  docs/egl.html|  259 
>  docs/egl.rst |  117 ++
>  docs/envvars.html|  383 --
>  docs/envvars.rst |  615 +
>  docs/extensions.html |   51 -
>  docs/extensions.rst  |   31 +
>  docs/faq.html|  392 --
>  docs/faq.rst |  308 +
>  docs/helpwanted.html |   88 --
>  docs/helpwanted.rst  |   46 +
>  docs/index.html  | 2380 -
>  docs/index.rst   | 2438 ++
>  docs/install.html|  252 
>  docs/install.rst |  193 +++
>  docs/intro.html  |  404 --
>  docs/intro.rst   |  308 +
>  docs/license.html|  121 --
>  docs/license.rst |   89 ++
>  docs/lists.html  |   97 --
>  docs/lists.rst   |   62 +
>  docs/llvmpipe.html   |  330 -
>  docs/llvmpipe.rst|  277 
>