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

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

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

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

Страницы: 1
DITA - формат RTF
 
Как вариант, можно использовать конвертер из FO в RTF или ODT http://www.xmlmind.com/foconverter/
Для целей практики он бесплатный
Технология адаптации Dita
 
[quote="ADVANCED":t4zaegq4]Если используются значки типа © и другие. Есть много значков и символов, которые поддерживаются редакторами и их можно использовать по умолчанию, допустим для наглядности или удобочитаемости текста, но в это же время, символы не попадают в диапазон для en-US.
[/quote:t4zaegq4]

Не совсем понятно. Русские символы кодируются в UTF-8 и в PDF отображаются правильно (у меня). Спецсимволы, типа (с) тоже выводятся корректно. И это все без настройки char-set. Может быть char-set нужно используется с определенными шрифтами? У меня PDF генерится на стареньких трутайпах, которые, вроде, не юникодные (надо точнее посмотреть).
Технология адаптации Dita
 
Заинтересовала рекомендация "Диапазон Unicode для символов языка". Для чего нужен <alphabet char-set="Russian"> ?
У меня файл ru_RU.xml - это копия с en_US.xml без изменений.
Добро пожаловать на форум Dita!
 
[quote="writer":1bc3iix5]Нажимаете "Новая тема" и можно создать сколько угодно веток которые все будут относится к Dita.[/quote:1bc3iix5]

Вам виднее, конечно, это ваш форум. Но было бы лучше так, что заходишь на http://techwriters.ru/forum/ и сразу видишь значок DITA*XML. Для FM и AuthorIT сделана ветка верхнего уровня, а для DITA подветка к "Единый источник". То есть как бы не знали куда запихнуть Диту и нашли ей теплое место.

А поставили бы в красный угол, и всем было бы видно, что здесь к Дите относятся с интересом. И новички бы тянулись, и старичкам было бы приятно :)

Ну это так в порядке отвлеченных дополнений. Спасибо уже за отдельную ветку! Скоро запущу в нее чего-нибудь полезное.
Добро пожаловать на форум Dita!
 
Вот не любите вы Диту  8) Могли бы целую ветку отвести, а не подветочку. Вот вам и значок для ветки

[img:rt4seklk]http://teux.ru/Insets/dita.logo.gif[/img:rt4seklk]
Космические корабли бороздят диту, DITA и DocBook что выбрать?
 
[QUOTE]А его можно где-нибудь почитать? Думаю имеет смысл сделать его достоянием общественности)). Вот здесь отдельный форум сделали по Дита (Dita) ([url]http://techwriters.ru/forum/forum620/[/url] Если будет время закиньте сюда.[/QUOTE]
Вот не любите вы Диту  8)  Могли бы целую ветку отвести, а не подветочку.
Кто займется переводом документации по DITA?
 
[quote="writer":2tnu4v2e]Коллеги, я повторю, но все можно сделать здесь.[/quote:2tnu4v2e]

Если возможно, заведите ветку "DITA" на верхнем уровне форума. Через некоторое время кину в нее ссылку на контрольный пример настройки и конвертации в PDF (с собственными шаблонами). В качестве исходников возьму тот же "гараж" из DITA-OT.


[quote="ADVANCED":2tnu4v2e]В каком-то смысле прав ADVANCED (он же Teux), что DITA “бороздит космические просторы”.[/quote:2tnu4v2e]

У вас, дорогой коллега, от жары и пожаров обострилась мнительность? Это скоро пройдет.
Мне не нужно шифроваться, чтобы еще раз услышать ваше мнение о DITA  :lol:

Вы же сами, как утверждаете, используете XML-технологию, хотя и не отличаете Eclipse от DocBook.
Что ж вы так на DITA ополчились? Это точно такая же XML-технология, но в отличии от уходящего в историю DocBook, DITA завоевывает будущее. Дороговизна внедрения связана исключительно с недостатком информации. Как только многие освоят DITA, критическая масса накопленных знаний в профессиональной среде пробьет барьер дороговизны.

