Оставить заявку

izogfif (Все сообщения пользователя)

Внимание! У нас сбои с почтовым сервером! Если не пришло письмо о регистрации или смене пароля напишите нам на info@techwriters.ru! 
@twriters
 obmen_soobsheniyami.pngчат для технических писателей в Telegram

 Зарегистрируйтесь
Выбрать дату в календареВыбрать дату в календаре

Страницы: 1 2 След.
Встроенная коррекция изображений в Эксплейне
 
Здравствуйте!

Пожалуйста, пришлите файл проекта Dr.Explain и сгенерированный CHM в техподдержку по адресу help@drexplain.com (или через [URL=https://indigobyte.freshdesk.com/support/tickets/new]сайт[/URL]) для исследования. Если проект большой, либо вы не хотите отправлять его целиком, создайте новый проект Dr.Explain, скопируйте в него раздел с проблемным изображением и отправьте уже его.
Локализация - работа с переводами
 
Здравствуйте!

На настоящий момент экспорт и импорт в / из форматы, поддерживаемые ПО для автоматизированного перевода в разработке. При необходимости перевести документ небольшого размера рекомендуется экспортировать в HTML (или, лучше, - в CHM), перевести результат экспорта и импортировать обратно в Dr.Explain (если в этом есть необходимость - иногда достаточно получить перевод справки). Если документация большого размера, либо часто обновляется, свяжитесь с техподдержкой - возможно, вам предоставят доступ к бета-версии, в которой экспорт и импорт из XLIFF уже реализован.
Переиспользование текста
 
[QUOTE]Еще один вопрос: возможно ли в качестве переменных использовать что-то кроме текста, например, изображения? Может быть как-то через специальные переменные?[/QUOTE]

Нет, к сожалению, пока что нет.
Переиспользование текста
 
Здравствуйте!

К сожалению, на данный момент требуемый функционал (conditional section) в программе отсутствует.

Можно попробовать применить следующий подход: все разделы под все подсистемы пишутся в одном и том же проекте. Когда нужно создать файл с документацией (например, PDF) для первой подсистемы, все разделы, не относящиеся к этой подсистеме, маркируются как неэкспортируемые (правой кнопкой по разделу, далее выбрать "Показать/скрыть" из выпадающего меню). Разделы, относящиеся только к одной подсистеме, можно помечать цветом, выставляя им статус - "в процессе", "закончено" или "ожидается" - это дает желтый, зеленый и красный цвета фона.
Если нужно скрыть раздел вместе со всеми подразделами, достаточно применить операцию "Скрыть" к этому разделу, все подразделы будут исключены из экспорта автоматически.

Чтобы не менять вручную уникальные для каждой подсистемы настройки (например, колонтитулы, строки и переменные), можно поступить следующим образом: для каждой подсистемы создать отдельные проекты, у которых выставить нужные настройки (меню Настройки->Настройки проекта), и сохранить их под различными именами (например, подсистема1.gui). Разделов в этих проектах может и не быть, будут использоваться только их настройки. Далее, в основном проекте, перед экспортом справки, нужно зайти в меню Настройки и выбрать пункт Импорт настроек. Далее в открывшемся диалоге нужно указать путь к проекту, из которого будут импортироваться настройки (например, подсистема1.gui) и нажать кнопку Импорт.

Мы планируем добавить возможность использования содержимого разделов для нескольких проектов в будущих версиях программы.
о файле CSS, где его сохранять
 
[quote]Но после компиляции СНМ стили не видны.[/quote]
Возможно, стили перекрываются стилями по умолчанию. Можете прислать файл проекта (или новый проект, у которого прописан CSS, если содержимое проекта нельзя разглашать третьим лицам) в техподдержку на help[собачка]drexplain[точка]com?
Собственный баннер для страниц справки СНМ
 
Попробуйте следующее:
[LIST=1]
[*]Создайте пустую папку C:\dechm
[*]Откройте проект в Dr.Explain.
[*]Перейдите в меню Настройки->Настройки проекта->CHM экспорт.
[*]Укажите в поле "Рабочий каталог" C:\dechm
[*]Положите картинки в эту папку.
[*]В коде баннера укажите в качестве адреса рисунка image.png (где image.png - это название файла с изображением баннера; полное название должно быть C:\dechm\image.png, но указывать нужно только часть без пути к файлу).
[*]Экспортируйте проект в CHM.
[/LIST]
Ссылка на место в тексте
 
[quote]Добрый вечер! Подскажите пожалуйста с внутренними ссылками что то изменилось? Есть более простой, понятный и удобный вариант их создания?[/quote]

Нет, пока что нет.
Структура разделов, В итоговом документе темы не сворачиваются.
 
Попробуйте перейти в меню Настройки -> Настройки проекта -> HTML экспорт -> Структура страницы и поменяйте тип левого меню со "Статическое" на "Динамическое, изначально свернуто".
Out Of Memory, Как не вовремя
 
Можно разбить проект на несколько отдельных, а потом перед созданием выходного файла копировать разделы в один большой проект. В зависимости от того, сколько оперативной памяти установлено на компьютере, количества одновременно запущенных программ размера редактируемого проекта ошибка OutOfMemory может происходить реже или чаще.
Изображения
 
[QUOTE]'''ADVANCED''' написал:
на первоначальном этапе подготовки скриншота надо думать о размерах[/QUOTE]
Говоря о размерах, вы имеете в виду ширину и высоту изображения, или размер файла с изображением в байтах? При работе с Dr.Explain можно вставить изображение, выставить ему ширину и высоту, а на выходе получить файл с изображением в максимальном качестве.
Изображения
 
[QUOTE]Бесполезный обезьяний труд, не находите? [/QUOTE]
Все зависит от того, что вкладывается в понятие "подготовить скриншоты" (в первом и втором упоминяниях), каковы трудозатраты (в первом и втором случаях) и чего нужно добиться. Если размер выходного файла (набора файлов) устраивает, то ничего делать и не нужно. Если же во что бы то ни стало нужно получить выходной файл минимального размера, то, вероятно, следует поискать способы. Например, написать скрипт (.bat-файл), который будет вызывать программу-упаковщик изображений после HTML-экспорта. Если такой скрипт один раз написан, то кроме двойного щелчка после экспорта (или вместо экспорта, если экспортировать через консольную программу deexport.exe, и включить вызов этой программы в .bat-файл) ничего не потребуется.
Изображения
 
На данный момент этот функционал не отключается. Чтобы уменьшить размер выходных файлов перед выгрузкой на сайт, можно воспользоваться программами-оптимизаторами PNG-файлов (например, tinypng или pngquant), либо сконвертировать в другой формат после экспорта.
Изображения
 
Здравствуйте!
Dr.Explain сохраняет изображения в формате PNG для того, чтобы избежать искажений, ухудшающих качество изображения при использовании алгоритмов сохранения изображений с потерями (например, JPEG).
Возможно ли предварительное указание точного расположения отдельного контента?
 
Откройте ваш проект в Dr.Explain, а затем проделайте следующее:

[COLOR=#FF0000]В ПРИВЕДЕННЫХ НИЖЕ ОТРЫВКАХ КОДА В НАЧАЛЕ И В КОНЦЕ НУЖНО УБРАТЬ ПРОБЕЛ ВНУТРИ "sc ript" ЧТОБЫ БЫЛО "script"[/COLOR]
[LIST=1]
[*]Перейдите в меню "Настройки->Настройки проекта". В левой части выберите "HTML экспорт", а в нижней части правой в разделе "Структура страницы" нажмите на кнопку "Настроить".
[*]В открывшемся диалоге "HTML шаблон и раскладка" нужно в левом верхнем углу отметить флажок "Детальная настройка". При этом в левой части станет видимой кнопка "До тега BODY, внутри тега HEAD". Нажмите эту кнопку и в правой части в текстовое поле введите следующий код:

[CODE] <sc ript type="text/javascript">
function updateElement(element, sourceUrl, partId)
{
$.ajax({
url: sourceUrl,
dataType: "html"
})
.done(function(data, textStatus, jqXHR) {
var t = $(data);

var curDiv = t.find("#" + partId + "Begin").parent("div")[0];
var siblings = new Array();
var cur = $(curDiv);
while (true)
{
if (cur.length == 0)
break;
siblings.push(cur[0]);
if ($(cur).find("#" + partId + "End").length == 1)
break;
cur = $(cur).next();
}
var insertion = $("<div></div>");
$(siblings).each(function(){
insertion.append($(this));
});
//var t = data;
//alert(t);
$(element).empty().prepend(insertion);
// alert("second success");
})
.fail(function(jqXHR, textStatus, errorThrown) {
console.log(errorThrown);
alert("error: status = " + textStatus + ", errorThrown = " + errorThrown);
});
}
</sc ript>
[/CODE]
[*]Нажмите OK / OK, чтобы сохранить изменения в настройках.
[*]Создайте раздел, фрагменты которого будут показываться в других разделах. В левом нижнем углу в поле "Имя файла" введите "tempfrag".
[*]В этом разделе перед (можно в начале абзаца) текстом, который вы хотите показывать в качестве фрагмента, вставьте HTML-фрагмент (комбинация Ctrl+Shift+S в редакторе). В появившемся окне введите следующий код:
[CODE] <div id="partOneBegin"></div>[/CODE]
и нажмите OK. Вставьте другой фрагмент в конце текста:
[CODE] <div id="partOneEnd"></div>[/CODE]
[*]В том разделе, в котором вы хотите показать фрагмент, добавьте HTML-фрагмент с кодом
[CODE] <sc ript type="text/javascript">
$(document).ready(function(){
updateElement(".m-pageContent__side__header", "tempfrag.htm", "partOne");
});
</sc ript>
[/CODE]
[/LIST]
Если нужно, чтобы фрагмент отображался в нижней части, поменяйте ".m-pageContent__side__header" на ".m-pageContent__side__footer", а чтобы показывался внутри основной части - на ".description_on_page".

Здесь "partOne" - это идентификатор фрагмента. Для нескольких фрагментов текста идентификаторы должны быть разными. Саму страницу "tempfrag.htm" можно создавать вручную, например, в текстовом редакторе, либо в отдельном проекте, а после HTML-экспорта загружать в ту же папку, куда был загружен результат HTML-экспорта проекта со вставками.

Проект, демонстрирующий описанное выше, находится в прикрепленном архиве.
Объединение CHM
 
К сожалению, в полностью автоматическом режиме без использования сторонних утилит сделать это не получится. Можно поступить следующим образом:
1) Создаете проект-заготовку в Dr.Explain. Настраиваете все пути, стили, форматирование и т.п. Открываете раздел, в качестве подразделов которого будете импортировать CHM-файл позднее и сохраняете проект. Сделайте резервную копию (на всякий случай).
2) Перед тем, как собрать финальный CHM или HTML, делаете копию этого проекта, открываете копию в Dr.Explain и находите нужный раздел, щелкаете по нему правой кнопкой мыши и выбираете "Добавить->Импортировать внешние файлы" из выпадающего меню. Указываете ваш CHM-файл и проводите импорт. Получаете проект, в котором часть разделов написана вами, а другая часть - импортирована из CHM-файла.
3) Далее проверяете правильность импортирования, делаете экспорт в нужные форматы и закрываете проект не сохраняя (или можно сохранить под отдельным именем файла, чтобы потом можно было что-нибудь подправить).

