Как надо отвечать на github. Git для чайника

Принтеры и МФУ Ricoh SP150 являются абсолютно новой печатной платформой, в которой инженеры Ricoh учли недостатки предыдущих аппаратов (SP100 / SP111). Вместе с новой платформой аппарат получил новое железо и софт. Если предыдущее поколение аппаратов для сервиса использовало скрытые возможности поставляемой в комплекте утилиты Smart Organizing Monitor, то для Ricoh SP150 была разработана новая утилита получившая название CE Tools.

Утилита CE Tools не поставляется в комплекте с аппаратом и доступна только авторизированным сервисным центрам. Утилита весит всего 1,8mb и не требует установки. Функционал утилиты достаточно широкий и позволяет не только сбрасывать ошибки, но и производить полноценную диагностику аппарата. Структура утилиты очень продумана и уже после пары минут общения с утилитой создается ощущение, что работаешь в ней не первый раз. Подключение утилиты происходит исключительно по USB кабелю, в случае невозможности соединиться с аппаратом утилита сообщает об этом.

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

Инструкция по сбросу ошибки SC542/541

Сброс ошибки достаточно прост, открываем утилиту, входим в раздел «Output Check» из выпадающего списка выбираем «FusingSCReset» и нажимаем кнопку «On».

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

Подводя итоги.

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

Что касается надежности самой печатной платформы, то мне эта платформа показалась гораздо надежней чем более продвинутая 200 серия. Еще не сталкивался с ложным срабатыванием термодатчика, а аппаратов на обслуживании более чем достаточно, даже вырванные USB перепаивал. Кстати стекло в сканере не переклеено, а держится на пластиковых упорах как в копирах А3 формата. В Ricoh SP150 корпус недостаточно жесткий и если пользователь неаккуратно обращается с аппаратом, то стекло сканера слетает с упоров и блокирует сканирующую линейку.

Что касается самой печки, то она по конструкции весьма надежна, но тефлоновый вал к сожалению сидит на бушингах, а не на подшипниках качения как в Ricoh SP325.

Многим трудно начать работать с Git , ведь не все привыкли работать с командной строкой, но именно ее лучше всего использовать при работе с репозиторием Git . И сегодня я расскажу о самом простом, так сказать Git для чайника , чтобы помочь освоиться Вам с этой системой. Git представляет собой систему контроля версий, которая позволяет в нужный момент откатиться на старую версию, если вы "наломали дров ".

С помощью Git Вы сможете размещать свой код на GitHub , BitBucket и Google Code .

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

С чего начать?

Нам понадобиться программа Git Bash , это шелл сделанный на основе Cygwin, поэтому возможно использование Unix-команд, вроде ls, cd, mkdir. Скачать его можно по следующей ссылке http://git-scm.com/ .

Настройка Git

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

Git config --global user.name "Ваше имя" git config --global user.email "Ваш Email"

Также нам нужно настроить параметры установок окончания строк, для Windows мы вводим две команды

Git config --global core.autocrlf true git config --global core.safecrlf false git config --global core.eol native

На этом настройка заканчивается, можем начинать работу с проектом.

Создание проекта

Допустим у нас есть папка с проектом, которую мы хотим разместить на GitHub.

2. Инициализируем папку для Git репозитория. Это нужно сделать только один раз для каждого проекта.

Git init

3. Связываем папку с удаленным репозиторием

Git remote add origin https://github.com/LeoXCoder/test_project.git

4. Добавляем все новые и измененные файлы

Git add .

5. Помечаем все новые и измененные файлы сообщением (commit )

Git commit -m "message"

Вместо message вписываем сообщение, например Initial Commit. или Bugfix.

6. Закачиваем код на удаленный репозиторий

Git push -u origin master

в таком виде используем только первый раз, потом используем команду без флагов

Git push

7. Можно посмотреть статус изменений, которые были сделаны.

Git status

8. Для скачивания репозитория используется команда

Git pull

Второй компьютер

Для использования репозитория на другом компьютере, используем следующие команды.

1. Клонирование репозитория

