LINUX.ORG.RU

Нужна сложная версионность для word

 , , ,


3

2

Здравствуйте.
Есть группа организаций (больше 10, а потом их будет еще больше).
Требуется для них вести документацию по системе. Система имеет некоторые отличия от организации к организации.
При этом требуется чтобы:
1. Каждая организация видела только общую для всех часть документации и ту, которая относится только к ней;
2. Чтобы была возможность контролировать новые версии документации, что-то вроде git.

К примеру в word, аналоги рассмотрю.
В документации кроме описания приводятся примеры запросов, кода, скриншоты.

Наверняка такое есть, подскажите, пожалуйста.


При написании диплома использовал megacloud. Каждое сохранение файла создавало новую версию. Доступ тоже наверняка можно организовать, облачное хранилище же.

l4gfcm ★★
()
Ответ на: комментарий от l4gfcm

Нужно видеть разницу по содержимому и возможность управлять составом содержимого

NoName
() автор топика

Двусмысленное описание. Что значит «сложная версионность»? Мержи нужны или доработка каждого конкретного файла всегда линейна?

Вобщем, если нужны - то для word'а ничего не выйдет.

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

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

Но в рамках одного файла выделить «это общее, это тем. а это тем» наверно ни в каком готовом продукте нет.

firkax ★★★★★
()
Ответ на: комментарий от Zhbert

Я не знаю что это, но из названия уже очевидно что оно не подходит по первому пункту. Гугл будет видеть и общую часть и все приватные.

firkax ★★★★★
()
  1. Переводишь организацию на LaTeX.
  2. У каждой организации свои репозитории.
  3. Дальше всё как у программистов.
ugoday ★★★★★
()
Последнее исправление: ugoday (всего исправлений: 1)
Ответ на: комментарий от NoName

Латех это текст со всеми плюсами и минусами. Если документ идёт на сторону, то другая сторона хочет как правило его исправить, а латехом пользоваться не умеет (вордом тоже).

einhander ★★★★★
()
Ответ на: комментарий от NoName

Подводных камней не будет?

Будут. Хомяки не осилят.

Zhbert ★★★★★
()
Ответ на: комментарий от einhander

pandoc -s my_latex_document.tex --bibliography=my_bib_file.bib -o resulting_word_document.docx

Не правда?

Я изначально думал про latex, сейчас больше склоняюсь что это было правильное предположение. Только откуда столько негатива что будут якобы с ним проблемы?

NoName
() автор топика
Последнее исправление: NoName (всего исправлений: 1)
Ответ на: комментарий от NoName

Смотря что за организации. Если научные институты, то всё ништяк, а вот вообразить бухгалтерш в латексе … не-не-не-не, я лучше даже начинать не буду.

ugoday ★★★★★
()
Ответ на: комментарий от NoName

А зачем latex? У вас сложное форматирование? Если нет, то можно что-то из автоматических генераторов документации типа gitbook, asciidoctor использовать. Там в основе текстовые файлы (markdown итп), легкие для редактирования, поддерживаются генераторы схем а-ля PlantUML, формулы и т.д. Хранишь эти исходные файлы в git, и «компилируешь» по мере надобности.

cocucka ★★★★☆
()
Ответ на: комментарий от ugoday

Один вопрос просится.
Допустим есть дока на Latex и есть git.
Как разнести разное содержимое относительно общего содержимого?
Отдельных веток с одной и той же докой для этого не достаточно - это неудобно (но лучше чем ничего). Нужно что-то, что вставляло бы в нужные области документа нужные куски частностей.

NoName
() автор топика

Проще перейти на какой нибудь MarkDown, AsciiDoc, Latex и т.п. и выкинуть офисные пакеты.

X512 ★★★★★
()
Ответ на: комментарий от NoName
  1. Зависит от сложности документа. В простых случаях точно работает, но пользователи такие затейники.

  2. Нужна и обратная команда. Иначе diff будет сложно сделать.

ugoday ★★★★★
()
Ответ на: комментарий от NoName

Сложно сказать без деталей, но разные части документа могут быть вынесены в подпроекты git, которые затем можно подключать директивами \input и \include.

ugoday ★★★★★
()

Word - двоичный формат, либо конвертировать в текстовый, либо поменять формат. Идеально: использовать легковесные языки разметки.

anonymous
()
Ответ на: комментарий от NoName

А ворд бесплатный чтоль? Да и у гитбука полно бесплатных альтернатив.

cocucka ★★★★☆
()
Ответ на: комментарий от ugoday

в основном редактировать будут в данном случае разработчики, так что не проблема

NoName
() автор топика
Ответ на: комментарий от ugoday

т.е. отдельные ветки будут содержать \include, а он будет вести на файл с дополнением. Прикольно. Похоже это то, что нужно. Поделитесь опытом, кто использовал, важно каждое сообщение.

NoName
() автор топика
Ответ на: комментарий от NoName

Я в ЛаТеХе диплом верстал. Доволен аки слон контрастом с сокурсниками у которых картинка на полпикселя съехала —> пол диплома расхерачило.

ugoday ★★★★★
()
Ответ на: комментарий от ugoday

без обид, но похоже на красноглазие

NoName
() автор топика
Ответ на: комментарий от ugoday