Притом я не спорю, что не всем нужна DITA, поскольку не всем нужны XML-технологии. Ее применение оправдано в следующих случаях:

- ведется коллективная работа над документами;
- документация хранится в системе контроля версий, где отлеживаются даты и авторы всех изменений;
- документы имеют модульную структуру и обеспечивается повторное использование материала;
- применяются специализированные разделы с новыми элементами (которых нет в DITA);
- требуется переводить документацию на разные языки с использованием Translation Memory;
- документация выводится в разные форматы - PDF, CHM, web help;
- для владеющих XSLT дается полный контроль над форматом выводимых документов, при этом применяется унифицированный и очень мощный препроцессинг DITA-OT;
- вывод автоматизирован и во время конвертации подверстывается дополнительная информация из файлов или базы данных.

Скажите, какая настольная издательская система может выполнять все эти задачи и является бесплатной?
Если же ваши потребности не выходят за рамки MS Word, то используйте его. Никто косо не посмотрит, ибо эффективность на первом месте.

[quote="ADVANCED":2tnu4v2e]PS На этом прекращаю дискуссию о DITA.[/quote:2tnu4v2e]
На моей памяти это уже второй раз. А вы актер, коллега, хороший актер!
Космические корабли бороздят диту, DITA и DocBook что выбрать?
 
В России как минимум три крупных компании полноценно используют DITA.
Это Yandex, Inline Telecom Solutions, Prompt. Используют Serna, FrameMaker, Arbortext.
Кто займется переводом документации по DITA?
 
[quote="ADVANCED":2jc2glzb]Так кто займется переводом документации по DITA?[/quote:2jc2glzb]

Не нужно этого. Там и так все понятно. Нужен ресурс, на котором бы публиковались статьи на злободневные темы. Одна из них - установка DITA-OT. Хотя я бы расширил эту тему, назвав "Настройка среды конвертации".

Но что пользы, если я или вы опишем свои решения, а в глубоко закопанной ветке их никто не найдет?

Могу поделиться конкретными файлами, конфигурационными параметрами. На их основе можно создавать нормальные PDF с помощью FOP. Но хочется, чтобы это было в каком-то постоянном месте, которое посвящено DITA.

Тормозит организационный вопрос, а полезная информация и опыт успешных внедрений есть.
Космические корабли бороздят диту, DITA и DocBook что выбрать?
 
[quote="ADVANCED":3hw15zsk]Тема еще актуальна?[/quote:3hw15zsk]
Что интересует?
Космические корабли бороздят диту, DITA и DocBook что выбрать?
 
[quote="ЮВ":paraa22q]
Т.к.  никаких профессионально аргументированных контрдоводов  я не нашел (кроме демагогии, подобной в приведенной цитате),  обсуждать нечего, поэтому дискуссию прекращаю.[/quote:paraa22q]
Дело в том, что дискутировать с поверхностным теоретиком - это пустое, а разобраться в теме Диты вы не хотите, что уже многократно подчеркнули. Поэтому и я обхожусь общими словами. Если бы вы хотели расширить  понимание, то заняли бы позицию человека ищущего. Вы же продолжаете настойчиво пропихивать заблуждения, пытаясь за твердостью скрыть незнание. О многом говорит уже тот факт, что по началу вы отождествляли Eclipse и Docbook... Поэтому я просил не впадать в неконструктивную дискуссию

Взять хотя бы это
[quote:paraa22q]Как я уже писал ранее, продукты DITA и DocBook – это плоды одной и той же фирмы.[/quote:paraa22q]
О какой фирме вы говорите? Не назовете ли, кем разрабатывается архитектура DITA и инструментарий DITA (DITA Open Toolkit) и в чем вообще отличие между ними?

[quote:paraa22q]Поэтому используются одни и те же механизмы и программы для подготовки и конвертации в различные форматы. Следовательно, овладев DocBook, легко овладеете и DITA.[/quote:paraa22q]
Вывод, основанный на предыдущем заблуждении. Только не говорите, что я неконкретен. Выше я достаточно ясно, хотя и в общих чертах, описывал процесс конвертации из XML в другие форматы. Повторять то же самое кажется бессмысленным.