Если хронических проблем с импортом нет, можно какой-нибудь программой автоматизации воспользоваться, чтобы она сама имитировала щелчки мыши и нажатия на кнопки в окнах, например, AutoIT.
Изменено: izogfif - 26.11.2014 19:24:38 (Добавлена информация об автоматизации.)
Ненумерованный список, замена символов
 
[QUOTE]ADVANCED пишет:
А смысл такую программу использовать?[/QUOTE]

Не думаю, что ответ на этот вопрос относится к обсуждаемой теме. Попробуйте поискать статьи, в которых сравниваются различные программы для создания файлов справки, там наверняка будет подробно рассмотрены преимущества и недостатки.
Ненумерованный список, замена символов
 
[QUOTE]Другое дело если он "вшит" в код[/QUOTE]

Именно так и обстоит дело. Для каждой строки-элемента списка генерируется XML-код, содержащий символ маркера. Удобного интерфейса, позволяющего в программе выбрать, какой символ будет отображаться в качестве маркера, пока что нет. Поэтому могу предложить лишь поправить файл, из которого собирается PDF.
Ненумерованный список, замена символов
 
[QUOTE]ADVANCED пишет:
[QUOTE] izogfif пишет:
многабукаф
....
Будет открыт XML-шаблон, на основе которого генерируется PDF.
[/QUOTE]

