Как создать файл в git

Обновлено: 21.11.2024

Файл ReadMe — это стандартное место для инструкций или документации, которыми вы хотите поделиться с людьми о репозитории. Вот как добавить файл ReadMe в репозиторий Git.

Создать файл ReadMe

<р>1. Создайте файл с именем README.md в корневой папке репозитория Git.
2. Добавьте любые инструкции или документацию, которыми вы хотите поделиться с другими. Используйте Markdown для форматирования заголовков, списков, ссылок и т. д. Вот несколько руководств по синтаксису Markdown:

<р>3. Когда закончите, зафиксируйте изменения и отправьте их в удаленное репо. GitHub и Bitbucket отобразят красиво оформленный файл ReadMe на странице проекта репозитория.

Что такое уценка?

Markdown можно преобразовать в другие форматы (например, HTML), и он используется во многих вещах. Это стандартный формат для файлов ReadMe в Git.

Джон Грубер из Daring Fireball (daringfireball.net) создал Markdown. Он говорит: «Markdown должен быть настолько простым для чтения и записи, насколько это возможно. Синтаксис Markdown предназначен для одной цели: его можно использовать в качестве формата для написания в Интернете».

Выйти за рамки Git

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

Связанные ресурсы

<Р> < бр />

Как создать репозиторий Git: git init

Репозиторий Git (сокращенно репозиторий) содержит все файлы проекта и всю историю изменений. Изучите команду Git, чтобы создать репозиторий.


Основы командной строки Git

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


Файлы этапа и фиксации: git add, git commit и git log

Представьте, что Git хранит список изменений в файлах. Итак, как мы можем сказать Git записать наши изменения? Каждое записанное изменение файла (или набора файлов) называется фиксацией. Прочтите, чтобы узнать больше.

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

Вы можете добавить файл в репозиторий в своем терминале, а затем отправить его в GitLab. Вы также можете использовать веб-интерфейс, который может оказаться более простым решением.

Если вам нужно сначала создать файл, например текстовый файл README.md, это также можно сделать из терминала или веб-интерфейса.

Добавить файл с помощью командной строки

Откройте терминал/оболочку и перейдите в папку вашего проекта GitLab. Обычно это означает выполнение следующей команды, пока вы не доберетесь до нужного места назначения:

Создайте новую ветку, чтобы добавить в нее файл. Следует избегать отправки изменений непосредственно в ветку по умолчанию, если только ваш проект не очень мал и вы единственный человек, работающий над ним.

Вы также можете переключиться на существующую ветку, если она у вас уже есть.

Используя стандартный инструмент для копирования файлов (например, Finder в macOS или File Explorer в Windows), поместите файл в каталог в проекте GitLab.

Проверьте, действительно ли ваш файл находится в каталоге (если вы работаете в Windows, используйте вместо этого каталог):

Вы должны увидеть имя файла в показанном списке.

Проверьте статус:

Имя вашего файла должно быть выделено красным, значит, git это заметил! Теперь добавьте его в репозиторий:

Проверьте статус еще раз, имя вашего файла должно стать зеленым:

Зафиксируйте (сохраните) файл в репозитории:

Теперь вы можете отправить (отправить) свои изменения (в ветке) в GitLab (удаленный Git с именем «origin»):

Ваше изображение добавлено в вашу ветку в вашем репозитории в GitLab.

Помощь и обратная связь

Редактируйте эту страницу, чтобы исправить ошибку или добавить улучшение в мерж-реквест.
Создайте задачу, чтобы предложить улучшение этой страницы.
Показывать и публиковать комментарии, чтобы просматривать и оставлять отзывы об этой странице.

Товар

Создайте проблему, если вам что-то не нравится в этой функции.
Предложите функциональность, отправив запрос функции.
Присоединяйтесь к программе First Look, чтобы помочь создавать новые функции.

Доступность функций и пробные версии продуктов

Просмотрите цены, чтобы увидеть все уровни и функции GitLab или обновиться.
Попробуйте GitLab бесплатно с доступом ко всем функциям на 30 дней.

Получить помощь

Если вы не нашли то, что искали, выполните поиск в документации.

Если вам нужна помощь с чем-то конкретным и вам нужна поддержка сообщества, опубликуйте сообщение на форуме GitLab.

При возникновении проблем с настройкой или использованием этой функции (в зависимости от вашей подписки на GitLab).

