Перевод книги "Pharo by example"

Здравствуйте!

Для начала надо зарегистрироваться на github.

Потом - пройти по адресу https://github.com/semka/pharo-by-example-ru и нажать кнопочку "Fork", таким образом у вашей учётной записи появится своя ветка для переводов.

После этого свою ветку надо выкачать на свой компьютер, для этого нужен клиент git под вашу ОС.

Так же потребуется сгенерировать ssh-ключи для рабочего компьютера и добавить их в настройках учетной записи, все процедуры в картинках описаны тут: http://help.github.com/linux-set-up-git/

Команда для выкачивания:

     git clone [hidden email]:$(имя вашей учетной записи)/pharo-by-example-ru.git

В моём случае, например, полный адрес [hidden email]:dmatveev/pharo-by-example-ru.git (его всегда можно узнать на странице репозитория).

Во время клонирования git спросит у вас pass phrase, по которому вы до этого должны были сгенерировать ключи.

По завершении у вас на компьютере появится директория с полным содержанием репозитория в его состоянии на данный момент. Ищете там свой файл (.tex), вносите изменения, коммитите и пушите на свой сервер :)

Чтобы сделать коммит - 

     git add путь-к-файлу-с-вашими-изменениями

     git commit -m "Комментарий коммита"

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

     git push origin master

По-умолчанию origin у вас указывает на github, master - имя бранчи, в которую производится пуш (не заморачивайтесь о бранчах). Во время пуша гит снова спросит у вас pass phrase.

Да, очень круто было бы ещё собирать книжку из исходников (latex) в pdf. Не знаю, как это делается в Windows, в Linux для сборки нужны были пакеты make, ruby и много texlive-*. У меня книжка собирается со следующими установленными пакетами texlive (Debian GNU/Linux либо Ubuntu):

texlive

texlive-base

texlive-bibtex-extra

texlive-binaries

texlive-common

texlive-doc-base

texlive-extra-utils

texlive-font-utils

texlive-fonts-recommended

texlive-fonts-recommended-doc

texlive-generic-recommended

texlive-lang-cyrillic

texlive-latex-base

texlive-latex-base-doc

texlive-latex-extra

texlive-latex-extra-doc

texlive-latex-recommended

texlive-latex-recommended-doc

texlive-luatex

texlive-metapost

texlive-metapost-doc

texlive-pictures

texlive-pictures-doc

texlive-pstricks

texlive-pstricks-doc

А собирается командой make из корневой директории проекта.

Вроде основные детали осветил. Куце и сумбурно, конечно, если что - спрашивайте.

Дмитрий

27 сентября 2011 г. 16:07 пользователь Екатерина Котикова <[hidden email]> написал:

Здравствуйте!!!


Мы студенты от Дениса Щетинина и хотим подключиться к переводу книги.
Для этого просим Вас послать нам подробные инструкции для написания
перевода в репозиторий github. Мы будем переводить главы 1,5,13.


С уважением студенты ИТ.

--
http://groups.google.ru/group/sugr

--
http://groups.google.ru/group/sugr