[Piglit] Piglit website in sphinx
tapani.palli at intel.com
Tue Dec 18 12:45:55 UTC 2018
On 12/18/18 9:58 AM, Jordan Justen wrote:
> On 2018-12-17 22:07:21, Tapani Pälli wrote:
>> 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:
>> 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. :)
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.
>>> The source code is here in this branch:
>>> 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?
>>> Piglit mailing list
>>> Piglit at lists.freedesktop.org
More information about the Piglit