Abstract

1 Introduction

Welcome to the markdown (aka commonmark) template for the International Conference on Live Coding 2016.

This document is a guide to using markdown for the conference, and is itself written in markdown. For full understanding, refer to iclc2016.txt to see the source of this document, and iclc2016.pdf to see the typeset output. Use of this template is currently only recommended for those familiar with commandline tools.

We suggest you take a copy of this template (iclc2016.txt), and use it as a starting point for your ICLC paper.

Preparing your submission using markdown will enable us to make proceedings available both in PDF files suitable for print, and in HTML suitable for the web. This is useful for making sure your paper is fully accessible, via Internet search, and with assistive technology such as screen readers for blind people. We recommend taking a straightforward approach to formatting your document.

If you do not wish to use markdown, please do not be discouraged from submitting your paper. There is also a word document template available from the conference website.

2 Learning and using markdown

We are happy to answer any questions you have about markdown in connection with your conference submission.

This is best done via our online community forum: http://lurk.org/groups/lcrn/

Alternatively you may email the conference chairs directly:

2.1 Running pandoc

Pandoc is software which turns text written in markdown into a beautiful looking document, complete with references. You will need to run it to create PDF documents of your paper for checking and uploading for peer review.

You may download pandoc for all major operating systems (including MS Windows, Apple Mac OS and GNU/Linux) from the following website: http://johnmacfarlane.net/pandoc/

As an alternative to the above downloads, on OS X only, the homebrew package manager can be used to install pandoc: http://brew.sh/

If you use homebrew to install on OS X you will need to install both the pandoc and pandoc-citeproc packages as follows:

brew update
brew install pandoc
brew install pandoc-citeproc

To produce PDF files you will need to have LaTeX installed, as well as pandoc. See the pandoc website for installation instructions: http://johnmacfarlane.net/pandoc/installing.html. LaTeX is used internally, you will not have to edit any LaTeX documents.

To render your markdown source as HTML, open a terminal window, change into the folder where the template is and run the following command:

pandoc --template=pandoc/iclc.html --filter pandoc-citeproc -N iclc2016.txt -o iclc2016.html

To produce a PDF document, make sure you have LaTeX installed (see above), and run the following:

pandoc --template=pandoc/iclc.latex --filter pandoc-citeproc -N iclc2016.txt -o iclc2016.pdf

For a higher quality output, add the option --latex-engine=xelatex to the above. You will need the Inconsolata and Linux Libertine opentype fonts installed.

An example Makefile is also provided to run these commands for you.

2.2 Bibliographic references

Pandoc accepts bibliographic databases in a range of formats, so make sure you have the right extension on your file.

Authors may be referenced in two ways; inline, e.g. Schwitters (1932) wrote the Ursonate sound poem, or in parenthesis, e.g. Ursonate is a sound poem (Schwitters 1932). Multiple references should be grouped together like so (Schwitters 1932; Miller 1956; Greenewalt 1946).

The pandoc command given in the above section will automatically render your references according to Chicago author-date style.

At the head of the markdown source file for this template, you will see an entry for "bibliography" that points to the file references.bib. Here you'll find examples of bibliography entries in BibLaTex format, including examples for articles, books, book chapters and items from conference proceedings.

2.3 Code

We have chosen a single column layout to better support code examples without having to break lines. The following shows how to include a code example with syntax highlighting:

d1 $ every 3 (iter 4) $ brak $ "bd [sn [[sn bd] sn]]*1/3"

For a list of supported languages, you can visit this page: [http://johnmacfarlane.net/highlighting-kate/]

If your favourite language isn't listed, perhaps a language with a similar syntax will still work.

2.4 Figures

Images should be included as figures, with captions provided and formatted as shown in Figure 1. Be prepared for the page layout and image size to be changed during the editing and layout process, and consider this when referring to the figures in the text.

A descriptive caption should be given for all figures, understandable without reference to the rest of the article.

3 Conclusion

We look forward to receiving your completed papers. Submission is through the online peer review system at http://iclc2016.mcmaster.ca only. Do not send papers directly by e-mail. In all cases, please submit a PDF version of your paper for peer review. At a later stage in preparing the proceedings, we may ask for the markdown or Word versions of your paper.

3.1 Acknowledgments

At the end of the Conclusions, acknowledgements to people, projects, funding agencies, etc. can be included after the second-level heading “Acknowledgments”.

Again, if you have any questions or problems, please share them on the forum: http://lurk.org/groups/lcrn/

Or email conference chair David Ogborn directly: ogbornd@mcmaster.ca

References