[Tex/LaTex] Sections that compilation ignores (Texmaker)

sectioningtexmakerwindows

Can I create "sections" in a .tex document that compilation will ignore, but will be reflected in the structure of the document, as displayed in texmaker to the left of the window?

When I write a .tex document with Texmaker (windows) and I use the commands \section or \subsection, this is reflected on the left side of the window: there is a list of all sections, subsection, subsubsections etc… This list is extremely useful for navigation within a document. Can I have a list like this show up while using texmaker, that will be ignored by the compiling process?

I need it for easy browsing and better orientation within the document.

My solution at the moment is very primitive: I use the standard \section command, and once I'm done writing the text, I place % signs in front of the sections I want Latex to ignore.

Edit I've noticed today that sometimes texmaker still displays %\section{whatever} as a real section in the sidebar, but I'm not sure wether it's a bug or a feature, and I don't know what triggered it, nor what turned it off eventually.

Best Answer

There seem to be several ways …

1 use the bookmark feature (by texenthusiast)

TeXmaker provides the option to add up to three book marks to your code. (TeXstudio which is a more flexile fork, can add up to ten book marks)

2 use the `comment package` (by Torbjørn)

\usepackage{comment}
% ...
\begin{comment}
   \section{I'm not here}
\end{comment}

3 hide it from TeX with booleans

You can use \iffalse which is a boolean operation that is always false and the following code will be ignored. Every \if… must be ended with a \fi.

\iffalse
   \section{I'm not here}
\fi

4 using different files

This is not a real answer to you question but maybe it will help if you separate your code in several files and load them with \input or \include. I guess \input would be better here (see When should I use \input vs. \include?). Again I like the handling of multiple files in TeXstudio better.

Related Solutions

[Tex/LaTex] Show/hide the sections, subsections and subsections that I want from the navigation sidebar (beamer, Berkeley)

Use the optional argument of the sectioning commands and leave it empty to not include the unit in the sidebar; the unit will, however, be included in the ToC; an example:

\documentclass{beamer}
\usetheme{Berkeley}

\begin{document}

\begin{frame}
\tableofcontents
\end{frame}

\section{Test Section One}
\begin{frame}test\end{frame}
\subsection[]{Test Subsection One One}
\begin{frame}test\end{frame}
\subsection{Test Subsection One Two}
\begin{frame}test\end{frame}

\section[]{Test Section Two}
\begin{frame}test\end{frame}

\section{Test Section Three}
\begin{frame}test\end{frame}
\subsection[]{Test Subsection Three One}
\begin{frame}test\end{frame}

\end{document}

The ToC:

enter image description here

and one of the frames with hidden units in the sidebar:

enter image description here

[Tex/LaTex] How to add an extra level of sections with headings below \subsubsection

You can use the titlesec package to change the way \paragraph formats the titles and set the secnumdepth counter to four to obtain numbering for the paragraphs:

\documentclass{article}
\usepackage{titlesec}

\setcounter{secnumdepth}{4}

\titleformat{\paragraph}
{\normalfont\normalsize\bfseries}{\theparagraph}{1em}{}
\titlespacing*{\paragraph}
{0pt}{3.25ex plus 1ex minus .2ex}{1.5ex plus .2ex}

\begin{document}

\section{Test Section}
test
\subsection{Test Subsection}
test
\subsubsection{Test Subsubsection}
test
\paragraph{Test Modified Paragraph}
test

\end{document}

enter image description here

If you want to define a new sectioning command, you can take a look at Defining custom sectioning commands.

If you want to define a fresh new sectional unit below \subsubsection, but above \paragraph, then you will have to do considerably more work: a new counter has to be created and its representation has to be appropriately defined; the sectional units \paragraph and \subparagraph will also have to be redefined, as well as they corresponding \l@... commands (controlling how the will be typeset in the ToC if the tocdepth value is increased); also, the toclevel (for eventual bookmarks) will have to be considered.

Here's an example showing how to obtain this new sectional unit giving you now the option to use \part, \section, \subsection, \subsubsection, \subsubsubsection, \paragraph, and \subparagraph:

\documentclass{article}
\usepackage{titlesec}
\usepackage{hyperref}

\titleclass{\subsubsubsection}{straight}[\subsection]

\newcounter{subsubsubsection}[subsubsection]
\renewcommand\thesubsubsubsection{\thesubsubsection.\arabic{subsubsubsection}}
\renewcommand\theparagraph{\thesubsubsubsection.\arabic{paragraph}} % optional; useful if paragraphs are to be numbered

\titleformat{\subsubsubsection}
  {\normalfont\normalsize\bfseries}{\thesubsubsubsection}{1em}{}
\titlespacing*{\subsubsubsection}
{0pt}{3.25ex plus 1ex minus .2ex}{1.5ex plus .2ex}

\makeatletter
\renewcommand\paragraph{\@startsection{paragraph}{5}{\z@}%
  {3.25ex \@plus1ex \@minus.2ex}%
  {-1em}%
  {\normalfont\normalsize\bfseries}}
\renewcommand\subparagraph{\@startsection{subparagraph}{6}{\parindent}%
  {3.25ex \@plus1ex \@minus .2ex}%
  {-1em}%
  {\normalfont\normalsize\bfseries}}
\def\toclevel@subsubsubsection{4}
\def\toclevel@paragraph{5}
\def\toclevel@paragraph{6}
\def\l@subsubsubsection{\@dottedtocline{4}{7em}{4em}}
\def\l@paragraph{\@dottedtocline{5}{10em}{5em}}
\def\l@subparagraph{\@dottedtocline{6}{14em}{6em}}
\makeatother

\setcounter{secnumdepth}{4}
\setcounter{tocdepth}{4}

\begin{document}

\tableofcontents
\section{Test Section}
test
\subsection{Test Subsection}
test
\subsubsection{Test Subsubsection}
test
\subsubsubsection{Test Subsubsubsection}
test
\paragraph{Test Paragraph}
test
\subparagraph{Test Subparagraph}
test

\end{document}

enter image description here

Best Answer

1 use the bookmark feature (by texenthusiast)

2 use the comment package (by Torbjørn)

3 hide it from TeX with booleans

4 using different files

Related Solutions

[Tex/LaTex] Show/hide the sections, subsections and subsections that I want from the navigation sidebar (beamer, Berkeley)

[Tex/LaTex] How to add an extra level of sections with headings below \subsubsection

Related Question

2 use the `comment package` (by Torbjørn)