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

Вот!  Хорошо бы каждый год проводить сравнительный анализ инструментов и докладывать о результатх сообществу. А то все в одиночку разбираются, разбираются...а потом перетягивают одеялу.

Я не эксперт, поправьте если это не так, но у меня сложилось впечатление что DITA - это голый xml, а остальное ПО - наряженный xml.

Есть конечно - другая сторона. Хорошо что есть мероприятия где можно собраться, поделится своими проблемами, задать интересующие вопросы.

Кстати, слышала звонок-вопрос одного из форумчан! Поделитесь своими впечатлениями!

Смотрела онлайн трансляцию.

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

Следующие про стилистику - был один интересный доклад назывался "Сильный текст...", ну это тоже не ново, даже для тех кто пишет  года 2 (это я про себя).

И последние были про технологии - вот это меня повеселило: докладчики говорили про  AuthorIT,  DITA, Help and Manual, делая вид что это совершенно разные программы и технологии, при этом рассказывали об одних и тех же возможностях единого источника.

Итог - ничего нового (и это для новичка, я пишу всего 2 года). Постоянно раздражали английские слова, люди язык ломали пытаясь выговорить "StyleGuide", но все равно говорили.

P.S. рядом со мной был вынужденный слушатель, человек вообще из другой сферы, который тоже удивлялся зачем говорить то, что ясно как день!

Тоже зарегистрировалась, думаю пойти..пока думаю . Ходила в прошлом году, какое-то двоякое впечатление осталось. Темы докладов слабоваты, вообще все напоминало саморекламу Яндекса. Интересно было посмотреть на других тех.писателей, кто чем живет .
Не понравилась неосведомленность Яндекса о существовании других русскоязычных сайтов, форумов и книг для тех.писателей, тесный зал, друг на друге сидели
Понравились вопросы из "зрительного зала", бесплатные бутерброды

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

А мне, иногда, вместо "Уступайте пожилым...."  слышится  "Уступайте  живым людям". Очень весело становится, когда тесно в вагоне.

Я решила задачу с повтором надписей, опишу здесь, вдруг кому пригодится:

[B]Проблема[/B]
При добавлении надписей на титульный лист (шаблон <xsl:template name="createFrontMatter_1.0"> - кастомизация файла front-matter.xsl) я использовала элементы topicmeta (например, prodname, category, vrm).
На выходе получалось что число надписей на титульном листе равнялось числу топиков+1.

[B]Решение [/B]
В карте к каждому элементу topicref (то есть при каждой ссылке на топик) добавить элемент topicmeta с теми же элементами, только оставить их пустыми.
(Правда с элементом vrm это так и не сработало пришлось его заменить).

О "topicmeta" см. [URL=http://docs.oasis-open.org/dita/v1.2/os/spec/langref/topicmeta.html]http://docs.oasis-open.org/dita/v1.2/os/spec/langref/topicmeta.html[/URL]

Ждите, отправила письмом :) .

В первый раз отправила администратору, чтобы не расслаблялся!  :)

отправила письмом :)

[QUOTE]
В документе несколько ditamap?
[/QUOTE]Да, в главном файле ditamap есть карта переменных и карта атрибутов.

[QUOTE]vrm указан несколько раз??
[/QUOTE]Да - три раза, для трех разных документов на выходе. Каждый vrm профильтрован по атрибуту product.

Такая проблема не только с  vrm (его указала как пример), а со всеми тэгами, которые я добавляю на титульный лист или в колонтитулы. Вот например  publisher указан один раз и не профильтрован соответственно, а повторяется ровно столько же раз, сколько и топиков.

Благодаря тому, что на выходе я получаю 4 разных документа с разным числом разделов, я смогла найти только эту одну зацепку - "сколько топиков - столько и повторов".

У меня вопрос в продолжение затронутой ранее темы (надписи на титульном листе).

Следуя инструкциям ADVANCED я вывела на титульный лист несколько надписей (за инструкции отдельное спасибо  :)  ) .
НО! Каждая надпись повторяется на титульном листе ровно столько раз, сколько в документе топиков (выявлено экспериментальным путем).
Как я не изменяла следующий код в front-matter.xsl, ничего не получается, надписей либо много, либо нет вообще:

[CODE]<fo:block xsl:use-attribute-sets="__frontmatter__version">
                       <xsl:if test="$map//*[contains(@class,' topic/vrm ')] [1]/@version">
                           <xsl:call-template name="insertVariable">
                              <xsl:with-param name="theVariableID" select="'Version'"/>
                              <xsl:with-param name="theParameters">
                               <number>
                                 <xsl:value-of select="$map//*[contains(@class,' topic/vrm ')][1]/@version"/>
                               </number>
                              </xsl:with-param>
                           </xsl:call-template>
                       </xsl:if>
                    </fo:block> [/CODE]
В xml разбираюсь "на ощупь", никак не получается справится с этой загадкой, надеюсь знающие люди без труда найдут ошибку.

Ум за разум зашел? :D

Что получается? Все правильно - по тексту стоит придерживаться однотипных понятий.

"Лазер...с ...активным элементом. "

Ой, и я , и я тоже, тоже через недельку и тоже на Средиземное!Технические писатели перебираются в тепло! Давайте-ка оккупируем побережье средиземного моря...заграничные фрукты не едут к нам, значит мы поедим к фруктам!

Начинаю распутываться, спасибо за терпение

Напишите, пожалуйста, для отличившихся, какие же всё-таки поля по ГОСТ 2.105-95!

На рисунке 22 (где речь идет о документах для двустороннего копирования указаны размеры: 20- левое поле, 5 - правое поле, о верхнем и нижнем можно только догадываться что 20).

В приложении А - Пример выполнения текстового документа  размер полей не указан, зато размеры междустрочных интервалов все даны!

Ага, спасибо большое  :)

hi-hi-hi  Придерживаешься, придерживаешся одного ГОСТа а тут БАМ, а в другом совсем другие указания - не первый раз сбивает с толку.

Ну, я прийду к своим соображениям, пока хочется узнать как поступают в этом вопросе другие технические писатели.

При решении вопроса "Поля" ( http://techwriters.ru/forum/forum598/topic19824/ ) возник новый вопрос:


В каком порядке в верхнем колонтитуле указывать код документа и номер страницы, если, например:

[url=http://techwriters.ru/services-for-technical-writers/gosts-and-standards/gost/gost_detail.php?ELEMENT_ID=278]ГОСТ 19. 106-78[/url] провозглашает порядок (см. Форма 1) "номер страницы"
  "обозначение документа"


[url=http://techwriters.ru/services-for-technical-writers/gosts-and-standards/gost/gost_detail.php?ELEMENT_ID=353]ГОСТ 34.602-89[/url] провозглашает противоположный порядок (см. п.3.2).

Как поступаете Вы?

В ГОСТ 2.105-95 не нашла ни слова о размере полей!

В ГОСТ 19.106-78 Требования к программным документам, выполненным печатным способом  - есть.


[CENTER]
[/CENTER]

Подскажите, пожалуйста, ГОСТ в котором указаны размеры полей в текстовых документах. Я так понимаю это должен быть ГОСТ 2..... ?

Спасибо

Можно просто предлог "с" поставить, глагол "присваивать" (например, атрибут с присвоенным значением).
А иногда мы именно "привязанный" и используем.

Спасибо, а юрист нашей компании сказал что подумает нужно ли нам вообще это.

А я на самокате неслась с горы - теперь хожу вся в ссадинах и с повязкой на руке.