Загрузка проектов на репозиторий SafeZone GitHub

[Dragokas]

ПОДГОТОВКА

Установите Git Bash: Git - Downloading Package

Зарегистрируйтесь на GitHub: Build software better, together

Напишите ваш email или вашу страницу профиля GitHub в этой теме, чтобы получить приглашение в группу.

Перейдите на эту страницу (или нажмите кнопку "New" в репозитории):

• укажите название нового проекта (без пробелов !!!)
• (необязательно, но желательно) - краткое описание
• (необязательно) можно также поставить галочку на "Initialize this repository with a README", чтобы создать полное описание проекта. Затем можно будет вручную его подредактировать - нажать на README.md => далее см. справа кнопку с карандашом (edit), а также вкладку "Preview changes", чтобы посмотреть результат).
• нажмите кнопку "Create repository"

Распакуйте приложенный ниже архив Git-Upload-Example.zip.

.upload_git.cmd => клик правой кнопкой мыши => Изменить:

Поменяйте nickname на свой ник:
git config --global user.name "NickName"

(необязательно) поменяйте admin@safezone.cc на свой адрес почты:
git config --global user.email "admin@safezone.cc"

В этой строке поменяйте Project-Name на название вашего проекта (вы указывали это имя выше )
repo="Project-Name"

Скопируйте эти файлы в локальную папку последней версии вашего исходного кода:

.gitattributes
.gitignore
.upload_git.cmd

А также, если ещё не сделали, создайте файл README.md (кодировка UTF-8 без BOM) - это описание проекта (см. пример в приложенном архиве).

(необязательно) в .gitignore можно внести файлы, которые вы хотите исключить из отгрузки на сервер.

-----------

ЗАЛИВКА В ПЕРВЫЙ РАЗ

Если ваша заявка на вступление в группу одобрена:

Запустите .upload_git.cmd:

• первый раз Git попросит вас вести ваш логин и пароль к GitHub, который будет сохранён.
• проверьте инфу в консоли (ошибки / предупреждения).
• введите номер версии вашей программы и подтвердите отгрузку кнопкой ENTER.

-----------

ОБНОВЛЕНИЕ

Если вы выпустили новую версию, чтобы отгрузить её на GitHub:

(наобязательно) Если для новой версии вы создали у себя локально новую папку, то:

1. Скопируйте из папки предыдущей версии программы в папку новой версии:

• файл .gitattributes
• файл .gitignore
• файл .upload_git.cmd
• файл README.md

2. Запустите батник .upload_git.cmd:

• проверьте инфу в консоли (предупреждения / какие файлы будут добавлены, обновлены, удалены).
• введите новую версию и подтвердите отгрузку кнопкой ENTER.

ВНИМАНИЕ: изменения, внесённые в ваш репозиторий сторонними разработчиками (либо лично вами из интерфейса сайта GitHub), будут потеряны (перезаписаны вашей локальной копией файлов).
Позаботьтесь о разрешении конфликтов предварительно самостоятельно.

 

[akok]

Заявку можно опубликовать в этой теме. Если нет учетной записи на github.com, то инвайт будет отправлен на e-mail который был указан при регистрации.

 

[Кирилл]

fire@safezone.cc

 

[Dragokas]

Принимай.

Сразу несколько советов:
1) по редактору, когда будешь готовить readme.md - там особый синтаксис:

# Самый большой заголовок
## Чуть по меньше
### Ещё меньше

Если нужно пометить текст гиперссылкой, то:
[заголовок](гиперссылка)

Да, ещё он иногда спутывает строки в одну, поэтому там где такое происходит, просто добавь ещё один перенос строки.

2) Если тебе нужно загрузить файл (например, картинку), то открой вкладку Issues (где угодно, например здесь, но лучше внутри своего проекта). Нажми "New Issue", внизу гиперссылка "select item", и когда картинка загрузится, ты получишь ссылку (окно можно закрывать).

Мог бы короткое видео записать, но не знаю нужно ли. Как-то интереса у людей немного.

Здесь только просьба менять замочек с Private на Public: SafeZone.cc

 

[Кирилл]

@Dragokas, спасибо большое - твой скрипт заметно облегчает жизнь)

 

[Dragokas]

@Кирилл, не забывай добавлять в каждый репозиторий хотя бы файл .gitattributes, иначе рискуешь испортить файлы при заливке.
Ну а так описание у тебя получилось отличное.

@Dragokas, спасибо большое - твой скрипт заметно облегчает жизнь)

Спасибо, я знаю, старался, чтобы по меньше получилось скриптов. Вроде получилось сделать всё в одном.

 

[Кирилл]

Может кто то тоже столкнулся:
Не нужно запускать .upload_git.cmd от имени Администратора - скрипт будет пытаться искать файлы в другом каталоге и вы ничего не обновите/ не зальете)

 

[Dragokas]

Исправил.

 

[Alex1983]

