Заказать звонок

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

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

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

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

Страницы: Пред. 1 ... 60 61 62 63 64 65 66 67 68 69 70 ... 72 След.
Как организовать работу отдела документирования?
 
Потом зафиксировать требования к документированию: закрепить стили, утвердить терминологию, добавить корп.стандарты и т.п. чтобы результаты работы каждого сотрудника были частью общего дела, а не каждый сам по себе
ip-адрес с большой или маленькой буквы писать
 
IP-адрес
IP-трафик
DITA pdf формат
 
Справедливо :)
1.[quote="Arven":3abe3hz6]А где здесь писать текст того же самого подзаголовка?[/quote:3abe3hz6]Текст задается в том же файле ru_RU.xml. Надо добавить строку [code:3abe3hz6]<variable id="Version">Версия <param ref-name="number"/></variable>[/code:3abe3hz6]2.[quote="Arven":3abe3hz6] не существует такого атрибута с именем " __frontmatter__version"[/quote:3abe3hz6]Надо в файл static-content-attr.xsl добавить атрибут [code:3abe3hz6] <xsl:attribute-set name="__frontmatter__version">
<xsl:attribute name="margin-top">50mm</xsl:attribute>
<xsl:attribute name="font-size">10pt</xsl:attribute>
 </xsl:attribute-set>
[/code:3abe3hz6] лучше рядом с тем местом, где описывается __frontmatter, чтобы ориентироваться потом.

3. Сам номер писать в теге топика.
DITA pdf формат
 
[quote="Arven":7u4pcpl5] а мне нужно ещё наподобие подзагловка (Дополнительная информация) и под-подзаголовка (версия 2.8.2)
Тема
Дополнительная Информация
Версия 2.8.2
[/quote:7u4pcpl5] Для начала надо определиться с типом тега, которым будет выделяться тот или иной блок.
Подзаголовок и версия оформляются каким-либо из тегов в [color=#FF0000:7u4pcpl5]Book[/color:7u4pcpl5]meta или [color=#FF0000:7u4pcpl5]topic[/color:7u4pcpl5]meta (в зависимости от типа карты Bookmap или Ditamap).
Тег <[color=#FF0000:7u4pcpl5]****[/color:7u4pcpl5]meta> содержит в себе большую иерархию других тегов, которыми можно оформить подзаголовок. Для версии наиболее подходящий [b:7u4pcpl5]<vrmlist><vrm version="???"></vrm></vrmlist>[/b:7u4pcpl5]. Для подзаголовка можно взять например, [b:7u4pcpl5]<prodname><wintitle></wintitle></prodname>[/b:7u4pcpl5]. А дальше всем любимый XSL.

Каждый блок на странице выводится в виде таблицы. Главным блоком является титульный лист - [b:7u4pcpl5]<xsl:template name="createFrontMatter">[/b:7u4pcpl5]. Всё остальное содержится внутри него, это могут быть - колонтитулы, заголовки, версии, редакции и т.п. Взять к примеру заголовок. Заголовок имеет свою область в виде прямоугольника, который можно перемещать по странице, менять границы, отступы относительно страницы или относительно предыдущего блока. В тот же блок можно добавить еще несколько блоков с подзаголовком, версией... как мы привыкли видеть титульный лист: вместе "версия, ЗАГОЛОВОК, Подзаголовок", отдельно внизу "Москва 2011" и так далее.
Выравнивание, шрифты и стили блоков самих по себе задаются в... ПРАВИЛЬНО, в файле с приведенным кодом
[quote="Arven":7u4pcpl5]<xsl:attribute-set name="__frontmatter">
        <xsl:attribute name="text-align">center</xsl:attribute>
        <xsl:attribute name="color">black</xsl:attribute>
        <xsl:attribute name="border-top">2.5pt solid lightsteelblue</xsl:attribute>
        <xsl:attribute name="padding-top">20pt</xsl:attribute>
        <xsl:attribute name="border-bottom">2.5pt solid lightsteelblue</xsl:attribute>
        <xsl:attribute name="padding-bottom">109mm</xsl:attribute>
</xsl:attribute-set>
[/quote:7u4pcpl5]
А последовательность, уровни вложенности и сам факт наличия того или иного блока на странице определяются в файле front-matter.xsl.
Для вставки версии, оформленной тегом, как описал выше, надо вставить следующий блок в шаблон [b:7u4pcpl5]<xsl:template name="createFrontMatter">[/b:7u4pcpl5] на то место, где выводить версию. Возможно перед [b:7u4pcpl5]<fo:block xsl:use-attribute-sets="__frontmatter__title">[/b:7u4pcpl5], не знаю как у вас.
[code:7u4pcpl5]
<fo:block xsl:use-attribute-sets="__frontmatter__version">
<xsl:if test="$map//*[contains(@class,' topic/vrm ')]">
<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:7u4pcpl5]
С другими блоками все аналогично.


[quote="Arven":7u4pcpl5]но эти линии получаются не как колонтитулы, а как линии к заголовку, а вот как создать их именно как колонтитулы, чтобы содержимое к верхнему прибить не понятно[/quote:7u4pcpl5] Мне тоже не совсем понятно что нужно :)
Верхняя граница блока <xsl:attribute name="border-top">[b:7u4pcpl5]2.5pt solid lightsteelblue[/b:7u4pcpl5]</xsl:attribute> что за граница такая? может дело в стилях???
ГБ или Гб для обозначения гигабайта
 
Нормоконтролер нормоконтролеру рознь. Кроме ГОСТов бывают сложившиеся и устоявшиеся традиции, правила удобочитаемости и корпоративные стандарты.
В одной компании может быть договор с заказчиком, согласно которому  документация оформляется строго по ГОСТ и вычитывается теми самыми "нормоконтролерами". А в другой компании может быть соглашение, о том что документация не должна быть "для галочки", а должна быть понятной и полезной.
Соблюдение ГОСТ - добровольное условие.

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

Артемий Лебедев предлагает так  http://www.artlebedev.ru/kovodstvo/sections/84/

В документации МБ и КБ можно посчитать за аббревиатуры (тупые, но примеры: Мерседес-Бенц и Конструкторское Бюро   :mrgreen:  ).

Глазу все таки привычней читать Кб и Мб.
ГБ или Гб для обозначения гигабайта
 
О, нашел более реалистичное описание!


Российский ГОСТ 8.417-2002[1] («Единицы величин») в «Приложении А» для обозначения байта регламентирует использование русской заглавной буквы «Б». [b:1t4q7xb4]Кроме того, констатируется традиция использования приставок СИ вместе с наименованием «байт» для указания множителей[/b:1t4q7xb4], являющихся степенями двойки (1 Кбайт = 1024 байт, 1 Мбайт = 1024 Кбайт, 1 Гбайт = 1024 Мбайт и т. д., причём вместо строчной «к» используется заглавная «К»), [b:1t4q7xb4] и упоминается, что подобное использование приставок СИ не является корректным[/b:1t4q7xb4].

Использование заглавной буквы «Б» для обозначения байта соответствует требованиям ГОСТ и позволяет избежать путаницы между сокращениями от байт и бит. Однако следует учитывать, что в стандарте нет сокращения для «бит», поэтому использование записи вроде «Гб» как синонима для «Гбит» недопустимо.
ГБ или Гб для обозначения гигабайта
 
Ну да, мне тоже так кажется, но странные примеры в ГОСТе.
В Windows в свойствах "Мой компьютер" отображается информация о системе. Там тоже написано ГБ.
Пропал сохраненный файл Word (.doc или docs)
 
Поиском F3. Найти все [b:2ltbqmwr]*.doc [/b:2ltbqmwr] на диске, когда поиск остановится, отсортировать по алфавиту и найти нужный файл, должна быть копия в папке типа [b:2ltbqmwr]С:\RECYCLER\S-1-5-21-1703110369-3916087505-959407[/b:2ltbqmwr]
Если есть, то дважды кликнуть на нем и нажать "Восстановить".
DITA pdf формат
 
Типа того:  [code:16q3txbi]<variable id="Toc odd header">Содержание   <param ref-name="pagenum"/></variable>
<variable id="Toc even header"><param ref-name="pagenum"/>   Содержание</variable>[/code:16q3txbi]
DITA pdf формат
 
<variable id="Body even footer">Версия 2.8.[color=#BF0000:1l0e3uiu][b:1l0e3uiu]2<[/b:1l0e3uiu][/color:1l0e3uiu]param ref-name="pagenum"/></variable>

После двойки без пробела идет подстановка номера страницы. Нужно пробелы поставить.
Если простой пробел не работает (это может зависеть от ОС и JRE), то ставьте [b:1l0e3uiu] [/b:1l0e3uiu] прям после двойки. Это символ пробела в HTML. Его лучше использовать если необходимо поставить несколько пробелов подряд.
Разработчик Oracle
 
ну наконец-то...
гора с плеч
ГБ или Гб для обозначения гигабайта
 
Да. Первая прописная, остальные строчные (Кбайт, Гбайт) и полностью пишется слово "байт".
Мне это тоже не привычно, но я сделал вывод, основываясь на ГОСТе.  :D
DITA pdf формат
 
Файл [b:blbmwa89]ditaot/demo/fo/xsl/fo/static-content.xsl[/b:blbmwa89], который был упомянут выше, определяет возможность создания колонтитулов (шаблоны, в которые можно вставлять свои переменные variables).

[code:blbmwa89]<xsl:template name="insertBodyEvenHeader">
       <fo:static-content flow-name="even-body-header">
           <fo:block xsl:use-attribute-sets="__body__even__header">
               <xsl:call-template name="insertVariable">
                   <xsl:with-param name="theVariableID" select="'Body even header'"/>
                   <xsl:with-param name="theParameters">
                       <prodname>
                           <xsl:value-of select="$productName"/>
                       </prodname>
                       <heading>
                           <fo:inline xsl:use-attribute-sets="__body__even__header__heading">
                               <fo:retrieve-marker retrieve-class-name="current-header"/>
                           </fo:inline>
                       </heading>
                       <pagenum>
                           <fo:inline xsl:use-attribute-sets="__body__even__header__pagenum">
                               <fo:page-number/>
                           </fo:inline>
                       </pagenum>
                   </xsl:with-param>
               </xsl:call-template>
           </fo:block>
       </fo:static-content>
   </xsl:template>[/code:blbmwa89]
Параметры "Body even header" и "$productName" задаются в ru_RU.xml (по умолчанию этого файла нет)
Рекомендуется скопировать \ditaot\demo\fo\cfg\common\vars\en_US.xml и сохранить его в той же директории с именем ru_RU.xml.
В файле содержатся параметры variable
[code:blbmwa89] <variable id="Body odd header"><param ref-name="prodname"/> | <param ref-name="heading"/> | <param ref-name="pagenum"/></variable>
[/code:blbmwa89] Которые также можно редактировать. Например:
  [code:blbmwa89]
<variable id="Body odd footer">© 2010, ЗАО "Название компании"</variable>
<variable id="Toc even header"><param ref-name="pagenum"/>   Содержание</variable>

[/code:blbmwa89] Если есть знания и навыки работы с XSLT, то можно накрутить что угодно с шаблонами, например, выводить заголовки разных уровней на определенных страницах, рамки, децимальные номера и т.д.

Файл \ditaot\demo\fo\cfg\fo\attrs\static-content-attr.xsl позволяет настроить ВИД колонтитулов (отступы, размеры, шрифты и т.п.). Все параметры задаются также как в html.
DITA pdf формат
 
[quote="Arven":2lsk7grn]как правильно оформлять колонтитулы в выходном формате pdf[/quote:2lsk7grn] Как оформлять или как создавать? Оформление на плечах корпоративного стиля или требований заказчика. А создание и изменение средствами DITA это другой вопрос.[quote="Arven":2lsk7grn]но в выходном документе линии отображаются через старницу (т.е. по нечётным страницам) [/quote:2lsk7grn] По поводу четных и нечетных страниц, если "на пальцах" по простому я бы разделил страницы на следующие:
Титульный лист  [b:2lsk7grn]front-matter[/b:2lsk7grn]
Оглавление [b:2lsk7grn]toc[/b:2lsk7grn]
Главы/разделы/части/параграфы [b:2lsk7grn]body[/b:2lsk7grn]
Алфавитный указатель [b:2lsk7grn]index[/b:2lsk7grn]

Каждая из страниц (рассмотрим на оглавлении) может быть:
Для понятности, надо положить перед собой книгу раскрытую на любой странице.
[b:2lsk7grn]toc-first[/b:2lsk7grn] - первая страница оглавления (нечетная, эта страница справа)
[b:2lsk7grn]toc-even[/b:2lsk7grn] - четная страница (оборотная сторона, страница слева)
[b:2lsk7grn]toc-odd[/b:2lsk7grn] - нечетная страница (правая но не первая в главе)
[b:2lsk7grn]toc-last[/b:2lsk7grn] - последняя страница главы ( оборотная, даже если нет текста, она будет пустая. Новая глава все равно начнется с правой страницы)

Разделение на "первую страницу" (нечетную) и "нечетную не первую", "оборотную" нужно для того, чтобы можно было добавлять разные колонтитулы. В большинстве книг можно наблюдать, что в начале главы колонтитул отсутствует или написано название книги, а на всех остальных страницах возможно название этой главы, раздела, подраздела. Dita позволяет это делать в полной мере, включая разные рамки по ГОСТ.

Верхний колонтитул - [b:2lsk7grn]header[/b:2lsk7grn]
Нижний колонтитул - [b:2lsk7grn]footer[/b:2lsk7grn]

Из этих слов (это основные) состоят названия xsl-шаблонов. Если посмотреть файл [b:2lsk7grn]ditaot/demo/fo/xsl/fo/static-content.xsl[/b:2lsk7grn], то там можно найти нужные шаблоны. Еще пару расшифровок для примера:
[b:2lsk7grn]<xsl:template name="insertBodyEvenHeader"> [/b:2lsk7grn]определяет параметры на верхний колонтитул на четной (оборотной, но не последней) странице главы
[b:2lsk7grn]<xsl:template name="insertTocOddFooter"> [/b:2lsk7grn]определяет параметры на нижний колонтитул нечетной, но не первой страницы оглавления

Помимо шаблонов есть переменные, в которых определяется текст или графика, которые будут подставляться в шаблоны, а еще стили их отображения в выходном документе (цвет, размеры, отступы и т.д.)

Вообще сложно объяснить "в общих чертах". Arven, задавайте конкретный вопрос, что не получается или что непонятно.
ГБ или Гб для обозначения гигабайта
 
[quote="Businka":2mx0dbz4]взяв за основу ГОСТ 8.417-2002, где указано:
(Приложение А, таблица А.1.) Б - русское обозначение байта.

Соотвественно, ГБ - корректное, по ГОСТу, обозначение гигабайта.

[/quote:2mx0dbz4]
Посмотрите ГОСТ внимательней. Там четко написано как следует применять обозначения: [color=#FF0000:2mx0dbz4]начинают с прописной[/color:2mx0dbz4]. Приложение А. (таблица)
[code:2mx0dbz4]2. В соответствии с международным стандартом МЭК 60027–2 единицы „бит“ и „байт“ применяют с приставками СИ.
3. Исторически сложилась такая ситуация, что с наименованием „байт“ некорректно (вместо 1000 = 103 принято 1024 = 210) использовали (и используют) приставки СИ: 1 Кбайт = 1024 байт, 1 Мбайт = 1024 Кбайт, 1 Гбайт = 1024 Мбайт и т.д. При этом обозначение Кбайт начинают с прописной буквы в отличие от строчной буквы „к“ для обозначения множителя 103.[/code:2mx0dbz4]
Куда поедем в отпуск?
 
А я вчера приехал из Туниса. По стоимости та же Черногория, уровень хуже и море грязнее  :D .
Больше всего порадовала погода: воздух 25-27, в Москве в то же время температура воздуха была больше и ощущение жары хуже. Получается, что зимой отстойную погоду можно пережить в Египте, тополиный пух в Турции, невыносимую жару в Африке  :mrgreen:
MAdCap Flare 7 и Wiki (Confluence)
 
[quote="drbotkin":oh2gbx8p]Мне щас нужно узнать, что именно можно использовать. не хотелось бы использовать цепочку из нескольких продуктов[/quote:oh2gbx8p] Написал выше.
Dita htmlhelp
 
[quote="o_alekseev":zdq6000c]Либо можно подредактировать таргет dita.out.map.htmlhelp.hhc как описал ADVANCED.[/quote:zdq6000c]HHC - он же TOC, это древовидное оглавление. Если проблемы с ним, то править нужно dita.out.map.htmlhelp.[color=#FF0000:zdq6000c]hhc[/color:zdq6000c]

HHK - это файл индексов (список слов, список файлов). Если проблемы с ним, то править нужно dita.out.map.htmlhelp.[color=#FF0000:zdq6000c]hhk[/color:zdq6000c]
DITA - формат RTF
 
[quote="Maxim":2utadg5e]а почему в формате rtf нужно.. заказчики просят:((
не знаю  зачем но им это надо:([/quote:2utadg5e] RTF-файл может получаться очень громоздким (бывает по 500 Мб). Если в документе много таблиц, то могут появиться ошибки в документе. Конечно, это поправимое дело, но настраивать вывод RTF сложно. Слышал что разработчики Dita "забросили" работы с этим форматом году в 2007 и взялись за поддержку OpenOffice.
Отлично собирается документ *.ODT в стандартной конфигурации Dita. Файл нормально открывается в MSWord и может быть сохранен в любом другом формате "если попросят". С кириллицей проблем тоже не возникало.
MAdCap Flare 7 и Wiki (Confluence)
 
[quote="drbotkin":3kgipel5]Доброго времени суток, колеги.
Недавно дошел до меня слух, что [color=#FF4000:3kgipel5]MadCap Flare[/color:3kgipel5] может как-то работать с wiki (Confluence). Для меня главное - взять существующий формат и перевести его в Wiki. Если есть возможность вытаскиваить из Wiki, тоже будет здорово.[/quote:3kgipel5] В Форуме Robohelp аналогичное сообщение. Если где-то еще придется спрашивать - DitaOT работает с confluence и wiki отлично.
Как организовать работу отдела документирования?
 
А начальника уже нашли ?
DITA - формат RTF
 
[quote="o_alekseev":1aofvwzi]Насколько помню в получающемся RTF имеются проблемы с русским языком, да и с форматированием и стилями не все гладко. Короче говоря надо донастраивать...[/quote:1aofvwzi] Если без донастроек, то проблем с русским нет в ODT. Но там со стилями работать надо будет в Word.

В общем, если и настраивать эти форматы, то уж не как основной вариант документации. Проще в MS Word тогда. (OpenOffice бесплатен)

Опаздываю на самолет. всем удачи!
DITA - формат RTF
 
[quote="Maxim":3hmdk71b]Попробовал выполнить команду ant -f buildfile dita2rtf? в ответ получаю сообщение: Unable to locate tools.jar. Expected to find it in C:\Program Files\Java\jre6\lib\tools.jar
[/quote:3hmdk71b]
О каком именно buildfile идет речь,  он был в примерах или самописный ?
DITA - формат RTF
 
Да и в примерах че-то не нашел rtf вообще  :)  Примерами не пользовался ни разу.
Страницы: Пред. 1 ... 60 61 62 63 64 65 66 67 68 69 70 ... 72 След.

Рейтинг@Mail.ru