А нельзя сразу исправиль XML файл без таких махинаций по запуску и паузам процессов?
Он наверняка где-то лежит в директории установки программы, главное его найти.
[/QUOTE]Файл генерируется при экспорте, поэтому править нужно после экспорта.
Ненумерованный список, замена символов
 
Можно поступить следующим образом.
Закрыть все приложения Dr.Explain, кроме одного.
Экспортировать проект в PDF один раз, сохранить его.
Открыть диспетчер задач (Ctrl+Shift+Esc), перейти на вкладку "Процессы" (Windows XP, Vista, 7) или "Детали" (Windows 8, 8.1), найти процесс drexplain.exe и выделить его, щелкнув левой кнопкой мыши.
Перейти в Dr.Explain и начать экспорт в PDF.
Перейти в Диспетчер задач и расположить его так, чтобы было видно окно Dr.Explain с отчетом об экспорте в PDF.
Как только появится строка "-- Запускаю FO преобразователь:" (в английской версии "-- Running FO converter:"  ;)  , нужно прервать процесс drexplain.exe: находясь в Диспетчере задач, нужно на клавиатуре нажать клавишу Delete, а после этого Enter. При этом на диске останутся временные файлы.
Далее нужно создать папку C:\temp, в ней подпапку C:\temp\fo.
Нажать комбинацию клавиш <клавиша с логотипом Windows>+<R>. Появится окошко "Выполнить". В нем нужно набрать %temp% и нажать Enter. Откроется папка с временными файлами. В ней нужно отсортировать элементы по дате изменения (это можно сделать, если поменять стиль отображения на "таблицу"  ;)       и найти папку с именем вида 0001PDFExport, которая была создана менее минуты назад. Нужно зайти в эту папку и скопировать все файлы в C:\temp\fo. Необходимо убедиться, что в ней появится файл C:\temp\fo\__template.fo.Далее нужно запустить приложение Блокнот и в нем написать следующее:

