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

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

Форум » Пользователи » '''ADVANCED'''

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

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

Страницы: Пред. 1 ... 61 62 63 64 65 66 67 68 69 70 71 72 След.
DITA - формат RTF
 
RTF как-то не прижился. Зачем его формировать, если есть PDF?  Сам процесс абсолютно такой же, только для вывода output используются другие процессоры и библиотеки.
transtype=wordrtf
Установка и инсталляция DITA
 
[quote="o_alekseev":3h9k993o]У мну тоже происходит преобразование в windows-1251 - но кажись русский указатель все равно не работал...[/quote:3h9k993o] В CHM ? Тут 2 момента надо уловить. Есть кодировка HTML страницы, а есть кодировка файла.
В Linux все файлы по умолчанию сохранены в utf-8 и Linux не знает других кодировок.
В Windows каждому файлу присваивается код, который редакторы и интерпретаторы считывают чтобы понять как далее обрабатывать файл.
[quote:3h9k993o]Многие программы Windows (включая Блокнот) добавляют байты 0xEF, 0xBB, 0xBF в начале любого документа, сохраняемого как UTF-8. Это метка порядка байтов Юникода (англ. Byte Order Mark, BOM), также её часто называют сигнатурой (соответственно, UTF-8 и UTF-8 with Signature). По наличию сигнатуры программы могут автоматически определить, является ли файл закодированным в UTF-8, однако файлы с такой сигнатурой могут некорректно обрабатываться старыми программами, в частности xml-анализаторами. Такие редакторы, как Notepad++, Notepad2 и Kate позволяют явно указывать, следует ли добавлять сигнатуру при сохранении UTF-файлов.[/quote:3h9k993o] HTMLHelpworkshop как раз работает под Win и считывает этот код. Для удачной (для нас) компиляции ему нужно, чтобы 2 файла HHC (это ТОС, оглавление) и HHK (это индекс) были именно в кодировке windows-1251. С HHP все проще, в нем содержатся все страницы с текстом и поиск там работает нормально. Если нет, то также можно перекомпилировать в 1251. Тут еще может влиять язык операционки.

[b:3h9k993o]Следует различать кодировку файла 0xEF, 0xBB, 0xBF и кодировку кода[/b:3h9k993o] <?xml version="1.0" encoding="UTF-8"?>.
Уверен, что плагины и "дорогие" инструменты делают тоже самое, только за спиной пользователя. Не позволяя ему видеть что и как работает. Тем самым оправдывая свою цену. Поставил флажок, нажал ОК, получил результат.

Я пробовал вручную собирать утилитой из 3 файлов в разных кодировках, экспериментировал пока не "допер" как, что и вкаком виде требуется компилятору. Все тоже самое потом поручил делать Ant автоматически.
Установка и инсталляция DITA
 
[quote="o_alekseev":2hm4qafq]Если у вас это сделано - исходники в студию[/quote:2hm4qafq] Какие именно исходники? Как реализовано в оригинальной Dita написал в предыдущем комментарии. Больше там ничего не менялось вообще. Остальные скрипты самописные и толку от них вам будет мало. Лучше спрашивайте как сделать что-то конкретное.
Установка и инсталляция DITA
 
[quote="o_alekseev":2ym8vfj3]Плагинами "Plus" пришлось пользоваться ради указателя на русском в HtmlHelp[/quote:2ym8vfj3]
Разберу по кусочкам:
1. СHM не отображает индекс и не позволяет осуществлять поиск по страницам, файлы которых до компиляции были в кодировке UTF-8. HtmlHelpWorkshop прекрасно работает с кириллицей, у Майкрософта есть русская версия, локализхации и т.п. Кроме того, различные ПЛАТНЫЕ инструменты уже имеют в своем дистрибутиве утилиту hhc.exe, которая запускается в командной строке.

2. Редактор XML в windows позволяет сохранять файлы в разных кодировках, но FOP не воспринимает ничего кроме UTF-8, но ничего страшного в этом нет. Если у нас проект с двумя и более форматами (PDF, CHM, HTML...) то кастомизировать нужно каждый. Либо настраивай, либо плати бабло и сиди на всем готовом

