diff options
author | Mohammad Akhlaghi <mohammad@akhlaghi.org> | 2019-11-25 01:38:00 +0000 |
---|---|---|
committer | Mohammad Akhlaghi <mohammad@akhlaghi.org> | 2019-11-25 01:38:00 +0000 |
commit | 9b5a3ce06dc7957355f7eaedc3b167e800fb24f6 (patch) | |
tree | 485cab59d74a311316b7294e18e4c1b2171c1dfa /reproducible-paper.tex | |
parent | 057faf5f817c8745aa5651643385f280fbf40e0f (diff) |
Added highted text to show relation between files
Some arrows and text were added over the shown Makefile to better help
the eye when the viewers aren't familiar with Make.
Diffstat (limited to 'reproducible-paper.tex')
-rw-r--r-- | reproducible-paper.tex | 66 |
1 files changed, 66 insertions, 0 deletions
diff --git a/reproducible-paper.tex b/reproducible-paper.tex index 1e33af3..9543f6e 100644 --- a/reproducible-paper.tex +++ b/reproducible-paper.tex @@ -812,6 +812,72 @@ \includegraphics[width=\linewidth]{img/reproducible-makefile.png} \end{columns} \end{frame} + \begin{frame}{Reproducible science: Template is managed through a Makefile} + \small + \begin{columns} + \column{10cm} + + All steps (downloading and analysis) are managed by Makefiles\\ + (example from + \textcolor{blue}{\small\href{https://doi.org/10.5281/zenodo.1164774}{zenodo.1164774}}): + + \vspace{5mm} + \begin{itemize} + \setlength\itemsep{0.7cm} + \item Unlike a script which always starts from the top, a + Makefile \alert{starts from the end} and steps that don't + change will be left untouched (not remade). + \item A single \emph{rule} can \alert{manage any number of + files}. + \item Make can identify independent steps internally and do them + in \alert{parallel}. + \item Make was \alert{designed for complex projects} with + thousands of files (all major Unix-like components), so it is + highly evolved and efficient. + \item Make is a very \alert{simple} and \alert{small} language, + thus easy to learn with great and free documentation (for + example + \textcolor{blue}{\href{https://www.gnu.org/software/make/manual/}{GNU + Make's manual}}). + \end{itemize} + + \column{5cm} + \includegraphics[width=\linewidth]{img/reproducible-makefile-highlighted-1.png} + \end{columns} + \end{frame} + \begin{frame}{Reproducible science: Template is managed through a Makefile} + \small + \begin{columns} + \column{10cm} + + All steps (downloading and analysis) are managed by Makefiles\\ + (example from + \textcolor{blue}{\small\href{https://doi.org/10.5281/zenodo.1164774}{zenodo.1164774}}): + + \vspace{5mm} + \begin{itemize} + \setlength\itemsep{0.7cm} + \item Unlike a script which always starts from the top, a + Makefile \alert{starts from the end} and steps that don't + change will be left untouched (not remade). + \item A single \emph{rule} can \alert{manage any number of + files}. + \item Make can identify independent steps internally and do them + in \alert{parallel}. + \item Make was \alert{designed for complex projects} with + thousands of files (all major Unix-like components), so it is + highly evolved and efficient. + \item Make is a very \alert{simple} and \alert{small} language, + thus easy to learn with great and free documentation (for + example + \textcolor{blue}{\href{https://www.gnu.org/software/make/manual/}{GNU + Make's manual}}). + \end{itemize} + + \column{5cm} + \includegraphics[width=\linewidth]{img/reproducible-makefile-highlighted-2.png} + \end{columns} + \end{frame} |