Вы можете создавать новые файлы непосредственно на GitHub в любом репозитории, к которому у вас есть доступ для записи.

При создании файла на GitHub учитывайте следующее:

  • Если вы попытаетесь создать новый файл в репозитории, к которому у вас нет доступа, мы разветвим проект на вашу учетную запись пользователя и поможем вам отправить запрос на извлечение в исходный репозиторий после того, как вы зафиксируете свое изменение.< /li>
  • Имена файлов, созданные через веб-интерфейс, могут содержать только буквенно-цифровые символы и дефисы (-). Чтобы использовать другие символы, создайте и зафиксируйте файлы локально, а затем отправьте их в репозиторий на GitHub.

Предупреждение. Никогда не выполняйте git add , commit , или отправку конфиденциальной информации в удаленный репозиторий. Конфиденциальная информация может включать, помимо прочего:

  • Пароли
  • Ключи SSH
  • Ключи API
  • Номера кредитных карт
  • PIN-номера

В репозитории перейдите к папке, в которой вы хотите создать файл.

Над списком файлов в раскрывающемся списке Добавить файл нажмите Создать новый файл.

В поле имени файла введите имя и расширение файла. Чтобы создать подкаталоги, введите разделитель каталогов /.

На вкладке "Редактировать новый файл" добавьте содержимое в файл.

Чтобы просмотреть новый контент, нажмите «Предварительный просмотр».

В нижней части страницы введите короткое осмысленное сообщение фиксации, описывающее изменение, которое вы внесли в файл. Вы можете приписать фиксацию более чем одному автору в сообщении фиксации. Дополнительные сведения см. в разделе «Создание фиксации с несколькими соавторами».

Если с вашей учетной записью на GitHub.com связано несколько адресов электронной почты, щелкните раскрывающееся меню адресов электронной почты и выберите адрес электронной почты, который будет использоваться в качестве адреса электронной почты автора Git. В этом раскрывающемся меню отображаются только подтвержденные адреса электронной почты. Если вы включили конфиденциальность адреса электронной почты, то @users.noreply.github.com является адресом электронной почты автора коммита по умолчанию. Дополнительные сведения см. в разделе «Настройка адреса электронной почты для фиксации».

Под полями сообщения о коммите решите, следует ли добавить вашу фиксацию в текущую ветку или в новую ветку. Если ваша текущая ветка является веткой по умолчанию, вы должны создать новую ветку для своего коммита, а затем создать запрос на извлечение. Дополнительные сведения см. в разделе «Создание нового запроса на вытягивание».

При работе с репозиторием Bitbucket Cloud вам необходимо знать, как добавлять новые файлы и редактировать существующие файлы. Оттуда вы зафиксируете свои изменения в репозитории, что позволит вам (или кому-либо еще) ссылаться на эту точку в репозитории.

Вы можете вносить и фиксировать свои изменения локально, прежде чем отправлять их в Bitbucket, или редактировать их в онлайн-редакторе.

Редактировать локальные исходные файлы

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

Добавить и зафиксировать с помощью Git

В качестве справки приведем несколько команд git, которые вы будете использовать для работы с файлами в локальном репозитории.

Получите представление о следующей команде git.

Дополнительную информацию см. в документации по Git.

Чтобы добавить и зафиксировать файлы в репозитории Git

Создавайте новые файлы или редактируйте существующие файлы в локальном каталоге проекта.

Введите git add --all в командной строке в локальном каталоге проекта, чтобы добавить файлы или изменения в репозиторий. Введите статус git, чтобы увидеть изменения, которые нужно зафиксировать.

Введите git commit -m '' в командной строке, чтобы зафиксировать новые файлы/изменения в локальном репозитории. Для , вы можете ввести все, что описывает изменения, которые вы фиксируете.

1 2 3 4 5 6 7 8 $ git commit -m 'Первоначальная фиксация всех файлов в хранилище' [main 2f41d64] добавление изображений 6 измененных файлов, 1 вставка (+), 1 удаление (-) режим создания 100644 African Daisy.jpg создать режим 100644 Dandelion.jpg создать режим 100644 Ixia.jpg создать режим 100644 Spiked.jpg создать режим 100644 Sunflower.jpg

Редактировать файлы онлайн