3. Если кто делал CHM, то должны знать, что HtmlHelpWorkshop берет hhc, hhk, hhp и разные css.
У нас есть исходники в UTF-8. Получается, что для компиляции PDF нам с кодировками делать ничего не надо. Для решения проблемы в CHM нам нужно получить файлы HHC и HHK в кодировке windows-1251 ПЕРЕД их компиляцией в CHM.
Для этого открываем файл /ditaot/build_dita2htmlhelp.xml и ищем таргет [b:2ym8vfj3]dita.out.map.htmlhelp.hhc"[/b:2ym8vfj3]
После описания параметров таргета добавляем следующие строки:
[code:2ym8vfj3]
           <move filtering="yes" file="${output.dir}${file.separator}${dita.map.filename.root}.hhc"
                 tofile="${output.dir}${file.separator}${dita.map.filename.root}.hhc.encoded"
                 encoding="utf-8" outputencoding="windows-1251"/>
     
           <move file="${output.dir}${file.separator}${dita.map.filename.root}.hhc.encoded"
                 tofile="${output.dir}${file.separator}${dita.map.filename.root}.hhc"/>
[/code:2ym8vfj3]
[u:2ym8vfj3]Новый, только что полученный файл ditamapname.hhc пересохраняем в нужную кодировку с другим имененм, потом переименовываем обратной в исходное имя.[/u:2ym8vfj3]

Тоже самое добавляем в таргет [b:2ym8vfj3]dita.out.map.htmlhelp.hhk[/b:2ym8vfj3], соответственно изменив расширения файлов.

Далее все выполняется как задано сценарием: compile.HTML.Help, подключается компилятор HtmlHelpWorkshop и выдает готовый CHM с поиском на русском и оглавлением. BUILD_SUCCESSFUL и т.п.  :D
С плагинами, мне кажется дольше возиться.
Установка и инсталляция DITA
 
[quote="o_alekseev":3qxd6m3l][quote="ADVANCED":3qxd6m3l] может теперь разработчики тулкита и перенесли эту идеалогию и для других (кроме pdf) выводов - но как быть с плагинами...
Плагинами "Plus" пришлось пользоваться ради указателя на русском в HtmlHelp
Да и заглавочные страницы без ковыряния скриптов тулкита настроить не получалось[/quote:3qxd6m3l][/quote:3qxd6m3l] :shock:
Без плагинов справляемся. Есть папка \dita-ot\resource в которой лежат нужные css, шаблон страницы html, иконки,  скрипты и т.п. Эта папка указывается в стартовом билд-скрипте   [code:3qxd6m3l] <property name="dita.resource.dir" value="${builder.dir}\custom\newsite\resource" /> [/code:3qxd6m3l]В процессе генерации CHM, HTML содержимое именно этой папки используется в создании output.

Согласен, для решения проблемы кириллицы надо "влезть" в оригинальный код. Но там 2 строки добавить. больше изменять не нужно ничего.
Установка и инсталляция DITA
 
[quote="o_alekseev":gah3rul0]В основном много изменений связано с тем что бы получался корректный PDF, XHTML и HTMLHelp и все в рамках одного тулкита и билда...
Более того у нас клиенты (сотовые операторы) иногда просят представить документацию с их лого, реквизитами и т.д. для это в билде (см. файл DITA_OT_Tuning.xml внутри архива DITA_OT_Tuning.rar) создано свойство document.style (можно указать как "bercut", "tele2", "mts", "beeline" "megafon") и соответственно в выводе меняется под этого заказчика...[/quote:gah3rul0] Ну это и есть Кастомизация Customization. Я имел ввиду, что папка кастомизации может быть совершенно на другом сервере и для каждого заказчика своя. У тебя она называется document.style, у меня custom. В оригинальных файлах Dita эта папка задана в виде переменной и по умолчанию подразумевается "если не задан пользовательский, то использовать оригинал". Это уже предусмотрели разработчики Dita open toolkit. В идеале, по этой задумке параметр должен передаваться через bat файл (если нужно могу описать как передавать из bat разные команды Анту).

