Questão Arquivos de ajuda e apresentações em power point


Editar: alguns esclarecimentos:

  • Nós já usamos a Ajuda e o Manual para nossos arquivos de ajuda
  • A questão é realmente o que usar que nos permite fazer hiperlinks de arquivo de ajuda para apresentação, e de volta, e ainda ter apresentação ser "facilmente apresentável".

Eu vou olhar para a resposta sobre a conversão de arquivos do PowerPoint para HTML primeiro, para ver se isso funciona para nós. Muito bem poderia.


Peço desculpas pela longa pergunta, e a identifiquei como subjetiva, porque provavelmente não há uma resposta única.


Estamos em uma posição em que estamos reavaliando as ferramentas que usamos para fornecer várias fontes de informações para nossos usuários finais.

Aqui está o que temos até hoje:

  • Arquivos CHM com ajuda para nosso produto (ou um monte de arquivos .html para compartilhamentos de rede)
  • Arquivos do PowerPoint com apresentações, usados ​​durante workshops e aulas sobre como usar nosso produto
  • Arquivos HTML e similares com ferramentas eLearning
  • Um arquivo de palavras com todas as alterações técnicas e alterações de produtos, correções de bugs, etc. que fazemos de um grande lançamento para o próximo

O que estamos descobrindo é que seria extremamente benéfico tentar integrar tudo em um único produto.

Minha pergunta é a seguinte: alguém já esteve nessa situação e o que você fez? Para quais ferramentas você olhou, encontrou alguma coisa boa, o que está fazendo agora? Nosso principal problema em integrar tudo em um único sistema é que a parte do PowerPoint, onde você coloca um slide de palavras-chave em um projetor e passa de um slide para outro, torna-se problemática a menos que o sistema integrado tenha algum tipo de "modo de projetor". navegação fácil, algo que páginas html puras não fazem, a menos que sejam codificadas com isso em mente.

De qualquer forma, os benefícios ...

Por exemplo, podemos fornecer hiperlinks estáveis ​​de um "sistema" para outro, de modo que, por exemplo, as apresentações possam conter links para as partes relevantes do arquivo de ajuda. Os usuários obtêm sua própria cópia dos arquivos de apresentação quando saem de nossa classe, para que possam abri-los e usá-los quando voltarem para seu próprio local de trabalho e, como tal, seria bom facilitar a localização de itens relacionados. material, sem depender deles, ou sua equipe de TI para fazer tudo 100% corretamente ao colocar os arquivos em suas máquinas.

Com a nossa configuração atual, um hiperlink do arquivo do PowerPoint tem um endereço relativo à parte correspondente do arquivo de ajuda, e se o usuário não organizar os arquivos PowerPoint e .HTML da mesma maneira localmente (por exemplo, o diretório é renomeado, tudo está em uma pasta, etc.), então os links não funcionam, mesmo que os arquivos estejam lá.

Para os arquivos de ajuda que estamos usando Ajuda e Manuale estamos pensando em padronizar esse produto para a maioria das coisas. A parte de eLearning é mantida por uma empresa separada, por isso não temos certeza se queremos trazer isso para o mix agora.

