@@ -20,7 +20,7 @@ You need to opt-in to use the [EasyBuild modules](https://wiki.ufz.de/eve/index.
- Run `touch ~/.easybuild-yes`
- `exit` and re-login
Also on eve the installed git module (2.10) is over 2 years old and we recommend using a newer module (especially when you have problems with fetching or checking out of Git LFS files):
Also on eve the installed git module (2.10) is over 2 years old and we recommend using a newer module:
@@ -90,7 +90,7 @@ Equations can be set with typical LaTeX syntax by using [MathJax](https://www.ma
#### Files and Downloads
Files belonging directly to a page (e.g. images shown on that same page) should be added directly (they are stored by git lfs). Other stuff such as linked PDF files, book chapter input files should be uploaded elsewhere and linked to. You can ask @bilke to host these files for you (on Azure cloud storage).
Files belonging directly to a page (e.g. images shown on that same page) should be added directly. Other stuff such as linked PDF files, book chapter input files should be uploaded elsewhere and linked to. You can ask @bilke to host these files for you (on Azure cloud storage).
[Git LFS](https://git-lfs.github.com/) (large file storage) is a git extension dealing with large binary files such as images and is used for the documentation. You don't need to worry about anything but you need to install the extension as it is not a part of standard git.
::: {.win}
- Git LFS is already part of your regular git installation, to enable it run: `git lfs install` in the command line
:::
::: {.linux}
Install via [PackageCloud](https://packagecloud.io/):
### <i class="far fa-info-circle"></i> Git LFS installation without admin rights
If you do not have rights to install a system package (e.g. on cluster systems) you can [download](https://github.com/git-lfs/git-lfs/releases/latest) a precompiled `git-lfs` executable. Simply put it into your `PATH` and everything should work (remember to run `git lfs install` once!). See also: <https://github.com/git-lfs/git-lfs/wiki/Installation#other>
@@ -31,12 +31,11 @@ The functionality is very flexible and more wrappers and checker can be added la
## Test Data
Test data is stored with git lfs in `Tests/Data`. Generated test output files should be found in `[build-dir]/Tests/Data`.
Test data is stored in `Tests/Data`. Generated test output files should be found in `[build-dir]/Tests/Data`.
In the OGS-cli outputting to `[build-dir]/Tests/Data` is already handled (via the `-o` parameter). For other executables you have to implement this, e.g. a with parameter specifying the output directory.
In code `BaseLib::BuildInfo::data_path` (from `BuildInfo.h`) references the data source directory and `BaseLib::BuildInfo::data_binary_path` references the data output directory.
For adding new data files make sure you have [setup git lfs](../../getting-started/prerequisites) already. Then simply commit the new files as usual.
For adding new data files simply commit the new files as usual.
Check this [in-depth tutorial](https://www.atlassian.com/git/tutorials/git-lfs) to learn more about git lfs.