Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Code Block
titleFootnote
Some regular text\footnote{%
    The text of the footnote. Notice the comment character above.
} ends here.

LaTeX source formatting

The coding conventions for documentation are far less strict than those used for program source code, for obvious reasons of the different levels of complexity and maintenance requirements.

Blocks of code should be indented with 4 spaces. Tab characters are not allowed.

No line of code should be longer than 120 characters.

Trailing whitespaces are not allowed; make sure to configure your text editor to automatically trim trailing whitespaces on save in the entire file.

Every text file should contain exactly one empty line at the end.

Allowed end-of-line character sequence is Unix-style (\n, LF). Windows or Mac line endings are not allowed.

All environments should be intended, excepting the outermost \begin{document} environment.

There shall be no more than one consecutive blank line.

There shall be at most one chapter per source file.

There shall be one blank line above and below a section header, unless the section header is at the top of the source file.

Multi-line content enclosed in curly braces should be indented.

If a list item spills on the next line, the spilled text should be indented on the same level with the first line.

Code Block
\begin{itemize}
    \item This list item is sufficiently long to exceed the limit of 120 characters per line,
          so it has to spill onto the next line.
          The spilled part is indented correctly.

    \item Another item.
\end{itemize}

% The next line contains a comment to remove the whitespace in the beginning of the footnote.
Regulated non-standard definitions\footnote{%
    I.e., public definitions contributed by vendors and other users
    of the specification, as explained in section~\ref{sec:basic_data_type_regulation}.
} are not included in this list.

Working with graphics

JPEG images are not permitted except for photos.

...

Always check the warning outputs of the compiler, especially when compiling the final version of the document!

LaTeX source formatting

The coding conventions for documentation are far less strict than those used for program source code, for obvious reasons of the different levels of complexity and maintenance requirements.

Blocks of code should be indented with 4 spaces. Tab characters are not allowed.

No line of code should be longer than 120 characters.

Trailing whitespaces are not allowed; make sure to configure your text editor to automatically trim trailing whitespaces on save in the entire file.

Every text file should contain exactly one empty line at the end.

Allowed end-of-line character sequence is Unix-style (\n, LF). Windows or Mac line endings are not allowed.

All environments should be intended, excepting the outermost \begin{document} environment.

There shall be no more than one consecutive blank line.

There shall be at most one chapter per source file.

There shall be one blank line above and below a section header, unless the section header is at the top of the source file.

Multi-line content enclosed in curly braces should be indented.

If a list item spills on the next line, the spilled text should be indented on the same level with the first line.

Code Block
\begin{itemize}
    \item This list item is sufficiently long to exceed the limit of 120 characters per line,
          so it has to spill onto the next line.
          The spilled part is indented correctly.

    \item Another item.
\end{itemize}

% The next line contains a comment to remove the whitespace in the beginning of the footnote.
Regulated non-standard definitions\footnote{%
    I.e., public definitions contributed by vendors and other users
    of the specification, as explained in section~\ref{sec:basic_data_type_regulation}.
} are not included in this list.

Toolchain

LaTeX distribution

...