Git clone https://github.com/LeoXCoder/test_project.git

В результате git скачает удаленный репозиторий в новую папку test-project

2. После каких-то изменений в коде, выполняем все те же команды

Git add . git commit -m "I changed the user module." git push

Откат изменений

1. Полный откат до предыдущего коммита

Git reset HEAD --hard

2. Сброс изменений в файле на версию коммита

Git checkout

3. Откат до установленного тега, например v1

Github - это очень известная платформа для хранения, распространения и управления исходным кодом открытых проектов. Этот сервис используют множество разработчиков по всему миру, среди которых есть и крупные компании, такие как Microsoft, RedHat и множество других, также сотни разработчиков многих популярных проектов.

Платформа предоставляет возможности не только по просмотру кода и его распространения, но также историю версий, инструменты совместной разработки, средства для предоставления документации, выпуска релизов и обратной связи. И самое интересное, что вы можете размещать на Gihub как открытые, так и приватные проекты. В этой статье мы рассмотрим как пользоваться Github для размещения своего проекта. Так сказать, github для начинающих.

Итак, допустим, у вас есть свой проект и вы хотите разместить его код на Github в открытом доступе чтобы другие пользователи могли его посмотреть и участвовать в разработке. Первое что вам нужно сделать - создать аккаунт.

1. Создание аккаунта

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

Когда завершите ввод, нажмите кнопку "Sign Up Free" :

На следующем шаге вам нужно выбрать тип репозитория. Публичные репозитории бесплатны, но если вы хотите создать частный репозиторий, код из которого будет доступен только вам, то придется платить $7 в месяц.

Аккаунт готов, и вы будете перенаправлены на страницу, где сможете создать свой первый проект. Но перед тем как вы сможете это сделать, нужно подтвердить свой Email адрес. Для этого откройте ваш почтовый ящик и перейдите по ссылке в письме от Github.

Никакая настройка github не нужна, достаточно лишь несколько кликов мышкой.

2. Создание репозитория

На открывшейся странице, это главная страница для авторизованных пользователей, нажмите кнопку "Start a project" :

Вы можете сразу же инициализировать репозиторий, создав файл Readme, для этого нужно отметить галочку "Initialize this repository with a README" внизу страницы. Также можно выбрать лицензию:

Когда все будет готово, выберите "Create project" , будет создан новый проект с файлом README, в котором находится описание и файлом лицензии.

3. Добавление веток

Ветки Github позволяют работать с несколькими версиями проекта одновременно. По умолчанию при создании репозитория создается ветка master, это основная рабочая ветка. Можно создать дополнительные ветки, например, для того, чтобы тестировать программное обеспечение перед тем, как оно будет опубликовано в ветке master. Таким образом, можно одновременно разрабатывать продукт и предоставлять пользователям стабильную версию. Также можно создавать отдельные ветки для версии программы для разных систем.

Текущая ветка обозначена в верхнем левом углу после слова "Branch". Чтобы создать новую ветку просто разверните этот список и начните набирать ее имя:

Сайт сам предложит вам создать новую ветку, выберите "Create branch".

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

4. Изменение файлов и коммиты

Любые изменения файлов на Github делаются с помощью коммитов. Коммит выполняется путем внесения самих исправлений и описания этих исправлений. Это необходимо для того, чтобы вы знали что и когда вы меняли, а также позволяет легко отслеживать работу команды. Слово коммит можно перевести как "фиксировать". То есть мы можем внести изменения в несколько файлов, а затем их зафиксировать. Давайте для примера изменим файл README. Для этого найдите в в правой стороне панели кнопку с кисточкой и нажмите на нее:

Откроется текстовый редактор, где вы можете ввести нужные вам исправления:

После того как вы сделаете все что вам нужно, необходимо заполнить поле "Commit" внизу страницы. Кратко опишите что было изменено, а затем нажмите кнопку "Commit changes" :

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

5. Создание запросов слияния (Pull Request)

GitHub для начинающих может показаться очень сложным именно из-за таких возможностей, но это очень удобно если разобраться. Запрос слияния или Pull Request - это возможность, благодаря которой любой разработчик может попросить другого, например, создателя репозитория просмотреть его код и добавить его в основной проект или ветку. Инструмент работы с запросами слияния использует инструмент сравнения diff, поэтому вы можете увидеть все изменения, они будут подчеркнуты другим цветом. Pull Request можно создать сразу же после создания коммита. Давайте отправим Pull Request из нашей testing ветки в основную. Сначала откройте вкладку "Pull Request".

Здесь нажмите кнопку "Create Pull Request" :

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

6. Просмотр и одобрение запросов на слияние

Теперь, на той же вкладке Pull Requests мы видим только что созданный запрос на слияние и нам остается только принять его нажав "Merge Pull Request" :

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

Затем код будет импортирован в основную ветку, а ветка testing может быть безопасно удалена.

7. Отчеты об ошибках

Удобно еще то, что возможно использование GitHub не только для разработки и управления кодом, но и для обратной связи с пользователями. На вкладке "Issue" пользователи могут оставлять сообщения о проблемах, с которыми они столкнулись при использовании вашего продукта. Откройте вкладку "Issues" , и нажмите на кнопку "New issue" :

8. Релизы

Последнее что мы сегодня рассмотрим - это релизы. Когда продукт достиг определенной стадии можно выпустить релиз, чтобы пользователи и вы могли быть уверенны что там все стабильно и никто ничего не сломал неверным Pull Request в Master. Сначала нужно перейти на главную страницу проекта, затем на вкладку "Releases" :

На этой странице нужно указать версию в поле "Tag Version" , затем имя релиза и небольшое описание. Если у вас есть скомпилированные архивы с бинарниками то их тоже нужно прикрепить сюда. Затем нажмите "Create Release" :

После создания релиза будет создана такая страничка:

Выводы

В этой статье мы рассмотрели как пользоваться GitHub для размещения и управления своим проектом. Вся система на английском, так что базовые знания языка очень желательны но даже без них работа с github будет не очень трудной. Надеюсь, эта информация была полезной для вас. Если вас интересует как работать с Git из командной строки, смотрите статью для начинающих.

Если Вы решили сделать первые шаги на пути использования VCS (Version Control System), то Вы уже должны понимать насколько это полезная вещь. Преимуществ использования подобных систем масса, но статья не об этом. В этой статье я расскажу как начать работать (под windows 7) с одной из самых популярных систем контроля версий — Github.

Очень часто в свободной речи мы говорим не гитхаб, а просто гит имея ввиду ресурс https://github.com, однако, это не совсем одинаковые вещи. Сам по себе ресурс гитхаб, это веб оболочка системы по контролю и управлению нашими проектами. Это своего рода социальная сеть для разработчиков и не только по php, но и по другим языкам программирования. Что же касается непосредственно гита, то это программа, которую мы будем ставить на наш компьютер/ноутбук.

Для того, чтобы приступить к работе, нам надо будет скачать две программы:

1. msysgit. Скачать последнюю версию можно отсюда -> Git
2. TortoiseGit (32bit и 64bit)

После того, как Вы скачали эти две программы, начнем их установку.

Обратите внимание! Сначала нам надо поставить msysgit , а после — TortoiseGit

Процесс установки msysgit интуитивно понятный, поэтому останавливаться на нем мы не будем. Единственное — все настройки, что нам предлагаются в процессе установки можно не менять и оставить их по-умолчанию.

Укажите тот пункт, который Вы видите на скрине выше.

После установки этих пакетов, считайте, что первый этап пройден. Второй этап — получение доступа к нашему репозиторию на Github.

Для начала нам надо пройти регистрацию на сайте https://github.com . Регистрация на этом сайте простая и мало чем отличается от подобных операций на других сайтах.

Обратите внимание! Во время регистрации указывайте реальный email, которым Вы пользуетесь

