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@lists.freedesktop.org
https://lists.freedesktop.org/mailman/listinfo/piglit
_______________________________________________
Piglit mailing list
Piglit@lists.freedesktop.org
https://lists.freedesktop.org/mailman/listinfo/piglit
