Помощь - Поиск - Пользователи - Календарь
Полная версия этой страницы: Кто в чем делает документацию
Форум разработчиков электроники ELECTRONIX.ru > Cистемный уровень проектирования > Документация
S_agent
Утро,вечер,день добрый! smile.gif

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

сеньк.
iosifk
Цитата(S_agent @ Jul 9 2010, 11:59) *
Интересуют сабжевые инструменты, позволяющие сделать и заэкспортить в pdf с оглавлениями порядка трех сотен страниц с картинками, и без уездов форматирования при изменениях.


Help and Manual версия 4 или 5...


Maverick
Цитата(iosifk @ Jul 9 2010, 11:02) *
Help and Manual версия 4 или 5...

а ссылку на сами программы, можно?

прошу прощения нашел здесь
iosifk
Цитата(Maverick @ Jul 9 2010, 12:38) *
а ссылку на сами программы, можно?

Надо качнуть с их сайта дополнительные словари для русского языка...
Я этой прогой пользуюсь и когда пишу тексты, вместо ворда. Только там есть два правила: все картинки должны иметь "Адрес"... Т.е. их кельзя просто вставить копированием. После этого, надо их "Конвертировать"... Тогда НМ будет знать, где они лежат... И есть опция, которая автоматически под каждым рисунком пропишет название его файла...
Ну а уж если "скормить" путь к компиляторам, то можно делать всякие СНМ и прочее.
PDF печатаем по шаблону, умеет делать многостраничные документы. У меня на сайте есть мои воспоминания о работе на Байконуре, там 70 страниц. Вот они и сделаны в НМ... И диск по "Краткому Курсу" я тоже делал в НМ...
В версии 4 были проблемы с крокозябрами, я знаю как их править. По почте могу ответить. А в 5 версии вроде все в порядке...
S_agent
Цитата(iosifk @ Jul 9 2010, 11:02) *
Help and Manual версия 4 или 5...

Спасибо, то что нужно!
iosifk
Цитата(S_agent @ Jul 9 2010, 13:12) *
Спасибо, то что нужно!

Еще забыл сразу написать. Там есть возможность делать "клик-зоны" на картинках. Это очень удобно, когда кликая по блок-схеме сразу попадаешь на нужный фрагмент...
Ну и вложенные проекты - тоже очень удобно для работы в команде. Каждый ведет свой раздел, потом они комилятся в единый выходной файл...
А если к этому добавить еще Камтазию или DemoBuilder, то и совсем круто будет...
S_agent
Цитата(iosifk @ Jul 9 2010, 12:24) *
Еще забыл сразу написать. Там есть возможность делать "клик-зоны" на картинках. Это очень удобно, когда кликая по блок-схеме сразу попадаешь на нужный фрагмент...
Ну и вложенные проекты - тоже очень удобно для работы в команде. Каждый ведет свой раздел, потом они комилятся в единый выходной файл...
А если к этому добавить еще Камтазию или DemoBuilder, то и совсем круто будет...

буду внедрять smile.gif, еще раз спасибо.
dch
Цитата(Maverick @ Jul 9 2010, 12:38) *
а ссылку на сами программы, можно?

Под линукс чтони будь есть кроме инструментов типа ps2pdf
nikolascha
Цитата(S_agent @ Jul 9 2010, 10:59) *
Утро,вечер,день добрый! smile.gif

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

сеньк.
А Latex вам для этой цели не подойдет?
Джеймс
Цитата(S_agent @ Jul 9 2010, 11:59) *
порядка трех сотен страниц с картинками, и без уездов форматирования при изменениях.

Все фирменные datasheet-ы делаются в Adobe Frame Maker
http://en.wikipedia.org/wiki/Adobe_FrameMaker
Yra
Цитата
Все фирменные datasheet-ы делаются в Adobe Frame Maker


По моему, не все. В LaTeX много чего делают. Система мощнейшая, кроссплатформенная причем.

Я последнее время в LaTeX делаю документацию. Заточил стили под ЕСКД и норм. Больше нет у меня гимора с ручной нумерацмей/перенумерацией рисунков, переносом таблиц на другую сторону, расползанием формул, генерацией содержания и др... Сложные рисунки типа схемы технологического приспособления вставляю на заключительном этапе. Благо нормоконтроль требует многостраничные tiff - документы. Прям сразу подменяю страницы с рамками и штампами. Исходник документа можно бить на несколько файлов (по главам) и в параллель править. Только надо договориться о ссылках между главами. Исходник - текстовый файл, который можно затолкать в mercurial (hg). В общем, документ с течением времени становится только лучше и любое изменение в нем не приводит к кашмарным последствиям....

