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

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

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

Страницы: Пред. 1 2 3 4 5 След.
Яндекс организует конференцию для разработчиков документации 18 апреля
 
Вот!  Хорошо бы каждый год проводить сравнительный анализ инструментов и докладывать о результатх сообществу. А то все в одиночку разбираются, разбираются...а потом перетягивают одеялу.

Я не эксперт, поправьте если это не так, но у меня сложилось впечатление что DITA - это голый xml, а остальное ПО - наряженный xml.
Яндекс организует конференцию для разработчиков документации 18 апреля
 
Есть конечно - другая сторона. Хорошо что есть мероприятия где можно собраться, поделится своими проблемами, задать интересующие вопросы.

Кстати, слышала звонок-вопрос одного из форумчан! Поделитесь своими впечатлениями!
Изменено: TechW - 20.04.2015 11:04:43
Яндекс организует конференцию для разработчиков документации 18 апреля
 
Смотрела онлайн трансляцию.

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

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

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

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

P.S. рядом со мной был вынужденный слушатель, человек вообще из другой сферы, который тоже удивлялся зачем говорить то, что ясно как день!
Яндекс организует конференцию для разработчиков документации 18 апреля
 
Тоже зарегистрировалась, думаю пойти..пока думаю . Ходила в прошлом году, какое-то двоякое впечатление осталось. Темы докладов слабоваты, вообще все напоминало саморекламу Яндекса. Интересно было посмотреть на других тех.писателей, кто чем живет :).
Не понравилась неосведомленность Яндекса о существовании других русскоязычных сайтов, форумов и книг для тех.писателей, тесный зал, друг на друге сидели :(
Понравились вопросы из "зрительного зала", бесплатные бутерброды :)
Какая замечательная погода!
 
Погода замечательная в Москве. Мне сегодня из окна улыбалась милая беззубая старушка, кормившая голубей на своем подоконнике :)
Очепятки, смешные инструкция, добавляем найденные опечатки, о том как не нужно писать
 
А мне, иногда, вместо "Уступайте пожилым...."  слышится  "Уступайте  живым людям". Очень весело становится, когда тесно в вагоне.hi-hi-hi
DITA pdf формат
 
Я решила задачу с повтором надписей, опишу здесь, вдруг кому пригодится:

[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]
DITA pdf формат
 
Ждите, отправила письмом :) .

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

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

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

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

Следуя инструкциям 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
Аномальные ГОСТы, Странные, непонятные и непознанные формулировки в ГОСТах
 
Что получается? Все правильно - по тексту стоит придерживаться однотипных понятий.

"Лазер...с ...активным элементом. "
Болтовня в реальном времени, Чат технических писателей, технические писатели в прямом эфире
 
Цитата
techwriter пишет:
Всем привет!  :)  Еще недельку, и в отпуск!  :)  ))
Ой, и я , и я тоже, тоже через недельку и тоже на Средиземное!Технические писатели перебираются в тепло! Давайте-ка оккупируем побережье средиземного моря...заграничные фрукты не едут к нам, значит мы поедим к фруктам!
Изменено: TechW - 22.08.2014 16:45:21
В каком ГОСТ, указаны размеры полей документа?
 
Начинаю распутываться, спасибо за терпение
В каком ГОСТ, указаны размеры полей документа?
 
Напишите, пожалуйста, для отличившихся, какие же всё-таки поля по ГОСТ 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..... ?
Уведомление об авторском праве. Торговые марки. Отказ от ответственности.
 
Спасибо
Каким словом в документации заменить слово "привязанный"
 
Можно просто предлог "с" поставить, глагол "присваивать" (например, атрибут с присвоенным значением).
А иногда мы именно "привязанный" и используем.
Уведомление об авторском праве. Торговые марки. Отказ от ответственности.
 
Спасибо, а юрист нашей компании сказал что подумает нужно ли нам вообще это.
Болтовня в реальном времени, Чат технических писателей, технические писатели в прямом эфире
 
А я на самокате неслась с горы - теперь хожу вся в ссадинах и с повязкой на руке. :(
Страницы: Пред. 1 2 3 4 5 След.

Рейтинг@Mail.ru