LaTeX template
LaTeX Template¶
Prepare your manuscript using the latest LaTeX template from
anoma/art-template and BibTeX to
generate your bibliography. The ART document class is designed to be used with
xelatex
, but it can also be compiled with pdflatex
.
If you find any issues with the template, please open an issue on GitHub or reach out to us on Heliax Slack in the #anoma-art-coordination channel.
For Anoma Authors¶
Setting Up Your Repository¶
Create or request a new repository under the Anoma organization on GitHub. Use this repository for your paper's source code and supporting material.
Name your repository following the format ART-<year>-<last-names>-<title>
:
<year>
: The publication year (actual or planned).<last-names>
: Hyphen-separated author surnames (up to three, else use 'et-al').<title>
: CamelCase paper title, hyphen-separated.
For example, if Alice, Bob, and Carol are the authors of a paper titled "Zero Knowledge Proofs for Fun and Profit" in 2021, the repository name would be:
ART-2021-Alice-Bob-Carol-Zero-Knowledge-Proofs-for-Fun-and-Profit
The repository name can be changed later as long as the format is preserved.
Using the ART Template¶
Employ the latest LaTeX template from anoma/art-template.
[Optional] Using gh
(GitHub
CLI), you can set up a new ART project
by running the following command:
gh repo clone anoma/<ART_REPO_NAME> --public --template=anoma/art-template
Alternatively, you can simply clone the template repository and copy the files to your new repository, for example:
git clone [email protected]:anoma/art-template.git ART-repo-name
Tip
With the template, a Makefile
is provided to simplify the build
process.
Also, next time you want to update the template, you can run the following
command:
make update-template
Tip
If you are using Overleaf, you can use the Anoma Overleaf template directly. However, make sure the version is up-to-date with the latest template on GitHub.
Writing Your Paper¶
-
Update
metadata.tex
with your paper's title, authors, abstract, and keywords. -
Your manuscript content should reside within the
main.tex
file. For better organization, you may divide your manuscript into several files. These can be included in themain.tex
file using the\input{<file>}
command. It's crucial to define the type of your paper by setting the appropriate document class options. For instance:
To configure a technical report, use the following command at the beginning of your document:
\documentclass[techreport]{anoma}
Document class options
- paper size:
a4paper
orletterpaper
(must be present) - add line numbers:
lineno
(optional) - no date:
nodate
(optional) - no authors:
noauthors
(optional) - toc:
toc
(optional) - document type:
article
: Article (default)techreport
: Technical Reportreport
: Reportcommun
: Communicationpersp
: Perspectivereview
: Reviewanonymous
: Article (without metadata)
Adding Figures and Tables¶
Tables and figures may be wider than \textwidth
, and should be centered.
For this reason, add a \centerline{}
around the \begin{tabular}...\end{tabular}
and \includegraphics{...}
statements.
For full-width figures set the width to 1.3\textwidth
:
\centerline{\includegraphics[width=1.3\textwidth]{filename}}
Adding References¶
Include references in ref.bib
. Google Scholar's BibTeX export can assist in
formatting.
Tip
The template repository includes a arts.bib
file with BibTeX entries for
all the published ARTs. See the arts.bib latest version.
Adding Macros¶
Include any custom packages, commands, or macros in macros.tex
.
Overleaf Collaboration (Optional)¶
Enable Overleaf collaboration. Log in on Overleaf using your Heliax email account, which will automatically grant you access to the Anoma organization, and request for the premium features of Overleaf in case you need them.
- Create a new Overleaf project using the option "Import from GitHub".
- Make sure the GitHub sync works
Info
The conventions for naming your repository, the LaTeX files, metadata.tex
and main.tex
, are important for the automated generation of our ART index,
as you see in the ART list. So, please follow these conventions.
External Contributors¶
In order to propose any topic and seek involvement from potential reviewers:
- Create a thread in the ART section on the Anoma Research forums describing the paper you would like to write.
In order to submit a paper:
- Create a new repository on GitHub (preferably) or another Git hosting service of your choice. Use this repository for your paper's source code and supporting material. Link to this repository in your submission.
- Employ the latest LaTeX template from anoma/art-template.
-
Submit your paper on Zenodo and make sure to leave your contact details in the metadata. We will reach out to you via email to any further questions or comments.
Overleaf Template project¶
If you're looking for an alternative method to begin your project, consider using the Overleaf template directly. Here's how you can get started:
-
Create a new project on Overleaf using this template link:
-
Once you've created your project, you can collaborate with us by adding our team as an editor. Please use the following email address to add us:
[email protected]
.
Info
Please note that in order to add collaborators and enable commenting on Overleaf and change tracking, your Overleaf account must be upgraded to a premium subscription.
As we assist you through the submission process, we will require you to get a Git repository (preferably on GitHub) for your paper by the time of submission.