diff options
author | Mohammad Akhlaghi <mohammad@akhlaghi.org> | 2020-04-02 04:06:03 +0100 |
---|---|---|
committer | Mohammad Akhlaghi <mohammad@akhlaghi.org> | 2020-04-02 04:06:03 +0100 |
commit | 646756675566a0907edf143c6b6950e0479d9e7e (patch) | |
tree | 6c2b1ae8ccb6888be0a48d31f314f8f9ac2d46f0 /tex | |
parent | 88367bc78c5e253fd5d03c4e30251f3b40d4c48e (diff) |
Rewrote abstract, better organization in publishing section
I hadn't updated the abstract since first writing it. With this commit, it
has been updated to be more precise and generically interesting, focusing
more on the principles and usability. I also greatly improved the section
on publishing the workflow.
Diffstat (limited to 'tex')
-rw-r--r-- | tex/README.md | 59 |
1 files changed, 59 insertions, 0 deletions
diff --git a/tex/README.md b/tex/README.md new file mode 100644 index 0000000..0f2f0d6 --- /dev/null +++ b/tex/README.md @@ -0,0 +1,59 @@ +Directory containing LaTeX-related files +---------------------------------------- + +Copyright (C) 2018-2020 Mohammad Akhlaghi <mohammad@akhlaghi.org>\ +See the end of the file for license conditions. + +This directory contains directories to various components the LaTeX part of +the project. In a running project, it will contain the atleast the +following sub-directories. Note that + +- The `src/` directory contains the LaTeX files that are loaded into + `paper.tex`. This includes the necessary preambles, the LaTeX source + files to build tables or figures (for example with TiKZ or PGFPlots), and + etc. These files are under version-control and an integral part of the + project's source. + +- The `build/` directory contains all the built products (not source!) that + are created during the analysis and are necessary for building the + paper. This includes figures, plots, images, table source contents and + etc. Note that this directory is not under version control. + +- The `tikz/` directory is only relevant if some of the project's figures + are built with the LaTeX packages of TiKZ or PGFPlots. It points to the + directory containing the figures (in PDF) that were built by these tools. + Note that this directory is not under version control. + +The latter two directory and its contents are not under version control, so +if you have just cloned the project or are viewing its contents on a +browser, they don't exist. They will be created after the project is +configured for the running system. + +When the full project is build from scratch (building the software, +downloading necessary datasets, running the analysis and building the +paper's PDF), the latter two directories will be symbolic links to special +places under the Build directory. + +However, when the distributed tarball is used to only build the PDF paper +(without doing any analysis), the latter two directories will not be +symbolic links and will contain the necessary components for the paper to +be built. + + + + + +### Copyright information + +This project is free software: you can redistribute it and/or modify it +under the terms of the GNU General Public License as published by the Free +Software Foundation, either version 3 of the License, or (at your option) +any later version. + +This project is distributed in the hope that it will be useful, but WITHOUT +ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or +FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for +more details. + +You should have received a copy of the GNU General Public License along +with this project. If not, see <https://www.gnu.org/licenses/>.
\ No newline at end of file |