jlcode.sty

License

jlcode.styCopyright 2018 GitHub user wg030

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 GitHub user wg030.

This work consists of the filesjlcode.sty, createkwlists.jl, createucclist.jl, testfile.jl, testfile2.jl and manual.pdf.

Short Package Description

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 State

Current version of the jlcode package: 6.0.
Date of creation: 2018/01/25
Date of last modification: 2021/09/14

Keywords

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.

Colors

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.

Special Unicode Characters

All tab completion Unicode characters that are supported by Julia can be found under
https://docs.julialang.org/en/v1/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.
The 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:

• Most common special characters that appear in latin languages.
• All tab completion Unicode characters that the Julia Mono font supports.
• Most of the characters which are used for drawing unicode boxes.

At the moment the jlcode package supports the follwoing Unicode characters,
when you compile your document with pdftex:

• Most common special characters that appear in latin languages.
• All greek small and capital letters.
• All latin and greek letters with dot, double dot, tilde, hat or bar above.
• All latin double-struck, script and fraktur capital letters.
• All superscripts and subscripts (except for the latin small letter schwa).
• Quite a few mathematical operators and symbols.
• Most of the characters which are used for drawing unicode boxes.

What's New in Version 6.0?

• The package option usecourier has been renamed to defaultmonofont.
• The package option linenumbers has been added.
• There is now support for LuaTeX as well as XeTeX.
• The package can now deal with two column documents.
• A lot more unicode box characters have been added.
• Keywords, literals, built-ins, macros, functions and string-prefixes
  have been refreshed according to Julia 1.6.2.
• A few typing errors have been corrected.

How to Use the Package:

Standard Use

Copy the jlcode.sty file to the same folder of your latex file.
Addionally, if you want to use luatex or xetex for compiling your
document, also put all MonoJulia-*.ttf files to the same folder
of 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 that 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}.

Advanced Use

Check out the manual to learn more about the package options and
some advanced techniques like handling managable issues.

Feel Free to Contribute

Please feel free to contribute and report bugs!

It would be especially appreciated if you helped me
adding support for more special unicode characters.