Вот захотел человек и на изи освоил

NoName
() автор топика
Ответ на: комментарий от ugoday

Возможно ли из latex получить доступ к версии git коммита?

UPD. А нет, нужно просто скрипт, который будет sed дергать и менять выходной файл

NoName
() автор топика
Последнее исправление: NoName (всего исправлений: 1)
  1. Для красноглазиков умеющих git

    • Markdown + Pandoc.

      Умеет:

      • Конвертировать в docx/html/latex, причём можно добавлять файлы шаблонов.
      • Поддерживает расширение функционала через «плагины-фильтры».

      Делал в своё время docx-отчёт на 100 с лишним страниц и внушительным списком литературы (спасибо за bibtex, pandoc-crossref, pandoc-citeproc)

      Среди минусов:

      • Не умеет сложных таблиц.
      • Без Makefile - сложно собирать.
      • По умолчанию не умеет инклудить файлы.
      • Установка через cabal иначе сложно состыковывать с плагинами.
    • Различные Markdown движки.

      Таких достаточно много, что-то для книг, что-то для конкретных ЯП, что-то для вики. Все с теми или иными прибобахами. Как пример, «R Markdown».

    • Asciidoctor

      • Удобно вести документацию разбитую на несколько файлов.
      • Экспорт в html и pdf.
      • Параметры для изменения вида/поведения внутри документа, что позволяет легче интегрировать в различные популярные IDE (можно определить параметры в отдельном файле и инклудить в остальных).

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

    • DocBook и прочие когда-то подававшие надежды форматы. (Но блин всё это Г).

    • LaTeX не рекомендую рассматривать. Очень много мелкой работы. Даже при наличии таких пакетов, как TikZ, tcolorbox, и т.д., наличии xelatex и много чего ещё. Это всё равно инструмент не для каждого.

  2. Для остальных только за денежку, но что там нынче популярно ещё вопрос. Смотри в сторону Onlyoffice, SharePoint и т.д. и т.п. Так или иначе именно системы документооборота позволяют распределить права, вести историю, одновременно редактировать. Последнее избавляет от слияния в стиле git.

AlexVR ★★★★★
()

На латех этих дебилов пересади, тогда никаких проблем не будет с поддержкой git’а.

anonymous
()
Ответ на: комментарий от NoName

Не правда?

Это хорошо в теории, на 95% документов будет выглядеть хорошо, на остальных криво, в первую очередь таблицы. Но это мое ИМХО, попробуйте вдруг действительно подойдёт.

einhander ★★★★★
()
Ответ на: комментарий от PPP328

Не нравится, не удобно.
Буду из LaTeX лучше в confluence экспорт делать

NoName
() автор топика
Ответ на: комментарий от NoName

много ума не нужно

А тут не в уме дело. Пятидесятилетние тетки в латексе — зрелище строго на любителя.

А то, что ты имеешь в виду, называется Латех.

Nervous ★★★★★
()
Ответ на: комментарий от Nervous

http://www.inftyreader.org/2021/09/09/one-page-subject-specific-pdf-files/

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

NoName
() автор топика
Последнее исправление: NoName (всего исправлений: 1)
Ответ на: комментарий от anonymous

ещё есть SILE на Lua – типа TeX

как один из форматов оно понимает XML, возможно, кто-то когда-то допишет стиль для .xml.zip = .docx или .odt (если не уже есть docbook).

anonymous
()

С латехом основная проблема — склонить всех участников документооборота работать с ним. Вот даже ты вместо «Microsoft Word» обтекаемо пишешь просто «word», как будто это не название коммерческого проприетарного текстового процессора с множеством ограничений, а имя нарицательное, что-то абсолютно естественно присутствующее на ПК. А многие именно так его и воспринимают. Попробуй затащи этих людей на латех, мотивируя это тем, что у тебя так версионирование будет работать, удачи. Конвертирование между латехом и вордом — тоже процедура не безболезненная, если что.

А судя по строчке

  1. Каждая организация видела только общую для всех часть документации и ту, которая относится только к ней

вам, вероятно, нужна не привычная для программистов VCS, а система документооборота или даже PDM-система (трудно сказать, не зная, что это за система, которую вы документируете). Версионирование там по сравнению с git и др. будет рудиментарным, зато разделение доступа может быть весьма продвинутым, с упором именно на документ как основную сущность.

Ещё вопрос: те самые организации участвуют в разработке документации или пользуются ей строго как потребители?

hobbit ★★★★★
()
Последнее исправление: hobbit (всего исправлений: 1)
Ответ на: комментарий от anonymous

english ... do you speak it?

docx ущербен в части версионности

latex
git diff --color-words

так показывает разницу графически и все!

NoName
() автор топика
Ответ на: комментарий от hobbit

Только пользуются. Там небольшое количество инструкций как пользоваться ПО, сомневаюсь что есть необходимость в системе документооборота.

NoName
() автор топика
Ответ на: комментарий от einhander

Попробовал, работает
еще конвертнул через abiword тоже работает, там другой конвертер

NoName
() автор топика
Ответ на: комментарий от Shadow

Судя по версии и дате оно умерло. А мертвым пользоваться это неправильно

NoName
() автор топика
Вы не можете добавлять комментарии в эту тему. Тема перемещена в архив.