daugavpils.fans
Поддержка
← daugavpils.fans

Как устроен этот архив

Сайт архива: daugavpils.fans

Этот текст — не для программистов. Он написан для всех, кому интересна музыка Даугавпилсской сцены: слушателей, музыкантов, их друзей и близких.

Здесь простыми словами объясняется три вещи:

  1. где на самом деле хранятся записи, фото и вся информация об этом архиве;
  2. как добавить новую музыку, фотографии или историю группы;
  3. что произойдёт, если тот, кто сейчас всем этим занимается, по какой-то причине не сможет продолжать.

Коротко: сайт daugavpils.fans — это просто витрина. Сами записи и описания хранятся в двух местах, независимых от этого сайта и от одного конкретного человека.

Где на самом деле хранятся данные

flowchart LR
    subgraph github["GitHub (открыто для всех)"]
        M["Описания групп и альбомов:<br/>названия, треклисты, биографии,<br/>кто в какой группе играл"]
    end

    subgraph ia["archive.org (открыто для всех)"]
        A["Сами файлы:<br/>записи песен, фотографии, видео"]
    end

    subgraph site["daugavpils.fans"]
        W["Основной сайт — витрина<br/>для просмотра и прослушивания"]
    end

    subgraph pages["Резервная копия сайта"]
        P["GitHub Pages:<br/>svalevka.github.io/daugavpils.fans<br/>обновляется сама, автоматически"]
    end

    M --> W
    A --> W
    M --> P
    A --> P

Такое разделение сделано специально: если с сайтом daugavpils.fans что-то случится, сами записи и описания от этого никуда не исчезнут — они не зависят от того, работает сайт или нет.

Как добавить совершенно новую группу или релиз

Если группы или альбома ещё нет в архиве — самостоятельно, через сайт, добавить их пока нельзя: это по-прежнему вручную делает один из кураторов проекта. Если у вас есть записи, фотографии, старые кассеты, статьи или просто история о даугавпилсской группе, которую стоит сохранить — напишите:

Не нужно самим ничего оформлять "по правилам" — достаточно поделиться материалами и рассказать, что это такое. Дальше куратор оформит это в архив в правильном виде.

(Если вы разбираетесь в git и хотите оформить материалы сами — точный технический процесс описан в README.md.)

Как исправить текст или добавить фото/видео к уже существующей группе

Это другой случай — и он проще. Если группа или альбом уже есть на сайте, и вы хотите:

— для этого не нужно писать в Issues и ждать ответа, и не нужна регистрация или git. На странице самой группы или альбома есть кнопка «Предложить изменение» (ведёт на review.daugavpils.fans/submit) — там можно сразу предложить исправление текста или загрузить новое фото/видео со своего телефона или компьютера.

Оба типа предложений куратор проверяет и одобряет одинаково. После одобрения текстовые правки появляются на сайте сразу, автоматически. Фото и видео публикуются почти так же, но перед этим файл ещё нужно загрузить в архив на archive.org — это отдельный шаг, поэтому может занять чуть больше времени.

Эта возможность есть только на основном сайте daugavpils.fans — на резервной копии на GitHub Pages (см. ниже) такой формы нет.

Что будет, если этим станет некому заниматься

Честный ответ: адрес daugavpils.fans может однажды перестать открываться. Он работает на сервере, за который нужно платить и о котором нужно заботиться (продлевать оплату, обновлять сертификат безопасности и так далее). Если по какой-то причине этим больше некому будет заниматься, именно этот адрес рано или поздно может исчезнуть.

Но сам сайт — то есть эта же витрина, с тем же содержимым — уже сейчас существует и по запасному адресу, который не зависит от этого сервера и обновляется сам, автоматически, при каждом изменении архива:

svalevka.github.io/daugavpils.fans

Эта копия размещена на GitHub Pages — бесплатном сервисе для размещения таких статичных сайтов, от того же GitHub, где хранятся описания групп и альбомов (см. выше). Если daugavpils.fans когда-то перестанет открываться из-за проблем именно с этим сервером, попробуйте этот адрес — там должно быть то же самое.

