Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

latex support? #419

Open
jzf2101 opened this issue May 28, 2018 · 19 comments
Open

latex support? #419

jzf2101 opened this issue May 28, 2018 · 19 comments

Comments

@jzf2101
Copy link

jzf2101 commented May 28, 2018

It would be nice to be able to have the option to submit the paper in LaTeX directly since we're considering moving to bibTeX anyway #163 #412

@llorracc
Copy link

YES. My team has probably spent a collective 10 hours figuring out how to convert to RST, which is NOT the native language for scientific papers. Then we realized that it converts the RST back to a LaTeX document, which is what we were converting from!

Much more efficient would just to have provided a LaTeX template for us to fill in.

@deniederhut
Copy link
Member

Thanks for the feedback! I wasn't around when this system was first built, but I think the motivation behind using restructured text was to reduce the barrier to entry for new authors. If you are someone who doesn't already know latex, the prospect can be a little daunting.

I share your frustration (those tables!) and it's something we'll look into for the next development cycle.

@llorracc
Copy link

The unfortunate thing is that, in making the use of RST mandatory, you massively INCREASED the barriers to entry for people who DID know how to use LaTeX -- which is most scientists. One of my team members actually proposed that we give up and not submit because after spending many hours on it none of us had the spare time to push the project over the finish line. Finally three team members found the time to get it over the finish line. But, if there had only been a LaTeX template, it would have been at most an hour, and maybe much less.

Thanks for taking these points into consideration for the next development round.

@jzf2101
Copy link
Author

jzf2101 commented May 30, 2018

Our team had a similar experience @llorracc . A number of us knew LaTeX well and struggled to do things we knew how to do- notably citations. A big challenge for us was to debug the LaTeX and errors through the rst- since we didn't always know how those errors were being generated.

@choldgraf
Copy link
Contributor

for people who DID know how to use LaTeX -- which is most scientists

My intuition is that this is definitely not true, and there seems to be some data to back it up. E.g., latex use is highly field-dependent:

image

I'm +1 on allowing for a direct Latex build on top of the rST build, but think it'd be a mistake to disallow rST submissions.

@jzf2101
Copy link
Author

jzf2101 commented Jun 19, 2018

To clarify, I'm not asking LaTeX only, just for LaTeX as an option.

@jzf2101
Copy link
Author

jzf2101 commented Oct 11, 2018

I would disagree with @choldgraf though on building on top of rST- our group struggled with getting LaTeX do do what we wanted without being able to explicitly write the LaTeX itself. It would be easier if we could submit the raw LaTeX and not have it compile to rST and back to LaTeX for the final build.

@choldgraf
Copy link
Contributor

I'm all for supporting latex as well - was just saying that most people don't know latex. For those who do know latex, I can see how this is a better option than rst

@jzf2101
Copy link
Author

jzf2101 commented Oct 13, 2018

Ah, I misunderstood you comment then.

@MooersLab
Copy link

MooersLab commented Jan 12, 2019

The on-line collaborative writing software Overleaf and ShareLatex make it really easy for nonLaTeX users to prepare documents in LaTeX. Overleaf has several million users in diverse fields. I am aware that LaTeX is growing in popularity in the quantitative social sciences like economics and in finance. I am biochemist. I learned about Overleaf from my daughter who used it in her class projects and to write her senior thesis as an undergraduate in economics. The table presented above is a decade old. It may not accurately represent the current situation.

I have prepared documents in Overleaf with new LaTeX users ranging in age from 20 to 70 years of age. Overleaf makes using LaTeX intuitive and fun! It error message system is better than that found in most text editors. Overleaf's use of git to track changes is superior to tracking changes in Word. Users can flip back and forth between source and rich text with the click of button. I do most of my writing in LaTeX, and I mostly use Overleaf. I will resort to using a text editor when I need access to a snippet library because the main weakness of Overleaf is the lack of support for snippet libraries.

I strongly endorse the use of LaTeX and providing Overleaf with of a SciPy Proceedings template. I have prepared manuscripts, grant applications, books 1000 page long, and beamer posters and slideshows in Overleaf. I currently have about 200 documents in my Overleaf account. I have been using Overleaf for about three years and LaTeX for about eight years.

@deniederhut deniederhut added this to the SciPy ???? new features milestone Apr 17, 2020
@tgmattso
Copy link

Please ... can't we agree to take LATEX source this year? Converting my existing Latex paper to a new formating system serves no purpose. Why are you doing this to us? This is definitely making me question why I have chosen to bring my work to SciPy. Please ... change this policy. Latex is heavily used in many communities. It should be a choice for SciPy authors.

@ntjess
Copy link

ntjess commented Apr 25, 2022

@mepa @cbcunc @deniederhut @stargaser Proceeding instructions indicate pinging co-chairs is the best way to reach out -- apologies if I misinterpreted that statement.

For the 2022 round of submissions, has there been any consideration of allowing LaTeX documents directly? I echo the sentiment above where a prohibitive amount of time would be spent converting our already-LaTeX sources into RST format.

@ntjess
Copy link

ntjess commented Apr 25, 2022

Not to spam the issue with comments, but I found this works quite well:

.. raw:: latex

    \input{sections/intro}
    \input{sections/background}
    % etc.

Citations and figures have no issues for my current document, and the paper header can still be specified in RST.

Is this acceptable as a submission? I recognize the potential downside of poor previews in the github markdown viewer, but hopefully that is a reasonable tradeoff. I can also zip & attach a MWE if you wish.

@deniederhut
Copy link
Member

has there been any consideration of allowing LaTeX documents directly?

I was hoping to have this ready for the 2022 conference (you can see a WIP here #679) but there have been a series of issues translating the tables, references, etc. Given that papers are already being submitted, it seems wise not to introduce a new build system at the moment.

Is this acceptable as a submission?

🤔 probably not? We add custom styling during the conversion from rst, so it's unlikely that your paper would look consistent with the rest of the proceedings if you put the whole thing as a raw latex field. Having said that, I'd be happy to be proven wrong.

@ntjess
Copy link

ntjess commented May 21, 2022

@deniederhut apologies for the late reply, it took a minute to get a proof-of-concept draft. Are you able to briefly skim the output PDF to confirm whether styling is appropriate? Source tex files and build script are in my paper repo: https://github.com/ntjess/scipy_proceedings/tree/s3a_paper/papers/221_jessurun

My environment works with the default publisher script run on the main rst file.

If the build fails, I am happy to attach the PDF here/elsewhere (~3MB) but I wanted to confirm the normal creation process works for others apart from me.

Thanks! Please note I have no intention of splitting hairs or adamantly sticking to a latex submission. I can rework an rst-only solution if it's required but as others in the thread mentioned, it would certainly be nice to save on the conversion time.

@MooersLab
Copy link

@deniederhut Will LaTeX submissions be supported in 2024?

@deniederhut
Copy link
Member

@mepa I think this might be a question for you

@scipy-conference scipy-conference deleted a comment from scoobies Jan 24, 2024
@mepa
Copy link
Member

mepa commented Jan 24, 2024

Thanks, @deniederhut!

@MooersLab, yes, we plan to support LaTeX submissions this year.

cc: @cbcunc @rowanc1

@MooersLab
Copy link

@mepa, Awesome! Thank you very much!!!!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

8 participants