Generate LaTeX documentation using dvipdfmx.

* Change: In documentation UserGuide, under RHEL7 documents generated
    with pdflatex tends to make evince core-dump while trying to print.
    So use latex+dvipdfm instead. Images then needs to be pdf with an
    auxiliary .bb file (the BoundingBox line extracted from the .eps).
This commit is contained in:
Jean-Paul Chaput 2015-04-05 23:43:01 +02:00
parent c7e4123662
commit 014e5eb538
55 changed files with 2632 additions and 26 deletions

View File

@ -8,7 +8,7 @@
add_custom_target ( doc_LaTeX ALL add_custom_target ( doc_LaTeX ALL
cd ${DOCUMENTATION_SOURCE_DIR}/UsersGuide cd ${DOCUMENTATION_SOURCE_DIR}/UsersGuide
&& rst2latex --use-latex-toc --stylesheet=./socstyle.tex UsersGuide_LaTeX.rst UsersGuide-raw.tex && rst2latex --use-latex-toc --graphicx-option=dvipdfm --stylesheet=./socstyle.tex UsersGuide_LaTeX.rst UsersGuide-raw.tex
&& sed 's, \\& \\\\multicolumn{2}{l|}{, \\& \\\\multicolumn{2}{p{0.6\\\\DUtablewidth}|}{,' UsersGuide-raw.tex > UsersGuide.tex ) && sed 's, \\& \\\\multicolumn{2}{l|}{, \\& \\\\multicolumn{2}{p{0.6\\\\DUtablewidth}|}{,' UsersGuide-raw.tex > UsersGuide.tex )
install ( DIRECTORY images/ install ( DIRECTORY images/
@ -21,7 +21,8 @@
install ( DIRECTORY images/ install ( DIRECTORY images/
DESTINATION ${latexInstallDir}/images DESTINATION ${latexInstallDir}/images
FILES_MATCHING PATTERN "*.pdf" FILES_MATCHING PATTERN "*.pdf"
PATTERN "*.eps" ) PATTERN "*.eps"
PATTERN "*.bb" )
install ( FILES socstyle.tex install ( FILES socstyle.tex
UsersGuide.tex DESTINATION ${latexInstallDir} ) UsersGuide.tex DESTINATION ${latexInstallDir} )

View File

@ -22,23 +22,23 @@
.. |menu_KiteFinalizeRoute| replace:: :raw-latex:`\fbox{\textsf{\textbf{{\underline{F}inalize Route}}}}` .. |menu_KiteFinalizeRoute| replace:: :raw-latex:`\fbox{\textsf{\textbf{{\underline{F}inalize Route}}}}`
.. Stand-alone images. .. Stand-alone images.
.. |ViewerSnapshot_1| replace:: :raw-latex:`\begin{center}\fbox{\includegraphics[width=.7\textwidth]{./images/Viewer-1.eps}}\end{center}` .. |ViewerSnapshot_1| replace:: :raw-latex:`\begin{center}\fbox{\includegraphics[width=.7\textwidth]{./images/Viewer-1.pdf}}\end{center}`
.. |ControllerSnapshot_1| replace:: :raw-latex:`\begin{center}\includegraphics[width=.7\textwidth]{./images/Controller-1.eps}\end{center}` .. |ControllerSnapshot_1| replace:: :raw-latex:`\begin{center}\includegraphics[width=.7\textwidth]{./images/Controller-1.pdf}\end{center}`
.. |ControllerLook_1| replace:: :raw-latex:`\begin{center}\includegraphics[width=.7\textwidth]{./images/Controller-Look-1.eps}\end{center}` .. |ControllerLook_1| replace:: :raw-latex:`\begin{center}\includegraphics[width=.7\textwidth]{./images/Controller-Look-1.pdf}\end{center}`
.. |ControllerFilter_1| replace:: :raw-latex:`\begin{center}\includegraphics[width=.7\textwidth]{./images/Controller-Filter-1.eps}\end{center}` .. |ControllerFilter_1| replace:: :raw-latex:`\begin{center}\includegraphics[width=.7\textwidth]{./images/Controller-Filter-1.pdf}\end{center}`
.. |ControllerLayersGos_1| replace:: :raw-latex:`\begin{center}\includegraphics[width=.7\textwidth]{./images/Controller-LayersGos-1.eps}\end{center}` .. |ControllerLayersGos_1| replace:: :raw-latex:`\begin{center}\includegraphics[width=.7\textwidth]{./images/Controller-LayersGos-1.pdf}\end{center}`
.. |ControllerNetlist_1| replace:: :raw-latex:`\begin{center}\includegraphics[width=.7\textwidth]{./images/Controller-Netlist-1.eps}\end{center}` .. |ControllerNetlist_1| replace:: :raw-latex:`\begin{center}\includegraphics[width=.7\textwidth]{./images/Controller-Netlist-1.pdf}\end{center}`
.. |ViewerNetlist_1| replace:: :raw-latex:`\begin{center}\includegraphics[width=.7\textwidth]{./images/Viewer-Netlist-1.eps}\end{center}` .. |ViewerNetlist_1| replace:: :raw-latex:`\begin{center}\includegraphics[width=.7\textwidth]{./images/Viewer-Netlist-1.pdf}\end{center}`
.. |ControllerSelection_1| replace:: :raw-latex:`\begin{center}\includegraphics[width=.7\textwidth]{./images/Controller-Selection-1.eps}\end{center}` .. |ControllerSelection_1| replace:: :raw-latex:`\begin{center}\includegraphics[width=.7\textwidth]{./images/Controller-Selection-1.pdf}\end{center}`
.. |ControllerInspector_1| replace:: :raw-latex:`\begin{center}\includegraphics[width=.7\textwidth]{./images/Controller-Inspector-1.eps}\end{center}` .. |ControllerInspector_1| replace:: :raw-latex:`\begin{center}\includegraphics[width=.7\textwidth]{./images/Controller-Inspector-1.pdf}\end{center}`
.. |ControllerInspector_2| replace:: :raw-latex:`\begin{center}\includegraphics[width=.7\textwidth]{./images/Controller-Inspector-2.eps}\end{center}` .. |ControllerInspector_2| replace:: :raw-latex:`\begin{center}\includegraphics[width=.7\textwidth]{./images/Controller-Inspector-2.pdf}\end{center}`
.. |ControllerInspector_3| replace:: :raw-latex:`\begin{center}\includegraphics[width=.7\textwidth]{./images/Controller-Inspector-3.eps}\end{center}` .. |ControllerInspector_3| replace:: :raw-latex:`\begin{center}\includegraphics[width=.7\textwidth]{./images/Controller-Inspector-3.pdf}\end{center}`
.. |ControllerSettings_1| replace:: :raw-latex:`\begin{center}\includegraphics[width=.7\textwidth]{./images/Controller-Settings-1.eps}\end{center}` .. |ControllerSettings_1| replace:: :raw-latex:`\begin{center}\includegraphics[width=.7\textwidth]{./images/Controller-Settings-1.pdf}\end{center}`
.. |CoriolisSoftSchema| replace:: :raw-latex:`\begin{center}\includegraphics[width=.7\textwidth]{./images/Coriolis-Soft-Schema.eps}\end{center}` .. |CoriolisSoftSchema| replace:: :raw-latex:`\begin{center}\includegraphics[width=.7\textwidth]{./images/Coriolis-Soft-Schema.pdf}\end{center}`
.. |ChipStructure-1| replace:: :raw-latex:`\begin{center}\includegraphics[width=.95\textwidth]{./images/chip-structure-1.eps}\end{center}` .. |ChipStructure-1| replace:: :raw-latex:`\begin{center}\includegraphics[width=.95\textwidth]{./images/chip-structure-1.pdf}\end{center}`
.. |Etesian-1| replace:: :raw-latex:`\begin{center}\includegraphics[width=.95\textwidth]{./images/etesian-1.eps}\end{center}` .. |Etesian-1| replace:: :raw-latex:`\begin{center}\includegraphics[width=.95\textwidth]{./images/etesian-1.pdf}\end{center}`
.. |BigMouse| image:: ./images/ComputerMouse.eps .. |BigMouse| image:: ./images/ComputerMouse.pdf
:scale: 25% :scale: 25%
.. Direct LaTeX commands encapsulation. .. Direct LaTeX commands encapsulation.

View File

@ -217,7 +217,7 @@ Credits & License
\begin{center}\begin{minipage}[t]{.8\textwidth} \begin{center}\begin{minipage}[t]{.8\textwidth}
\noindent\DUrole{sc}{Hurricane} \dotfill Rémy \DUrole{sc}{Escassut} \& \noindent\DUrole{sc}{Hurricane} \dotfill Rémy \DUrole{sc}{Escassut} \&
Christian \DUrole{Masson} \\ Christian \DUrole{sc}{Masson} \\
\noindent\DUrole{sc}{Etesian} \dotfill Gabriel \DUrole{sc}{Gouvine} \\ \noindent\DUrole{sc}{Etesian} \dotfill Gabriel \DUrole{sc}{Gouvine} \\
\noindent\DUrole{sc}{Stratus} \dotfill Sophie \DUrole{sc}{Belloeil} \\ \noindent\DUrole{sc}{Stratus} \dotfill Sophie \DUrole{sc}{Belloeil} \\
\noindent\DUrole{sc}{Knik} \dotfill Damien \DUrole{sc}{Dupuis} \\ \noindent\DUrole{sc}{Knik} \dotfill Damien \DUrole{sc}{Dupuis} \\
@ -325,10 +325,11 @@ Release v2.0.1
#. The multiples user defined configuration files are now grouped under #. The multiples user defined configuration files are now grouped under
a common hidden (dot) directory ``.coriolis2`` and the file extension a common hidden (dot) directory ``.coriolis2`` and the file extension
is back from ``.conf`` to ``.py``. is back from ``.conf`` to ``.py``.
#. Under |RHEL7| / |SL7|, there is a known bug in the graphical visualizer.
When shifting to the left, the right-half part of the screen gets .. #. Under |RHEL7| / |SL7|, there is a known bug in the graphical visualizer.
badly redrawn. Uses |CTRL_L| to refresh. It will be corrected as soon .. When shifting to the left, the right-half part of the screen gets
as possible. .. badly redrawn. Uses |CTRL_L| to refresh. It will be corrected as soon
.. as possible.

View File

@ -0,0 +1 @@
%%BoundingBox: 0 0 135 135

Binary file not shown.

View File

@ -0,0 +1 @@
%%BoundingBox: 0 0 451 434

File diff suppressed because one or more lines are too long

View File

@ -0,0 +1 @@
%%BoundingBox: 0 0 451 434

File diff suppressed because one or more lines are too long

View File

@ -0,0 +1 @@
%%BoundingBox: 0 0 451 434

File diff suppressed because one or more lines are too long

View File

@ -0,0 +1 @@
%%BoundingBox: 0 0 451 434

File diff suppressed because one or more lines are too long

View File

@ -0,0 +1 @@
%%BoundingBox: 0 0 454 436

File diff suppressed because one or more lines are too long

View File

@ -0,0 +1 @@
%%BoundingBox: 0 0 451 434

File diff suppressed because one or more lines are too long

View File

@ -0,0 +1 @@
%%BoundingBox: 0 0 451 434

File diff suppressed because one or more lines are too long

View File

@ -0,0 +1 @@
%%BoundingBox: 0 0 451 434

File diff suppressed because one or more lines are too long

View File

@ -0,0 +1 @@
%%BoundingBox: 0 0 451 434

File diff suppressed because one or more lines are too long

View File

@ -0,0 +1 @@
%%BoundingBox: 0 0 451 434

File diff suppressed because one or more lines are too long

View File

@ -0,0 +1 @@
%%BoundingBox: 0 0 433 420

View File

@ -0,0 +1 @@
%%BoundingBox: 0 0 200 20

View File

@ -0,0 +1 @@
%%BoundingBox: 0 0 301 351

File diff suppressed because one or more lines are too long

View File

@ -0,0 +1 @@
%%BoundingBox: 0 0 587 573

File diff suppressed because one or more lines are too long

View File

@ -0,0 +1 @@
%%BoundingBox: 0 0 1018 438

Binary file not shown.

View File

@ -0,0 +1 @@
%%BoundingBox: 0 0 48 48

Binary file not shown.

View File

@ -0,0 +1 @@
%%BoundingBox: 0 0 507 267

Binary file not shown.

View File

@ -0,0 +1 @@
%%BoundingBox: 0 0 48 48

Binary file not shown.

View File

@ -2,13 +2,15 @@
\usepackage[default,osfigures,scale=0.95]{opensans} \usepackage[default,osfigures,scale=0.95]{opensans}
\usepackage{xspace} \usepackage{xspace}
\usepackage{fancyhdr} \usepackage{fancyhdr}
\usepackage{graphicx} \usepackage[dvipdfm]{graphicx}
\usepackage{enumitem} \usepackage{enumitem}
\usepackage[sf,bf]{titlesec} \usepackage[sf,bf]{titlesec}
\usepackage{titletoc} \usepackage{titletoc}
\usepackage[colorlinks=true,linkcolor=blue,urlcolor=blue,dvipdfm]{hyperref}
\usepackage[paper=a4paper,headheight=30pt,tmargin=1.5in,bmargin=1in]{geometry} \usepackage[paper=a4paper,headheight=30pt,tmargin=1.5in,bmargin=1in]{geometry}
%\usepackage{layouts} %\usepackage{layouts}
\urlstyle{tt} % normal text font (alternatives: same, tt, rm, sf)
\renewlist{itemize}{itemize}{9} \renewlist{itemize}{itemize}{9}
\setlist[itemize]{label=\textbullet} \setlist[itemize]{label=\textbullet}
@ -49,7 +51,7 @@
\begin{center} \begin{center}
\sffamily \sffamily
\begin{array}[t]{m{1cm}!{\vrule width 1pt}m{.90\textwidth}} \begin{array}[t]{m{1cm}!{\vrule width 1pt}m{.90\textwidth}}
\raisebox{0.0cm}{\includegraphics[scale=0.5]{./images/clipboard.eps}} & \raisebox{0.0cm}{\includegraphics[scale=0.5,natwidth=48,natheight=48]{./images/clipboard.pdf}} &
\begin{minipage}[t]{.85\textwidth} #1 \begin{minipage}[t]{.85\textwidth} #1
\end{minipage} \\ \end{minipage} \\
\end{array} \end{array}
@ -62,7 +64,7 @@
\begin{center} \begin{center}
\sffamily \sffamily
\begin{array}[t]{m{1cm}!{\vrule width 1pt}m{.90\textwidth}} \begin{array}[t]{m{1cm}!{\vrule width 1pt}m{.90\textwidth}}
\raisebox{0.0cm}{\includegraphics[scale=0.5]{./images/i-core.eps}} & \raisebox{0.0cm}{\includegraphics[scale=0.5,natwidth=48,natheight=48]{./images/i-core.pdf}} &
\begin{minipage}[t]{.85\textwidth} #1 \begin{minipage}[t]{.85\textwidth} #1
\end{minipage} \\ \end{minipage} \\
\end{array} \end{array}