[Piglit] Piglit website in sphinx

Jordan Justen jordan.l.justen at intel.com
Tue Dec 18 07:58:03 UTC 2018

On 2018-12-17 22:07:21, Tapani Pälli wrote:
> Hi;
> On 12/17/18 11:50 AM, Jordan Justen wrote:
> > Although I doubt it generates much traffic, I wanted to try to convert
> > the https://piglit.freedesktop.org/ homepage into an 'auto-building'
> > gitlab branch.
> > 
> > I think the current site was built by ikiwiki, but I was after
> > spending way more time that I hoped, I still was unable to reproduce
> > the site without lots of extra undesirable links.
> > 
> > So, I tried converting it to sphinx. Of course, I expected it would
> > look somewhat different with sphinx. This change proved much easier,
> > and I think looks pretty good:
> > 
> > https://jljusten.pages.freedesktop.org/piglit/
> Looks nice and clean! Maybe at same time the documentation could be 
> improved. Some of the Piglit options seem to be missing, as example I 
> never saw PIGLIT_PLATFORM documented, there is no list of platforms so 
> only way is to grep the source ... or are they somewhere?

Eric pointed out that it could be good to make the website sources
appear under the docs directory, like Mesa does. I made the changes to
do that here:


With this version, the website would be rebuilt whenever the docs
directory changes on the master branch.

I guess my point is that by putting the website under the docs
directory of the main branch, maybe it will allow others to contribute
changes (like this) more easily. :)

Another change that we might consider is whether to use merge requests
in piglit. That would also require a change to the website.


> > The source code is here in this branch:
> > 
> > https://gitlab.freedesktop.org/jljusten/piglit/commits/website
> > 
> > It is setup such that we could add a small 'website' branch to the
> > piglit repo. The branch's history would be detacted from the source
> > code history.
> > 
> > Then, if we need to change the piglit website again, in, say a decade
> > or so :), it'll be a bit simpler.
> > 
> > Does it look ok, and does it seem like an ok plan?
> > 
> > -Jordan
> > _______________________________________________
> > Piglit mailing list
> > Piglit at lists.freedesktop.org
> > https://lists.freedesktop.org/mailman/listinfo/piglit
> > 

More information about the Piglit mailing list