[Piglit] Piglit website in sphinx

Eric Anholt eric at anholt.net
Mon Dec 17 20:09:23 UTC 2018


Jordan Justen <jordan.l.justen at intel.com> writes:

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

Looks nice to me, only nit is the title is "Piglit 1 documentation" --
where did that "1" come from?

I kind of like having the website in master so that some of the contents
on the site can be documentation in-tree as well, but I'm happy with it
at least being easily modifiable.
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 832 bytes
Desc: not available
URL: <https://lists.freedesktop.org/archives/piglit/attachments/20181217/36f96ffd/attachment.sig>


More information about the Piglit mailing list