302 lines
9.8 KiB
Python
302 lines
9.8 KiB
Python
# Configuration file for the Sphinx documentation builder.
|
|
#
|
|
# This file only contains a selection of the most common options. For a full
|
|
# list see the documentation:
|
|
# https://www.sphinx-doc.org/en/master/usage/configuration.html
|
|
|
|
# -- Path setup --------------------------------------------------------------
|
|
|
|
# If extensions (or modules to document with autodoc) are in another directory,
|
|
# add these directories to sys.path here. If the directory is relative to the
|
|
# documentation root, use os.path.abspath to make it absolute, like shown here.
|
|
#
|
|
import os
|
|
import sys
|
|
sys.path.insert(0, os.path.abspath(''))
|
|
|
|
|
|
# -- Project information -----------------------------------------------------
|
|
|
|
project = 'SNP Labs'
|
|
copyright = '2022, stsh'
|
|
author = 'stsh'
|
|
master_doc = 'index'
|
|
|
|
# The full version, including alpha/beta/rc tags
|
|
release = ''
|
|
|
|
#LaTex
|
|
|
|
|
|
|
|
|
|
# -- General configuration ---------------------------------------------------
|
|
|
|
# Add any Sphinx extension module names here, as strings. They can be
|
|
# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
|
|
# ones.
|
|
extensions = [
|
|
'myst_parser', # pip install myst-parser
|
|
'sphinx.ext.duration',
|
|
'sphinx.ext.doctest',
|
|
'sphinx.ext.autodoc',
|
|
'sphinx.ext.autosummary',
|
|
#'sphinxcontrib.mermaid',# pip install sphinxcontrib-mermaid
|
|
'sphinx.ext.intersphinx',
|
|
'sphinx.ext.todo',
|
|
'sphinx.ext.coverage',
|
|
'sphinx.ext.mathjax',
|
|
'sphinx.ext.ifconfig',
|
|
'sphinx.ext.viewcode',
|
|
'sphinx.ext.githubpages'
|
|
]
|
|
|
|
myst_enable_extensions = [
|
|
"amsmath",
|
|
"colon_fence",
|
|
"deflist",
|
|
"dollarmath",
|
|
"fieldlist",
|
|
"html_admonition",
|
|
"html_image",
|
|
"linkify",
|
|
"replacements",
|
|
"smartquotes",
|
|
"strikethrough",
|
|
"substitution",
|
|
"tasklist",
|
|
]
|
|
|
|
# -- Options for LaTeX output ---------------------------------------------
|
|
latex_engine = 'pdflatex'
|
|
|
|
latex_elements = {
|
|
# The paper size ('letterpaper' or 'a4paper').
|
|
#
|
|
'papersize': 'a4paper',
|
|
'releasename':" ",
|
|
# Sonny, Lenny, Glenn, Conny, Rejne, Bjarne and Bjornstrup
|
|
# 'fncychap': '\\usepackage[Lenny]{fncychap}',
|
|
'fncychap': '\\usepackage{fncychap}',
|
|
'fontpkg': '\\usepackage{amsmath,amsfonts,amssymb,amsthm}',
|
|
'figure_align':'htbp',
|
|
# The font size ('10pt', '11pt' or '12pt').
|
|
#
|
|
'pointsize': '10pt',
|
|
# Additional stuff for the LaTeX preamble.
|
|
#
|
|
'preamble': r'''
|
|
%% %% %% %% %% %% %% %% %% %% Meher %% %% %% %% %% %% %% %% %%
|
|
%% %add number to subsubsection 2=subsection, 3=subsubsection
|
|
%% % below subsubsection is not good idea.
|
|
\setcounter{secnumdepth}{3}
|
|
%
|
|
%% %% Table of content upto 2=subsection, 3=subsubsection
|
|
\setcounter{tocdepth}{2}
|
|
\usepackage{amsmath,amsfonts,amssymb,amsthm}
|
|
\usepackage{graphicx}
|
|
%% % r educe spaces for Table of contents, figures and tables
|
|
%% % i t is used "\addtocontents{toc}{\vskip -1.2cm}" etc. in the document
|
|
\usepackage[notlot,nottoc,notlof]{}
|
|
\usepackage{color}
|
|
\usepackage{transparent}
|
|
\usepackage{eso-pic}
|
|
\usepackage{lipsum}
|
|
\usepackage{lmodern}
|
|
\usepackage{footnotebackref} %% link at the footnote to go to the place of footnote in the text
|
|
%% spacing between line
|
|
\usepackage{setspace}
|
|
%% %% \onehalfspacing
|
|
%% %% \doublespacing
|
|
\singlespacing
|
|
%% %% %% %% %% % d atetime
|
|
\usepackage{datetime}
|
|
\newdateformat{MonthYearFormat}{%
|
|
\monthname[\THEMONTH], \THEYEAR}
|
|
%% RO, LE will not work for 'oneside' layout.
|
|
%% Change oneside to twoside in document class
|
|
\usepackage{fancyhdr}
|
|
\pagestyle{fancy}
|
|
\fancyhf{}
|
|
%% % Alternating Header for oneside
|
|
\fancyhead[L]{\ifthenelse{\isodd{\value{page}}}{ \small \nouppercase{\leftmark} }{}}
|
|
\fancyhead[R]{\ifthenelse{\isodd{\value{page}}}{}{ \small \nouppercase{\rightmark} }}
|
|
%% % Alternating Header for two side
|
|
%\fancyhead[RO]{\small \nouppercase{\rightmark}}
|
|
%\fancyhead[LE]{\small \nouppercase{\leftmark}}
|
|
%% for oneside: change footer at right side. If you want to use Left and right then use same as header defined above.
|
|
%% %\fancyfoot[R]{\ifthenelse{\isodd{\value{page}}}{{\tiny } }{\href{http://pythondsp.readthedocs.io/en/latest/pythondsp/toc.html}{\tiny PythonDSP}}}
|
|
%% % Alternating Footer for two side
|
|
%\fancyfoot[RO, RE]{\scriptsize ()}
|
|
%% % page number
|
|
\fancyfoot[CO, CE]{\thepage}
|
|
\renewcommand{\headrulewidth}{0.5pt}
|
|
\renewcommand{\footrulewidth}{0.5pt}
|
|
|
|
\RequirePackage{tocbibind} %% % c omment this to remove page number for following
|
|
\addto\captionsenglish{\renewcommand{\contentsname}{Table of contents}}
|
|
\addto\captionsenglish{\renewcommand{\listfigurename}{List of figures}}
|
|
\addto\captionsenglish{\renewcommand{\listtablename}{List of tables}}
|
|
% \addto\captionsenglish{\renewcommand{\chaptername}{Chapter}}
|
|
%% reduce spacing for itemize
|
|
\usepackage{enumitem}
|
|
\setlist{nosep}
|
|
%% %% %% %% %% % Quote Styles at the top of chapter
|
|
\usepackage{epigraph}
|
|
\setlength{\epigraphwidth}{0.8\columnwidth}
|
|
\newcommand{\chapterquote}[2]{\epigraphhead[60]{\epigraph{\textit{#1}}{\textbf {\textit{--#2}}}}}
|
|
%% %% %% %% %% % Quote for all places except Chapter
|
|
\newcommand{\sectionquote}[2]{{\quote{\textit{``#1''}}{\textbf {\textit{--#2}}}}}
|
|
''',
|
|
|
|
'maketitle': r'''
|
|
\pagenumbering{Roman} %% % to avoid page 1 conflict with actual page 1
|
|
\begin{titlepage}
|
|
\centering
|
|
\vspace*{40mm} %% % * is used to give space from top
|
|
\textbf{\Huge {SNP Laboratories}}
|
|
\vspace{0mm}
|
|
\begin{figure}[!h]
|
|
\centering
|
|
\includegraphics[scale=0.5]{en-zhaw-ines-rgb.png}
|
|
\end{figure}
|
|
\begin{figure}[!h]
|
|
\centering
|
|
\textbf{ welo, bazz, fisa, huno, grop, donn, scia }
|
|
\end{figure}
|
|
\vspace*{20mm}
|
|
\vspace{20mm}
|
|
|
|
\vspace*{0mm}
|
|
\small Last updated : \MonthYearFormat\today
|
|
%% \vfill adds at the bottom
|
|
\vfill
|
|
\small \textit{More documents are available at }{\href{https://github.zhaw.ch/SNP/snp-lab-code}{github.zhaw.ch}}
|
|
\end{titlepage}
|
|
\clearpage
|
|
\pagenumbering{roman}
|
|
\tableofcontents
|
|
%% %\listoffigures
|
|
%% %\listoftables
|
|
\clearpage
|
|
\pagenumbering{arabic}
|
|
''',
|
|
|
|
|
|
# Latex figure (float) alignment
|
|
#
|
|
# 'figure_align': 'htbp',
|
|
'sphinxsetup': \
|
|
'hmargin={0.7in,0.7in}, vmargin={1in,1in}, \
|
|
verbatimwithframe=true, \
|
|
TitleColor={rgb}{0,0,0}, \
|
|
HeaderFamily=\\rmfamily\\bfseries, \
|
|
InnerLinkColor={rgb}{0,0,1}, \
|
|
OuterLinkColor={rgb}{0,0,1}',
|
|
'tableofcontents':' ',
|
|
}
|
|
|
|
latex_logo = 'en-zhaw-ines-rgb.png'
|
|
# Grouping the document tree into LaTeX files. List of tuples
|
|
# (source start file, target name, title,
|
|
# author, documentclass [howto, manual, or own class]).
|
|
latex_documents = [
|
|
(master_doc, 'main.tex', 'SNP Laboratories',
|
|
'', 'report')
|
|
]
|
|
|
|
|
|
# ---------------------------------------------------
|
|
|
|
# Add any paths that contain templates here, relative to this directory.
|
|
templates_path = ['templates']
|
|
|
|
# List of patterns, relative to source directory, that match files and
|
|
# directories to ignore when looking for source files.
|
|
# This pattern also affects html_static_path and html_extra_path.
|
|
exclude_patterns = []
|
|
|
|
source_suffix = {
|
|
'.rst': 'restructuredtext',
|
|
'.md': 'markdown',
|
|
}
|
|
|
|
# If true, `todo` and `todoList` produce output, else they produce nothing.
|
|
todo_include_todos = True
|
|
|
|
# There are two options for replacing |today|: either, you set today to some
|
|
# non-false value, then it is used:
|
|
#
|
|
# today = ''
|
|
#
|
|
# Else, today_fmt is used as the format for a strftime call.
|
|
#
|
|
# today_fmt = '%B %d, %Y'
|
|
|
|
# List of patterns, relative to source directory, that match files and
|
|
# directories to ignore when looking for source files.
|
|
# These patterns also affect html_static_path and html_extra_path
|
|
exclude_patterns = ['_build', 'Thumbs.db', '.DS_Store']
|
|
|
|
# The reST default role (used for this markup: `text`) to use for all
|
|
# documents.
|
|
#
|
|
# default_role = None
|
|
|
|
# If true, '()' will be appended to :func: etc. cross-reference text.
|
|
#
|
|
# add_function_parentheses = True
|
|
|
|
# If true, the current module name will be prepended to all description
|
|
# unit titles (such as .. function::).
|
|
#
|
|
# add_module_names = True
|
|
|
|
# If true, sectionauthor and moduleauthor directives will be shown in the
|
|
# output. They are ignored by default.
|
|
#
|
|
# show_authors = False
|
|
|
|
# The name of the Pygments (syntax highlighting) style to use.
|
|
pygments_style = 'sphinx'
|
|
|
|
# A list of ignored prefixes for module index sorting.
|
|
# modindex_common_prefix = []
|
|
|
|
# If true, keep warnings as "system message" paragraphs in the built documents.
|
|
# keep_warnings = False
|
|
|
|
# If true, `todo` and `todoList` produce output, else they produce nothing.
|
|
todo_include_todos = False
|
|
|
|
highlight_options = {
|
|
'default': {'stripall': True},
|
|
'php': {'startinline': True},
|
|
}
|
|
|
|
# -- Options for HTML output -------------------------------------------------
|
|
|
|
# The theme to use for HTML and HTML Help pages. See the documentation for
|
|
# a list of builtin themes.
|
|
#
|
|
html_theme = 'alabaster'
|
|
html_theme_path = ['_static']
|
|
|
|
# Add any paths that contain custom static files (such as style sheets) here,
|
|
# relative to this directory. They are copied after the builtin static files,
|
|
# so a file named "default.css" will overwrite the builtin "default.css".
|
|
html_static_path = ['_static']
|
|
|
|
html_theme_options = {
|
|
'logo': 'logo.png',
|
|
'logo_name' : 'true',
|
|
}
|
|
|
|
language = "en"
|
|
myst_html_meta = {
|
|
"description lang=en": "metadata description",
|
|
"description lang=fr": "description des métadonnées",
|
|
"keywords": "Sphinx, MyST",
|
|
"property=og:locale": "en_US"
|
|
}
|