Все сервисы Хабра

Сообщество IT-специалистов

Ответы на любые вопросы об IT

Профессиональное развитие в IT

Удаленная работа для IT-специалистов

Три системы мобильной аналитики глазами digital-компаний
Войти на сайт
  • Все вопросы
  • Все теги
  • Пользователи

Хабр Q&A — вопросы и ответы для IT-специалистов

Получайте ответы на вопросы по любой теме из области IT от специалистов в этой теме.

Узнать больше
другие проекты хабра
  • Хабр
  • Карьера
  • Фриланс
Задать вопрос
eduardtibet

Эдуард Тибет

Technical Writer / Documentation Engineer
  • 42
    вклад
  • 2
    вопроса
  • 142
    ответа
  • 18%
    решений
Ответы
  • Информация
  • Ответы
  • Вопросы
  • Комментарии
  • Подписки
  • Нравится
  • Достижения
  • Можно ли скормить RTF на вход XSLT-процессору, чтобы получить на выходе PDF?

    eduardtibet
    Эдуард Тибет @eduardtibet
    Technical Writer / Documentation Engineer
    У вас изначально неправильно поставлена цепочка преобразований.

    В правильном варианте то, что вы перечислили, является представлением исходного контента в xml, Т.е. конечной точкой. А не наоборот.
    Ответ написан более трёх лет назад
    2 комментария
    Нравится 2 комментария
  • Типографика: ГОСТ и импортозамещение - чья взяла?

    eduardtibet
    Эдуард Тибет @eduardtibet
    Technical Writer / Documentation Engineer
    Я вам больше скажу по этой теме.

    Есть ГОСТ Р ИСО/МЭК 26300-2010 ( Информационная технология. Формат Open Document для офисных приложений (OpenDocument) v1.0)
    А есть еще ГОСТ на PDF (тоже тянутый с ISO) - не помню номер, можете погуглить.

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

    Есть даже статья на хабре по этому поводу - https://habrahabr.ru/post/181900/ (м.б. и другие есть статьи)
    Ответ написан более трёх лет назад
    4 комментария
    Нравится 1 4 комментария
  • Через что верстать PDF?

    eduardtibet
    Эдуард Тибет @eduardtibet
    Technical Writer / Documentation Engineer
    1. Если надо именно _полиграфическое качество_ (т.е. ориентированное на типографию: с цветоделением, crop marks и т.п. штуковинами), то решение - кастомный xml и возможности InDesign по использованию xml-содержимого.

    Есть даже специальная литература по этому поводу: "XML Publishing with Adobe InDesign " (shop.oreilly.com/product/0636920015949.do)

    2. Если же НЕ надо полиграфическое качество (в просто обычный качественный pdf), то решение: кастомный xml (под данные вашего отчета) >> xsl:fo >> fo >> pdf . Т.о. вы будете получать гарантированное содержимое (дизайн) с изменяемой частью (данные). Можно даже это все дело запихать в CI :)

    На вскидку: xml (c вашей схемой, будь то DTD или W3C Schema или RelaxNG) >> xsltproc (libxslt) | saxon | xalan [для шага xml > fo] >> FOP [для шага fo > pdf]
    И все - с нулевыми затратами по софту.

    П. 2 применяется в документации и называется "Технология единого источника в технической документации" (Single sourcing technical documentation).
    Ответ написан более трёх лет назад
    1 комментарий
    Нравится 1 1 комментарий
  • Есть ли конвертер XSD файлов в документацию для человека?

    eduardtibet
    Эдуард Тибет @eduardtibet
    Technical Writer / Documentation Engineer
    xsd > кастомный xsl > DocBook xml source > Docbook xsl "out of box" > txt, man, html, html chunked, chm, pdf из одного исходника - что пожелаете :)

    Но все-таки надо заметить, что xsd - это все таки именно схема (хоть с xml-based) с правилами. Вы уверены, что хотите экспортить именно xsd, а не xml, использующий эту схему?
    Ответ написан более трёх лет назад
    Комментировать
    Нравится Комментировать
  • Как Вы документируете функционал приложения?

    eduardtibet
    Эдуард Тибет @eduardtibet
    Technical Writer / Documentation Engineer
    1. Насколько большое ПО по функционалу сейчас и предполагается?
    2. Какой тип информации вы хотите размещать там? Высокоуровневые требования, технические требования, архитектуру, пользовательскую документацию или все вместе?
    Ответ написан более трёх лет назад
    2 комментария
    Нравится 2 комментария
  • Как восстановить систему из бэкапа debian 8.7?

    eduardtibet
    Эдуард Тибет @eduardtibet
    Technical Writer / Documentation Engineer
    А почему вы не хотели изначально использовать rsync???
    Ответ написан более трёх лет назад
    Комментировать
    Нравится Комментировать
  • Как сделать локальную сеть из 2-х компьютеров?

    eduardtibet
    Эдуард Тибет @eduardtibet
    Technical Writer / Documentation Engineer
    Если не надо ограничивать траффик и другие squid-подобные вещи, то самое легкое решение: dnsmasq. Эта штука может работать с режиме masquerading.
    Ответ написан более трёх лет назад
    Комментировать
    Нравится Комментировать
  • Какие есть временные папки в дебиане?

    eduardtibet
    Эдуард Тибет @eduardtibet
    Technical Writer / Documentation Engineer
    /var/[run,spool,lock]

    Еще, насколько я понимаю,
    /dev
    /sys
    /proc
    Все это создается динамически в процессе загрузки.
    НО! основной вопрос здесь, КОГДА они инициализируются. Т.е. не получится ли так, что память доступна становится такой ПОСЛЕ инициализации /dev /sys и /proc - можете погуглить на эту тему.

    Под вопросом /var/tmp ...

    UPDATE: Здесь www.pathname.com/fhs/2.2/fhs-5.15.html и здесь: https://wiki.archlinux.org/index.php/Tmpfs рекомендуют этого НЕ делать.

    Кстати, по теме tmpfs очень много материала - погуглите.
    Ответ написан более трёх лет назад
    Комментировать
    Нравится Комментировать
  • Как отсортировать большое количество фотографий?

    eduardtibet
    Эдуард Тибет @eduardtibet
    Technical Writer / Documentation Engineer
    Из серии: "как сделать все true в консоли":

    1. find
    2. Тут нужно уточнить. Вы имеете в виду exif? Но тут есть много вариантов - фотография, сохраненная без exif и т.п. Самое простое - exiv2
    3. Информация - exiv2
    4. По дубликатам - jdupes (это лучше, чем fdupes).
    5. find + exec mv

    Обернуть все в sh и отладить.
    Ответ написан более трёх лет назад
    3 комментария
    Нравится 3 комментария
  • База данных клиентов со сканами?

    eduardtibet
    Эдуард Тибет @eduardtibet
    Technical Writer / Documentation Engineer
    Клиентов - юр. лиц или физ. лиц?

    Вы не забыли про 152-ФЗ ?
    Ответ написан более трёх лет назад
    Комментировать
    Нравится Комментировать
  • Какие общепринятые принципы формирования электронных документов вам известны?

    eduardtibet
    Эдуард Тибет @eduardtibet
    Technical Writer / Documentation Engineer
    довольно специфичное ПО, используемое в нескольких частных организациях


    Не указаны:
    1. Предназначение ПО.
    2. Тип ПО.
    3. Требования по документации к ПО со стороны организации-клиента.

    Начините с ответов на эти вопросы. Потом будет ясно, какие советы давать.
    Ответ написан более трёх лет назад
    4 комментария
    Нравится 1 4 комментария
  • Как выглядит документ о составе предприятия?

    eduardtibet
    Эдуард Тибет @eduardtibet
    Technical Writer / Documentation Engineer
    Этот вопрос лучше адресовать к юристам предприятия. Т.к. холдинг, то юристы там должны быть.
    Ответ написан более трёх лет назад
    Комментировать
    Нравится 1 Комментировать
  • Как документировать поля форм (в т.ч. валидацию, логику), api, БД?

    eduardtibet
    Эдуард Тибет @eduardtibet
    Technical Writer / Documentation Engineer
    Вам надо:
    1. Посмотреть здесь: schemaspy.sourceforge.net
    2. Потом посмотреть здесь: dba.stackexchange.com/questions/515/how-do-you-doc...
    Ответ написан более трёх лет назад
    Комментировать
    Нравится Комментировать
  • Как создать корпоративный документ в Word?

    eduardtibet
    Эдуард Тибет @eduardtibet
    Technical Writer / Documentation Engineer
    Если целевой документ не будет требовать редактирования ПОСЛЕ внесения информации о контрагенте, то оптимальной в вашем случае представляется схема:
    xml (c variable-данными) + xsl:fo (шаблон) > pdf (результирующий документ). В этом случае вы гарантированно получите результат, при котором документы будут отличаться только на величину содержимого xml-файла с данными.
    Ответ написан более трёх лет назад
    Комментировать
    Нравится 1 Комментировать
  • Кто каким образом документирует локальную сеть?

    eduardtibet
    Эдуард Тибет @eduardtibet
    Technical Writer / Documentation Engineer
    Посмотрите вот здесь: Где сисадмину хранить документацию и конфиги серверов, а также собственные наблюдения и размышления?

    Там приведены аргументы ПРОТИВ использования любых вики-систем для документирования сетевых ресурсов.
    Ответ написан более трёх лет назад
    Комментировать
    Нравится Комментировать
  • Какой движок использовать для ведения документации по программе?

    eduardtibet
    Эдуард Тибет @eduardtibet
    Technical Writer / Documentation Engineer
    Сначала определитесь, какой формат вам необходим. Это можно сделать по _полным_ требованиям к документации и сравнением "требования <> возможности формата".

    В общем случае под ваши требования:
    Т.е. должна быть функция фильтрации описания, в зависимости от версии и релиза, или возможность раздельной публикации.

    подпадает любой src-based формат (неважно, plain text или xml-based), который можно хранить в ветках в дереве SCM.
    Ответ написан более трёх лет назад
    Комментировать
    Нравится 1 Комментировать
  • Где добыть правильные шаблоны/образцы для документации процессов?

    eduardtibet
    Эдуард Тибет @eduardtibet
    Technical Writer / Documentation Engineer
    Вы поясните - каких процессов? Процессов разработки софта или процессов приема/увольнения работников?

    Далее... Непонятно с чего вдруг "Теперь все дружно решили попробовать "как надо"."
    Есть какие-либо проблемы при существующих подходах? Если да, то какие.

    Вопросы подобного плана обычно задают по схема: "Есть условие А, есть проблема Б, как ее решить при ограничениях В?".
    Ответ написан более трёх лет назад
    Комментировать
    Нравится Комментировать
  • Как скачать содержимое директории со своего VPS?

    eduardtibet
    Эдуард Тибет @eduardtibet
    Technical Writer / Documentation Engineer
    Для таких вещей существует rsync
    Ответ написан более трёх лет назад
    Комментировать
    Нравится Комментировать
  • Кто использует Google Docs для написания корпоративных инструкций?

    eduardtibet
    Эдуард Тибет @eduardtibet
    Technical Writer / Documentation Engineer
    Странно, вы говорите про "не хочется проблем из-за миграции", но забываете, что Google Docs может ввести плату на раз. Например, при превышении определенного количества документов и т.п.

    Раз уж вы настолько думаете о проблемах миграции, то ваше дело - хранить в одном из ФОРМАТОВ (лучше стандартов) в SCM, а не размениваться на GD.

    UPDATE: Кстати, вот и подтверждение моих слов о гугле. Прямо в соседнем топике:
    "Все было хорошо, пока его не закрыли - начал искать у гугла альтернативу и зашел в тупик." Подробнее... Где именно граница в Google Custorm Search API между «Paid» и «Free», 2016?
    Ответ написан более трёх лет назад
    Комментировать
    Нравится Комментировать
  • Как автоматически создавать документацию к программному коду?

    eduardtibet
    Эдуард Тибет @eduardtibet
    Technical Writer / Documentation Engineer
    добавлю к предыдущему комментарию

    "... и никакого ворда" :)
    Ответ написан более трёх лет назад
    1 комментарий
    Нравится 2 1 комментарий
Оценили как «Нравится»
  • ← Предыдущие
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • Следующие →
Самые активные сегодня
  • sergey-gornostaev
    Сергей Горностаев
    • 8 ответов
    • 0 вопросов
  • tyllo
    tyllo
    • 7 ответов
    • 0 вопросов
  • neuotq
    Александр Талалаев
    • 7 ответов
    • 0 вопросов
  • wppanda5
    WP Panda
    • 6 ответов
    • 0 вопросов
  • ky0
    ky0
    • 6 ответов
    • 0 вопросов
  • MrDecoy
    Вадим
    • 6 ответов
    • 0 вопросов
  • © Habr
  • О сервисе
  • Обратная связь
  • Блог

Войдите на сайт

Чтобы задать вопрос и получить на него квалифицированный ответ.
Войти через центр авторизации