Культурный офтопик
 help / color / mirror / Atom feed
From: Alexei Mezin <alexei.mezin@gmail.com>
To: smoke-room@lists.altlinux.org
Subject: [room] Коллективная работа над документами
Date: Mon, 21 Mar 2022 13:48:59 +0300
Message-ID: <t19l5p$10jd$1@ciao.gmane.io> (raw)

Господа, имею вот какой вопрос:

как правильно работать коллективно над документами?


Имеется задача: написание больших многостраничных документов типа 
отчетов, документации для сертификации изделий, документации к изделиям 
и т.п. Возможно даже "по ГОСТу".

Сейчас исполнители делают это все "в ворде", синхронизируя содержимое 
через "сетевую папку". Не буду пояснять, на сколько это трэш, угар и 
сами-знаете-что.

Облачные сервисы типа гугло-докс в наше время не очень. Но, кажется, на 
раз заменяются на NextCloud, во всяком случае в наших условиях и с точки 
зрения "развернуть систему".

Однако, составление документа без разделения содержимого от оформления, 
я считаю неправильным и тупиковым путем. Какие есть альтернативы?

Я когда-то смотрел в сторону dockbook. Но XML-тэги это антигуманно, 
рекомендованные редакторы типа Oxygen слишком платные, поддержка русских 
букв при трансляции в pdf у меня так и не заработала на нашей системе. И 
непонятно, что там с трансляцией в docx, ибо "заказчик" все еще понимает 
только единственный формат.

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


Отсюда проистекает второй вопрос: ТеХ (или asciidoc, или что-там-еще) и 
коллективная работа. У кого какой опыт в данном вопросе? Какое-то 
облачное решение типа Overleaf, только облако должно быть локальное. 
Есть что-то? Или просто хранение всего дерева проектов в SVN/Git, и 
редактор для соответствующей системы разметки с поддержкой 
соответствующей системы контроля версий? И компиляция документа на 
каждой локальной машине пользователя во время работы?

Или может есть вариант чего-то типа wiki, из которой автоматическая 
трансляция в docx/pdf/odt. И вменяемая документация по настройке шаблонов.



             reply	other threads:[~2022-03-21 10:48 UTC|newest]

Thread overview: 4+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2022-03-21 10:48 Alexei Mezin [this message]
2022-03-21 22:07 ` Alexey V. Vissarionov
2022-03-22 18:50   ` Alexei V. Mezin
2022-03-23  8:11     ` Michael Bykov

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to='t19l5p$10jd$1@ciao.gmane.io' \
    --to=alexei.mezin@gmail.com \
    --cc=smoke-room@lists.altlinux.org \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link

Культурный офтопик

This inbox may be cloned and mirrored by anyone:

	git clone --mirror http://lore.altlinux.org/smoke-room/0 smoke-room/git/0.git

	# If you have public-inbox 1.1+ installed, you may
	# initialize and index your mirror using the following commands:
	public-inbox-init -V2 smoke-room smoke-room/ http://lore.altlinux.org/smoke-room \
		smoke-room@lists.altlinux.org smoke-room@lists.altlinux.ru smoke-room@lists.altlinux.com smoke-room@altlinux.ru smoke-room@altlinux.org smoke-room@altlinux.com
	public-inbox-index smoke-room

Example config snippet for mirrors.
Newsgroup available over NNTP:
	nntp://lore.altlinux.org/org.altlinux.lists.smoke-room


AGPL code for this site: git clone https://public-inbox.org/public-inbox.git