Aibolit198@mail.ru DrDabin

 

[Dragokas]

@Alex1983, добавил. Лови инвайт.

 

[Alex1983]

@Dragokas в файле EjDrive_src.txt проекта Safe-RemoveDrive местами кракозябры. может кодировка неправильная.

 

[Dragokas]

Стандартная Win-1251. Ты скачай, всё будет норм. Это GitHub веб-интерфейс плохо понимает русский язык.

 

[Dragokas]

Перезалил образец скрипта отгрузки на GitHub:

- замена web-префикса репозитория по новым требованиям безопасности, иначе GitHub откажет в авторизации;
- решена проблема с назойливым предложением заменить стиль переносов строк (Win -> Linux).

 

[Dragokas]

GitHub переходит на новый метод аутентификации при работе с Git репозиториями с 30 июня 2021 года (а с 13.09 принудительно).
Вместо логина/пароля будет затребован:

1) SSH

либо

2) логин + токен

1. SSH

а) Запустите Git Bash (из меню ПУСК),
введите команду, указав почту, привязанную к вашему аккаунту на GitHub.com:

ssh-keygen -t ed25519 -C "ваша_почта@example.com"

На все вопросы можно отвечать кнопкой ENTER. Парольную фразу указывать не обязательно (она будет требоваться каждый раз при коммите - обязательно указывайте пароль, если к вашему ПК имеют доступ посторонние лица).
Будет создан ключевой файл.

б) добавьте публичный ключ в агент, командой:

ssh-add ~/.ssh/id_ed25519

в) Публичный ключ нужно внести в ваш аккаунт на сайте GitHub.com
В Git Bash введите:

clip < ~/.ssh/id_ed25519.pub

Это скопирует в буфер публичный ключ. Введите его на странице GitHub.com => Настройки профиля (Settings) => SSH and GPG Keys => Add SSH Key (название ключа вводим любое).

Чтобы это работало на новом ПК:
- скопируйте на него ключевой файл /.ssh/id_ed25519 (он находится в папке %UserProfile% )
- выполните пункт б)
- Вы также можете сгенерировать для этого ПК отдельный SSH по этой же инструкции (пп. а, б, в).

Более подробно:

Generating a new SSH key and adding it to the ssh-agent - GitHub Docs

After you've checked for existing SSH keys, you can generate a new SSH key to use for authentication, then add it to the ssh-agent.

docs.github.com

Adding a new SSH key to your GitHub account - GitHub Docs

To configure your account on GitHub.com to use your new (or existing) SSH key, you'll also need to add the key to your account.

docs.github.com

Working with SSH key passphrases - GitHub Docs

2. Токен
(этот способ на сколько мне известно больше не работает отдельно без генерации SSH - см. п.1 выше)

Инструкция по генерации: Creating a personal access token - GitHub Docs
Использовать токен просто - в запрашиваемой форме аутентификации указывайте вместо пароля - id выданного вам токена.

Инструкция по генерации: Generating a new SSH key and adding it to the ssh-agent - GitHub Docs
Использование:
Обычно, достаточно просто добавить ключ в аккаунт на сайте GitHub:

How to Add SSH Keys to Your GitHub Account via Command Line

In this article, you will learn how to add SSH keys to your GitHub account.

www.inmotionhosting.com

=============

В качестве допольнительной защиты, можно создать ключи GPG, чтобы подписывать коммиты своим именем.
Для этого, сгенрируйте ключ GPG: Generating a new GPG key - GitHub Docs

Аналогично, добавьте ключ в настройки GitHub => Settings => SSH and GPG Keys => New GPG Key.
Использование: в командной строке перед началом работы с git (или в скрипте .upload_git.cmd) необходимо указать ваш GPG Key Id:

git config --global user.signingkey XXX

Во время коммита нужно указывать дополнительный ключ -S
Пример:

git commit -S -a -m "v1.1"

Если всё успешно, ваши коммиты будут помечены зелёным флажком "Verified".

Внимание, удаление GPG ключа из настроек приведёт к невозможности идентифицировать ваш коммит как подписанный.

 

[Dragokas]

Из-за афро-американцев теперь ввели ещё одно изменение, которое ломает работу нашего скрипта.
Теперь по-дефолту, создаётся ветка не master, а main.

Поэтому чтобы скрипт нормально работал для ваших новых репозиториев,
замените в скрипте все слова master => на main.

 

[Dragokas]

Выкладываю обновленную версию скрипта.
Я его целиком не тестировал, только частями. Т.к. сейчас приболел. Было бы неплохо, если кто-то проверит и скажет, что все ок.
Изменения:
- добавлены популярные исключения для .gitignore
- добавлен git pull для выкачивания изменений, сделанных через web и другими контрибуторами вашего репозитория
- добавлены фиксы, помогающие обойти некоторые проблемы с git
- добавлен пример, как читать версию/список изменений из внешнего файла