"C:\Program Files\Java\jre6\bin\java.exe" -Xmx1024m "-Djava.util.logging.config.file=C:\temp\fo\logging.properties" -classpath "c:\Program Files\DrExplain\fop.jar" org.apache.fop.cli.Main -c "C:\temp\fo\fop.xconf" "C:\temp\fo\__template.fo" -pdf "C:\temp\fo\__template.pdf"
pause


Где C:\Program Files\Java\jre6\bin\java.exe - путь к файлу java.exe. Нужно поменять его на подходящий, в зависимости от того, 32-битная или 64-битная у вас система, а также от того, какая версия Java установлена на компьютере.

Аналогично, нужно поправить путь к файлу c:\Program Files\DrExplain\fop.jar - смотря куда был установлен Dr.Explain.

Далее, нужно сохранить файл как C:\temp\pdf_command_line.bat. Чтобы указать расширение .bat, нужно в блокноте в окне сохранения поменять в выпадающем списке "Тип файла:" с "Текстовые документы (*.txt)" на "Все файлы (*.*)", затем перейти в папку C:\temp и в поле "Имя файла" набрать "pdf_command_line.bat".

Затем нужно открыть папку C:\temp и двойным щелчком по файлу pdf_command_line.bat запустить на выполнение экспорт PDF. Когда операция закончится, появится сообщение "Для продолжения нажмите любую клавишу . . ." и окошко можно будет закрыть. Если все пути были указаны верны, в папке C:\temp\fo появится файл C:\temp\fo\__template.pdf. Щелкните по нему и проверьте, что все экспортировалось в PDF правильно.

