Новое: совместная работа в Интернете и в автономном режиме с Overleaf и Git (бета)

1. Как мне использовать Git с Overleaf?
2. 1. Создайте проект на следующей странице
3. 2. Найдите ссылку Git для вашего проекта
4. 3. Клонируйте свой проект с помощью Git
5. 4. Отредактируйте ваш проект и внесите свои изменения
6. 5. Переместите ваши изменения на обложку
7. Использование графических клиентов Git
8. Часто задаваемые вопросы
9. Могу ли я использовать Overleaf с проектом, размещенным на GitHub?
10. Могу ли я получить доступ к файлу git, которым делятся со мной через обмен ссылками?
11. Как мне войти через git?
12. Как насчет файловых кодировок и окончаний строк?
13. А как насчет пустых папок?
14. Об Имперской Студенческой Команде

Интеграция git Overleaf теперь также доступна в Overleaf v2 , Обратите внимание, что формат удаленных Git изменился в Overleaf v2 - пожалуйста, посмотрите сообщение, которое вы получите, если вы все еще используете пульты Git Overleaf в стиле v1, как те, что в этом сообщении в блоге.

Одна из наиболее востребованных вами функций - ссылка между Overleaf и Git - теперь доступна в бета-версии. Теперь вы можете клонировать любой проект на Overleaf (включая защищенные проекты), используя его ссылку с «git» вместо «www», например:

мерзкий клон https://git.overleaf.com/2029559gkypzx

Другое направление также работает: как только вы сделаете последние изменения из Overleaf в своем репозитории, вы можете обычным способом сделать git push на наш пульт, и все будет обновляться в режиме онлайн. Смотрите ниже подробные инструкции.

Мост на верхнем листе был написан большой группой студентов из Империала (с небольшой помощью от нас и их научного руководителя, доктора Ананды Гопалан) - вы можете прочитать их мысли у подножия этого поста в блоге - и это открытый Исходный сервер, который общается с нашим API: https://github.com/winstonli/writelatex-git-bridge ,

Как мне использовать Git с Overleaf?

Если вы задаете этот вопрос, то, надеюсь, вы уже знаете, что такое Git! Если нет, вы можете просмотреть официальный Страница «Начало работы» здесь , Git Bridge от Overleaf обеспечивает возможность держать ваши проекты в автономном режиме и работать, не выходя из собственной командной строки. Вот как использовать Git-репозиторий для вашего проекта:

1. Создайте проект на следующей странице

Сначала вам понадобится проект на Overleaf - вы можете создать новый проект или использовать один из существующих проектов. Мы будем использовать этот пример проекта:

2. Найдите ссылку Git для вашего проекта

Каждый проект на Overleaf имеет секретную ссылку «читать и редактировать», которую вы можете найти в меню «Поделиться». Ссылка git для вашего проекта такая же, как ссылка, которую вы используете для доступа к проекту через браузер, но с ссылкой git вместо www .

В этом случае ссылка проекта - https: // www .overleaf.com / 2029559gkypzx, поэтому ссылка git - https: // git .overleaf.com / 2029559gkypzx.

3. Клонируйте свой проект с помощью Git

Теперь мы готовы клонировать проект на Overleaf. Здесь мы клонируем его в каталог с именем test_paper с помощью команды

мерзкий клон https://git.overleaf.com/2029559gkypzx test_paper

4. Отредактируйте ваш проект и внесите свои изменения

Теперь, когда вы клонировали свой проект, вы можете отредактировать его, используя любые инструменты, которые вам нравятся, и зафиксировать свои изменения с помощью команды git commit, как обычно при работе с git.

Вы также можете добавлять и удалять файлы в / из вашего проекта и фиксировать их, как и следовало ожидать. Обратите внимание, что вам все равно придется придерживаться правил Overleaf для именования файлов, чтобы избежать проблем при перемещении кода между операционными системами и редакторами (например, без пробелов в именах файлов). Вам сообщат о любых проблемах с именами (а также об ограничениях размера проекта и т. Д.), Когда вы попытаетесь внести изменения.

5. Переместите ваши изменения на обложку

Когда все будет готово, верните изменения в Overleaf с помощью мастер-команды git push origin.

Обратите внимание, что если были внесены изменения в ваш проект на Overleaf, когда вы работали в автономном режиме, вы будете уведомлены, когда вы попытаетесь git push. Не паникуйте! Вам просто нужно вытащить изменения из Overleaf перед тем, как вы сможете перенести изменения в Overleaf. Если есть какие-либо конфликты слияния, вам придется разрешить их локально, прежде чем вы сможете отправить свои изменения в Overleaf. Это хорошая идея, чтобы регулярно вытягивать и толкать, чтобы избежать конфликтов слияния, особенно если у вас есть много авторов, работающих над проектом Overleaf.