Aqui está o que achamos que podemos obter ao integrar o changelog + informações técnicas, o arquivo de ajuda e a documentação da classe em um sistema:

  • Hiperlinks estáveis, que funciona. Não mais "certifique-se de que os arquivos do PowerPoint e os arquivos de ajuda do html estão localizados exatamente no seu disco local", entre todos os sistemas.
  • Uma tabela de conteúdo e um índice, que reúne todos os sistemas em um (para o usuário, aparecerá o arquivo de ajuda que obteve muito mais informações)
  • Várias saídas: Podemos produzir um único arquivo .CHM, um conjunto de arquivos html, um arquivo de palavras, um arquivo pdf, todos com cliques, funcionamento, hiperlinks e vários outros bônus para encontrar material relacionado, a partir do mesmo projeto de origem. Não recortar e colar de um sistema para outro.
  • Podemos integrar tudo no sistema de ajuda do nosso produto. Quando o usuário clica no botão de ajuda em um formulário em nosso produto, ele não apenas pode ver o arquivo de ajuda direta, mas também pode encontrar as apresentações de classe que foram usadas para ensinar essas coisas, bem como links para informações técnicas. a equipe de TI pode usar para solucionar problemas ou configurar itens.
  • Várias pessoas podem trabalhar no mesmo material aqui em nosso lugar, ao mesmo tempo. Com arquivos do PowerPoint e do Word, eles rapidamente se tornam gargalos em períodos agitados, e a Ajuda e Manual permite que várias pessoas trabalhem nos mesmos projetos ao mesmo tempo.
  • Reutilizar ativos, imagens e screenshots produzidos para um "sistema" podem ser reutilizados em outro sem fazer duplicatas, atualizar um (quando uma nova versão principal altera o layout, cores, etc.) e atualizamos todos eles

O que nós perdemos:

  • Modo de apresentação do PowerPoint. Uma coisa sobre a qual nos perguntamos é manter as classes reais, já que o apresentador agora tem um arquivo html, e precisa apontar o mouse para o botão "next page" (que o Help e o Manual adicionam), em vez de poder use um desses dispositivos clicker para ir rapidamente para o slide seguinte e anterior. Além disso, nenhum efeito de "uma palavra-chave por vez" é exibido nos slides.

Então, algum pensamento?


2


origem




Respostas:


Você já pensou em converter as apresentações do Powerpoint em HTML e agrupá-las com a Ajuda em HTML em sua própria seção? ("Apresentação" por exemplo). Existem várias ferramentas que podem fazer isso em lote, mesmo livre.

Nosso principal problema com a integração   tudo em um sistema é que o   Parte do PowerPoint, onde você coloca um   deslize de palavras-chave em um projetor, e   em seguida, passar de slide para slide, torna-se   problemático a menos que o   sistema tem algum tipo de "projetor   modo" com navegação fácil, algo   que páginas html puras não, a menos   Eles são codificados com isso em mente.

Com CHMs você pode colocar a mesma navegação em cada página sem problemas, como mostrado aqui nos botões de navegação:

alt text

Ao fazer as apresentações em aula, use os arquivos PPT para tela cheia. Quando os alunos precisam fazer referência a isso, tudo está em um arquivo CHM simples para eles. Sem downloads ou instalações adicionais, o visualizador CHM deve estar disponível para eles em seu ambiente Windows. Se você quiser referenciar uma parte na apresentação, é fácil fazer o hiperlink para outras páginas no CHM. Os alunos podem usar o botão Voltar no visualizador CHM para voltar para onde estavam antes de clicar no hiperlink.


2



Isso parece muito promissor, o html como ferramentas de powerpoint. - Lasse Vågsæther Karlsen
A melhor parte é que eles não precisam abrir um segundo programa quando você quiser referenciar uma página no slide do powerpoint. Arquivos CHM podem facilmente referenciar outras páginas dentro do documento. - John T
Um fato chato com o CHM, por outro lado, é que tentar abri-lo a partir de um compartilhamento de rede é meio problemático. o ie (usado para renderizar o html) reclama de coisas de segurança ... - akira


Soa como um trabalho para algo como SharePoint. Eu tenho apenas uma experiência limitada em mim, mas parece fazer todas as coisas que você precisa fazer.

Esteja ciente de que a funcionalidade completa vem apenas com o Microsoft Office SharePoint Server (MOSS), uma configuração básica do Windows SharePoint Services (WSS) provavelmente deixará você querendo mais. O kicker? O WSS é gratuito, MOSS não é tão grátis!

Existem alternativas de código aberto, mas vou deixar que outras pessoas proponham pacotes específicos, já que estou menos familiarizado com eles.


1