Ko4egap
LaTeX давным давно стал стандартом для технической доккументации. В европах в научные журналы статьи принимаются только в LaTeX, или за дополнительную плату преводят из ворда, диссертация - тоже только в LaTeX. Только мы тормозим как всегда.
bigal
OpenOffice.org Writer неплохо справляется. Таблицы и рисунки экспортируются в PDF нормально.
Русскую версию и документацию можно скачать здесь http://www.i-rs.ru/Produkty/OpenOffice.org/Skachat
ukpyr
а в чем лучше делать документацию с экспортом в HTML (для сайта) и в PDF ?
желательно бесплатное и кроссплатформенное.
dissector
Цитата(ukpyr @ Aug 26 2010, 14:25) *
а в чем лучше делать документацию с экспортом в HTML (для сайта) и в PDF ?
желательно бесплатное и кроссплатформенное.

Есть такая штука, называется Serna. Бесплатные версии для винды и линукса.
ukpyr
кто-нибудь успешно использовал texinfo http://www.gnu.org/software/texinfo/ ?
У меня какие-то проблемы с кириллицей - выводит кракозябры...
halfdoom
Цитата(Yra @ Jul 13 2010, 16:27) *
Я последнее время в LaTeX делаю документацию. Заточил стили под ЕСКД и норм.
Завершили и мы переезд под LaTeX. Все более чем удобно, качество выходного документа отличное. Но самое главное: забили в библиотеку компонентов новое поле 'Ref Name', изначально пустое. Теперь, допустим из документации нужно сослаться на микросхему DA14, которая является выходным RF усилителем. Если документация пишется после того как проект зафиксирован, то проблем нет - так и пишем 'DA14'. Но часто проект и дока развиваются одновременно, в этом случае при перенумерации элементов на схеме придется вносить изменения в текст. В LaTeX это решается просто и изящно: в отчетах системы проектирования генерируем файл вида:
Код
\def \refRFAmp{DA14}
\def \refRFMixer{DA11}
где строка 'RFAmp' берется из вышеупомянутого поля 'Ref Name'. В LaTeX просто включаем этот файл и можно не думать о позиционном номере:
Код
\include{prj-refnames}

% Пример ссылки на RefDes
Сигнал с выхода смесителя \refRFMixer{} после фильтрации поступает на выходной усилитель \refRFAmp{}, а затем...

Modest
Help and manual скачал , а там всего 2 недели для пробы. Есть ли где сказать реально бесплатную версию?
Спасибо!
comper
а вот от этих парней тулсы кто-нить пробовал?
по-моему "космический корабль" просто - умеет все...и pdf viewer мне их очень нравится заодно...
пользуюсь в основном для конвертинья чертежей из автокада
Serpento
Цитата(halfdoom @ Sep 2 2010, 19:37) *
Завершили и мы переезд под LaTeX. Все более чем удобно, качество выходного документа отличное. Но самое главное: забили в библиотеку компонентов новое поле 'Ref Name', изначально пустое. Теперь, допустим из документации нужно сослаться на микросхему DA14, которая является выходным RF усилителем. Если документация пишется после того как проект зафиксирован, то проблем нет - так и пишем 'DA14'. Но часто проект и дока развиваются одновременно, в этом случае при перенумерации элементов на схеме придется вносить изменения в текст. В LaTeX это решается просто и изящно: в отчетах системы проектирования генерируем файл вида:
Код
\def \refRFAmp{DA14}
\def \refRFMixer{DA11}
где строка 'RFAmp' берется из вышеупомянутого поля 'Ref Name'. В LaTeX просто включаем этот файл и можно не думать о позиционном номере:
Код
\include{prj-refnames}

% Пример ссылки на RefDes
Сигнал с выхода смесителя \refRFMixer{} после фильтрации поступает на выходной усилитель \refRFAmp{}, а затем...


Пробую внедрить Latex в своём бюро. Для простоты использую связку Latex-Lyx. Заморочек чуть больше но писать намного проще и быстрее чем в чистом Latex. Могу помочь с шаблонами и примерами.
Vadim
Написал для себя латеховский класс pcbdoc. С его помощью оформляю перечени элементов, спецификации, инструкции по настройке, схемы электрические принципиальные, сборочные чертежи, чертежи печатных плат и даже наклеечки для дисков. Очень доволен и с ужасом вспоминаю свои потуги делать все это во всяких компасах, вордах, и даже казалось бы специально заточенного для оформления чертежей менторовского Drawing Editor, тормознутого, кривого и падучего.
iosifk
Цитата(Modest @ Oct 10 2010, 20:23) *
Help and manual скачал , а там всего 2 недели для пробы. Есть ли где сказать реально бесплатную версию?


Бесплатную ищите на netz.ru или на сайтах, где есть серийники...
Serpento
Цитата(Vadim @ Mar 24 2011, 01:01) *
Написал для себя латеховский класс pcbdoc. С его помощью оформляю перечени элементов, спецификации, инструкции по настройке, схемы электрические принципиальные, сборочные чертежи, чертежи печатных плат и даже наклеечки для дисков. Очень доволен и с ужасом вспоминаю свои потуги делать все это во всяких компасах, вордах, и даже казалось бы специально заточенного для оформления чертежей менторовского Drawing Editor, тормознутого, кривого и падучего.