Таким образом, можно ничего не делать с оригинальной версией Ditaot, а все настройки (pdf, chm, html...), стили (для каждого заказчика), локализации (en, ru, fr ...) хранить в совершенно сторонней (-их) папке (-ах) на другом диске, сервере и т.п. Даже по каждому проекту может требоваться разное оформление, как например корп.стандарт и ГОСТ. Я делал много кастомизаций и 1 кнопкой задаю что мне надо получить.

Также может потребоваться разграничение прав на изменение тех или иных стилей. Например, когда стиль утвержден официально и документация должна соответствовать ему. В этом случае вся dita и кастомизации были под моим контролем, а запускать публикацию я разрешал только после ввода логина и пароля писателя или тестировщика.

Повторюсь, это задумка разработчиков Dita. При появлении новой версии dita-ot она всего лишь распаковывается "куда-нибудь" на диске и всего в одном bat указывается этот путь.
Установка и инсталляция DITA
 
[quote="o_alekseev":3f1mz3kc]Добавили таргет cover.xhtml ....
В таргет dita2htmlhelp+ добавили вызов таргета cover.xhtml
В папке C:\DITA-OT1.5_M11\xsl поменяли содержимое файла map2hhp.xsl
Строку 162 закоментировали
После строки 194 добавили новую строку с содержимым cover.html
В папке C:\DITA-OT1.5_M11\demo\htmlsearch\css подредактировали search.css
В папке C:\DITA-OT1.5_M11\demo\htmlsearch\basefiles заменили файлы frameset.html и searchbox.html
В папке C:\DITA-OT1.5_M11\demo\tocjs\basefiles заменили файл tocnav.html
В папке C:\DITA-OT1.5_M11\demo\tocjs\basefiles\css заменили файл screen.css
В папку C:\DITA-OT1.5_M11\css добавили файл bercut.css[/quote:3f1mz3kc] Мне кажется, что столько изменений через чур привязывает инструмент к одному рабочему месту и к одной версии Dita. При появлении новой версии Dita, нужно будет изменять столько же файлов. Для таких задач сделали возможность кастомизации. Для разных проектов/версий/форматов могут быть разные кастомизации. Можно написать скрипты так, что все само будет "делаться" на любом диске, на любой операционке для разных кастомизаций...
[quote="o_alekseev":3f1mz3kc]
Рекомендации по работе с редактром XML-Mind
Что бы длинные слова (например длинные имена переменных) не залазили на соседние ячейки таблицы и не выходили за пределы страницы в PDF предлагается использовать специальный символ пробела нулевой длины  (zero width spaces, U+200B или ​).[/quote:3f1mz3kc] Разве переносами проблема не решается ? Ранее писалось, что FOP тоже настраивается [quote:3f1mz3kc]Настройка FOP
В папку C:\DITA-OT1.5_M11\demo\fo\fop\conf добавили файл fop.xconf, старый переименовали в !OLDfop.xconf
В папку C:\DITA-OT1.5_M11_\demo\fo\fop\lib добавили файл fop-hyph.jar
В CLASSPATH startcmd.bat добавили %DITA_DIR%demo\fo\fop\lib\fop-hyph.jar; старый переименовали в !OLDstartcmd.bat.xconf
[/quote:3f1mz3kc] fop-hyph.jar занимается переносами и выравниванием.
Установка и инсталляция DITA
 
[quote="o_alekseev":c29utrr8]FOP T - с переносами[/quote:c29utrr8] Я не мог их делать в Ditaot 1.2 с любой версией fop. В 1.5* можно "играться" в XSLT с настройками переносов.
[quote="o_alekseev":c29utrr8]
Также примечания предупреждения глоссарий - это представляется как XSL FO табличные структуры  - Xep поддерживает разные ширины колонок и они хорошо в конечном счете выглядят в pdf [/quote:c29utrr8] С таблицами тоже все отлично, но надо править стили. В общем чтобы не платить, надо чуток "подпилить" :D
Ведь XEP это такой же "допиленный" кем-то  FOP.
Установка и инсталляция DITA
 
[quote="o_alekseev":10sl12lk]XEP тогда давал лучший результат но он платен а это зло... [/quote:10sl12lk] Сейчас XEP не дает лучший результат. fop 0.94 и 0.95 и ссылки в оглавлении делает и алфавитный указатель и все, с чем были проблемы три года назад :D
Опрос: Как называется ваша должность в трудовой книжке?
 
