numberingsections-paragraphstable of contents
Sorry if this question already appears elsewhere, I couldn't find it.
Is there a way to label a section in the text but give it a different name in the table of contents?
I have very long section titles but would like to give them nicknames in the TOC. I tried using \section*{A} then \addcontentsline{toc}{section}{B} but this removes the numbering of the section from the body of the text.
I'm very new to LaTeX so sorry if this is an annoying question!
The titlesec package can be used here. The modifications to the .sty file:
\ProvidesPackage{aglc}
\NeedsTeXFormat{LaTeX2e}
\RequirePackage{parskip}
\RequirePackage{chngcntr}
\RequirePackage{titlesec}
\setcounter{secnumdepth}{5}
\setcounter{tocdepth}{5}
\counterwithin*{subsection}{section}
\counterwithin*{paragraph}{subsection}
\counterwithin*{subparagraph}{paragraph}
% AGLC Heading 1
% I Section
\renewcommand*\thesection{\Roman{section}}
\renewcommand\section{\@startsection {section}{1}{\z@ }%
{-3.5ex \@plus -1ex \@minus -.2ex}%
{2.3ex \@plus .2ex}{\normalfont \centering \large \sc }}
% AGLC Heading 2
% A SubSection
\renewcommand*\thesubsection{\Alph{subsection}}
\renewcommand\subsection{\@startsection {subsection}{2}{\z@ }%
{-3.25ex\@plus -1ex \@minus -.2ex}%
{1.5ex \@plus .2ex}{\normalfont \centering \large \emph }}
% AGLC Heading 3
% 1 SubSubSection
\renewcommand*\thesubsubsection{\arabic{subsubsection}}
\renewcommand\subsubsection{\@startsection {subsubsection}{3}{\z@ }%
{-3.25ex \@plus -1ex \@minus -.2ex}%
{1.5ex \@plus .2ex}{\normalfont \emph }}
% AGLC Heading 4
% (a) Paragraph
\renewcommand*\theparagraph{(\alph{paragraph})}
\titleformat{\paragraph}
{\normalfont\normalsize\em}
{\renewcommand*\theparagraph{%
\arabic{subsubsection}(\alph{paragraph})}\theparagraph}
{1em}{}
\titlespacing*{\paragraph}
{0pt}{3.25ex plus 1ex minus .2ex}{1.5ex \@plus .2ex}
% AGLC Heading 5
% (i) SubParagraph
\renewcommand*\thesubparagraph{(\roman{subparagraph})}
\titleformat{\subparagraph}
{\normalfont\normalsize\em}
{\renewcommand*\thesubparagraph{%
\arabic{subsubsection}\theparagraph(\roman{subparagraph})}\thesubparagraph}
{1em}{}
\titlespacing*{\subparagraph}
{0pt}{3.25ex plus 1ex minus .2ex}{1.5ex \@plus .2ex}
\newcommand{\case}[1]{\emph{#1}}
\newcommand{\caseref}[1]{[\emph{#1}]}
\newcommand{\statute}[2][Qld]{\emph{#2} (#1)}
\newcommand{\latin}[1]{\emph{#1}}
\endinput
Since titlesec was used to change the formatting for \paragraph and \subparagraph, it could also be used for the other sectional units.
Here's a simple test document using the aglc.sty file to show the desired changes in action:
\documentclass{article}
\usepackage{aglc}
\usepackage{lipsum}% just to generate text for the example
\begin{document}
\tableofcontents
\section{Test section}
\subsection{Test subsection}
\subsubsection{Test subsubsection}
\paragraph{Test paragraph}
\lipsum[2]
\subparagraph{Test subparagraph}
\lipsum[2]
\end{document}
And the resulting document:
The process might be somewhat counter-intuitive, but you need to insert the spacing changes mid-document for it to have a partial effect in the ToC. The reason for this is because the entire .toc file is read during a call to \tableofcontents. Therefore, changing anything prior to that (in the preamble, for example), will have an effect for the entire ToC. The solution is to add
\addtocontents{toc}{\setlength{\cftsecnumwidth}{4em}}
just after you initiate the Appendix:
\documentclass[a4paper,12pt,twoside]{scrreprt}% http://ctan.org/pkg/koma-script
\usepackage{hyperref}% http://ctan.org/pkg/hyperref
\hypersetup{colorlinks,breaklinks,plainpages=false,linktocpage,hypertexnames=true,naturalnames=false}
\hypersetup{linkcolor=red,citecolor=blue,filecolor=blue,urlcolor=blue} %Colorful
\usepackage{tocloft}
\begin{document}
\tableofcontents
\chapter{Hardware Data} \label{chap.hardware}
\setcounter{section}{19}
\section{Test section one}
\subsection{test section one one}
\subsection{test section one two}
\section{Test section two}
\subsection{test section two one}
\subsection{test section two two}
%%%% Appendix
\cleardoublepage
\phantomsection
\appendix
\chapter*{Appendix}
\addcontentsline{toc}{part}{Appendix}
%%% Configure de distance
\addtocontents{toc}{\setlength{\cftsecnumwidth}{4em}}
\chapter{Appendix Test Chapter}
\setcounter{section}{199}
\section{Test Section}
%%%%%%%%%%%%%%%% Annex:
\cleardoublepage
\phantomsection
\setcounter{chapter}{0}
\renewcommand{\theHchapter}{an.\Alph{chapter}}
\renewcommand{\thechapter}{$\,\!$\Alph{chapter}}
\renewcommand{\appendixname}{Annex}
\addcontentsline{toc}{part}{Annex}
\chapter*{Annex}
\renewcommand{\thesection}{\thechapter$_{x}$.\arabic{section}}
\chapter{Annex Test Chapter}
\setcounter{section}{1199}
\section{Test Section}
\end{document}
Since you're adding stuff to the ToC, results will only be visible upon the second compile.
Best Answer
Most document classes offer the user the option of specifying a different ToC-related entry for the sectional unit that what is displayed in the actual document body through an optional argument:
This allows one to effectively create a completely different ToC than what is contained within the actual document. However, it provides many advantages, including:
Abbreviating the ToC-related content that would otherwise look awkward or not make sense;
Remove notation from a sectional unit that is not defined when the reader views the ToC;
Include "bizarre" things as part of the heading;
...
Common usages (apart from the above ones) stems from the fact that sectional units' mandatory argument ends up moving. That is, they find their way into the text where you put it, but also in the ToC. And, moving arguments is sometimes fragile, so care has to be taken with the content they may contain. The optional argument provides an easy-way-out where one can remove the "unwanted" content and specify your own.