Важная оговорка: эта резервная копия сама размещена на GitHub — том же сервисе, где ведётся сама работа над описаниями групп и альбомов. Она защищает от одного конкретного случая — если откажет именно сервер daugavpils.fans — но не от гипотетического исчезновения самого GitHub. Если бы это всё-таки произошло, вместе с ним пропали бы обе копии сайта и сама возможность редактировать архив привычным способом.

Но даже такой, более серьёзный сценарий не означает, что музыка и история группы будут потеряны безвозвратно. Вот почему:

Иными словами: сайт — это только витрина, и у неё уже есть запасной адрес на случай, если основной перестанет работать. Но то, что в этой витрине показано, уже сейчас лежит открыто в двух надёжных, независимых местах, и достаточно, чтобы хотя бы несколько человек скачали себе копию архива — и он не исчезнет никогда.

Что будет, если пропадёт доступ к аккаунту на archive.org

Это отдельный, более узкий вопрос, чем предыдущий раздел (там речь о самом сайте daugavpils.fans). Здесь — про сами файлы: чтобы загружать в архив новые записи, фото и видео, куратор использует один конкретный аккаунт на archive.org (его имя — daugavpils.fans). Если доступ к этому аккаунту будет потерян и его не удастся восстановить — это неприятно, но не конец света: всё, что уже опубликовано, никуда не денется и останется доступно всем, как есть, навсегда. Просто станет сложнее добавлять что-то новое, пока доступ так или иначе не восстановят.

Есть два способа справиться с этим, и они дополняют друг друга:

  1. Заранее подготовленный автоматический способ. Куратор может заранее выбрать небольшой круг доверенных людей. Если куратор пропадёт и не будет отвечать, любой из этого списка может запросить доступ через GitHub; после этого у куратора есть неделя, чтобы отменить запрос (если он на самом деле никуда не пропал). Если за неделю ничего не произошло, доступ автоматически передаётся тому, кто запросил. Всё это устроено так, что не требует от куратора постоянно что-то поддерживать, и не требует ни от кого хранить пароли заранее. (Технические подробности — в documentation/DEAD_MANS_SWITCH.md, для тех, кто разбирается в git и GitHub Actions.)
  2. Запасной способ для любого человека. Даже если первый способ не настроен или не сработал, восстановить возможность добавлять новое может в принципе кто угодно, даже без всякой предварительной договорённости — потому что все описания групп и альбомов и так открыты и лежат на GitHub. Это займёт немного больше шагов (нужно завести новый аккаунт на archive.org и один раз перенести туда ссылки), но не требует ничьего разрешения. (Подробности — documentation/RECOVERY.md.)

Как попасть в список доверенных людей

Если вы разбираетесь в GitHub и хотите быть одним из тех, кто сможет восстановить доступ, если куратор вдруг пропадёт — это не тяжёлая обязанность:

Как самому скачать себе весь архив

Если хочется иметь свою собственную копию всего архива — записей, фото, видео и всех описаний — на всякий случай, или просто чтобы она была:

Просто послушать музыку можно прямо на daugavpils.fans — скачивать ничего не нужно. А если нужна именно полная копия себе на компьютер — есть готовый способ скачать всё одной командой, автоматически и с проверкой, что ничего не повреждено при скачивании. Он требует немного технических навыков (умения запустить команду в терминале), зато занимает один шаг вместо ручного скачивания каждой группы и альбома по отдельности.

Полная, пошаговая инструкция (для тех, кто разбирается в git и терминале): documentation/BACKUP.md.

А можно так делать? Про лицензию

Да. У каждого альбома в архиве указана лицензия Creative Commons — это разрешение от автора записи, явно позволяющее скачивать её и делиться ею дальше (обычно с условием — не в коммерческих целях и с указанием авторства). Это значит, что скачивать и распространять записи из этого архива можно открыто, не спрашивая ни у кого дополнительного разрешения — сами авторы уже дали его заранее, именно для того, чтобы эта музыка не потерялась.

Как связаться