Add cleanup action: "Make LaTeX ready: Escape $"

[ThiloteE]

Problem:

1. Want to prepare entries to be used with LaTeX
2. Want to not start math-mode, but instead simply render $ character in my bibliography

Describe the solution you'd like

• Add cleanup action that adds a backslash in front of $
• Name this cleanup action: Make LaTeX ready: Escape $
• Add to the documentation: Adds backslash to $ characters. \$ will be rendered by LaTeX as $ instead of starting math-mode. Do not use this cleanup action, if you have entries that require usage of LaTeX math-mode.

Additional context

• Why not add this function to Make LaTeX ready: Cleanup or Make LaTeX ready: Unicode to LaTeX? Both allow the usage of math-mode, which is fine. This seems to be a zero-sum game and there is no heuristic that can find out if the user wants to use math-mode or simply render the $.

Related to #8490 (comment) and #8650

[fly-ing-fish]

Hello! I am a junior undergraduate cs student and I wanna have a try. Hope you can give me the chance, thank you!

[ThiloteE]

Hey @fly-ing-fish of course :-) Feel free to work on this.

As a general advice: check out https://github.com/JabRef/jabref/blob/main/CONTRIBUTING.md for a start. Also, https://devdocs.jabref.org/getting-into-the-code/guidelines-for-setting-up-a-local-workspace is worth having a look at. Don't mind asking, if you have any questions here on GitHub or also at JabRef's Gitter chat.

Try to open a (draft) pull request early on, so that people can see you are working on the issue and so that they can see the direction the pull request is heading towards. This way, you will likely receive valuable feedback.

[ThiloteE]

I just did a test to check how LaTeX/Biber behaves concretely:

Test bibliography:

@Article{A20220416mwm,
  author  = {A},
  date    = {2022-04-16},
  title   = {Math with Mathmode: $2*3/3$},
  comment = {- No error during Biber compilation.
- Dollar Signs vanish. Only 2*3/3 remains.
- Rendering of 2*3/3 is different as compared to when not using mathmode.},
}

@Article{B20220416mwm,
  author  = {B},
  date    = {2022-04-16},
  title   = {Math without Mathmode: 2*3/3},
  comment = {- No error during Biber compilation.
- Dollar Signs vanish. Only 2*3/3 remains},
}

@Article{C20220416tia,
  author  = {C},
  date    = {2022-04-16},
  title   = {This is a normal entry with a backslashed \$ (dollar) sign. Think of being an economist and having to write about currencies},
  comment = {- biber finishes the compilation normally},
}

@Article{D20220416tia,
  author  = {D},
  date    = {2022-04-16},
  title   = {This is a normal entry with a $ (dollar) sign. Think of being an economist and having to write about currencies},
  comment = {- biber finishes the compilation but with errors.
- biber complains about a missing dollar sign
- the dollar sign STARTS mathmode, but since there is a dollar sign missing to CLOSE mathmode, there is an error},
}

@Comment{jabref-meta: databaseType:biblatex;}

The .tex file used for the test:

\documentclass[12pt,a4paper]{article}

	\usepackage[noibid,eprint=false,authordate,backend=biber]{biblatex-chicago}
  
%\usepackage{hyperref}


\usepackage[ngerman,english, bidi=basic]{babel}
	\usepackage{helvet}
			\renewcommand{\familydefault}{\sfdefault}
			\renewcommand{\familydefault}{\ttdefault}
	\usepackage[autostyle,german=quotes]{csquotes}


  
  
  
  
\addbibresource{bibliography.bib} 

\begin{document}
	
Start of the document.\\

\parencite{A20220416mwm,B20220416mwm,C20220416tia,D20220416tia}.\\

End of the document.\\


\printbibliography
	
\end{document}

Results:

[ThiloteE]

The solution may resemble the cleanup actions Escape underscores or escape ampersands! Maybe part of the code can be copied from there :-)

[ThiloteE]

