[Mesa-dev] [RFC] - Rewrite mesa website in Sphinx

[Jean Hertel]

Hi Laura,


Aurelio Silves pointed me out that there is the possibility of using pandoc for the conversion of mesa html sources to rst.

You can take a look here: https://pandoc.org/index.html

Depending on your distribution, probably there is a package for this.


Also, if there is anything else I can do, send me an email and I will do the best I can to help.


Kind Regards,

Jean Hertel

________________________________
De: Jean Hertel <jean.hertel at hotmail.com>
Enviado: segunda-feira, 2 de abril de 2018 21:19
Para: Laura Ekstrand
Cc: Emil Velikov; Vedran Miletić; mesa-dev at lists.freedesktop.org; Jason Ekstrand
Assunto: Re: [Mesa-dev] [RFC] - Rewrite mesa website in Sphinx

Hi Laura,

I haven't used any script.
I made all the HTML to rst translations by hand, file by file.

Kind Regards,
Jean Hertel

Em 2 de abril de 2018 19:09:34 BRT, Laura Ekstrand <laura at jlekstrand.net> escreveu:
Hi Jean,

I'm going to play around with your patches to get them into a format that Mesa devs can review.  This will blow the history away.

The problem is that your workflow in 1 & 2 ruins the Git history for reviewers.  It makes the patch series hard to read.

Could you provide us with your script for translating HTML to rst?  Go ahead and commit it to your repo as a patch.

Thanks.

Laura

On Sun, Apr 1, 2018 at 6:12 AM, Jean Hertel <jean.hertel at hotmail.com<mailto:jean.hertel at hotmail.com>> wrote:

Hi Laura,


The commits have the idea of being atomic, so it makes sense to have a lot of them.

Some of them are just fixes, and can be squashed.


Please keep in mind that no CSS file is supposed to live there, as we are using an existing template from readTheDocs.

The commits are doing mainly two things:

1 - Create a new file and translate the old HTML content into a rst format.

2 - Delete the old file


Kind Regards,

Jean Hertel

________________________________
De: Laura Ekstrand <laura at jlekstrand.net<mailto:laura at jlekstrand.net>>
Enviado: sábado, 31 de março de 2018 22:06
Para: Jean Hertel
Cc: Emil Velikov; Vedran Miletić; mesa-dev at lists.freedesktop.org<mailto:mesa-dev at lists.freedesktop.org>; Jason Ekstrand
Assunto: Re: [Mesa-dev] [RFC] - Rewrite mesa website in Sphinx

Jean,

I've taken at look at your sphinx-docs branch (https://github.com/jlHertel/mesa).

Oh my you have a lot of commits there!  It would be simpler for me to review if you could squash some of them together.

I am thinking a series on the order of 30 patches to start - just the pretty CSS stuff in Sphinx.

Once we get the page to look nicer, then we can start editing the content for readability!!!

Thanks.

Laura

On Sat, Mar 31, 2018 at 5:57 PM, Laura Ekstrand <laura at jlekstrand.net<mailto:laura at jlekstrand.net>> wrote:
Hello Jean,

Has anyone reviewed your patch series yet?   I would like to get these website updates moving.

Thanks.

Laura

On Tue, Jun 6, 2017 at 10:43 AM, Jean Hertel <jean.hertel at hotmail.com<mailto:jean.hertel at hotmail.com>> wrote:
Hello Emil,

I've updated the website with the new release notes template.

Please take a look at: http://mesa2.jeanhertel.com.br/relnotes.html


What about rebasing my current work on top of mesa-master?
(Remembering that github comments referencing directly the commit will be loss)


The repository: https://github.com/jlHertel/mesa
Demo site: http://mesa2.jeanhertel.com.br/

Best regards,
Jean Hertel
_______________________________________________
mesa-dev mailing list
mesa-dev at lists.freedesktop.org<mailto:mesa-dev at lists.freedesktop.org>
https://lists.freedesktop.org/mailman/listinfo/mesa-dev




--
Enviado de meu dispositivo Android com K-9 mail. Desculpe-me pela brevidade.
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://lists.freedesktop.org/archives/mesa-dev/attachments/20180403/4c4b848e/attachment-0001.html>