Сейчас можно писать как угодно и что угодно )). Слышал, что в ближайшие годы планируют отменить трудовые вообще. Будут учитываться рекомендации с предыдущих мест работы, как в Европе и США.
Опрос: Как называется ваша должность в трудовой книжке?
 
Инженер-программист III категории
Технический писатель
Руководитель группы документирования
Ведущий технический писатель
Обсуждаем тесты
 
А в каком виде будут результаты тестирования? Что-то никак не пойму как это можно будет посмотреть новичкам и старичкам  :D
Обсуждаем тесты
 
Что определяет выбор профессии технический писатель: параметры и факторы

Вопросы:                                                           Ответы:
1. Физиологические параметры
Пол (мужчина - женщина)                                           [b:2w23i5p2]Мужчина[/b:2w23i5p2]
Параметры телосложения (рост, вес, тип сложения)       [b:2w23i5p2]Рост 193 см, вес 110 кг, тип сложения Атлетическое[/b:2w23i5p2]
Возраст                                                                     [b:2w23i5p2]29 лет[/b:2w23i5p2]
2. Параметры психологические
Тип характера (один из общепринятых  или комбинация) [b:2w23i5p2]Самостоятельный[/b:2w23i5p2]
Тип личности (интраверт-экстраверт)                           [b:2w23i5p2]Не определился[/b:2w23i5p2]
Тип темперамента                                                       [b:2w23i5p2]Сангвиник[/b:2w23i5p2]
3. Параметры наследственные
Были ли Ваши родители творческими личностями (писателями)?        [b:2w23i5p2]Нет[/b:2w23i5p2]
Были ли среди Ваших бабушек-дедушек творческие личности?           [b:2w23i5p2]Нет[/b:2w23i5p2]
Есть ли среди Ваших родственников творческие личности?                      [b:2w23i5p2]Нет[/b:2w23i5p2]
4. Факторы культурного воздействия
Образование (учебное заведение, курсы)                [b:2w23i5p2]Основное высшее: *скрыто*, второе высшее: Юридическое [/b:2w23i5p2]
Увлечения (литература, искусство, музыка, танцы и т.п.)            [b:2w23i5p2]Музыка, рыбалка, off-road, охота… на женщин, готовка и кулинария, путешествия.[/b:2w23i5p2]
Экспертные способности      [b:2w23i5p2]Какие именно и в чем ????
                                        1. В TW: MS Office, DitaOpenToolkit, XML, XSLT
                                        2. В юриспруденции – никаких
                                        3. Владею навыками стрельбы из всех видов стрелкового оружия, стоящего на вооружении спецслужб РФ.                   Мастер спорта по рукопашному бою[/b:2w23i5p2] 8)   :twisted:  
Примеры личного творчества (текст, фото, рисунок, видеосюжет)     [b:2w23i5p2] Аватарка на форуме[/b:2w23i5p2]

Вышеописанное как-то повлияет на выбор профессии Технический писатель?
После вставки оглавления, сначала ломается схема документа..
 
[quote="zz_top":208b04o9]Для удобства периодически меняю [b:208b04o9]Вставку в пределах одного документа[/b:208b04o9] и [b:208b04o9]Вставка в другой документ[/b:208b04o9].[/quote:208b04o9] Дык может стоит использовать по умолчанию? Хотя бы проверить будут ли изменения.
Не сталкивался с такими "удобствами" никогда.
После вставки оглавления, сначала ломается схема документа..
 
[quote="zz_top":fq8aqjia]Куда ещё смотреть? Почему Word сам изменяет уровень?[/quote:fq8aqjia]Реально уровень изменяется при повторном открытии?
Установка и инсталляция DITA
 
[quote="Nata":dp6wa1k5]С лицензией на XEP PERSONAL EDITION я скачала и использовала при установке! [/quote:dp6wa1k5] Зачем нужен XEP, если есть бесплатный fop уже в составе полного дистрибутива Dita-ot?
Установка и инсталляция DITA
 
