Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add instructions for browsing using LFS cloning #223

Merged
merged 2 commits into from
Nov 14, 2024

Conversation

bertvandepoel
Copy link
Contributor

Based on #222 there was a need for this. Not sure if the "git lfs clone" is the best option, or if it would be better to just go for a "one time git lfs install", so feedback is very welcome!

README.md Outdated
@@ -7,6 +7,9 @@ This repository is used to host assets used in Cyan World's Myst Online: Uru Liv
* [dirtsand](https://github.com/H-uru/dirtsand) - An open-source Plasma-compatible server project.
* [korman](https://github.com/H-uru/korman) - Blender plugin for creating ages for Cyan Worlds' Plasma engine.

## Browsing MOUL Assets
You may notice while browsing this repository online or after cloning on your own machine that most files seem to be small text files containing some kind of hash reference. This is because the MOUL assets repository is too large for (free) GitHub. We therefore use an external Git Large File Storage server. The easiest way to download the entire repository is to use `git lfs clone`. Do keep in mind that the repository is very large (over 20GB), so make sure to run this command in a location with sufficient space. You can of course also enable Git LFS be default. You can find some basic information on the [Git LFS website](https://git-lfs.com/) or refer to the [Git LFS wiki page on pulling and cloning](https://github.com/git-lfs/git-lfs/wiki/Tutorial#pulling-and-cloning).
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

You can of course also enable Git LFS be default.

This should say "by default", and we might also want to drop the "of course"

README.md Outdated Show resolved Hide resolved
@Deledrius
Copy link
Member

According to the docs (and in my own testing), it appears that the git lfs clone command is unnecessary once git-lfs is installed. On Windows, git-lfs is installed by default with git-for-windows, but generally needs to be installed as its own package on Linux and macOS (instructions are provided in the linked documentation). Once that's done, a normal git clone appears to work as expected against a repository with LFS data.

@Hoikas Hoikas added documentation Improvements or additions to documentation enhancement New feature or request labels Jun 25, 2023
@patmauro patmauro mentioned this pull request Nov 5, 2024
Co-authored-by: Joseph Davies <deledrius@gmail.com>
@Hoikas Hoikas merged commit 51a4916 into H-uru:master Nov 14, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Improvements or additions to documentation enhancement New feature or request
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants