О данном сайте

Что это за сайт

Здесь мы (сообщество Metapractice — http://metapractice.livejournal.com) будем выкладывать в «чистовой» форме статьи, руководства, технические описания и прочую документацию по вопросам моделирования человеческой активности. Сообщество в ЖЖ продолжит функционировать в том виде, в котором функционировало и ранее — итерационное обсуждение и последовательная ротация тем.

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

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

Быстрый старт

Кратко:

Пишем текст

Документация пишется на простом языке разметки reStructuredText.

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

Подробное описание языка разметки можно найти в соответствующем разделе документации:

http://sphinx-ru.readthedocs.io/ru/latest/rst-markup.html#id4

Для начала работы не требуется каких-либо специальных знаний: вы просто пишете текст, который следует изложить.

Сохраняем изменение в облаке

То место, где хранятся все тексты и полная история их изменений (кто, когда, что дополнил, убрал или изменил), называется репозиторием. В качестве облачного сервиса для хранения репозитория мы используем ГитХаб.

Не откладывая в дальний ящик, предлагаю пройти простую процедуру регистрации (потребуется указать никнейм, электронную почту и пароль):

https://github.com/join

С тем, как у вас появился аккаунт (и администратор репозитория Metapractice дал ему доступ на запись), вы можете прямо из интерфейса самого ГитХаба отредактировать страницы данного сайта — обратите внимание на ссылки в левом меню.

Изменения в репозитории на ГитХабе автоматически (спустя пару минут) будут подхвачены данным сайтом.

Работаем локально

Для локального храниния репозитория требуется установить Git-клиент. Имеется множество разных клиентов под разные операционные системы.

Для быстрого начала работы рекомендуем воспользоваться официальным клиентом ГитХаба:

https://github-windows.s3.amazonaws.com/GitHubSetup.exe

Зачем нужна локальная работа с репозиторием?

Веб-интерфейс ГитХаба ограничен в возможностях.

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

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