Check out page 15 and 16 of the comprehensive LaTeX symbols list! (https://www.ctan.org/tex-archive/info/symbols/comprehensive)

I am not sure if all these other symbols in the above tables create problems when compiling with LaTeX nowadays (I would assume yes 😑). I am also not sure how many of these symbols the Unicode to LaTeX or the LaTeX cleanup actions are able to convert. Testing this would be nice. I can help with that.

Since you are touching this code anyway, implementing a few more cleanup-actions (or merging a few of them together into ONE cleanup action) might be possible, no? If you can find out how to do one, the others will be only a few clicks and "copy paste" away, I assume 😁

[fly-ing-fish]

Thank you for the reply and support with details! I am working on it.

[fly-ing-fish]

I followed the indications of the " Set up a local workspace" in the JabRef Development Documentation, but met a problem while doing "Build and run JabRef by double-clicking JabRef | Tasks | application | run.".

Task :generateBstGrammarSource FAILED
error(1): cannot write file : java.io.FileNotFoundException: src-gen\main\java\org\jabref\logic\bst\G:\BstParser.java (�ļ�����Ŀ¼������������ȷ��)
java.base/java.io.FileOutputStream.open0(Native Method)
java.base/java.io.FileOutputStream.open(FileOutputStream.java:293)
java.base/java.io.FileOutputStream.(FileOutputStream.java:235)
java.base/java.io.FileOutputStream.(FileOutputStream.java:184)
java.base/java.io.FileWriter.(FileWriter.java:96)
org.antlr.Tool.getOutputFile(Tool.java:889)
org.antlr.codegen.CodeGenerator.write(CodeGenerator.java:1292)
org.antlr.codegen.Target.genRecognizerFile(Target.java:98)
org.antlr.codegen.CodeGenerator.genRecognizer(CodeGenerator.java:459)
org.antlr.Tool.generateRecognizer(Tool.java:674)
org.antlr.Tool.process(Tool.java:487)
org.antlr.Tool.main(Tool.java:98)
error(1): cannot write file : java.io.FileNotFoundException: src-gen\main\java\org\jabref\logic\bst\G:\Bst__.g (�ļ�����Ŀ¼������������ȷ��)
java.base/java.io.FileOutputStream.open0(Native Method)
java.base/java.io.FileOutputStream.open(FileOutputStream.java:293)
java.base/java.io.FileOutputStream.(FileOutputStream.java:235)
java.base/java.io.FileOutputStream.(FileOutputStream.java:184)
java.base/java.io.FileWriter.(FileWriter.java:96)
org.antlr.Tool.getOutputFile(Tool.java:889)
org.antlr.Tool.process(Tool.java:513)
org.antlr.Tool.main(Tool.java:98)

Execution failed for task ':generateBstGrammarSource'.

Process 'command 'C:\Program Files\Java\jdk-17.0.2\bin\java.exe'' finished with non-zero exit value 1

wrong path are generated automatically, like src-gen\main\java\org\jabref\logic\bst\G:\BstParser.java and src-gen\main\java\org\jabref\logic\bst\G:\Bst__.g.

I have no idea to solve this right now, could you give me some advice, please?

[Siedlerchr]

@fly-ing-fish is Jabref located directly under G:\Jabref?
Try move it down to a folder like G:\workspace\jabref

[fly-ing-fish]

It works, thanks for your help! 😁 @Siedlerchr

[ThiloteE]

Hey, I just noticed: Obviously, JabRef can't know if the user wants to use special characters with or without backslash, but JabRef could NOTIFY the user that there are special characters present in an entry via "Integrity check". (JabRef's current integrity check does not check for this)

When I tried to use a workaround and use "search" to search for a $ sign within the entry, it was not found. 😅 Yay. Another issue that lets me look forward to JabRef 6.x with Lucene search xD

[Siedlerchr]

@fly-ing-fish I would appreciate it if you could add a hint to the devdocs https://github.com/JabRef/jabref/blob/main/docs/getting-into-the-code/guidelines-for-setting-up-a-local-workspace.md