2

Изменить: некоторые уточнения:

  • Мы уже используем справку и руководство для наших файлов справки
  • Вопрос действительно в том, что использовать, что позволяет нам делать гиперссылки из файла справки на презентацию и обратно, и при этом презентация должна быть "легко представимой".

Сначала я рассмотрю вопрос о преобразовании файлов PowerPoint в HTML, чтобы понять, подходит ли это нам. Это очень хорошо, может.


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


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

Вот что мы должны на сегодняшний день:

  • Файлы CHM с помощью нашего продукта (или несколько файлов .html для общих сетевых ресурсов).
  • Файлы PowerPoint с презентациями, используемые на семинарах и занятиях по использованию нашего продукта
  • HTML-файлы и аналогичные с инструментами электронного обучения
  • Файл слов со всеми техническими изменениями и изменениями продукта, исправлениями и т.д., Которые мы делаем от одного основного выпуска к следующему

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

У меня такой вопрос: кто-нибудь был в такой ситуации, и что вы делали? На какие инструменты ты смотрел, нашел ли ты какие-нибудь хорошие, чем ты сейчас занимаешься? Наша основная проблема с интеграцией всего в одну систему состоит в том, что часть PowerPoint, в которой вы помещаете слайд с ключевыми словами на проектор, а затем переходите от слайда к слайду, становится проблематичной, если в интегрированной системе не установлен своего рода "режим проектора" с легкая навигация, то, чего не делают чистые html-страницы, если они не запрограммированы на это.

Во всяком случае, преимущества ...

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

С нашей текущей настройкой гиперссылка из файла PowerPoint имеет относительный адрес к соответствующей части файла справки, и если пользователь не организует PowerPoint и.HTML-файлы аналогичным образом локально (например, каталог переименовывается, все находится в одной папке и т.д.), Тогда ссылки не работают, даже если файлы там есть.

Для файлов справки мы используем Help и Manual, и мы думаем о стандартизации этого продукта для большинства вещей. Часть электронного обучения поддерживается отдельной компанией, поэтому мы не уверены, хотим ли мы внести это в миксы сейчас.

Вот что, по нашему мнению, мы можем получить, объединив changelog+ техническую информацию, файл справки и документацию класса в одну систему:

  • Стабильные гиперссылки, это работает. Больше не нужно «убедиться, что файлы PowerPoint и файлы html-справки точно расположены на вашем локальном диске», между всеми системами.
  • Одна таблица содержания и один индекс, объединяющие все системы в одну (для пользователя это будет файл справки, который получил гораздо больше информации)
  • Различные выходы: мы можем произвести один.CHM-файл, набор html-файлов, файл word, pdf-файл, все с кликабельными, рабочими, гиперссылками и различными другими бонусами для поиска связанных материалов из одного исходного проекта. Нет вырезать и вставить из одной системы в другую.
  • Мы можем интегрировать все в справочную систему в нашем продукте. Когда пользователь нажимает кнопку справки на форме в нашем продукте, он не только может увидеть файл прямой справки, но и сможет найти презентации класса, которые использовались для обучения этим вещам, а также ссылки на техническую информацию. ИТ-персонал может использовать для устранения неполадок или настройки вещей.
  • Несколько человек могут работать над одним и тем же материалом здесь, у нас, в одно и то же время. С объединением файлов PowerPoint и Word они быстро становятся узкими местами в беспокойные периоды, а справка и руководство позволяют нескольким людям одновременно работать над одними и теми же проектами.
  • Повторное использование ресурсов, изображений и снимков экрана, созданных для одной "системы", можно повторно использовать в другой, не создавая дубликатов, обновите один (когда новый основной выпуск изменит макет, цвета и т.д.), И мы обновим их все

Что мы теряем:

  • Режим презентации PowerPoint. Одна вещь, которая нас интересует, - это удержание реальных классов, поскольку у докладчика теперь есть html-файл, и он должен обязательно указывать мышью на кнопку "следующая страница" (которую добавляют Справка и Руководство), вместо того, чтобы иметь возможность используйте одно из этих устройств-кликеров, чтобы быстро перейти к следующему и предыдущему слайду. Кроме того, на слайды не влияет "одно ключевое слово за раз".

Итак, есть мысли?

6 ответов6

2

Рассматривали ли вы преобразование презентаций Powerpoint в HTML и связывание его со справкой HTML в своем собственном разделе? ("Презентация", например). Существуют различные инструменты, которые могут сделать это в пакетном режиме, даже бесплатно.

Наша основная проблема с интеграцией всего в одну систему состоит в том, что часть PowerPoint, в которой вы помещаете слайд с ключевыми словами на проектор, а затем переходите от слайда к слайду, становится проблематичной, если в интегрированной системе не установлен своего рода «режим проектора» с легкая навигация, то, чего не делают чистые html-страницы, если они не запрограммированы на это.

