aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorMohammad Akhlaghi <mohammad@akhlaghi.org>2019-11-25 01:38:00 +0000
committerMohammad Akhlaghi <mohammad@akhlaghi.org>2019-11-25 01:38:00 +0000
commit9b5a3ce06dc7957355f7eaedc3b167e800fb24f6 (patch)
tree485cab59d74a311316b7294e18e4c1b2171c1dfa
parent057faf5f817c8745aa5651643385f280fbf40e0f (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.pngbin0 -> 449943 bytes
-rw-r--r--img/reproducible-makefile-highlighted-2.pngbin0 -> 432362 bytes
-rw-r--r--reproducible-paper.tex66
3 files changed, 66 insertions, 0 deletions
diff --git a/img/reproducible-makefile-highlighted-1.png b/img/reproducible-makefile-highlighted-1.png
new file mode 100644
index 0000000..b1e8522
--- /dev/null
+++ b/img/reproducible-makefile-highlighted-1.png
Binary files differ
diff --git a/img/reproducible-makefile-highlighted-2.png b/img/reproducible-makefile-highlighted-2.png
new file mode 100644
index 0000000..79ffdf0
--- /dev/null
+++ b/img/reproducible-makefile-highlighted-2.png
Binary files differ
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}