A latex package for displaying Julia code using the listings package. The package supports pdftex, luatex and xetex for compilation.
LPPL-1.3C License
jlcode.sty Copyright 2018 Willi Gerbig
This work may be distributed and/or modified under the conditions of the LaTeX Project Public License, either version 1.3 of this license or (at your option) any later version. The latest version of this license is in http://www.latex-project.org/lppl.txt and version 1.3 or later is part of all distributions of LaTeX version 2005/12/01 or later.
This work has the LPPL maintenance status 'maintained'.
The Current Maintainer of this work is Willi Gerbig.
This work consists of the files jlcode.sty, createkwlists.jl, createucclist.jl, testfile.jl, testfile2.jl and manual.pdf.
The jlcode.sty is a latex package, which contains a Julia language definition for the listings package as well as a style definitions with different themes. Since version 6.0 it cannot only be used with pdftex, but also with luatex and xetex. Check out the manual (manual.pdf), which explains all package options and also shows how the Julia code from testfile.jl and testfile2.jl looks when displayed.
Current version of the jlcode package: 6.1.4. Date of creation: 2018/01/25 Date of last modification: 2023/07/20
The lists for the keywords, literals, built-ins, macros, functions and string types for this language definition were created with the julia script createkwlists.jl, which was strongly inspired by the approach of the following script: https://github.com/isagalaev/highlight.js/blob/master/src/languages/julia.js.
All colors for the default theme of this package were taken from the file https://docs.julialang.org/en/v1/assets/themes/documenter-light.css and all colors for the darkbeamer theme of this package were taken from the file https://github.com/dietercastel/jlcode/blob/darktheme/jlcode.sty, which contains a contribution from "dietercastel" who put toegther this great theme, which is designed to be ideally suited for the dark-beamer-theme.
All tab completion Unicode characters supported by Julia can be found under https://docs.julialang.org/en/v1.7/manual/unicode-input/. When dealing with the luatex or xetex engine the jlcode package will by default work with the JuliaMono font, whose latest version can be found under https://github.com/cormullion/juliamono. This JuliaMono font approach was inspired by the following repository: https://github.com/mossr/julia-mono-listings.
At the moment the jlcode package supports the follwoing Unicode characters, when you compile your document with luatex or xetex:
At the moment the jlcode package supports the follwoing Unicode characters, when you compile your document with pdftex:
!
are now colored correctly.\addlitjlmacros
and \addlitjlfunctions
for manualbreaklines=true
is now used automatically by default.Copy the jlcode.sty file to the same folder like your latex file. Addionally, if you want to use luatex or xetex for compiling your document, also put all JuliaMono-*.ttf files to the same folder like your latex file. Then add the following line to your latex document header, which will load the package with its default options:
\usepackage{jlcode}
After doing so you can use the package as follows:
% listing of standalone files
\jlinputlisting{filename.jl}
% displayed code
\begin{jllisting}
# some julia code
println( "Here we go with Julia!")
\end{jllisting}
% code snippets
Julia's standard library contains some useful macros like \jlinl{@time}.
Check out the manual to learn more about the package options and some advanced techniques like handling manageable issues.
Please feel free to contribute and report bugs!
It would be especially appreciated if you helped me adding support for more special unicode characters.