[quote:paraa22q]DITA – это расширение DocBook в части механизма компоновки документов
...
После того как DITA обработает карту документа (т. е. заменит ссылки на топики их содержимым) мы получим исходный XML-документ - придем к технологии DocBook
...
Т. е. DITA – надстройка над DocBook
[/quote:paraa22q]
Пусть это комментируют те, кто внушил вам такие мысли. Для остальных еще раз повторю:

НЕ НАДО РАЗДЕЛЯТЬ ПОДОБНОЕ ПОНИМАНИЕ ДИТЫ, ПОСКОЛЬКУ ОНО НЕ ВЕРНО И ОСНОВАНО НА ЗАБЛУЖДЕНИЯХ ЮВ (которые он, надеюсь, скоро изживет)
Космические корабли бороздят диту, DITA и DocBook что выбрать?
 
Вот это требует комментария

[quote:1abn03u8]5 Предлагаемый подход (научиться самостоятельно устанавливать и конфигурировать дистрибутив DITA, изучить языки программирования XSLT и его отладчик и т. п.) считаю в корне ошибочным (метод натурального хозяйства, когда все необходимое делалось в самом хозяйстве) давно показал свою неэффективность.[/quote:1abn03u8]

Мы здесь обсуждаем Диту как таковую, а не конкретные варианты ее применения.
Разговор об XML-технологии будет неполным без объяснения, что собственно можно делать с XML-файлами.
Это и приводит к обсуждению XSL.

Да, это программирование. Если кто-то не способен его освоить, он может применять технологии WYSWYG. Знаю, таких людей больше, но есть и другие - с пытливым умом. Они хотят освоить новую прогрессивную технологию, но не имеют достаточной информации. Данная тема для них, для будущих профессионалов, а не для ретроградов.

Иногда неспособность освоить технологию прикрывают отчаянными попытками убедить в нецелесообразности самой технологии. Это не есть хорошо. Еще плохо, когда пытаются авторитетно обсуждать вещи малознакомые и непонятные. Кто-то из начинающих может прочесть писанное выше об XSL-FO и подумать, будь-то все так и есть. В результате пойдет по ложному пути.

А в это время профессиональное сообщество активно поворачивает корабли в сторону Диты
Космические корабли бороздят диту, DITA и DocBook что выбрать?
 
Мне хотелось закончить читать ваш этюд много раньше, но я сумел дойти до этого места
[quote="ЮВ":38gzvzm7]3 Технология DITA основана на DocBook. Освойте сначала её.[/quote:38gzvzm7]
Дальше читать просто бессмысленно. Вы ставите жирную точку в признании себя неспециалистом в обсуждаемом вопросе. Признайте, что никогда на практике не использовали Диту, и все что вам про нее известно, - что в ней есть разметка.
Космические корабли бороздят диту, DITA и DocBook что выбрать?
 
Немного подумав, определил важные темы для освоения DITA. Вот они:

1. Подходящие XML-редакторы для DITA
2. Распределение разделов документа по файлам. Структура каталогов для хранения файлов DITA
3. Разметка DITA. Основные разделы – topic, concept, task, reference, glossentry. Схема документа - map и bookmap
4. Установка и настройка DITA OT
5. Запуск конвертации. Использование инструмента Apache ANT
6. Настройка шаблонов XSLT для конвертации в PDF
7. Настройка шаблонов XSLT для конвертации в XHTML
8. Настройка шаблонов XSLT для конвертации в CHM
9. Препроцессинг в DITA OT. Как его использовать в своих целях.
10. Специализация DITA. Создание плагинов для обработки специализированных разделов.

Для понимания тем начиная с 5 полезен опыт программирования.
Хотя в действительности необходимо лишь аналитическое мышление
и знание основных концепций любого из языков программирования.
Космические корабли бороздят диту, DITA и DocBook что выбрать?
 
ЮВ, очень просто вступить в неконструктивную дискуссию...
Лучше начните изучать Диту. За ней будущее, а не за отживающим свой век Докбуком
Но даже если вы адепт Докбука, углубите свои знания в области XSL.
Вы зря считаете, что XSL не заслуживает внимание техписа. Современный техпис не просто оформитель бумажек.
Впрочем, и таким находится место с соответствующей зарплатой.

Другое дело, что Дита оправдывает себя в масштабных проектах, когда нужно вести большой объем однотипно оформленной документации по разным версиям продукта и есть много повторно используемого материала. Хотя у меня имеются и мелкие документы на Дите. Настроенные однажды шаблоны удобно применять для их оформления. Но я выберу другой инструмент (не Диту), если потребуется создать буклетик с уникальным оформлением.

На мое длинное письмо отвечать не нужно, оно адресовано не вам.
Это просто краткий обзор того, как происходит трансформация из XML в другие форматы.
Может кому пригодится, тогда копнем глубже.
Космические корабли бороздят диту, DITA и DocBook что выбрать?
 
[quote="ЮВ":1546wcgu]
Хотя с вашим подходом  к теме "DITA",  имхо, она закроется сама, без моих усилий.[/quote:1546wcgu]

Это зависит даже не от меня, увы. Сложность вхождения в тему является большим препятствием
Я как раз и хочу облегчить вхождение для заинтересованных, чтобы возникла возможность взаимообогощаться практикой других специалистов
Космические корабли бороздят диту, DITA и DocBook что выбрать?
 
[quote="гена":2vwc7o3e]Тут можно посоветовать админу разделить тему)[/quote:2vwc7o3e]

Да нет, не нужно. Небольшие перепалки привлекают внимание. Людям нравятся ток-шоу)


Кстати, сообщения уважаемого ЮВ как раз показывают трудности с освоением XML-технологий вообще и Диты в частности. Большинство специалистов привыкли работать с визуальными редакторами, в которых вывод документа полностью скрыт от автора. Возьмем к примеру Ворд. Автор сверстал документ, отправил на печать и достал лист из принтера. Больше ничего знать не требуется. При этом уровень профессионализма определяется умением нажимать  кнопочки в интерфейсе.

Другой уровень - это когда требуется создавать несколько выходных форматов. Увлеченные люди сталкиваются с этой задачей и начинают искать подходящие инструменты. Находят Robohelp, H&M, AuthorIT. Работая с подобными системами, уже начинаешь понимать, что документ не является единым потоком текста-графики-таблиц, а состоит из частей, то есть имеет структуру. Однако данные системы также скрывают от разработчика процесс вывода документа. Да это разработчику и не нужно: он привык работать в визуальном интерфейсе и его не волнует, что твориться в недрах программы.

Третий уровень – это применение XML-технологий. В этом случае разработка документации явно делится на два класса задач: создание информационных материалов и вывод их в разные форматы. Специалист-практик имеет здесь полный контроль над процессом вывода. Однако люди, вышедшие из визуальных систем разработки, не понимают, что должны сами настраивать процедуры вывода. Это бывает трудно понять, поскольку раньше вывод был скрыт в коде визуального редактора и не заботил автора.

Отсюда появляются фразы типа "Для конвертирования в PDF DITA использует тот же механизм и те же программы, что и Eclipse". Это не верно. Конечно, при использовании XML-технологий применяются схожие инструменты, но они лишь как кисти для художника. Только сам художник определяет, как смешать краски и как наложить их на холст, от чего будет зависеть результат.

Опишу это конкретнее. Для получения PDF-документа из XML-исходника применяются две программы: XSLT-процессор и FO-процессор. Оба являются ничем иным, как интерпретаторами определенных команд. Именно на создание команд для XSLT-процессора направлены все усилия по настройке вывода. Эти команды, называемые шаблонами, пишутся на специальном языке программирования XSLT. По сути, они указывают XSLT-процессору, что нужно сделать с исходным XML-документом. А сделать он может многое, в том числе преобразовать исходный документ, например, в html-страничку либо в текст или еще во что-то. Это определяется исключительно шаблонами XSLT, а не самим процессором. Ну а наиболее популярные XSLT-процессоры – это Saxon и Xalan (оба бесплатные).

Для получения PDF сначала  необходимо привести исходный документ к промежуточному формату FO, причем не важно, в чем сделан документ - в DITA или DocBook. Для такой конвертации также применяются XSLT-шаблоны. Они тесно связаны с исходным форматом документа, поэтому для DITA и для DocBook они совершенно разные. Кроме того, любой человек может написать собственные шаблоны.

В формате FO документ также имеет структуру XML, но дополнительно к информационному содержанию добавляются указания, как расположить материал на печатных листах, каким шрифтом оформить, какой цвет текста и заливок применить и прочее, прочее, прочее. Вся эта информация берется из XSLT-шаблона, куда изначально помещается разработчиком. Когда выше я приводил пример FO-структуры, то подразумевал, что ЮВ увидит необходимые ему атрибуты и поместит их в нужное место своих XSLT-шаблонов. После этого любая конвертация в PDF будет автоматически создавать FO-файл c данными атрибутами. Но ЮВ оказался не знаком с XSLT.

На последнем этапе FO-документ скармливается FO-процессору. Поскольку FO – это стандартный формат, процессор без труда понимает, как отформатировать материал, и создает PDF. На этом этапе ничего настраивать не нужно. Существует несколько популярных FO-процессоров, в том числе бесплатный FOP и платный RenderX XEP.

Такие вот пирожки… А вы говорите "базара нет"
Космические корабли бороздят диту, DITA и DocBook что выбрать?
 
>Вы продекларировали себя как крупного специалиста по XSL-FO.

Ну если вы так восприняли, пусть...

>Для конвертирования в PDF DITA использует тот же механизм и те же программы, что и Eclipse,

Для конвретации можно использовать FOP, можно XEP, можно AH Formatter или еще какой-нибудь FO-процессор. It's depend. Никакой непосредственной связи между DITA и выходным форматом Eclipse не существует

>Тема закрыта

На вашем месте я бы поостергся закрывать чужие темы :)
Космические корабли бороздят диту, DITA и DocBook что выбрать?
 
Как раз на примере ЮВ хочу показать, как не надо относится к изучению Диты.
ЮВ хочет решить какую-то свою проблему . Это нормально. Но вместо того, чтобы разобраться в проблеме,
и найти пути ее решения ЮВ ищет, чтобы кто-то решил проблему за него. Но увы - этот подход не приведет ни к чему.
Возможно, ЮВ и решит текущую проблему с помощью кого-то, но возникнет пятьдесят новых проблем, перед которыми он окажется бессилен. Гораздо лучше понять систему и научиться ее применять.
Такие люди, как ЮВ, конечно, всегда будут. Им надо помогать. Но в данном случае, да простит меня ЮВ, тема посвящена не Докубуку, а Дите.
Космические корабли бороздят диту, DITA и DocBook что выбрать?
 
Вы спросили:
[quote:3acwif5g]Можно ли (если да, то как) реализовать это в XSL-FO ?[/quote:3acwif5g]
А реалиазовть вы хотели следующее
[quote:3acwif5g](графическое изображение, на которое накладывается текст)[/quote:3acwif5g]

Я вам показал, как это реализуется в XSL-FO. Если вы искали ответ на другой вопрос, то сначала сформулируйте его, но прежде чем задать, пожалуйста, обратите внимание, что эта ветка посвящена Дите, а не Докбуку.

[quote:3acwif5g]1 Вы предлагаете мне корректировать промежуточный файл (fo) при конвертировании XSL-FO.
Это не совсем удобно - если у меня, скажем, 50 документов, то я должен исправлять все эти 50 файлов ?[/quote:3acwif5g]

Единственно, что я предлагаю, это изучать Диту. С Докбуком не знаком, и в этом я не помощник, извините.

