Skip to content

klb2/ieee-paper-template

Repository files navigation

IEEE LaTeX Paper Template

This repository contains a LaTeX template for research papers that are going to be submitted to IEEE journals or conferences. It is based on the IEEEtran LaTeX class.

Additionally, there is a bash script that helps setting up a new document.

Usage

On GitHub

Click on "Use this template".

Local Installation

You can simply copy all the files in the repository and start writing your document in main.tex.

If you want to use the generator script, follow the following steps:

0. Requirements

The following software is required

  • Bash
  • jq
  • Git

1. Installation

# Clone the git repository
git clone https://github.com/klb2/ieee-paper-template.git
# Optional: link script to local bin directory
ln -s $(realpath ieee-paper-template/mkieeepaper.sh) "$HOME/.local/bin/"

2. Custom Default Values

You can create a config file with custom values that are used for initializing the paper. Create the file config.json in ieee-paper-template/ with the following content (replace with your values as needed)

{
  "author": "Name of the first Author, \\IEEEmembership{Student Member, IEEE} and Second Author, \\IEEEmembership{Senior Member, IEEE}",
  "affiliation": "Author 1 is with ...",
  "funding": "This work is supported by ..."
}

3. Initialize New Paper

mkieeepaper name-of-the-paper-directory

This command will create a new directory name-of-the-paper-directory with the template. It automatically includes the default information from config.json and copies all necessary files. Additionally, it initializes a Git repository and makes an initial commit.

Revisions and Highlighting Changes

Typically, you want to highlight changes that you made when revising the paper and resubmitting it to a journal. For this, you can use the \change{...} command, which sets its content in the change color, which is defined in setup-misc.tex.

A revised version could therefore look something like the following example:

This is a sentences, \change{to which we added additional information in the revised version}.

\change{%
The change command accepts paragraphs and floats, e.g., figures.

\begin{figure}
\includegraphics{...}
\caption{We added this figure in the revised version}
\end{figure}
}

Automatically Removing Change Markings

After your paper has been accepted (or if you need to do a second revision), you need to remove the change markings. If you used the \change command to highlight the changes, you can use the remove_change_markings.sh script to quickly remove them from a given TeX file. Simply call the script with the TeX file as an argument, e.g.,

bash remove_change_markings.sh main.tex

Additional Information

This template includes various custom commands and definitions: