Всем привет! 

techwriter.ru.com
Внимание! У нас сбои с почтовым сервером! Если не пришло письмо о регистрации или смене пароля напишите нам на info@techwriters.ru!
@twriters чат для технических писателей в Telegram
05.12.2014 09:16:05
[QUOTE]zukatoka пишет:
Спасибо вам всем большое, начиталась ваших советов, перерыла форумы, решаюсь на MadCap Flare, т.к. понимаю, что моментальный переход на технологию DITA будет немного сложным, все-таки, если правильно понимаю, MadCap Flare это какой-то переходный продукт и мне будет в нем проще, хотя бы благодаря понятному интерфейсу. Возникли только три важных вопроса: 1) Есть ли у данного продукта русскоязычная поддержка? Куда можно обращаться, если зайду в тупик? 2) Позволяет ли данная программа делать ссылки на разные топики внутри одного документа? Допустим, могу ли я внутри выходного документа word настроить перекрестные ссылки? А есть ли возможность однократной настройки перекрестных ссылок в едином источнике и затем использования их в разных выходных форматах? 3) Я так понимаю, интерфейс программы на английском языке, а возможно ли её русифицировать? Может быть отдельно можно где-то купить (скачать) русификатор? [/QUOTE]Думаю, будет правильно вот сюда обратиться и всё уточнить :) |
|
|
05.12.2014 09:14:05
[QUOTE]ADVANCED пишет:
Внутри процесса генерации как бы выстраивается полная карта документа из всех задействованных файлов, включая ссылки на внешние документы. Выполняется разбивка на книги, документы, разные структуры и т.п., отбрасывая (фильтрами) ненужные файлы, выполняется нумерация всех разделов, таблиц, рисунков, приложений, примечаний и всего что можно/нужно нумеровать. А потом применяются стили к каждой единице документа (сайт это или отдельный PDF или CHM или электронные книги без разницы). В стилях можно выводить номера, можно их отображать своими шрифтами и делать что угодно, обрезать, сокращать и т.д. [/QUOTE]CSS позволяет создавать генерируемое содержимое и автоматически нумеровать главы, рисунки, списки с помощью CSS-счётчиков внутри глав, книг, разделов. Для этого просто нужно корректно настроить таблицу стилей. |
|
|
04.12.2014 09:42:20
[QUOTE]zukatoka пишет:
Для того, чтобы параллельно можно было генерить разные форматы приходится настраивать вручную подпись к каждому рисунку, причем как настроить автоматическое обновление нумерации по всему документу в процессе именно разработки, вообще тайна из тайн. [/QUOTE]Автоматическая нумерация рисунков - проблема и для HTML-справок, в чём бы они ни разрабатывались. У меня пока что для этого есть только одно решение - CSS-счётчики. |
|
|
02.12.2014 08:46:36
[QUOTE]writer пишет:
В 2015 году из-за спада в экономике работодатели могут отказаться от традиционной индексации заработных плат. Повышения будут «точечными» – только тем сотрудникам, которых работодатель захочет удержать во что бы то ни стало о том, что все будет плохо написано [url=http://top.rbc.ru/economics/01/12/2014/54786d20cbb20f5ec0136bd1?utm_source=newsmail&utm_medium=news&utm_campaign=news_mail2]здесь[/url] [/QUOTE]Мне кажется, всегда так и было :) |
|
|
27.11.2014 16:38:58
[QUOTE]s.chaschin пишет:
Подскажите, как правильно назвать такое выделение текста? [/QUOTE]Начертание. |
|
|
27.11.2014 16:35:26
[QUOTE]Ден пишет:
вообще она (сущность) это, собственно, название настройки. К ней привязывается одна настройка, с помощью, которой она выбирается, а во второй настройке, что она будет делать. Вообщем, такое триединство :D .. [/QUOTE]Может, тогда так и оставить "сущностью"? Как второй вариант, можно назвать "объектом" :) |
|
|
24.11.2014 11:42:51
[QUOTE]fs444 пишет:
Знаю, что можно подключить один tex-файл в другой, лежащий в той же папке. Но как выйти на уровень вверх? [/QUOTE]Необходимо указать относительный путь к файлам. См. пример: 1. Путь к файлам: 2. Содержимое файла doc3: 3. Если поменяю для doc2 название папки:
Изменено: techwriter - 24.11.2014 11:43:13
|
|
|
23.11.2014 19:48:44
[QUOTE]arm пишет:
Если проще, то у меня есть рукописный файл помощи (1), в который я хочу автоматически встроить другой CHM (2), сгенерированный Sandcastle help file builder-ом. Я могу генерить html для второго CHM, но как мне встроить эти страницы в проект (1) так, чтобы при изменении (добавлении/удалении) новых страниц в (2) они автоматически попадали в TOC файла (1)? Цель в том, чтобы генеря при каждом билде файл(ы) (2) он автоматически встраивался в результирующий файл (1) под определенной нодой в дереве TOCа. Честно говоря удивлен, что этот довольно простой сценарий не поддерживается системами генерации справок. Тем более, что CHM это всего лишь ZIP с определенным форматом. [/QUOTE] Думаю, что это слишком сложная схема. Но, возможно, решение есть. Правда, я его не вижу. CHM на сегодняшний день устаревший формат. Но периодически его поддерживают. Я тоже в данный момент делаю самописный CHM, пока средство разработки справок других электронных форматов в закупке. По моим прогнозам, в скором будущем его вообще перестанут разрабатывать и поддерживать.
Изменено: techwriter - 23.11.2014 19:49:22
|
|
|
21.11.2014 11:32:49
[QUOTE]arm пишет:
Ищу среду создания файлов помощи в разных форматах с такими требованиеми: есть (1) CHM справка для разработчиков, генерится отдельной тулзой, (2) глобальный проект помощи, который содержит различные кастомные (вручную написанные) разделы помощи. Файл (1) должен быть включен/вложен/импортирован под определенной мной нодой в TOC помощи. Т.е. при генерации помощи из проекта (2) в нужный формат (на сейчас нужны CHM и HTML для онлайн помощи) файл (1) должен также попасть в сгенерированную помощь. Т.к. файл (1) в CHM формате, DrExplain должен распаковать его на HTML файлы и вложить в результирующую сгенерированную справку. Файл (1) будет строится при каждой сборке проекта, поэтому импортнуть его содержимое в отдельный проект (если DrExplain это позволяет) без авто-обновления содержимого - не вариант. Вопрос: DrExplain позволяет это сделать? [/QUOTE]Я думаю, что CHM все равно генерируется из HTML и должны быть HTML-исходники? Поэтому вряд ли должны возникнуть проблемы с импортом. Вот, другой вопрос я не очень поняла. Т.е., у вас есть TOC, который хочется тоже "встроить" в проект? |
|
|
19.11.2014 11:39:46
![]()
techwriter.ru.com
|
|||
|
13.11.2014 10:44:49
[QUOTE]writer пишет:
Ого, год издания 1908?? А так думаешь что в это время темные люди жили) [/QUOTE]Да, 1908 год :)) Я случайно наткнулась на эту книгу, когда писала об истории технического писателя для своего блога :))) Решила прочитать. В целом, мысли многие очень правильные. Правда, язык отличается от современного английского, что может вызвать трудности при чтении. |
|
|
12.11.2014 17:26:05
[QUOTE]''ivs0'' пишет:
А вы хотите что-то "свое" в ГОСТы написать? :-) Или Вы предпочитаете взять оригинальные тексты 50-ти документов ГОСТ, свести их по перекрестным ссылкам, проверить их актуальность и скачать новые тексты, все это прочитать, запомнить и с легкостью всем этим пользоваться? Ну, каждый сам решает. [/QUOTE]Просто смысла в таких книгах не вижу. Это мое личное мнение. |
|
|
11.11.2014 11:35:31
[QUOTE]fs444 пишет:
Нужно настроить конвертацию latex в html. Нашел в интернете кое-какую информацию, но все на английском и я пока не понял, заработает ли) Кто какими инструментами пользуется для этого? [/QUOTE]Попробуйте конвертер. Например, в TeXStudio есть встроенный конвертер в HTML. |
|
|
10.11.2014 09:44:34
[QUOTE]writer пишет:
нет, тут скорее всего имеется ввиду специфика удаленной работы. Не каждый сможет так работать, кого-то нужно пинать и следить за тем чтобы он работал, а на удаленной работе такого нет. Это как школа и институт, в школу нужно обязательно ходить на все уроки, в институте можно пропускать лекции, но главное чтобы сдать экзамены :) [/QUOTE]Это точно. Человек должен уметь себя организовать и вовремя выдать хорошего качества работу. Да и тема непростая. Надо самостоятельно понять, как работает устройство. Для этого нужно иметь, как минимум, высшее техническое образование, хорошо знать физику, схемотехнику, автоматизацию технологических процессов в этой области. Мое мнение, для достижения хорошего результата (=получения качественной документации) лучше взять двух специалистов: технического специалиста и технического писателя. Иначе велика вероятность, что один человек с этим не справится.
Изменено: techwriter - 10.11.2014 09:45:03
|
|
|