Comments 30
Первые два инструмента не подошли по одной и той же причине: нам нужны были навыки программирования
Во-первых, вроде и не нужны, а во-вторых, отсутствие навыков это не повод использовать какие-то странные решения, а повод найти человека с навыками или научится.
0
UFO just landed and posted this here
Я к сожалению ни разу не пользовался системами для работы с документацией, но имею приятный опыт написания ЕСКД/ЕСПД документации в формате PDF.
Связка LaTex с git хорошо покрывает задачи совместного редактирования, а одна хорошо написанная преамбула может гарантировать единый воспроизводимый стиль документа.
Тут конечно есть порог входа, плюс не всегда потребители документации хотят использовать что-то кроме docx формата.
Связка LaTex с git хорошо покрывает задачи совместного редактирования, а одна хорошо написанная преамбула может гарантировать единый воспроизводимый стиль документа.
Тут конечно есть порог входа, плюс не всегда потребители документации хотят использовать что-то кроме docx формата.
0
Да, в нашем случае потребители ЕСКД документов хотят работать исключительно с docx.
0
Вот уж точно, latex здесь лучше всего использовать, тем более есть пакет eskdx.
Docx, заказчик собирается редактировать эти документы? Тогда с вероятностью 100% документ поплывет. Хотя я сдавал заказчику docx полностью сделанный из картинок из pdf.
0
При каждой новой правке свёрстанного в MS Word документа примерно в половине случаев «съезжают» скриншоты, «плывут» таблицы с иконками, а при печати документа и вовсе внезапно появляются невидимые пустые страницы.
Вообще, так быть не должно. Word при корректной вёрстке выдает достаточно стабильный (стабильно хороший :-) результат на сложных документах. Возможно, вам надо не забывать добавлять разрывы между разделами документов, либо неправильно настроены параметры вставки изображений/таблиц.
0
Зачастую недостатки вёрстки выявляются после конвертации docx в pdf, при этом документ docx выглядит хорошо. На «отлавливание» причин уходит иногда достаточно много времени.
0
Вообще, так быть не должно. Word при корректной вёрстке выдает достаточно стабильный (стабильно хороший
По ЕСКД? Чтобы отступы и толщины линий — в мм, некратно долям дюйма? Я его в этом плане так и не победил. Приходится все размеры «прибивать гвоздями» (думаешь — пропади оно пропадом, уже бы в postscript написал), а потом одно неловкое движение мышки сбивает всё обратно на 2,54 и тому подобное.
0
Я правда, не понимаю, в чем у вас проблема. В Word есть в параметрах переключатель единиц измерения по умолчанию, хотите — дюймы, хотите — сантиметры/миллиметры, хотите типографские пункты. При этом если будут выбраны, например, сантиметры, все отступы будут исключительно в сантиметрах, и никак не будут сбиваться на доли дюйма. Единственное, размеры шрифта и толщины линий задаются всегда в типографских пунктах, а не в дюймах/миллиметрах. Но тут ничего хитрого, 1 мм примерно равен 2.8pt, для корректной вёрстки этого знания достаточно.
0
При каждой новой правке свёрстанного в MS Word документа примерно в половине случаев «съезжают» скриншоты, «плывут» таблицы с иконками, а при печати документа и вовсе внезапно появляются невидимые пустые страницы.
Это звучит как «Мы не хотели учиться работать в Word, и вместо этого начали учиться работать в Confluence». Инструмент, несомненно хороший, и радостно за вас, что в итоге получилось сделать некую базу знаний. Но проблемы с Word, так понимаю, остались. Может, посмотреть теперь в сторону обучения работы с ним?
0
Проблем с MS Word и экспортом в PDF больше нет, так как теперь мы создаём в нём только ЕСКД документы и используем docx — эти документы не нуждаются в экспорте в PDF. Пользовательская документация в свободной форме (не ЕСКД) создается в Confluence и экспортируется в PDF плагином с сохранением вёрстки.
0
Привет коллегам! Тоже больная тема. Сколько Word уже существует, а всё равно кривой. И никуда от него не денешься, потому что сам-то можешь писать в чем угодно, но если надо заказчикам отдавать на согласование — делать нечего.
Когда нужно отдать финальный документ без возможности правки — пишу в LaTeX. Конечно, в начале нужно нормально так посидеть поковыряться, постучаться головой об стол из-за очень «понятных» ошибок компиляции, но потом привыкаешь и работать становится даже удобно. Никаких проблем с разметкой, содержанием, со слетевшей нумерацией и форматированием. Насколько знаю, *.tex формат через pandoc можно конвертировать в *.docx (либо в промежуточный, а потом в *.docx).
Когда нужно отдать финальный документ без возможности правки — пишу в LaTeX. Конечно, в начале нужно нормально так посидеть поковыряться, постучаться головой об стол из-за очень «понятных» ошибок компиляции, но потом привыкаешь и работать становится даже удобно. Никаких проблем с разметкой, содержанием, со слетевшей нумерацией и форматированием. Насколько знаю, *.tex формат через pandoc можно конвертировать в *.docx (либо в промежуточный, а потом в *.docx).
+1
С pandoc у меня так и не получилось сделать нумерацию всех элементов которые есть в latex. Буду признателен если у вас есть какой-нибудь рецепт для этого.
0
Да. Я тоже двигался от Латеха, но пришел к org-mode.
Вендорлокнутый формат емакса, но благодаря открытости хорошая интероперабельность. Хотя, конечно, не хватает опубликованного стандарта.
Пандок умеет напрямую конвертировать в латех. Там можно наложить оформление eskdx и вывести в pdf.
Самое приятное — ворд по сути и не понадобится. Org-mode отлично читается в любом текстовом редакторе. Все-таки, документы нужны для совместного редактирования. Отправить org-mode можно любому рецензенту. Он может внести правки и вернуть документ. Выявить правки легко с помощью git. В моем случае — gitea.
А редактировать в емаксе его — одно удовольствие: тут тебе и сворачиваение глав, и автоматичиеское форматирование таблиц и вставка ссылок.
Если орг-мод не подходит, то следующий кандидат — Asciidoc. К сожалению, тулинг у него практически отсутствует. Я редактирую в VSCode. Просматриваю в браузере.
Конвертация в .tex средствами pandoc вроде хорошая, но я не пробовал.
Вендорлокнутый формат емакса, но благодаря открытости хорошая интероперабельность. Хотя, конечно, не хватает опубликованного стандарта.
Пандок умеет напрямую конвертировать в латех. Там можно наложить оформление eskdx и вывести в pdf.
Самое приятное — ворд по сути и не понадобится. Org-mode отлично читается в любом текстовом редакторе. Все-таки, документы нужны для совместного редактирования. Отправить org-mode можно любому рецензенту. Он может внести правки и вернуть документ. Выявить правки легко с помощью git. В моем случае — gitea.
А редактировать в емаксе его — одно удовольствие: тут тебе и сворачиваение глав, и автоматичиеское форматирование таблиц и вставка ссылок.
Если орг-мод не подходит, то следующий кандидат — Asciidoc. К сожалению, тулинг у него практически отсутствует. Я редактирую в VSCode. Просматриваю в браузере.
Конвертация в .tex средствами pandoc вроде хорошая, но я не пробовал.
0
Плюсую LaTeX. И в docx, и в pdf и вообще во всё.
+1
Посмотрите по теме DocOps — много интересного для вашего случая можно найти.
0
Концепция единого источника, несомненно, очень помогает повышению производительности совместной работы. Я сам постоянно в поиске идеального инструмента для создания и поддержания проектной документации.
Конечно, самое популярный инструмент — это Конфлюенс. Он не идеален.
Разработчики тяготеют к работе с маркдаун + git.
Поэтому обратите внимание на gitlab.iaaras.ru/iaaras/gostdown
Вполне возможно, что для ваших коллег будет трудновато освоить разметку и SourceTree, но в конечном итоге, это того стоит.
Конечно, самое популярный инструмент — это Конфлюенс. Он не идеален.
Разработчики тяготеют к работе с маркдаун + git.
Поэтому обратите внимание на gitlab.iaaras.ru/iaaras/gostdown
Вполне возможно, что для ваших коллег будет трудновато освоить разметку и SourceTree, но в конечном итоге, это того стоит.
0
Из серии примеры борьбы с MS Word.
В ИПА РАН создали инструмент написания документации в Markdown с последующей генерации их в docx и pdf gitlab.iaaras.ru/iaaras/gostdown
В ИПА РАН создали инструмент написания документации в Markdown с последующей генерации их в docx и pdf gitlab.iaaras.ru/iaaras/gostdown
0
Sign up to leave a comment.
Как мы искали замену MS Word, а вместо этого внедрили новый процесс управления документами