После этого, нам нужен будет тот имеил, который мы указали при регистрации. Если Вы вдруг забыли какой именно указали при регистрации, то его можно посмотреть в разделе Edit Profile -> Emails (https://github.com/settings/emails) и в главном окне Вы его увидите:

Тут закончили, теперь нам надо сгенерировать SSH key. Это такая цифровая подпись для Вашего компьютера. Чтобы получить этот ключ, нам понадобится тот самый git. После его установки у Вас на рабочем столе должен был появиться ярлык Git Bush. Двойное нажатие на него запустит консоль.

Обратите внимание! Если у Вас нет на рабочем столе этого ярлыка, то эту командную строку можно вызвать так: на рабочем столе, на свободном месте вызовите контекстное меню мышью и в списке пунктов Вы найдете тот самый Git Bush

Теперь в командной строке необходимо выполнить команду:

ssh-keygen -t rsa -C "E-Mail из Вашего профиля"

После этого, здесь же, появится надпись «Enter file in which to save the key». Пока мы оставим все как есть и просто нажмем Enter. Теперь нас просят ввести пароль, пока мы пропустим и этот шаг нажав Enter, но в последствии этот пароль можно будет ввести самостоятельно. После этого у нас сгенерируются два файла — один из них будет нашим SSH ключом.

Обратите внимание! У Вас может быть не установлен модуль ssh-keygen и вышеописанная команда попросту не сработает, а как следствие — ключ генериться не будет. В таком случае либо качайте программы вроде putty. Более подробно в статье на хабре -> http://habrahabr.ru/ . Либо используйте соединение по протоколу HTTPS.

Если Вы все делали как описано в этой инструкции и ничего в процессе не меняли, то файлы будут находиться здесь: C:/users/{UserName}/.ssh/

В этой папке нам нужен будет файл ida_rsa.pub , который надо открыть при помощи обычного блокнота и скопировать содержимое в буфер обмена (попросту говоря, в открытом файле нажать Ctrl+A, затем Ctrl+C).

Следующим шагом настройки, будет занесение этого ключа в Ваш профиль на гитхабе. Для этого идите в настройки Вашего профиля: Settings -> SSH Keys и нажмите кнопку Add SSH key, как показано на скрине ниже.

Перед Вами открылась форма с двумя полями:

1. Title

Тайтл оставляйте пустым, а вот в поле Key вставьте скопированный ранее текст из файла ida_rsa.pub .

Поздравляю, еще один этап окончен. Еще совсем чуть-чуть и Вы сможете наслаждаться работой в своем собственном репозитории.

Теперь создайте отдельную папку на локальном хосте в которой будет храниться Ваш проект и вызовите на ней контекстное меню. Затем выберите пункт TortoiseGit -> Settings как показано на скрине:

В открывшемся окне слева, Вы увидите древовидное меню. Вам нужно выбрать Git -> Config и записать свое имя и адрес имейла в точности такой же, как Вы указывали при регистрации на гитхабе.

Теперь нам надо клонировать (скопировать) репозиторий на наш компьютер. Для этого перейдите на гитхабе в свой созданный репозиторий и справа вы увидите его адрес:

Скопируйте этот адрес в буфер обмена. Теперь вызовите контекстное меню на папке, которую Вы создали под свой проект и выберите команду «Git Clone…» :

У нас открылось окно куда нам надо вставить скопированный адрес нашего репозитория:

Обратите внимание на поле Directory — иногда может быть дописана еще одна папка. Проследите чтобы там путь был к вашей папке с проектом, а не какой-нибудь другой. Теперь нажимайте ОК. Начинается клонирование:

Продолжение статьи о работе с Git. Учимся добавлять файлы, коммитить и пушить >

Сегодня я расскажу о GitHub – сервисе для работы с системой контроля версий Git, которая является важным инструментом командной разработки. В этой статье вы узнаете о его основных возможностях и предназначении, познакомитесь с процессом настройки и установки на компьютер, чтобы приступить к использованию.

Зачем нужен Git

Git позволяет возвращать отдельные файлы и весь проект к прежнему состоянию, просматривать происходящие со временем изменения. Определять, кто последним вносил изменения во внезапно переставший работать модуль, отследить цепь событий, которая привела к ошибкам и многое другое. Одним из наиболее популярных ресурсов для работы с Git является GitHub. Для удобства работы с ним существует графический клиент GitHub Desktop и консольный Git Shell. В статье рассмотрен пример работы с использованием этого сервиса и его графического клиента.

Основные возможности GitHub

Этапы разработки

С помощью вкладки commits вы можете изучить историю разработки проекта: когда и кем были внесены изменения в какие файлы и строки, как развивался проект в целом. Коммиты (“commit” - фиксировать) - записи изменений в репозиторий.

Даты последних изменений в файловом каталоге п роекта на сайте GitHub
История изменений в текущей ветке в клиенте GitHub Desktop.

Контроль версий

Git позволяет создавать несколько различных, параллельных версий проекта – веток, каждая из которых предназначена для разных целей. Допустим, у вас есть работающий проект. Основная ветка проекта – master. В ней хранится последняя стабильная версия. Для добавления в проект новой функциональности необходимо создать отдельную ветку, при этом данные изменения никак не отразятся на основной версии. Можно переключаться между ветками, что приведёт к изменению файлов локальной версии репозитория.

Работа с ветками в GitHub Desktop

Начало работы

Как развернуть локальный репозиторий

Начнем с того, что для работы с Git необходима локальная копия (клон) удаленного репозитория – папка на компьютере, в которой будут храниться его файлы. С ними вы будете в дальнейшем работать.

Для клонирования репозитория существующего проекта зайдите на страницу вашего проекта, выберите нужный репозиторий, в открывшемся меню нажмите Clone or download, затем – Open in Desktop.

Откроется Git клиент, где вам будет предложено выбрать директорию для скачивания репозитория. После скачивания файлов попробуйте внести изменения в какой-нибудь файл репозитория – они сразу отобразятся в Git клиенте в разделе Changes:

Если вы хотите отменить изменения – нажмите правой кнопкой мыши на галочку напротив файла. Появится вкладка Discard changes. Чтобы отменить изменения во всех файлах – нажмите на самую верхнюю галочку, затем Discard all changes.

Также вы можете развернуть локальный репозиторий, который затем можно синхронизировать c GitHub, нажав на кнопку Сreate. Чтобы добавить существующий репозиторий на вашем компьютере – нажмите Add:

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

Для создания новой ветки нажмите на кнопку слева от названия ветки. Новая ветка образуется от той, которая указана; изменения, которые есть в текущей ветке, но отсутствуют в мастере, будут перенесены в новую ветку.Для того чтобы начать работу с последней актуальной версией, нажмите кнопку Sync – ваш локальный репозиторий синхронизируется с удалённым. В локальном репозитории появятся все последние версии файлов. Если вы забудете синхронизироваться перед началом работы, может возникнуть ситуация, когда вы внесли изменения в старую версию файла. В таком случае возникает конфликт ваших изменений с изменениями в актуальной версии. Объединять их вам придется вручную. Процесс этот порой может быть довольно долгим и трудоёмким. Для того чтобы сделать коммит, нужно ввести общее название изменений (Summary). В description описывается, какие изменения были внесены. Оно не является обязательным. Ваш коммит появится в разделе History.

После этого тоже обязательно синхронизируйтесь. Для того чтобы другие разработчики узнали о внесённых вами изменениях и рассмотрели их для внесения в одну из веток, существует действие под названием Pull request. После отправки Pull request’a разработчики знакомятся с изменениями, оставляют комментарии к коду, вносят правки и при необходимости добавляют коммиты.

Ваш реквест появится во вкладке “Рull requests” на странице проекта, поделитесь ссылкой на него с другими участниками. Можете снова добавлять коммиты в созданную ранее ветку, они отобразятся в пулл-реквесте. Когда все изменения будут согласованы, ветки смёрджат (merge - операция слияния веток), пулл-реквест будет закрыт и все изменения окажутся в ветке, в которую он был сделан.

Итоги

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

1. Стать пользователем сервиса github.com и присоединиться к проекту

2. Установить клиент Github Desktop

3. Клонировать нужный репозиторий и начать работать с ним в клиенте