Como adiciono código formatado a um documento do Microsoft Word?

29

Preciso escrever um documento no MS-Word 2007 que contenha muitos exemplos de código VB.NET e C #.

Qual é a melhor maneira de fazer com que o código pareça razoável no documento?

Que estilos, etc, as pessoas usam?

(Não tenho tempo para editar / formatar manualmente o código e ficaria muito feliz se parecesse o mesmo que no estúdio de desenvolvedor)

Em outros trabalhos, o que as pessoas fazem escrevendo livros de programação, deve haver uma boa solução automatizada para isso ...

Eu gostaria de uma maneira de usar folhas de estilos de palavras para controlar a aparência do código, mas não desejo "selecionar" todas as palavras-chave etc. para definir seu estilo.

consulte também https://stackoverflow.com/questions/387453/how-do-you-display-code-snippets-in-ms-word-preserving-format-and-syntax-highlig/2653406#2653406

microsoft-word c# vb.net source-code Ian Ringrose
fonte
Você pode achar stackoverflow.com/questions/760121/… útil.
voyager
De @ user1068538: este link pode ser útil stackoverflow.com/a/2653406/1068538 . Acho que a resposta da @ gargamel (no link acima para SO) é a maneira mais fácil de usar código de programação em um documento do Word, especialmente se você estiver escrevendo um livro, pois ele não mostra erros de ortografia.
fixer1234

Respostas:

14

Você pode usar os serviços de destaque de origem e copiar / colar no documento do Word. Eu acho que será o caminho mais rápido ( atual. Copypaste simples do VS também funciona).

A segunda maneira é criar um estilo para o bloco de código, salvá-lo e aplicá-lo a todos os blocos de código.

sashaeve
fonte
1
como uso os "serviços de destaque de origem"?
Ian Ringrose
4
Por exemplo, vá para source.virtser.net , cole o código C #, destaque, copie a saída e cole no Word.
O link source.virtser.net fornece o erro "Página não encontrada", "A página que você tentou acessar não existe neste servidor ..."
JohnC:
11

O Word não suporta nativamente o realce de sintaxe ou outra formatação de código. Como tal, é melhor criar o destaque etc. em um programa diferente (visual studio, eclipse, bloco de notas ++ ou este site que pode conter 14 idiomas e não requer instalação).

No entanto, ao colar o texto, fazê-lo diretamente no próprio documento do word pode causar dores de cabeça, como sublinhados de ortografia e gramática.

Para corrigir isso, em vez de copiar e colar diretamente, use Inserir -> Objeto -> Texto OpenDocument . Isso abrirá um novo documento. Cole o texto aqui e feche a janela. Seu código agora será mostrado como um objeto, completo com toda a formatação mostrada na janela anterior, mas sem verificação ortográfica ou gramatical.

Embora seja possível formatar código com estilos, não há estilos internos para fazer isso, e não é exatamente o que os estilos devem fazer. Se você usar estilos para formatar seu código, use esse estilo em todos os objetos que você criar.

Atualização: se você quiser fazer isso com estilos de código, aqui estão algumas idéias.

  • Use um estilo de parágrafo com uma fonte monoespaçada
  • Luz de fundo (cinza funciona bem)
  • Ortografia desativada
  • Verifique se o espaçamento entre linhas está do jeito que você deseja

Se você deseja adicionar um pouco mais de complexidade, pode colocar camadas de estilos de caracteres sobre o estilo do parágrafo para criar algo semelhante à visualização do código no fluxo de pilha com formatação e / ou cor diferente para nomes de classes, nomes de instâncias etc.

Configurar um estilo como esse exige trabalho, mas você pode obter um resultado mais personalizável do que o obtido com o realce da sintaxe do bloco de notas ++ ou do Visual Studio.

Como uma aceleração ao formatar o código com um estilo, pode ajudar primeiro a realçar a sintaxe em um desses programas e, em seguida, usar o utilitário Localizar do Word para procurar texto que corresponda a uma cor ou outro estilo de fonte, para que você não precise identifique manualmente o que é um nome de classe, por exemplo, no código manualmente (ele está em mais-> formato no prompt de localização).

soandos
fonte
@ianRingrose: existe algum outro recurso que você está procurando?
soandos
Desejo que o hilighting da sintaxe seja feito com estilos de palavras para que eu possa alterar os tamanhos dos tipos, etc. com facilidade.
Ian Ringrose
@IanRingrose, atualizado. Deixe-me saber se há algo faltando.
soandos
Eu acho que essa é uma das melhores maneiras de formatar o código no word. Eu sempre tive problemas com a formatação e, como objeto, não tenho mais problemas. Muito obrigado ; )
xtarsy
No MS Word 2007 e versões posteriores, uma alternativa para "Inserir -> Objeto -> Texto em OpenDocument" é selecionar o código depois de colá-lo e usar Revisão | Prova | Defina o idioma e verifique se "Não verificar ortografia ou gramática" está selecionado. Pode ser necessário aplicar essa configuração mais de uma vez para que ela permaneça.
JohnC
4

Eu gosto de usar o Notepad ++. No NP ++, escolha a sintaxe correta, clique com o botão direito do mouse no código selecionado, escolha "comandos de plug-in", clique em "copiar texto com destaque de sintaxe". Cole-o no Word e você terá um código muito bonito.

Fonte: melhor maneira de mostrar trechos de código no word? [fechadas]

Robert
fonte
3

Se você configurar seu VS para ter a aparência que você deseja no documento, uma simples cópia e colagem do código funcionará. Ele preservará cores e outras formatações.

No entanto, se você quiser alterar o estilo no documento, isso será muito difícil de gerenciar. Nesse caso, a criação de um codeestilo no Word e a certeza de que todo o código colado está definido são assim (se você alterar o estilo, tudo marcado como esse estilo será alterado). Isso não permitirá que você tenha destaque de sintaxe como no VS.

Oded
fonte
Existem algumas preocupações, como a aparência de uma linha maior que a largura do documento?
voyager