Также стоит отметить, что вы можете использовать все модель ветвления git Вам нравится локально, но вы можете только вносить изменения в основную ветку на Overleaf.

Когда вы внесете свои изменения, они автоматически появятся в сети!

Использование графических клиентов Git

Мост Overleaf Git Bridge также совместим с графическими инструментами Git, которые являются отличным способом для того, чтобы вы (и ваши соавторы) начали работать с Git, без каких-либо сложностей, связанных с использованием командной строки. Например, как только вы клонировали репо, как описано выше, вы можете открыть его в GitHub для Mac (или же GitHub для Windows ) и использовать его для коммитов и просмотра истории вашего проекта:

Мы надеемся, что это будет полезной функцией для многих из вас, и любые дальнейшие вопросы или вопросы можно направлять нам через наша контактная страница , Наслаждайтесь!

Часто задаваемые вопросы

Могу ли я импортировать мой существующий репозиторий Git в Overleaf?

Да, Вы можете настроить Overleaf как удаленный в вашем существующем хранилище и перенесите ваши изменения в Overleaf, точно так же, как в GitHub или BitBucket.

Могу ли я использовать Overleaf с проектом, размещенным на GitHub?

Да, Вы можете установить Overleaf как удаленный или как субмодуль , Каждый проект на Overleaf получает свое собственное git-репо, поэтому подмодули могут быть полезны, если вы хотите управлять несколькими Overleaf-проектами в одном git-репо на GitHub.

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

Да, когда вы посещаете проект в вашем браузере. Вы не можете использовать ссылку обмена ссылками непосредственно с git, но вы можете найти ссылку git в меню, когда открываете проект в Интернете.

Как мне войти через git?

Когда вы попытаетесь выполнить git pull from или git push to Overleaf, вам будет предложено войти в систему, используя свое имя пользователя Overleaf (ваш адрес электронной почты) и пароль. Обратите внимание, что если вы зарегистрировались с помощью другого провайдера, такого как Google или Twitter, вам сначала нужно будет установить пароль Overleaf. Вы можете сделать это через ваши настройки , Одинаковые средства управления доступом применяются независимо от того, получают ли пользователи доступ к проекту через мост git или через веб-интерфейс.

Чтобы не вводить свои учетные данные каждый раз, вы можете настроить свой git-клиент так, чтобы он запоминал их постоянно или в течение ограниченного времени. Есть несколько вариантов в зависимости от вашей платформы. Пожалуйста, смотрите эту статью помощи от GitHub для получения дополнительной информации. Обратите внимание, что доступ по SSH-ключу не поддерживается на Overleaf.

Обратите внимание, что некоторые старые версии клиента git не поддерживают аутентификацию. Если аутентификация через git не работает для вас, а git - -version меньше 2, вам следует обновить клиент git до версии 2 или новее.

Как насчет файловых кодировок и окончаний строк?

Overleaf использует внутреннее кодирование UTF-8 и окончания строк в стиле Unix (\ n), но git может автоматически преобразовывать окончания строк. Увидеть эта статья для получения дополнительной информации о кодировках файлов и окончаниях строк ,

А как насчет пустых папок?

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

Об Имперской Студенческой Команде

Бен Anuworakarn, третий курс бакалавриата CS в Имперском колледже Лондона

Шестеро из нас - Уинстон Ли, Бен Ануворакарн, Алекс Лаун, Алекс Мусафейрис, Зейн Сеха и Джит Яп - являются студентами компьютерных факультетов в Имперском колледже Лондона, и все они в настоящее время находятся на третьем курсе нашего курса. Часть нашего зимнего семестра в этом году состояла из большого группового проекта, включающего создание собственного продукта с применением различных идей и концепций, которые мы изучили до сих пор, начиная от стилей программирования и решения проблем, вплоть до практики разработки программного обеспечения и дизайнерские решения.

Это было настоящее путешествие для нас, как умственно, так и физически ( Офисы Overleaf довольно далеко от кампуса)! Этот проект был непохож на любую курсовую работу, над которой мы когда-либо работали, поскольку мы действительно можем видеть, как плоды нашего труда используются людьми в Интернете. Это был удивительно глубокий проект, который требовал понимания многих вещей, которые мы обычно воспринимаем как должное, и все мы должны были быть на одной странице, чтобы обеспечить успешный проект.

Тем не менее, все препятствия, с которыми мы столкнулись на этом пути, только помогли нам стать лучшими программистами. Было здорово работать с Overleaf, учитывая, что мы так много пользовались их услугами, и, в конце концов, мы действительно довольны этим продуктом и надеемся, что он понравится всем так же, как мы его создали!

Похожие

Комментарии