This issue follows some remarks left on the juliacon channel on Slack

1. The code environment does not wrap code to a new line at the value corresponding to the width of the environment, so we do have to tweak things manually (which is not horrible). Maybe we could solve things by adding a submission style in JuliaFormatter.jl that include the exact width (seems to be 63 characters)
2. I, personally, find the itemized bullet style terrible as there is no space at all between the hyphen and the first character following it. I would not complain if we have something different (a simple bullet would do …) from next JuliaCon.

Note that these are very small and not important complaints. I do love the juliacon logo on top

Is it possible to add a linebreak in the title or authors? My title currently looks like this:

So the first line is very long and the second very short, not to mention the start of the title is slightly overlapping with the JuliaCon logo. If it was pure .tex, I could just add \\ after "for" to get the following:

Which looks much better. I tried to do this in the .yml and it just doesn't work. One of my colleagues is also having a related issue where the name of one of the authors is split between two lines.

So, is there any way to add a linebreak in the .yml?

Hey,
changing the lstlisting example slightly to

\begin{lstlisting}[language = Julia, caption={Hello Julia}]
using Plots

x = -3.0:0.01:3.0
y = rand(length(x))
plot(x, y)
\end{lstlisting}

results in this.

What would we need to change?

Thanks,
Felix

The bib entry

@misc{juliacontemplate,
	title = {JuliaConSubmission.jl : An example package for submissions to JuliaCon},
	url = {https://github.com/JuliaCon/JuliaConSubmission.jl},
	urldate = {2020-08-31},
	year = {2020},
}

is printed as

[1]  Juliaconsubmission.jl : An example package for submissions to juliacon, 2020.

in the references section. I think the URL of the bib item should also be printed in the references. Any idea how to do it?

I played around with the template locally and noticed that the PDF metadata wasn't embedded in the code. I ended up using something à la

\hypersetup{
pdftitle = {Econometrics.jl},
pdfsubject = {JuliaCon 2019 Proceedings},
pdfauthor = {José Bayoán Santiago Calderón},
pdfkeywords = {Julia, Econometrics, Statistical Software, Software Validation}
}

I don't know if someone wants to make a PR to pre-fill those values from the YAML file.

When a bibliography record in the bib file contains a doi field, and the doi contains an underscore, compilation breaks.

The bibliography style doesn't support DOI fields. This was mentioned in #7, but that was since closed.

This was also requested in JuliaCon/proceedings-review#68

Hi,

Firstly many thanks for this template!

I'd like to cross-reference my code listings and have noted some odd behaviour for the captions. Here's my listing:

\begin{lstlisting}[language=Julia, escapechar=@, numbers=left, label={lst:binary-advanced}, caption={An advanced usage example involving the DiCE Generator.}]
# Counterfactual search:
opt = Flux.Optimise.Descent(1.0) @\label{line:binary-advanced-opt}@
generator = DiCEGenerator(;opt = opt) @\label{line:binary-advanced-dice}@
counterfactuals = generate_counterfactual(
    x, target, counterfactual_data, M, generator;
    num_counterfactuals=5 @\label{line:binary-advanced-num}@
)
# Plotting
plt = plot(counterfactuals)
\end{lstlisting}

This is what it generates:

I haven't seen captions for listings in any of the previous proceedings, so perhaps this is intentional? For now I'll submit with empty captions, but would be great to find a solution. Any advice would be much appreciated.

Have a good weekend 👋🏽

I'm trying to find the specifications of page limit and paper size for the proceedings.
One author asked if it was ok to use single column, and another has formatted for A4 paper...
Thanks

@dpanigo is using \begin{listing} to format pseudo-code this breaks with us defaulting to lstlistings

Proposal:

biblatex is the preferred bibliography management in LaTeX and uses biber over bibtex as the backend. In terms of actual output changes, it would be nice to include the DOI which I think it is an improvement over the current output.

• Add to cls,

\usepackage[maxbibnames=99,
            ]{biblatex}
\addbibresource{ref.bib}

• Delete juliacon.bst, bib.tex, and \input{bib.tex} in paper.tex

The logo smashes into (vertically) longer titles, add a little vertical space after the logo.

Hi

subject says it all. Just change the instances of

\verb foo  and so on...

in paper.tex, with something like

\verb|foo| and so on...

and everything is hunky-dory.

All the best

Marco

Hi there,

I've been working on a Quarto extension for JuliaCon Proceedings: https://github.com/pat-alt/quarto-juliacon-proceedings. It is built on top of the LaTeX class contained in this repo (though with minor edits to the cls file, tracked here). It needs some more work but could eventually enable authors to write the proceedings articles in Quarto with ease. The repo contains more information including links to examples that can be used to spot any remaining discrepancies.

What is Quarto?

Quarto makes it easy to write reproducible documents that can be rendered to PDF, HTML, Word and more. It is based on Markdown, which is easy to learn and write. It also supports LaTeX, which is useful for more advanced formatting. As this extension demonstrates, Quarto is also very flexible and can be extended with custom templates and styles.

Why Quarto?

By embracing Quarto, JuliaCon Proceedings can set an example for how to write reproducible documents. We would not only make it easier for authors to write their submissions but also open the door for more advanced features such as interactive figures and executable code blocks in HTML documents.

The template discusses some further advantages: pdf, html.

Remaining Discrepancies

There are some remaining discrepancies. I've opened issues for all of the discrepancies that I have discovered so far. The rendered PDF of my recent JuliaCon publication serves as a comparison to the published version. If you spot any differences not currently listed in issues, please open a new issue.

BTW, this is what a corresponding HTML version of a JuliaCon Proceedings paper could look like.

Help appreciated

I not very good with LaTex, so if this proposal is of interest, I'd much appreciate your support with this 😅

Any thoughts/questions welcome!

Hi,

First off, thanks for your work on this great submission template.

I have found that the listings package doesn't like some unicode characters that we use in our Julia library, eg.

\begin{lstlisting}[label=composition, numbers=left, mathescape]
Ω₀ = CH(X₀, Φ*X₀ ⊕ E₊(X₀))
\end{lstlisting}

gives an error.

A workaround is to escape the math commands like this:

\begin{lstlisting}[label=composition, numbers=left, mathescape]
$\Omega_0$ = CH($X_0, \Phi*X_0 \oplus E_+$)
\end{lstlisting}

While this shows the code, I find this is not great because the colors are wrong (all math characters in dollar signs are shown in red).