CodeSoul LaTeX Paper Template

🌐 中文说明

---

A LaTeX class for CodeSoul team papers and technical reports. Two layouts are available:

File	Layout
codesoul.cls	Single-column (article style)
codesoul-2col.cls	Two-column body (title/abstract always full-width)

Both use XeLaTeX or LuaLaTeX with TeX Gyre fonts — no separate font install needed.

Quick Start

xelatex main && bibtex main && xelatex main && xelatex main

Or with latexmk:

latexmk -xelatex main

For two-column layout, use main-2col.tex and codesoul-2col.cls instead.

Files

File	Description
codesoul.cls	Single-column document class
codesoul-2col.cls	Two-column document class
main.tex	Sample paper (single-column)
main-2col.tex	Sample paper (two-column)
references.bib	Sample bibliography (BibTeX format)
logo.png	Team logo (replace with your own)

Design at a Glance

• Two layout options. codesoul.cls is a standard article layout; codesoul-2col.cls uses a two-column body with title, authors, and abstract always spanning the full width.
• Body. TeX Gyre Pagella serif at 11pt, generous margins.
• Accent font. Title, section headings, theorem/definition titles, callout titles, abstract label, and caption labels all use TeX Gyre Adventor — a friendly, slightly informal face built into TeX Live.
• Colors. Deep blue primary (#1F4E79), accent red (#C0392B), grayed body labels, light shaded callout backgrounds. Override at the top of the class file.

Customizing

Open the class file. Brand colors and team info are near the top:

% Brand colors
\definecolor{teamprimary}{HTML}{1F4E79}   % main color
\definecolor{teamaccent}{HTML}{C0392B}    % accent — definitions, URLs
\definecolor{teamgray}{HTML}{4A4A4A}      % body labels
\definecolor{teamlight}{HTML}{F4F6F8}     % callout backgrounds

% Team branding
\teamname{Your Team}
\teamtagline{Your tagline here}
\teamlogo{logo.png}              % PNG or vector PDF
\teamwebsite{yourteam.dev}

Document metadata (in .tex):

\title{Your Paper Title}
\addauthor{Author Name}{1}
\addaffil{1}{Your Affiliation}
\date{May 2026}

Included Elements

Title Block

Team name + tagline on the left, logo on the right, horizontal rule, then title with red accent underline, authors with numbered affiliations.

Abstract

Shaded box with colored left bar, inline accent-font "Abstract." label.

Theorem Environments

Sidebar-style boxes with colored left bar. Use {title}{label} arguments:

\begin{theorem}{Stability under composition}{stability}
  Let $\mathcal{M}, \mathcal{C}, \mathcal{R}$ be Lipschitz...
\end{theorem}

Reference with \cref{>thm:stability}. Available: theorem, lemma, proposition (primary color), definition (accent color).

Key Insight Callout

\begin{insight}
  Treating routing as a separate module exposes a tunable axis...
\end{insight}

Code Listings

Pre-styled with team colors via listings:

\begin{lstlisting}[language=Python, caption={...}, label=lst:foo]
def forward(x):
    return route(compute(memory(x)))
\end{lstlisting}

Cross-references

cleveref is loaded. Use \cref{...} for everything.

Bibliography

natbib with numeric citations. \citep{key} for parenthetical, \citet{key} for textual. Default style is abbrvnat.

Overleaf

Upload the .cls file, your main.tex, logo.png, and references.bib to your Overleaf project. Set Compiler to XeLaTeX or LuaLaTeX in Menu → Settings.

Engine Requirements

Requires XeLaTeX or LuaLaTeX (because of fontspec). pdflatex will not work. TeX Live 2020+ or any recent MiKTeX is fine.