Skip to content

dschaehi/commenting.sty

Repository files navigation

LaTeX Commenting Package

Description

A LaTeX package for collaborative academic writing with sophisticated comment management and tracking features. Designed with accessibility in mind, featuring colorblind-safe colors for better collaboration.

page1.png page2.png page3.png

Features

  • Color-coded inline comments with author attribution
  • Distinct footnote-style annotations
  • Tracked text additions with author identification
  • Author-specific colored environments
  • Smart draft/final mode switching
  • Colorblind-safe predefined colors

Installation

  1. Place commenting.sty in your LaTeX project directory or in your local texmf tree
  2. Add the package to your document:
    \usepackage[draft|final]{commenting}
        

Usage

Author Registration

Register authors with their assigned colors:

\registerauthor{<author>}{<color>}    % Register author with chosen color

Available Commands

Each registered author gets access to these commands:

CommandDescription
\<author>inline{text}Add an inline comment
\<author>footnote{text}Add a footnote comment
\<author>add{text}Add tracked text changes
\begin{<author>env}...Create colored environment

Example Usage

This is a paragraph. \aliceinline{needs clarification}

Here's a statement\bobfootnote{Add citation}.

\begin{bobenv}
    This is \aliceadd{very} important.
\end{bobenv}

Full Example

\documentclass{article}
\usepackage[draft]{commenting}

\registerauthor{alice}{cbBlue}    % Register Alice with blue color
\registerauthor{bob}{cbOrange}    % Register Bob with orange color

\title{\texttt{commenting.sty} examples}
\date{}
\begin{document}

\maketitle

\section{Introduction}

This is a paragraph. \aliceinline{needs clarification}

Here's a statement\bobfootnote{Add citation}.

\begin{bobenv}
    This is \aliceadd{very} important.
\end{bobenv}

\end{document}

Color Documentation

Available colorblind-safe colors:

Color NameDescriptionRGB Values
cbBlueStrong blue(51,114,189)
cbOrangeVivid orange(255,127,42)
cbTealBright teal(64,204,204)
cbRedClear red(217,37,37)
cbPurpleMuted purple(148,103,189)
cbGreenBright green(0,158,115)
cbYellowVivid yellow(240,228,66)
cbPinkSoft pink(204,121,167)
cbBrownWarm brown(146,73,0)
cbGrayNeutral gray(128,128,128)

Package Options

Two modes available:

\usepackage[draft]{commenting}  % Show all comments (default)
\usepackage[final]{commenting} % Hide all comments

Author Information

  • Author: Jae Hee Lee
  • Website: jaeheelee.de
  • Version: 2024/11/20 v1.1

License

This package is distributed under the MIT License (MIT).

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages