New URL for NEMO forge!   http://forge.nemo-ocean.eu

Since March 2022 along with NEMO 4.2 release, the code development moved to a self-hosted GitLab.
This present forge is now archived and remained online for history.
document.tex in NEMO/trunk/doc/latex/global – NEMO

source: NEMO/trunk/doc/latex/global/document.tex @ 11176

Last change on this file since 11176 was 11176, checked in by nicolasmartin, 5 years ago

Implementation of multi-indexes instead of an indiscrimate aggregate index
Creation of 5 sections under Indexes chapter for the most relevant lists of index entries:
namelist blocks and parameters, CPP keys, modules and subroutines.

  • indexes.tex & index.ist: new file in global directory for index management
  • Add symbolic links under main to non-existing *.idx before LaTeX compilation to reduce trivial error messages with makeindex
  • Create latexmkrc init file loaded latexmk with '-r' option in order to apply the style rules to the indexes with the sequence of several compilations

Other changes:

  • Define a preamble.tex with the list of files to load from global folder
  • Integrate 'Citation' subsubsection in new info_page.tex for the 2nd page along with 'frontpage.tex' for the cover, in order to have a clear distinction with \maketitle in the main LaTeX document
  • Move 'Foreword' chapter from subfiles to main as more appropriate

Bugfixes with few attempts of HTML export

  • One single location for defining the paths to search for images with \graphicspath in packages.tex
  • Renaming of authors variables (\1stauthor -> \firstauthor and so one)
  • Update of LaTeX dependencies in terms of new pkgs (DEPS)
File size: 2.2 KB
RevLine 
[11176]1
[9376]2%% ==============================================================================
[11176]3%% Template structure for reference manual
[9376]4%% ==============================================================================
[707]5
[11170]6%% NEMO release version
[11176]7\def \version{4.0rc~}
[707]8
[9376]9%% Preamble
10%% ==============================================================================
11
[10495]12%% Document layout
[11151]13\documentclass[draft]{scrreport}
[10495]14
[11176]15%% Load the configuration of the manual
16\input{../main/definitions}
[11171]17
[11176]18%% Load global *.tex files
19\input{../../global/preamble}
[707]20
[11176]21\dominitoc
[10414]22
[11176]23%% Launch the creation of the indexes
24\input{../../global/indexes}
[10495]25
[11176]26
[10495]27%% End of common preamble between main and sub-files
[11176]28%% Override custom cmds for full manual compilation
29\newcommand{\onlyinsubfile}[1]{#1}
30\newcommand{\notinsubfile}[1]{}
31
[9388]32\begin{document}
[9376]33
[11176]34\renewcommand{\onlyinsubfile}[1]{}
35\renewcommand{\notinsubfile}[1]{#1}
36
[10442]37\renewcommand{\biblio}{}
38\renewcommand{\pindex}{}
[9376]39
[10414]40
[9376]41%% Frontmatter
42%% ==============================================================================
43
[11176]44\pagenumbering{gobble}
[707]45
[11176]46%% Title page
47\input{../../global/frontpage}
[11151]48
[11176]49\maketitle
50\emptythanks
51
52%% Information page (2nd page)
53\input{../../global/info_page}
54
[11170]55%% Foreword
[11151]56%\frontmatter   %% Chapter numbering off and Roman numerals for page numbers
57\pagenumbering{roman}
[11176]58\input{foreword}
[11151]59
[11176]60%% Table of Contents
[11171]61\tableofcontents
[11176]62%\listoffigures
63\listoftables
[9376]64
[11151]65\clearpage
66%\end{document}
[9376]67
[11170]68
[9376]69%% Mainmatter
70%% ==============================================================================
71
[11151]72%\mainmatter   %% Chapter numbering on, page numbering is reset with Arabic numerals
73\pagenumbering{arabic}
[707]74
[11170]75\input{chapters}
[11007]76
[707]77
[9388]78%% Appendix
[11151]79%% ==============================================================================
[9376]80
[11170]81%% Chapter numbering is reset with letters now
82\appendix   
[11151]83
[11170]84\input{appendices}
[11151]85
[9376]86
87%% Backmatter
88%% ==============================================================================
89
[11151]90%\backmatter   %% Chapter numbering off
[9376]91
[9394]92%% Bibliography
[11171]93\phantomsection
94\addcontentsline{toc}{chapter}{Bibliography}
[11170]95\bibliography{../main/bibliography}
[9394]96
[9376]97%% Index
[11151]98\clearpage
[11171]99\phantomsection
[11176]100\addcontentsline{toc}{chapter}{Indexes}
101\printindex[keys]
102\printindex[modules]
103\printindex[blocks]
104\printindex[parameters]
105\printindex[subroutines]
[707]106
[781]107\end{document}
[11176]108
Note: See TracBrowser for help on using the repository browser.