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 | |
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.
-rw-r--r-- | img/reproducible-makefile-highlighted-1.png | bin | 0 -> 449943 bytes | |||
-rw-r--r-- | img/reproducible-makefile-highlighted-2.png | bin | 0 -> 432362 bytes | |||
-rw-r--r-- | reproducible-paper.tex | 66 |
3 files changed, 66 insertions, 0 deletions
diff --git a/img/reproducible-makefile-highlighted-1.png b/img/reproducible-makefile-highlighted-1.png Binary files differnew file mode 100644 index 0000000..b1e8522 --- /dev/null +++ b/img/reproducible-makefile-highlighted-1.png diff --git a/img/reproducible-makefile-highlighted-2.png b/img/reproducible-makefile-highlighted-2.png Binary files differnew file mode 100644 index 0000000..79ffdf0 --- /dev/null +++ b/img/reproducible-makefile-highlighted-2.png 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} |