From 33e00f02d4ecd28ea5084fc553d2ad182a11ca52 Mon Sep 17 00:00:00 2001 From: Mohammad Akhlaghi Date: Wed, 6 Feb 2019 02:45:41 +0000 Subject: Better management for .tex directories to build from tarball In order to collaborate effectively in the project, even project members that don't necessarily want (or have the capacity) to do the whole analysis must be able to contribute to the project. Until now, the users of the distributed tarball could only modify the text and not the figures (built with PGFPlots) of the paper. With this commit, the management of TeX source files in the pipeline was slightly modified to allow this as cleanly as I could think of now! In short, the hand-written TeX files are now kept in `tex/src' and for the pipeline's generated TeX files (in particular the old `tex/pipeline.tex'), we now have a `tex/pipeline' symbolic-link/directory that points to the `tex' directory under the build directory. When packaging the project, `tex/pipeline' will be a full directory with a copy of all the necessary files. Therefore as far as LaTeX is concerned, having a build-directory is no longer relevant. Many other small changes were made to do this job cleanly which will just make this commit message too long! Also, the old `tarball' and `zip' targets are now `dist' and `dist-zip' (as in the standard GNU Build system). --- paper.tex | 20 ++++++++++---------- 1 file changed, 10 insertions(+), 10 deletions(-) (limited to 'paper.tex') diff --git a/paper.tex b/paper.tex index 19c202d..a36b3eb 100644 --- a/paper.tex +++ b/paper.tex @@ -17,12 +17,11 @@ %% Necessary LaTeX preambles to include for relevant functionality. We want %% to start this file as fast as possible with the actual body of the %% paper, while keeping modularity in the preambles. -\input{tex/pipeline.tex} -\input{tex/preamble-style.tex} -\input{tex/preamble-header.tex} -\input{tex/preamble-biblatex.tex} -\input{tex/preamble-pgfplots.tex} -\input{tex/preamble-necessary.tex} +\input{tex/src/preamble-style.tex} +\input{tex/src/preamble-header.tex} +\input{tex/src/preamble-biblatex.tex} +\input{tex/src/preamble-pgfplots.tex} +\input{tex/src/preamble-necessary.tex} @@ -75,10 +74,11 @@ Just don't forget to \emph{never} use numbers or fixed strings (for example database urls like \url{\wfpctwourl}) directly within your \LaTeX{} source. Read them directly from your configuration files or outputs of the programs as part of the reproduction pipeline and import them into \LaTeX{} -as macros through the \texttt{tex/pipeline.tex} file. See the several -examples within the pipeline for a demonstration. For some recent -real-world examples, the reproduction pipelines for Sections 4 and 7.3 of -\citet{bacon17} are available at +as macros through the \texttt{tex/pipeline/macros/pipeline.tex} file +(created after running the pipeline). See the several examples within the +pipeline for a demonstration. For some recent real-world examples, the +reproduction pipelines for Sections 4 and 7.3 of \citet{bacon17} are +available at \href{https://doi.org/10.5281/zenodo.1164774}{zenodo.1164774}\footnote{\url{https://gitlab.com/makhlaghi/muse-udf-origin-only-hst-magnitudes}}, or \href{https://doi.org/10.5281/zenodo.1163746}{zenodo.1163746}\footnote{\url{https://gitlab.com/makhlaghi/muse-udf-photometry-astrometry}}. Working -- cgit v1.2.1