README.md 2.34 KB
Newer Older
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20
This is a way to share our personal media (photos (including raw images), videos,
etc) and other files (talk slides, documents, GPS tracks, etc) related to
DebConf with other attendees and the public, and ensure that it's all
preserved in one place.

Please limit uploads to content that is legal, respectful of others,
and that it's appropriate to share with the world.

We do not have infinite amounts of disk space, so use common sense before uploading huge files.

## web

All files in the repository can be accessed via the web:
<https://salsa.debian.org/debconf-team/public/share/debconf19>

## setup

All DDs can directly push to this repository.
Others can either open a merge request or ask any DD for commit rights.

21 22 23 24
The repository is using git lfs (git large file system).
This makes handling of big files more efficient, but requires some additional precaution,
when adding files to the repository.

25 26 27 28 29 30 31 32 33 34
1. you need the package git-lfs
1. on Debian systems from buster on `# apt install git-lfs`
1. for stretch install from backports, see documentation on https://backports.debian.org/

You probably do not want to `git clone` the repo, as git-lfs will download *everything*
inside it. To do a shallow clone:

1. `$ GIT_LFS_SKIP_SMUDGE=1 git clone --config filter.lfs.smudge=true  git@salsa.debian.org:debconf-team/public/share/debconf19.git`
1. `$ cd debconf19`
1. lfs files now just are stored as references. To actually fetch a file, do `git lfs fetch -I <filename>`
35
1. Use it mostly as if it was a normal git repository, but for adding files see below
36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58

## adding files

In principle add files like you normally would in git,
but make sure that the files you add actually end up in lfs
using git lfs ls-files after committing (or staging).

    $ git add slides/testfile.svg
    $ git commit -m"commit message"
    $ git lfs ls-files
    f2ca1bb6c7 * slides/testfile.svg

If it's not there, check if the file pattern is tracked by lfs:
`$ git lfs track`

If it's not there, either, if it makes sense, rename the file to match one pattern
or see git-lfs documentation (eg <https://docs.gitlab.com/ee/workflow/lfs/manage_large_binaries_with_git_lfs.html>)
on how to add your extension.
When doing so, don't forget to either commit/push .gitattributes or to include it in your merge request.

## license

License for all files uploaded: cc-by-sa 4.0 unless explicitly stated otherwise.
Stefano Rivera's avatar
Stefano Rivera committed
59