Теперь можно приступить к замене маркеров списков.

Запустите Блокнот, в меню "Файл" выберите "Открыть...".
Из выпадающего списка "Кодировка" выберите "UTF-8".
В поле "Имя файла" укажите "C:\temp\fo\__template.fo". Будет открыт XML-шаблон, на основе которого генерируется PDF.
Нужно найти и заменить все фрагменты текста с
<fo:inline role="list-item-label">• </fo:inline>
на
<fo:inline role="list-item-label">■ </fo:inline>
после чего сохранить файл и запустить C:\temp\pdf_command_line.bat еще раз. В файле C:\temp\fo\__template.pdf все маркеры списка должны поменяться с кружков на квадратики.
Неудобство редактирования, Планируется ли это?
 
<quote>Или может уже есть какой-то обходной путь?</quote>
Пока что только копировать содержимое по одной ячейке. У нас эта задача есть в списке, но мы заняты более приоритетными.
Как изменить внешний вид локальной справки
 
[quote:x3bkt4rd]Неужели нет совсем никакого выхода из данной ситуации?[/quote:x3bkt4rd]
Можно поставлять справку в формате HTML, например, размещать ее в папке
c:\Program Files (x86)\YourApplication\Help\
и открывать нужный HTML-файл.
Как изменить внешний вид локальной справки
 
Здравствуйте.

К сожалению, окно программы-просмотрщика CHM-файлов едино для всех версий Windows. Модифицировать вид левой части со списком разделов существенным образом (например, заменить все иконки слева от разделов на новые) не получится, поскольку эта самая левая часть не является частью HTML-страницы.
Windows 8 - не работают горячие клавиши (мыши и клавиатуры)
 
Сообщите, пожалуйста, какая версия Windows 8 используется (Consumer Preview, Developer Preview, Release Preview, RTM и т.п.), а также какая редакция: обычная или Pro. Какой язык интерфейса установлен? Проблема с захватом наблюдается только в Вашей программе, или же в любой? Пожалуйста, перезагрузите компьютер, и, не запуская других программ, откройте калькулятор, запустите Dr.Explain и попытайтесь сделать захват окна калькулятора разными способами: PrintScreen, Ctrl+Click, нажатием обеих кнопок мыши одновременно. Что получится? Можно ли скачать Вашу программу для тестирования захвата скриншотов?
Оглавление, титульная страница и др.
 
Здравствуйте!
[quote="kknop":3nh9mv45]1) каким шрифтом делается оглавление в PDF-документе? Где (в каких астройках) и как можно этот шрифт выбрать и поменять?[/quote:3nh9mv45]
Оглавление делается шрифтом Arial, 10 пунктов. Его поменять нельзя.
[quote="kknop":3nh9mv45]2) каким шрифтом делается титульная страница для PDF-документа, какой именно текст в нее попадает и как можно это все настроить?[/quote:3nh9mv45]
Она делается со шрифтом Arial, 20 пунктов (первая строка) и Arial, 10 пунктов (вторая строка). На нее попадает название первого  раздела проекта (первая строки) и содержимое текстовой строки (меню Настройки->Настройки проекта...->Текстовые строки->Заголовки->"Руководство пользователя"). Поменять шрифты и отредактировать страницу нельзя.
Импорт закладок
 
Попробуйте создать копию Вашего документа, оставьте пару разделов (остальное удалите) и замените текст абракадаброй. Пришлите такой документ на support[собака]drexplain.com.
Страницы: 1 2 След.

Рейтинг@Mail.ru