Andrea fix for so many sections + minor additions
[goodguy/cin-manual-latex.git] / common / packages.tex
index 01bee8f69449967a645e5c808c54e8d57a9a638d..4b9312ff875ae76e07e88f8cc04f7fb4867cba5b 100644 (file)
@@ -1,26 +1,43 @@
+% Packages - The programs texdoc and texdoctk (GUI for texdoc) offer
+% help for the packages.
 
 \usepackage{cmap}
-\usepackage[T2A]{fontenc}
-\usepackage[utf8]{inputenc}         % file encoding
-\usepackage{substitutefont}         % so we can use fonts other than those specified in babel
-\usepackage[english]{babel}         % default language for document
-\usepackage[scaled=0.925]{XCharter} % Подключение русифицированных шрифтов XCharter
-\usepackage[bitstream-charter]{mathdesign} % Согласование математических шрифтов
+\usepackage[T1]{fontenc}  % T2A (Cyrillic) and T1 are only identical
+                          % in the first 128 positions. This is an
+                          % English language document.
+\usepackage[utf8]{inputenc} % file encoding
+\usepackage{substitutefont} % so we can use fonts other than those specified in babel
+\usepackage[english]{babel} % default language for document
+% Cyrillic - if it is used, no Small Caps are available:
+%\usepackage[scaled=0.925]{XCharter} % Подключение русифицированных
+                                    % шрифтов XCharter "Connection
+                                    % of Russified XCharter Fonts"
+\usepackage[bitstream-charter]{mathdesign} % Согласование
+                                           % математических шрифтов
+                                           % "Math font
+                                           % harmonization"
 
-\usepackage{
+\usepackage{%
     %amsfonts,
     mathtools,
-    mathtext,
+    mathtext,% Cyrillic?
     cite,
     enumerate,
     float,
     textcomp
-}                                   % some packages 
-%\usepackage[font={small}]{caption}
+}
+
+% Customization of captions in floating environments
+\usepackage[font={small},textfont=it]{caption}
+
 \usepackage{hhline}                 % beautiful links
+\PassOptionsToPackage{hyphens}{url}
 \usepackage{hyperref}               % beautiful links
+
 \usepackage{pdflscape}              % landscape pages
 \usepackage{longtable}              % longtable support
+\usepackage{calc} % in conjunction with longtable
+
 \usepackage{multirow}               % vertical cell in table
 \usepackage{bigstrut}               % big strut
 \usepackage{array}                  % additional cell aligh
 
 %\usepackage[nottoc]{tocbibind} %  do we need bibliography in toc
 %----------------------------------------------
-%\usepackage{mhchem}        
+%\usepackage{mhchem}
 %===============  Font for tables  ============
-\let\oldtabular\tabular
-\renewcommand{\tabular}{\small\oldtabular}
-\hypersetup{colorlinks=true,
-    linkcolor=blue,
-    citecolor=blue, 
-    filecolor=blue, 
-    urlcolor=blue, 
-    pdftitle={Cinelerra GG Infinity Manual}, 
-    pdfauthor={Cinelerra Authors},
-    pdfsubject={Video Editing}, 
-    pdfkeywords={Cinelerra, Good Guy}
-} % pdf properties
-\usepackage[pdftex]{graphicx}       % do we need some figures in our pdf 
+%\let\oldtabular\tabular
+%\renewcommand{\tabular}{\small\oldtabular}
+
+\usepackage[pdftex]{graphicx}       % do we need some figures in our pdf
 \graphicspath{{images/}}            % path to images
 \usepackage{tikz}                   % drawing package
 \usepackage{nameref}                % use \nameref{} to set reference to chapter neme.
-\input{common/settings.tex}
-
-%----------------------------------------------------------------------
-\usepackage{listings}               % include code 
-\lstset{                            % begin settings
-  %language=R,                      % the language of the code
-  inputencoding=utf8,
-  basicstyle=\ttfamily\footnotesize,         % the size of the fonts that are used for the code
-  numbers=left,                     % where to put the line-numbers
-  numberstyle=\tiny\color{black},   % the style that is used for the line-numbers
-  stepnumber=1,                     % the step between two line-numbers. If it's 1, each line
-                                    % will be numbered
-  numbersep=5pt,                    % how far the line-numbers are from the code
-  %backgroundcolor=\color{white},   % choose the background color. You must add \usepackage{color}
-  showspaces=false,                 % show spaces adding particular underscores
-  showstringspaces=false,           % underline spaces within strings
-  showtabs=false,                   % show tabs within strings adding particular underscores
-  frame=lines,                      % adds a frame around the code
-  %frame=single,                    % adds a frame around the code
-  rulecolor=\color{black},          % if not set, the frame-color may be changed on line-breaks within not-black text (e.g. commens (green here))
-  tabsize=2,                        % sets default tabsize to 2 spaces
-  captionpos=b,                     % sets the caption-position to bottom
-  breaklines=true,                  % sets automatic line breaking
-  breakatwhitespace=false,          % sets if automatic breaks should only happen at whitespace
-  title=\lstname,                   % show the filename of files included with \lstinputlisting;
-                                    % also try caption instead of title
-  keywordstyle=\color{blue},        % keyword style
-  commentstyle=\color{gray},        % comment style
-  stringstyle=\color{black},        % string literal style
-  %backgroundcolor=\color{green!10},
-  escapeinside={\%*}{*)},           % if you want to add a comment within your code
-  extendedchars=\true,
-  %keepspaces = true                %!!!! spaces in comments
-  texcl=true,
-  morekeywords={*,...}              % if you want to add more keywords to the set
-}
-%======================геометрия полей
 \usepackage{geometry}               % page geometry