[quote="Nata":1sjyfwmt]пользуюсь dita for solo writers(15 стр). Команда ant -f integrator.xml выполняется успешно, но скомпилировать sample_pdf2.xml не получается ant -f sample_pdf2.xml[/quote:1sjyfwmt] Как называется ваш ант-скрипт?
В документе написано [code:1sjyfwmt][b]2. Copy and paste the following ANT script into the new file:[/b][/code:1sjyfwmt]
По умолчанию он должен был называться build.xml. А в нем должен быть текст, который предлагается скопировать из примера dita for solo writers (15-16 стр).

<?xml version="1.0" encoding="UTF-8" ?>
<project name="sample_pdf2" [color=#FF0000:1sjyfwmt][b:1sjyfwmt]default="sample2pdf2"[/b:1sjyfwmt][/color:1sjyfwmt] basedir=".">
......тра-ля-ля ....
</project>
Значит надо:
1. Либо выполнять [b:1sjyfwmt]ant -f ant_script_filename.xml[/b:1sjyfwmt] и будет браться аругмент по умолчанию default="sample2pdf2"
2. Либо выполнять [b:1sjyfwmt]ant -f sample2pdf2[/b:1sjyfwmt] если файл называется build.xml
3. Если так тоже не получилось, то нужно в команде  ant -f build.xml  добавить параметр [b:1sjyfwmt]log.log[/b:1sjyfwmt] в конце для получения лога (ant -f build.xml log.log). После выполнения компиляции (неуспешной) открыть файл в любом редакторе, найти текст BUILD FAILED и отправить текст первые 10-15 строк после BUILD FAILED
После вставки оглавления, сначала ломается схема документа..
 
Надо поменять стили текста, который идет до оглавления. Все строки, помеченные как Заголовок 1,2,3 по умолчанию попадают в схему документа и в автособираемое оглавление (для РФ автособираемое оглавление ну никак не подходит, ну его в топку).

Выделите строку "Научно-производственное предприятие ..." и в параметрах форматирования поменяйте Уровень текста.
[b:9zvx3ll7]Вкладка Главная -> Абзац -> Отступы и интервалы -> Уровень -> Основной текст[/b:9zvx3ll7].

Название предприятия и название документа это не заголовок, а всего лишь текст, который может выделяться более крупным шрифтом, отступом и т.п. Для каждой строки на титульной странице нужно создавать свой стиль, который можно будет применяться в других документах.
Обсуждаем тесты
 
Намек 1972 года понят.

Зачем сравнивать Технического писателя с писателями различных литературных жанров?

Во-первых. В предлагаемых тестах вопросы, как мне кажется, касаются именно литературных писателей: бабушки, дедушки, музы, вдохновители....
Технический писатель - более чем на 50% технарь (программист, инженер, аналитик и т.п.) Остальными "50-ю процентами" могут быть филологи, лингвисты и другие специалисты. Ключевое слово - [b:2ibiw4h9]Специалисты[/b:2ibiw4h9], которые получали знания в ВУЗах, а не наследовали их от дальних родственников. И качества специалистов никак не зависят от роста, веса и ориентации.

Во-вторых. Какова цель этих тестов? Что реально полезного можно подчеркнуть, узнав, что твой коллега из Анадыря -весом 88 кг - голубоглазый брюнет - интраверт - фотограф - живет с родителями (папа геолог писал в молодости стихи маме-домохозяйке), учится по специальности "математик-программист" и подрабатывает тех.писом?

Цитата
Скоро будет тема "что вы думаете о предыдущем участнике" ??? :shock:
Цитата
Да это же "Кофейня" тут можно хоть о чем болтать) хоть о предыдущем участнике))
Все в сад или в кофейню!!!  8)
Открыт новый раздел форума – Тесты, опросы, конкурсы (ТОК)!
 
Можно было бы так провести  http://ap-test-team.blogspot.com/2011/03/blog-post_26.html , только про технических писателей. Недалеко ушли бы.
Обсуждаем тесты
 