И еще обратите внимание на написанное мной выше
[quote:3acwif5g]К сожалению, я не могу отвечать на вопросы индивидуально, поэтому предпочел бы обсуждать проблемы с внедрением Диты в неформальных встречах[/quote:3acwif5g]
Космические корабли бороздят диту, DITA и DocBook что выбрать?
 
[code:ng52k996]<fo:root>
<fo:page-sequence force-page-count="auto" format="1" master-reference="front-matter">
<fo:flow flow-name="xsl-region-body">


<fo:block-container absolute-position="absolute" bottom="0" left="0" right="0" top="0">
<fo:block>
<fo:external-graphic content-height="297mm" content-width="210mm" src="url(../../Insets/bmcover.svg)"/>
</fo:block>
</fo:block-container>


<fo:block color="white" margin-right="11mm" text-align="right">
   <fo:block font-size="9pt"
margin-top="50mm"
line-height-shift-adjustment="disregard-shifts"
font-family="HeliosC">версия 7.1</fo:block>
   <fo:block font-size="11pt" font-weight="bold"
line-height="140%"
margin-left="110mm"
margin-top="5mm"
line-height-shift-adjustment="disregard-shifts"
font-family="HeliosC">Регламент технического обслуживания</fo:block>
</fo:block>

...
</fo:flow>
</fo:page-sequence>
</fo:root>[/code:ng52k996]
Космические корабли бороздят диту, DITA и DocBook что выбрать?
 
Помните фразу прораба из комедии: "В то время как космические корабли бороздят просторы вселенной..."? Сейчас подведу ее к ситуации с DITA. За последние годы скачкообразно вырос интерес к этой технологии со стороны американского (да и вообще западного) сообщества техписов. Количество успешных применений растет, появляются все новые специалисты. А у нас застой... корабли ржавеют на старте. Мы отстаем технологически, и это удручает.

Наши спецы если и осваивают Диту, то не торопятся делиться информацией, из-за чего никак не возникнет публичная среда распространения знаний о Дите. Это тормозит развитие тех, кто уже что-то знает, и блокирует попытки разобраться новичкам. Единственная компания Философт предлагает какие-то курсы, но они стоят много и не отвечают на все вопросы.

Обращаюсь к профессиональному сообществу с вопросом: сколь многие техписы готовы практически освоить Диту? Если интерес к ней существует в России, я готов посодействовать в освоении. Моя цель - создать некоммерческую среду распространения знаний о Дите.  А для этого нужны адепты Дита, которые смогут отвечать на вопросы новичков в форуме. Никакие коммерческие цели я не преследую. Мне самому порой не хватает времени разбираться с новшествами и требуется консультация. С другой стороны, я проделал большой  путь в освоении Диты, и могу поделиться знаниями.

Важно понимать, что освоение Диты невозможно без знакомства с XML и XSL. Скажу больше, Дита требует хорошего знания XSLT и хотя бы общего представления об XSL-FO. И тут мне тоже есть чем поделиться. Уже больше года я создаю PDF и web-help из исходников DITA. В моих PDF-документах работают все ссылки (как в содержании, так и в закладках), формируется индекс, пронумерованы разделы. При этом я использую бесплатный процессор FOP. Примером простого web-help может служить мой личный сайт http://teux.ru.

Сейчас мне важно понять, есть ли хотя бы несколько человек, готовые осваивать и внедрять Диту, а также отвечать на вопросы новичков. Очень важно, чтобы эти люди были ориентированы на практическое использование технологии, поскольку только так можно ее освоить. К сожалению, я не могу отвечать на вопросы индивидуально, поэтому предпочел бы обсуждать проблемы с внедрением Диты в неформальных встречах, как поступают американские техписы.
Могучая связка DITA & XLIFF
 
[quote="Тес":uavk3j2v]Я так понимаю, что DITA это какая-то бездна :D , просто космос)[/quote:uavk3j2v]
Это точно. Другая ветвь эволюции по сравнению с WYSWYG.
Могучая связка DITA & XLIFF
 
Программулина для перевода SwordFish конвертит файлы DITA в XLIFF и обратно
Страницы: 1

Рейтинг@Mail.ru