С CHM вы можете безболезненно размещать на каждой странице одну и ту же навигацию, как показано здесь на кнопках навигации:

альтернативный текст

При проведении презентаций в классе используйте файлы PPT для полноэкранного режима. Когда студентам нужно сослаться на них, для них все в одном простом файле CHM. Никаких дополнительных загрузок или установок, программа просмотра CHM не должна быть доступна для них в среде Windows. Если вы хотите сослаться на часть в презентации, можно легко гиперссылку на другие страницы в CHM. Студенты могут использовать кнопку «Назад» в средстве просмотра CHM, чтобы вернуться туда, где они были до нажатия гиперссылки.

1

Похоже, работа для чего-то вроде SharePoint. У меня есть только ограниченный опыт в этом, но он, кажется, делает все, что вам нужно для этого.

Имейте в виду, что полная функциональность предоставляется только с Microsoft Office SharePoint Server (MOSS), а базовая установка Windows SharePoint Services (WSS), скорее всего, оставит вас в ожидании большего. Кикер? WSS бесплатно, MOSS не так бесплатно!

Существуют альтернативы с открытым исходным кодом, но я оставлю других предлагать конкретные пакеты, так как я еще менее знаком с ними.

1

Извините, если я не понял суть именно то, что вы хотите, но я думаю, что я мог бы-

Лично у меня есть два продукта, которые я продаю, которые требуют огромной документации. Я делаю то, что Microsoft делает с распространением файлов справки.

Один компакт-диск, который содержит все это -

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

Вы можете иметь / лекции, / документы, / помощь и т.д. Или / topic1 / лекции / и т.д.

вы можете иметь общие ресурсы (например, изображения) в /resources /pictures

... Затем вы можете легко раздать диск всем в конце обучения и включить его в свой продукт. Давать новые версии очень просто ... и в любой момент вы можете просто скопировать корень диска на веб-сайт, и тогда весь диск будет доступен онлайн! (просто используйте относительные пути вместо прямых).

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

Я немного усовершенствовал его, используя такие вещи, как FlashPaper, а также предоставив ссылку на документ.

В любом случае, надеюсь, вам понравится и не стесняйтесь задавать вопросы.

1

Моя компания также использует Help & Manual, и я считаю, что, вероятно, вы должны идти по этому пути. Пользовательский интерфейс не так сложен в освоении, и это единственный известный мне авторский продукт, который поддерживает все перечисленные форматы.

1

Я верю, что Zimbra может помочь вам :)

1

Я использую doxygen для всего, что вы описываете, кроме презентации в Powerpoint. Звуки Doxygen, на высоком уровне, похожем на «Справку и руководство», являются кроссплатформенными и очень легко настраиваемыми. Если вы знакомы с javadoc или подобными системами документации на основе тегов, вы уже на полпути. Он создает графические документы с высокой степенью гиперссылки. Он разработан для справочных руководств по API, но я «злоупотребил» им для создания практически всех типов документов, которые вы можете себе представить.

Не уверен, на каком языке вы документируете, но doxygen поддерживает многие, и вы можете отфильтровать неподдерживаемые языки, чтобы получить нужный вам результат. Например, хотя это официально не поддерживается, я обычно использую doxygen для документирования своего VB-кода. Я часто генерировал файлы chm, содержащие классы кода и диаграммы сотрудничества, а также определяемые пользователем диаграммы непосредственно из моего исходного кода. Я обычно делаю HTML, но также создаю PDF и RTF. У них есть все гиперссылки, которые вы найдете в документе HTML.

Doxygen автоматически выбирает множество ссылок из структуры вашего программного обеспечения. Основным недостатком, который я обнаружил, является то, что если вам не нравится внешний вид, который doxygen предоставляет по умолчанию, вы должны написать свою собственную каскадную таблицу стилей. Честно говоря, я никогда не знал, какой стиль может быть жестко закодирован в HTML, создаваемом doxygen.

Похоже, что Help & manual использует XML в качестве формата файла. Doxygen может производить XML. Таблица стилей xml позволит вам переводить один формат в другой. Вы должны написать это сами, но у вас будут все ссылки между всеми вашими документами.

Для меня одно из главных преимуществ использования doxygen не имеет ничего общего с его способностью генерировать документы. Это то, что он позволяет мне обрабатывать всю мою документацию точно так же, как и мой исходный код. Он находится в том же хранилище, я могу просматривать и управлять diff-файлами, а также отмечать / размечать документы вместе с кодом. Для меня это огромно.

Всё ещё ищете ответ? Посмотрите другие вопросы с метками .