Цитата
Новичок, мечтающий стать техническим писателем, может просмотреть результаты опросов и конкурсов, чтобы найти помощь в выборе профессии и познакомиться с тайнами профессии TW.
Новичок, мечтающий стать техническим писателем, может просмотреть результаты опросов и понять, что без дяди по маминой линии у него мало шансов.
Цитата
Опытный TW может принять участие во всех опросах и конкурсах, чтобы поделиться своими знаниями и профессионализмом.
Опытный TW может похвастаться бабушкиным домом на Рублево-Успенском шоссе, постороенным в стиле "Барокко"
Цитата
А для того, чтобы ясно представлять свой уровень профессионала TW может попробовать свои силы в тестах и занять подобающее место в рейтинге.
А для того, чтобы ясно представлять свой уровень профессионала TW может заполнить форму и полчаса настраивать стили в файле Test1.doc.
Цитата
Посетитель, случайно (или по наводке знакомых) забредший на форум TechWriters.Ru сможет воочию убедиться в том, что TW такие же люди как он сам, со своими эмоциями, проблемами, радостями и горестями.
Не спят в 6 утра, решают проблемы и радуются  :D

Цитата
Мир технических писателей является частью общего мира и отражает все его надежды и мечты, достижения и катастрофы. Каждый живущий в мире не только подвергается воздействию окружающего, иногда весьма кардинально меняющего судьбу, но и способен сам повлиять на окружающий мир. Пожелаем всем изменений только к лучшему и с нашей помощью!
Да убоится Господа вся земля, да содрогнутся пред Ним все живущие по вселенной – ибо Он сказал – и возникли они, Он повелел – и были созданы.
Аминь.
Обсуждаем тесты
 
Цитата
Есть мнение, что это резвится какой-то троешник психолог-аспирант. К тому же еще и флудер.
Как минимум "ОН" имеет права создавать оранжевую панель и ссылаться на почту info @techwriters.ru.
Writer, это пиар, маркетинг? Форум решил обзавестись непрофильными темами ?
Обсуждаем тесты
 
[color=#FF0000:3bbq2ust]Attention!
Открыт новый раздел «Тестирование, опросы, конкурсы (ТОК)». Теперь каждый посетитель форума (сайта) может найти здесь что-то для себя. [/color:3bbq2ust]

Открыт новый раздел форума – Тесты, опросы, конкурсы (ТОК)!
в [b:3bbq2ust]форуме Журнал для технических писателей[/b:3bbq2ust]
Открыт новый раздел форума – Тесты, опросы, конкурсы (ТОК)!
в [b:3bbq2ust]форуме Вопросы, предложения и отзывы.[/b:3bbq2ust]
Открыт новый раздел форума – Тесты, опросы, конкурсы (ТОК)!
в [b:3bbq2ust]форуме Все в сад![/b:3bbq2ust]
Открыт новый раздел форума – Тесты, опросы, конкурсы (ТОК)!
в [b:3bbq2ust]форуме Кофейня[/b:3bbq2ust]
Открыт новый раздел форума – Тесты, опросы, конкурсы (ТОК)!
в [b:3bbq2ust]форуме Введение в специальность
[/b:3bbq2ust]


Зачем рассылать в каждую тему, если достаточно одного сообщения в одной теме????
1. Тем, кто подписан на обновления приходит куча бестолковых писем.
2. Те, кто пользуется разделом [b:3bbq2ust][u:3bbq2ust]Активные темы[/u:3bbq2ust][/b:3bbq2ust] видят множество непрочитанного.
3. Это больше походит на анкеты в подготовительной группе детсада для того, чтобы "кандидата" взяли в подходящий класс (первый) школы.

Я высказал свои мысли. Можно банить и удалять сообщения.
Обсуждаем тесты
 
:lol:   :lol:   :lol:   Это предварительный отбор кандидатов для продолжения родословной какого-то богатого, ленивого и "Великого" творческого деятеля ????

Понимаю, спросить кто каким ПО пользуется в работе, это полезно. Но про бабушек стихоплетов спрашивать на сайте TW как-то странно.
[code:21wxttbi]Тест-анкета предполагает насыщенные информацией ответы (если есть творческие родственники, надо указать степень родства – дядя по матери, например). Необходимо запастись терпением и напрячь свою память, чтобы дать содержательный ответ.[/code:21wxttbi]
Опрос: Какое ПО или отдельные модули использует TechWriter?
 
4) заполненная форма высылается в указанный адрес

Куда слать то? уже заполнил  :D
Страницы: Пред. 1 ... 61 62 63 64 65 66 67 68 69 70 71 72 След.

Рейтинг@Mail.ru