PaperPilot Docs

Customizing Templates

Modify templates to match your specific needs

Templates are starting points, not finished products. Here's how to customize them for your needs.

Safe Customizations

These changes are always safe and encouraged:

Update Metadata

Always update these fields with your information:

\title{Your Paper Title}
\author{Your Name}
\affiliation{Your Institution}
\email{you@example.com}
\date{\today}

Modify Content

Replace example content with your own:

\section{Introduction}
% Delete the placeholder text and write your content
Your introduction goes here...

Add Packages

Include additional packages you need:

% Add in the preamble, before \begin{document}
\usepackage{algorithm2e}  % For algorithms
\usepackage{subfig}       % For subfigures
\usepackage{url}          % For URLs

Add new packages near the existing \usepackage commands. Order can matter for some packages.

Common Customizations

Changing Fonts

With pdfLaTeX, use font packages:

% Serif fonts
\usepackage{times}       % Times
\usepackage{palatino}    % Palatino
\usepackage{charter}     % Charter

% Sans-serif
\usepackage{helvet}      % Helvetica

With XeLaTeX, use system fonts:

\usepackage{fontspec}
\setmainfont{Times New Roman}
\setsansfont{Arial}
\setmonofont{Courier New}

Remember to switch compiler to XeLaTeX in project settings.

Adjusting Margins

\usepackage{geometry}
\geometry{
    margin=1in,
    top=1.5in,
    bottom=1in
}

Be careful with margins in publisher templates — journals often have strict requirements.

Custom Commands

Define shortcuts for frequently used content:

% In preamble
\newcommand{\eg}{e.g.,\ }
\newcommand{\ie}{i.e.,\ }
\newcommand{\R}{\mathbb{R}}
\newcommand{\N}{\mathbb{N}}
\newcommand{\bm}[1]{\boldsymbol{#1}}

Colors

Add custom colors for highlights:

\usepackage{xcolor}

% Define custom colors
\definecolor{linkblue}{RGB}{0, 102, 204}
\definecolor{citegreen}{RGB}{0, 128, 0}

% Use in hyperref
\hypersetup{
    colorlinks=true,
    linkcolor=linkblue,
    citecolor=citegreen
}

Template Structure

Understanding the structure helps you customize safely:

Preamble

Everything before \begin{document}:

\documentclass{...}      % Document type (don't change for publishers)

% Package imports
\usepackage{...}

% Custom commands
\newcommand{...}

% Document metadata
\title{...}
\author{...}

\begin{document}

Document Body

The main content:

\begin{document}

\maketitle               % Generate title

\begin{abstract}         % Abstract environment
...
\end{abstract}

\section{...}            % Main sections
\subsection{...}
...

\bibliography{refs}      % Bibliography
\end{document}

Multi-File Projects

For larger documents, split into multiple files:

Create Section Files

Create separate .tex files for each section:

sections/
├── introduction.tex
├── methods.tex
├── results.tex
└── conclusion.tex

Use Input Commands

Include them in your main file:

\section{Introduction}
\input{sections/introduction}

\section{Methods}
\input{sections/methods}

Compile from Main

Always compile the main file — PaperPilot handles the rest.

The Writing Agent can help split large files into sections. Just ask!

What NOT to Change

Be careful modifying these in publisher templates:

ElementRisk
\documentclass optionsMay break required formatting
Page geometryPublishers have strict requirements
Required packagesTemplates depend on specific packages
Style file contentsBreak compatibility
Citation stylePublishers require specific formats

Always check publisher guidelines before submitting. Some changes that look fine locally may cause rejection.

Troubleshooting

Template Not Compiling

  1. Check if you accidentally deleted required content
  2. Ensure all \begin{} have matching \end{}
  3. Look for missing package imports
  4. Ask the AI to diagnose the error

Formatting Looks Wrong

  1. Compare with the original template preview
  2. Check if you changed document class options
  3. Verify margin/geometry settings
  4. Clear compilation cache and re-compile

Package Conflicts

Some packages don't work well together:

ConflictSolution
caption + subfigUse subcaption instead
hyperref loading orderLoad hyperref last
tikz + beamerLoad tikz after beamer

When adding packages, compile after each addition to catch conflicts early.

On this page