[Piglit] Piglit website in sphinx

[Tapani Pälli]

On 12/18/18 9:58 AM, Jordan Justen wrote:
> 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:
> 
> https://gitlab.freedesktop.org/jljusten/piglit/commits/master
> 
> 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. :)

Yes, that makes sense. Maybe I can contribute instructions for 
PIGLIT_PLATFORM when this comes available :)

> Another change that we might consider is whether to use merge requests
> in piglit. That would also require a change to the website.
> 
> -Jordan
> 
>>> 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
>>>