Если у вас есть доступ для записи в репозиторий, вы можете редактировать и фиксировать изменения в репозитории из исходных файлов. Если у вас есть доступ для чтения и вы пытаетесь редактировать онлайн, Bitbucket разветвляет репозиторий, фиксирует ваши изменения в разветвлении и открывает запрос на вытягивание обратно в исходный репозиторий.

Вот как выглядит файл в режиме редактирования:

А. Заголовок файла — отображает владельца репозитория (рабочее пространство), проект, в котором он находится, и имя репозитория.

Б. Параметры файла — щелкните «Различия», чтобы просмотреть различия файла, или «История», чтобы просмотреть историю его фиксации, чтобы выйти из режима редактирования. Если вы уже вносили изменения, вы получите сообщение с вопросом, хотите ли вы отменить изменения, чтобы продолжить.

С. Варианты редактирования:

Режим синтаксиса — выберите подходящий тип файла для вашего файла.

Режим отступа: выберите табуляцию или пробел. Bitbucket пытается угадать, что вы используете, но вам, возможно, придется подстроиться.

Размер отступа: обновите количество пробелов для отступа. Вы увидите этот параметр только в том случае, если пробелы являются режимом отступа.

Перенос строк. Обновите, если хотите, чтобы строки в вашем файле переносились.

Д. Предварительный просмотр/фиксация:

Просмотр различий — показывает различия между вашими изменениями и самой последней версией этого файла в Bitbucket. После просмотра различий нажмите «Редактировать файл», чтобы вернуться в режим редактирования.

Зафиксировать — отображает диалоговое окно «Зафиксировать изменения», в котором вы можете ввести сообщение о фиксации и сохранить его, нажав «Зафиксировать».
Если у вас есть доступ для записи в репозиторий, вы можете зафиксировать непосредственно в репозиторий или выбрать «Создать запрос на вытягивание» для этого. change.
Если у вас нет прав на запись, Bitbucket автоматически создает ответвление и запрос на извлечение, который указывает на исходный репозиторий.

Вот как редактировать файл из Bitbucket:

В репозитории нажмите «Источник» на левой панели навигации.

Нажмите на файл, который хотите открыть.
Возможно, вам придется перемещаться по дереву файлов или ввести файл в поле "Фильтровать файлы", чтобы найти его.

Нажмите кнопку "Изменить", чтобы открыть режим редактирования.

Внесите необходимые изменения и любые другие обновления в файл.

Нажмите "Подтвердить".

Обновите сообщение о коммите, если хотите, и снова нажмите Commit.

Вашим первым побуждением, когда вы начинаете делать что-то новое, должно быть git init . Вы начинаете писать новую статью, пишете код для компьютерного моделирования, возитесь с новыми данными… что угодно: подумайте о git init .

Новое репо с нуля

Скажем, вы только что получили данные от соавтора и собираетесь начать их изучение.

  • Создайте каталог для проекта.
  • Перейдите в новый каталог.
  • Введите git init .
  • Напишите код.
  • Введите git add, чтобы добавить файлы (см. страницу типичного использования).
  • Введите git commit .

Первый файл, который нужно создать (а также добавить и зафиксировать), вероятно, является файлом ReadMe, либо в виде обычного текста, либо с Markdown, описывающим проект.

Markdown позволяет добавлять разметку текста, например гиперссылки, выделение полужирным шрифтом/курсивом или указывать код моноширинным шрифтом . Markdown легко конвертируется в html для просмотра в веб-браузере, и GitHub сделает это за вас автоматически.

Новый репозиторий из существующего проекта

Скажем, у вас есть существующий проект, который вы хотите начать отслеживать с помощью git.

  • Перейдите в каталог, содержащий проект.
  • Введите git init .
  • Введите git add, чтобы добавить все нужные файлы.
  • Возможно, вы захотите сразу же создать файл .gitignore, чтобы указать все файлы, которые вы не хотите отслеживать. Также используйте git add .gitignore .
  • Введите git commit .

Подключите его к github

Теперь у вас есть локальный репозиторий git. Вы можете использовать git локально, вот так, если хотите. Но если вы хотите, чтобы у этой штуки был дом на github, сделайте следующее.

  • Перейти на GitHub.
  • Войдите в свою учетную запись.
  • Нажмите кнопку нового репозитория в правом верхнем углу. У вас будет возможность инициализировать репозиторий файлом README, но у меня его нет.
  • Нажмите кнопку "Создать репозиторий".

Теперь следуйте второму набору инструкций: "Отправьте существующий репозиторий..."

Читайте также: