search

jolly-good-toolbelt / sphinx_gherkindoc

A tool to convert Gherkin into Sphinx documentation
https://jolly-good-toolbelt.github.io/sphinx_gherkindoc/
11 stars 10 forks source link

Formatting in Latex? #37

Open ghost opened 4 years ago

ghost commented 4 years ago

Hi,

I hope this question hasn't been asked before (at least I could not find it in the closed issues).

I played around with gherkindoc and it looks great so far, thank you! The possibility to change the styling of the steps with CSS in HTML is great, too.

Is there a way to get styling of the gherkin-* roles for the Latex output of Sphinx, too? Without it, the current output is kind of plain and not that great to read.

Sorry if this question is rather a generic Sphinx question.

rbcasperson commented 4 years ago

Hi @snke! Sorry for taking so long to get back to you here. I'm not sure how the notifications for the issue were overlooked, but thanks for your interest in the tool!

I've never used the Latex option for Sphinx before, and I don't think any of the maintainers have either. At think point, we are only considering rST to be supported, so we'd have to make a larger decision to try to support that output. But my anticipation is that the use case is pretty small, so I honestly can't see us working on that anytime really, unless Latex takes over the world as the most popular text format (hey maybe it should!).

That said, if you think it would be really beneficial to you, you are more than welcome to contribute that support. It might not be too difficult. If you do, we would be happy to give you some guidance and feedback during the process.

dgou commented 2 years ago

I somehow missed this too. At this point I think the solution is going to be from someone who is using the LaTeX output and would be willing to write the tests for it. Otherwise something will break and it'll just look for the project to claim support but have it be like a sports car sitting in a barn for years. :-) This is coming up on two years old, so unless @snke or @rbcasperson have something imminently planned, I'd like to close this issue.

controlpl4n3 commented 1 year ago

FWIW, I have a lot of experience using Sphinx and LaTeX. This module builds the rST and its job is done. Sphinx then translates the rST into LaTeX using a process similar to how the Javascript gets produced.. I say similar, but in fact the details are completely diffrent

Basically, @dgou you can close this issue because it is out of scope.