Внимание! Статья переведена автопереводчиком и предназначена для собственных нужд. Если есть интерес, рекомендую читать оригинал (ссылка в конце статьи).
Одним из основных проблем в процессе написания журнальной статьи — это отслеживание версий: создание, прогресс и изменения, сделанные вашими сотрудниками.
Для большинства ученых Microsoft Word пишет по умолчанию инструмент, и это как очень хороший и очень плохо в этом.
Очень хорошо, потому что особенность изменения дает это легко увидеть, что изменилось с момента последней версии, а кто сделал изменения.
Очень плохо, потому что эта функция строится вокруг одного документа Word, так что только один человек может работать на над рукописью в то время.
Это, как правило, означает отправку рукописи по электронной почте, и нужно быть очень осторожным, чтобы не путать разные версии документа, которая требует творчества .
Подходы к преодолению этих проблем предлагают:
- интегрировать документы Word, в инструменты для совместной работы, такие как Sharepoint и Office 365, или документ, файлообменников, таких как Dropbox и Google Docs (если вы используете его для этого), или
- использует различные авторинга инструмент в целом.
- Если ни один из этих подходов работает для вас, у вас есть третий вариант: использовать систему контроля версий Git .
Git является программным обеспечением, которое помогает отслеживать изменения в файлах, так что вы можете вспомнить конкретные версии позже.
Git, как правило, используется для отслеживания изменений исходного кода программного обеспечения (и был первоначально разработан Linus Torvalds для разработки ядра Linux в 2005 году), но на самом деле он может быть использован для любого файла, в котором мы хотите отслеживать версии с течением времени.
Git — это программное обеспечение с открытым исходным кодом, которая работает на локальном компьютере, поэтому, поэтому есть все основания попробовать и начать отслеживать изменения в ваших рукописях (или других сложных документах) с Git.
Каждый раз, когда вы хотите сохранить версию, не Git совершить с небольшим описанием и дополнительной метки.
Такой подход не является идеальным, так как Git был написан с исходным кодом в текстовом формате в виду, и, например, не понимает, что изменилось между двумя ревизиями документа Word.
Некоторые люди скажут вам, чтобы никогда не надо хранить двоичные файлы в системе контроля версий, но не следует слушать их.
Вместо этого нужно дать Git инструмент для преобразования документов Word в обычный текст и Git будет счастливо сказать вам, что изменилось между версиями.
Некоторые инструменты могут сделать это, но, поскольку ранее в этом месяце Pandoc может читать документы Word в DOCX формате.
Сделайте следующее, чтобы Pandoc конвертировал документы Word и сравнить изменения от слова, а не от линии (что делает больше смысла):
# .gitattributes file in root folder of your git project *.docx diff=pandoc # .gitconfig file in your home folder [diff "pandoc"] textconv=pandoc --to=markdown prompt = false [alias] wdiff = diff --word-diff=color --unified=1
Вы можете использовать Git wdiff important_file.docx чтобы увидеть изменения (с ударениями в красном цвете и вставок в зеленом), или Git войти -p —word дифференциала = цвет important_file.docx , чтобы увидеть все изменения с течением времени.
Хотя теперь вы можете отслеживать изменения документа Word, и увидеть изменения, вы также хотите, чтобы иметь возможность объединить различные версии документа Word, вместе с тем, что вы и ваши сотрудники могут работать над рукописью параллельно.
Git не может объединить двоичные файлы вместе, так что сначала необходимо преобразовать документ Word в формат, который Git понимает.
Так же, как и в предыдущем примере, можно использовать для Pandoc. Это также будет работать с HTML, но простота уценки делает это лучше подходит для управления версиями, которые не знают о разметке из этих форматов.
Одна из причин, почему Git стал настолько популярным является то, что это распределенная система контроля версий, а не централизованная система, как, например, Subversion.
Это означает, что вы можете отслеживать все изменения на локальном компьютере, но все еще может синхронизировать изменения с другим пользователем.
Github является популярным сервисом, который облегчает эту синхронизацию и добавляет некоторые полезные функции.
Один из способов сотрудничать с вашими соавторами состоит в том, чтобы создать хранилище GitHub (государственный или частный) для вашей рукописи, а также хранить эталонную версию рукописи в формате уценки.
Вместо того чтобы работать на мастер-версии непосредственно, вы должны использовать Pandoc для конвертирования туда и обратно между этой главной версией в формате уценки и ваш документ Word, и будет продолжать использовать слово как инструмент разработки.
Rakali является Pandoc инструмент, который я выпустил на прошлой неделе которые могут помочь автоматизировать этот преобразования документов.
Github имеет много особенностей, чтобы облегчить сотрудничество, которое может быть использовано здесь, например, вопросы GitHub для обсуждения и управления задачами.
Есть еще несколько грубых краев в рабочем процессе, описанном выше (например, только частичной поддержке отслеживания изменений Word), но это интересный подход к сотрудничеству с помощью Microsoft Word и Git.
И этот рабочий, конечно, могут быть улучшены также включать авторов, которые пишут в LaTeX или один из других форматов, которые поддерживает Pandoc.
Один хороший побочный эффект использования уценки в том, что Github автоматически создает веб-страницу для документа (которая не будет делать для HTML без дополнительных усилий).
Оригинал статьи: http://blog.martinfenner.org/2014/08/25/using-microsoft-word-with-git/
Здесь был Google Translate =)