Embora o SharePoint provavelmente funcione, precisamos de algo que possamos trazer aos nossos usuários e que eles possam fazer o download e obter uma cópia de suas próprias máquinas no local de trabalho. Como fornecemos software para hospitais e indústrias similares, na maioria das vezes eles não têm nenhuma conexão de internet no local de trabalho, o que significa que qualquer solução hospedada por nós não é realmente uma opção. - Lasse Vågsæther Karlsen
E por "download", quero dizer que eles podem fazer o pessoal de TI fazer o download e instalá-lo para eles. - Lasse Vågsæther Karlsen


Desculpe se eu não entendi exatamente o que você quer, mas acho que posso ter-

Pessoalmente, tenho dois produtos que eu vendo que exigem enorme documentação. Eu faço o que a Microsoft faz com a distribuição de arquivos de ajuda.

Um CD que contém tudo -

um arquivo de execução automática que lança uma página da web no cd, tem um layout agradável e uma boa estrutura de diretórios.

Você poderia ter / palestras / documentos / help e.t.c. ou / topic1 / lectures / e.t.c.

você pode ter recursos compartilhados (por exemplo, imagens) em / resources / pictures

... Você pode distribuir um disco facilmente para todos no final do treinamento e incluí-lo em seu produto. Dar novas versões é fácil ... e a qualquer momento, você pode simplesmente copiar a raiz do disco para um site e depois todo o disco estará disponível online! (apenas use caminhos relativos em vez de diretos).

Eu tenho usado muitos sistemas de gerenciamento de conteúdo ao longo dos anos, mas eu sinceramente acho que apenas fazer isso sozinho, e usar o método acima, é melhor.

Eu o refinei ligeiramente usando coisas como FlashPaper bem como fornecer um link para o documento.

De qualquer forma, espero que gostem e sintam-se à vontade para fazer perguntas.


1





Minha empresa também usa o Help & Manual, e acredito que é provavelmente o caminho que você deve seguir. A interface do usuário não é tão difícil de dominar, e é o único produto de autoria que eu conheço que suporta todos os formatos listados.


1





eu uso doxygen para fazer tudo o que você está descrevendo, exceto a apresentação em Powerpoint. Doxygen sons, em alto nível, semelhante ao 'Ajuda e manual', é multi-plataforma e altamente configurável. Se você é familiar com javadoc ou sistemas de documentação baseados em tags, você já está no meio do caminho. Ele cria documentos gráficos altamente vinculados a hiperlinks. Ele é projetado para manuais de referência de APIs, mas eu abusei dele para gerar praticamente todos os tipos de documentos que você possa imaginar.

Não tenho certeza de qual idioma está documentando, mas o doxygen suporta muitos e você pode filtrar idiomas não-exportados para gerar a saída de que você precisa. Por exemplo, embora não seja oficialmente suportado, eu uso rotineiramente o doxygen para documentar meu código VB. Eu tenho frequentemente gerado arquivos chm contendo diagramas de classe de código e colaboração, bem como diagramas definidos pelo usuário diretamente do meu código-fonte. Eu normalmente faço HTML, mas também produzi PDF e RTF. Eles têm todos os hiperlinks que você encontraria no documento HTML.

O Doxygen capta automaticamente muitos links da estrutura do seu software. A principal desvantagem que eu encontrei é que, se você não gosta da aparência que o doxygen fornece por padrão, você tem que escrever sua própria folha de estilo em cascata. Eu nunca, francamente, não sei quanto estilo pode ser codificado no HTML produzido pelo doxygen.

Parece que a Ajuda e o manual usam XML como formato de arquivo. doxygen pode produzir XML. Uma folha de estilo xml permitiria que você traduzisse um formato para o outro. Você teria que escrever isso sozinho, mas você teria todos os links entre todos os seus documentos no lugar.

Para mim, uma das principais vantagens do uso do doxygen não tem nada a ver com a capacidade de gerar documentos. É que me permite tratar todos minha documentação exatamente o mesmo como meu código fonte. Está no mesmo repositório, posso ver e gerenciar diffs e marcar / ramificar os documentos junto com o código. Para mim isso é enorme.


1





Acredito Zimbra pode ajudar você :)


1