можно посмотреть?
Vadim
В смысле исходники выложить? Не вопрос, но чтобы кто-то смог ими воспользоваться, надо сначала документацию написать sad.gif
nikolascha
Цитата(Vadim @ Mar 24 2011, 23:16) *
В смысле исходники выложить? Не вопрос, но чтобы кто-то смог ими воспользоваться, надо сначала документацию написать sad.gif
У нас есть для этого площадка. Вики для написания документации очень удобна...
Vadim
Цитата(nikolascha @ Mar 25 2011, 07:33) *
Вики для написания документации очень удобна...

Удобнее, чем latex? sm.gif
Serpento
Цитата(Vadim @ Mar 25 2011, 00:16) *
В смысле исходники выложить? Не вопрос, но чтобы кто-то смог ими воспользоваться, надо сначала документацию написать sad.gif

выкладывайте, посмотрим
mdmitry
Цитата(Vadim @ Mar 25 2011, 21:58) *
Удобнее, чем latex? sm.gif

???
Посмотрите пакеты до их установки средствами LaTeX (например, Foiltex). Большинство из них САМОдокументированы!
Обычная поставка:
readme.somename (readme file)
somename.ins (driver file for unpacking the code)
somename.dtx (user guide and documented source)
nikolascha
Цитата(Vadim @ Mar 25 2011, 20:58) *
Удобнее, чем latex? sm.gif
Смотря для каких целей. Если нужен совместный доступ к редактированию, то вики конечно удобней, а если нужно печатное качество, то конечно латех. В контексте написания инструкции к пакету, то, возможно, на вики лучше...
Vadim
Ок, выкладываю. Имейте ввиду, что

1. Класс заточен для xelatex. Входные файлы, следовательно, должны быть юникодные. Шрифт используется гостовский юникодный от аскона. К сожалению, не знаю, как заставить xelatex наклонять шрифт (подозреваю, что пока это невозможно, может быть, в будущих версиях появится такая возможность), поэтому в качестве наклонного используется с трудом найденный на просторах инета юникодный шрифт, но он кривой, что порождает проблемы - при просмотре полученного pdf в Acrobat не видно точек, впрочем, evince показывает нормально. Еще - нет кавычек в наклонном шрифте, приходится переключаться на прямой. Если не устраивает xelatex, затачивайте класс под latex самостоятельно, тут я не помощник.
2. Работаю в Debian 6. Все необходимые пакеты для работы с pcbdoc там есть. Класс успешно работал и в OpenSuse11.2. На других осях, в том числе и на ЕдинственноВерной, не проверял.

Скопируйте папку pcbdoc в ~/texmf/tex/latex, шрифты из fonts - в ~/.fonts, папку exаmple - куда нибудь. Зайдите куда-нибудь/example и запустите скрипт compile.sh.
nikolascha
Решил опробовать ваш пример в XeTeX, Version 3.1415926-2.2-0.9997.4 (MiKTeX 2.9). В процессе компиляции выдаётся сообщение об ошибке:
Код
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
! This is a LaTeX bug: check coding!
! Command name `\font_set:Nnn' already defined! Current meaning:
!   \protected\long macro:#1#2#3->\tex_font:D #1=#2 at #3\scan_stop:
! See the LaTeX3 documentation for further information.
! For immediate help type H <return>.
!...............................................
l.602 \cs_new:Npn \font_set:Nnn
                                #1#2#3 {
?
Я её игнорирую, после чего какие-то pdf-файлы создаются, но так как вы не приложили эталонов, то оценить их правильность сложно.
Vadim
У меня XeTeX, Version 3.1415926-2.2-0.9995.2 (TeX Live 2009/Debian). Выкладываю example со скомпилированными примерами. Попробуйте компилить каждый документ отдельно, а не скриптом, может это позволит локализовать причину. Windows? sm.gif

Вот это наводит на размышления :
This is a LaTeX bug: check coding!
Может каким-то волшебным образом кодировка сменилась, при пересохранении, например?
1lliivv1
И вы говорите, что LaTeX лучше ворда? sm.gif Я лично сделал для себя один документ в ворде с нужными мне стилями и теперь все документы делаю из него.
halfdoom
Цитата(1lliivv1 @ Mar 28 2011, 22:21) *
И вы говорите, что LaTeX лучше ворда?

LaTex и Word это две большие разницы.
Vladex
Цитата(S_agent @ Jul 9 2010, 11:59) *
Утро,вечер,день добрый! sm.gif

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

сеньк.
Adobe InDesign или другая издательская система.
Для просмотра полной версии этой страницы, пожалуйста, пройдите по ссылке.
Invision Power Board © 2001-2025 Invision Power Services, Inc.