-\geometry{left=2.0cm}
-\geometry{right=2.0cm}
-\geometry{top=2.0cm}
-\geometry{bottom=1.5cm}
-\parindent=1.0cm                    % first indent in section
-\righthyphenmin=2                   % hyphen last charecter
+%----------------------------------------------------------------------
+\usepackage{listings}               % include code
 %---------------------------------------------------------------------------
 \makeatletter
-\renewcommand{\@biblabel}[1]{#1.}
+\renewcommand{\@biblabel}[1]{#1.} % FIXME? Do not use @ in LaTeX macro names.
 %---------------------------------------------------------------
+%
+\usetikzlibrary{% Libraries for TiKz
+    positioning,
+    arrows,
+    shapes,
+    shadows
+}
+\usepackage{wrapfig}  % Wrapping figures
+\usepackage{enumitem} % custom lists
+
+% Todo package - Inserts a list of shame at the end of the
+% document. This way you can show your readers that you
+% have identified the problem, but don't feel like fixing it at the
+% moment. Use the general FIXME as a invisible comment instead.
+% \usepackage[colorinlistoftodos,textsize=tiny]{todonotes}
+% \setlength{\marginparwidth}{2.0cm} % fix left margin for todo
+
+\usepackage{scrextend}
+\usepackage{enumitem}
+%\usepackage{ifthen}
+%\usepackage{tocvsec2}
+\usepackage[intoc]{nomencl} % glossary package
+\makenomenclature%            make glossary
+\usepackage{makeidx}
+\makeindex
+
+% eso-pic makes it easy to add some picture commands to every page
+% at absolute positions:
+\usepackage{eso-pic}
+% For easier alignment of graphics:
+% \usepackage{subfig}
+
+% The corporate typeface. So far this is the charter, see above. The
+% charter has a pleasant typeface and continuous text is easy to
+% understand. When designing the graphics, the font used there
+% should roughly match. Suggestion: Myriad Pro 11pt,
+% 90% black or a similar neutral but well readable Sans Serif.
 
-% Title page definition
-%\providecommand{\HUGE}{\Huge}% if not using memoir
-\newlength{\drop}% for my convenience
-%% specify the Webomints family
-%\newcommand*{\wb}[1]{\fontsize{#1}{#2}\usefont{U}{webo}{xl}{n}}
-%% select a (FontSite) font by its font family ID
-\newcommand*{\FSfont}[1]{\fontencoding{T1}\fontfamily{#1}\selectfont}
-%% if you don’t have the FontSite fonts either \renewcommand*{\FSfont}[1]{}
-%% or use your own choice of family.
-%% select a (TeX Font) font by its font family ID
-\newcommand*{\TXfont}[1]{\fontencoding{T1}\fontfamily{#1}\selectfont}
-%% Generic publisher’s logo
-\newcommand*{\plogo}{\fbox{$\mathcal{PL}$}}
-%% Some shades
-\definecolor{Dark}{gray}{0.2}
-\definecolor{MedDark}{gray}{0.4}
-\definecolor{Medium}{gray}{0.6}
-\definecolor{Light}{gray}{0.8}
-%%%% Additional font series macros
+% Playground
+% \usepackage[sfdefault]{noto}
+% \usepackage{AlegreyaSans}
+% \usepackage{Alegreya}
+% \usepackage{lmodern}
+% Switch to sans serif (usually these do not contain SC):
+% \renewcommand*\familydefault{\sfdefault}
 
-\newcommand*{\titleLL}{\begingroup% Lost Languages
-\drop=0.1\textheight
-\fboxsep 0.5\baselineskip
-\sffamily
-\vspace*{\drop}
-\centering
-{\textcolor{Dark}{\HUGE Cinelerra-GG Version Infinity}}\par
-\vspace{0.5\drop}
-{\includegraphics[width=0.1\linewidth]{./images/cin-logo}}\par
-\vspace{0.5\drop}
-\colorbox{Dark}{\textcolor{white}{\normalfont\itshape\Large
-User Manual}}\par
-\vspace{0.3\drop}
-{\Large Last update}\\
-{\footnotesize \today}\\
-\url{https://www.cinelerra-gg.org}\par
-\vspace*{\drop}
-{\includegraphics[width=0.5\linewidth]{./images/cin-big.png}}\par
-\endgroup}
+% The necessary package for LaTeX2HTML
+\usepackage{html}
+% html.sty declares its own \hyperref - redefinition hack required
+\renewcommand{\hyperref}[2][]{\hyperrefhyper[#1]{#2}}
 
+%%% Local Variables:
+%%% mode: latex
+%%% TeX-master: "../CinelerraGG_Manual"
+%%% End: