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

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

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

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

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

Страницы: 1 2 3 4 След.
дизайн для тех. писателей
 
У нас на работе создана библиотека фирменного стиля, в которой есть иконки сервера, сайта, ноутбука и т.п. Загружаем их в visio и работаем уже как с объектами.
Также иногда подходящие иконки можно найти на iconfinder.com.
На последнем гипербатоне еще был доклад от Яндекса на эту тему.
Содержание в webhelp
 
Если браузер не Mozilla и вы не используете веб-сервер, то так и будет. Надо веб-сервер использовать, типа HM2GO.
Придумываем слова, Тема-говоломка для писателя
 
Засинглсорсить - перенести контент из обычного документа в систему, поддерживающую условия и прочие плюшки  beach-smile
условные пользовательские переменные
 
Я делаю это через Task Manager - там в настройках Task Action на вкладке Custom Variables можно менять значения переменных. Т.е. придётся для каждого вашего заказчика создать свой Task Action, соответствующий Custom Build-у. А если для одного заказчика, к примеру, несколько документов, то для каждого документа свой Task Action, и можно все переменные, соответствующие одному заказчику, хранить в текстовом файле, а потом его импортировать на той же вкладке Custom Variables.
Ряд вопросов по H&M, Вопросы по нумерованию разделов, репозиторию и сложным модульным проектам.
 
[QUOTE]Geonaft написал:
Внешний репозиторий крайне необходим. Т.к. с документацией будут  работать несколько человек. Соответственно, все наработки должны  храниться на сервере. Начал разбираться с SVN. На сколько я понимаю,  такой вариант вполне подойдет. По работе другими специалистами он уже  используется. Модулем я называю отдельный файл типа "Module_A.hmxz",  который может быть самодостаточным, содержать вложенные модули или быть  вложенным в другой модуль. Получается своеобразная матрешка из модулей.
[URL=http://techwriters.ru/forum/user/14053/]tech_writer_1[/URL] , как Вы делаете ручную нумерацию?[/QUOTE]
А, простите, я думала, вы с топиками работаете, с модулями не работала к сожалению...
Вручную - в содержании делаю Edit Caption и ввожу туда номера разделов.
Ряд вопросов по H&M, Вопросы по нумерованию разделов, репозиторию и сложным модульным проектам.
 
[URL=http://techwriters.ru/forum/user/18987/]Geonaft[/URL], отвечу по тому, что знаю:
1. Если правильно поняла, то Вам нужно использовать вставку сниппета со связью. Но для каждого абзаца надо создавать свой топик (Вы их вроде модулями называете), не включая его в содержание. Тут же ответ на вопрос 4: все топики лучше создавайте в едином проекте, не прибегая к внешнему репозиторию. Для этого в Project Explorer найдите Project Files > Topic Files и там из контекстного меню создавайте топик и в нем сохраните нужный абзац. Далее откройте топик, куда хотите вставить абзац, нажмите Insert Object > Snippet, выберите созданный ранее топик и установите переключатель Snippet is linked. В итоге абзац будет вставлен со связью. Но: почему-то в последней версии наблюдаются глюки в этом функционале: если топик содержит if-ы, то они так и остаются if-ами в пдфках.. В общем, суть в том, что HM - очень глючный продукт и я бы не советовала с ним связываться. Сделать можно многое, но реализация у них... через одно место.
2. Тут уже обсуждалась эта тема, если не ошибаюсь. Мне так и не удалось найти нормального решения, приходится делать нумерацию руками (к стыду и ужасу).
Technical Writer, В компанию NTechLab (http://ntechlab.ru)
 
Добрый день! А общение внутри команды на каком языке предполагается?
Help & Manual 7, Обсуждение Help & Manual версии 7+
 
[QUOTE]Mariel написал:
Всем доброго времени суток! Есть такие, кто уже обновил Help and Manual 7 до версии 7.2?[/QUOTE]
ааа это ужас! переменная <%TARGETTITLE%> работает не так, как раньше. Подставляет ID вместо Title
Прошу совет, хочу понять, техпис ли я?, и как мне заработать этим денег...
 
Цитата
Виктор Фигурнов написал:
Цитата
 tech_writer_1  в целом при разработке ПО обычно требуют ТЗ по ГОСТу
Полагаю, что 99,9% разработчиков ПО в мире никогда не встречались с первобытным обычаем составления "ТЗ по ГОСТу".
Даже в в России ведущие разработчики ПО, такие как 1С, Яндекс, Лаборатория Касперского, ABBYY, Acronis, JetBrains, Parallels и др. как-то обходятся.
Тем не менее, описания большинства вакансий для техписов говорят об обратном.
Прошу совет, хочу понять, техпис ли я?, и как мне заработать этим денег...
 
Не знаю насчёт разработки игр, но в целом при разработке ПО обычно требуют ТЗ по ГОСТу, и здесь техпис нужен скорее как оформитель чужих мыслей. Если освоите ГОСТы и сможете писать сухим деловым языком, то найдете работу - такие специалисты довольно-таки востребованы. Только не забывайте про точки в конце предложений и прочие "мелочи", когда пишете.
Юмор!
 
Цитата
Ranaloc написал:
Цитата
 tech_writer_1  написал:
Интересная формулировка: "Исключение, которое бросается объектами во время возникновения нештатных ситуаций."
Стульями в людей бросается?
Да, причем хотели сказать, что стул бросает исключение, а получилось наоборот.
Юмор!
 
Интересная формулировка: "Исключение, которое бросается объектами во время возникновения нештатных ситуаций."
Юмор!
 
Из книги Таненбаума:
Цитата
With this algorithm, the page daemon maintains two pointers into the core map.
Перевод:
Цитата
В этом алгоритме страничный демон поддерживает два указателя на карту памяти.
Нашла в Lingvo ))
Проверка наличия рисунков, Можно ли в больших проектах автоматически проверить наличие рисунков?
 
хороший вопрос. Help and Manual настолько убог, что даже в compiler messages не пишет о проблемах с рисунками.
Помогите разобраться с заполнителем в оглавлении при импорте в PDF, Заполнитель при компиляции PDF
 
Обращайся еще :)
Очень нужны ваши советы, Как объединить пользовательскую документацию с тестерской
 
почему нельзя просто сделать custom build в проекте, например for_testers? и помечать им все текстовые фрагменты, которые предназначены только для тестировщиков
Как лучше формировать из H&D группу документов по одному комплексу?
 
С 7-ой версией - однозначно единый проект.

Немного поделюсь опытом. У меня примерно такая же ситуация, один большой продукт, состоящий из множества модулей, на каждый модуль 1 или 2 документа. Сначала я делала отдельные проекты на каждый документ, при этом был один manual template для PDF. Если у меня повторялся один и тот же текст в нескольких документах, приходилось делать некое "общее хранилище" топиков (репозиторий), а потом создавать такие же топики в каждом проекте и линковать туда топики из репозитория как сниппеты. Процесс этот мне постепенно надоел. Еще одно: все переменные пришлось хранить в репозитории, т.к. нужно соблюсти единообразие употребления названий одного и того же компонента во всех документах. Проблема, что переменные, хранящиеся в репозитории, нельзя вставлять в проекты, используя UI.

В итоге я решила попробовать другую схему: чтобы все топики хранились в одном проекте и при этом для каждого документа формировалось своё содержание. В 6-ой версии я делала это так: создавала копию map-файла, меняла его имя, содержимое, и указывала ссылку на него в файле проекта. В 7-ой версии поддержали фичу Multiple TOC, так что стало возможно средствами UI создавать несколько содержаний в одном проекте. Необходимость хранить топики в репозитории исчезла. Минус такого решения пока только 1: надо создавать отдельный manual template на каждый PDF, потому что из свойств проекта не удастся извлечь данные для титульника и колонтитулов. Хотя при желании можно и этого недостатка избежать с помощью переменных.
Изменено: tech_writer_1 - 22.04.2016 13:19:24
Переквалификация в техписы. Нужна помощь
 
[QUOTE]Lawyer написал:
Обратного никто не написал.[/QUOTE]
Просто мало кто форум посещает :)
Нумерация глав (разделов) в справочном пособии, Как сделать, чтобы отдельные главы автоматически не нумеровались
 
Есть теория, что с функцией Multiple TOCs, которая поддержана в 7 версии, всё станет проще. Можно тупо вставлять нумерацию текстом (1.1, 1.2 и т.д.) в заголовок топика (Edit caption в Project Explorer). Если из проекта создаётся несколько документов и для каждого документа свое содержание, то нумерацию можно контролировать для каждого документа отдельно. Но тогда придётся вручную править номера при создании и перемещении топиков.
Вопрос по копированию данных строки таблицы + создание текста под катом
 
Вроде как в 7 версии что-то улучшили в работе с таблицами:
[QUOTE]You can now copy and paste the contents of multiple cells across rows and columns in tables. Just select the cells you want to copy and transfer them to the clipboard. Then click in the cell where you want the paste to begin and paste.[/QUOTE]
Болтовня в реальном времени, Чат технических писателей, технические писатели в прямом эфире
 
2 февраля, 3 марта, 4 апреля... Давайте каждый месяц праздновать.
Болтовня в реальном времени, Чат технических писателей, технические писатели в прямом эфире
 
Цитата
Nadufka написал:
Здравствуйте, уважаемые) Давно не заглядывала, жив еще форум?)
не особо
%SEARCH_SCRIPT%
 
Поставлю вопрос по-другому. Подскажите кто-нибудь, как можно изменить вот эту форму поиска из стандартных hmskin-ов? Ведь наверняка не все её используют.


Имею в виду не текст, а расположение элементов, внешний вид кнопки Submit (или как ее убрать вообще).
Изменено: tech_writer_1 - 27.11.2015 11:45:21
Нумерация глав (разделов) в справочном пособии, Как сделать, чтобы отдельные главы автоматически не нумеровались
 
В содержании нужно кликнуть правой кнопкой по топику, выбрать [B]Delete TOC Entry/Topic[/B]. В появившемся окне снять флажок [B]Also delete referred topic files[/B] и нажать [B]Delete entries[/B].
Help & Manual 7, Обсуждение Help & Manual версии 7+
 
Нельзя просто так взять и перейти с 6 на 7 :)
Страницы: 1 2 3 4 След.

Рейтинг@Mail.ru