Software para formatação / publicação na web do tipo tutorial, artigos técnicos

0

Eu quero colocar alguns dos meus próprios textos técnicos na web: tutoriais, como fazer, artigos conceituais sobre programação, etc. Eu escrevo principalmente para mim ainda, mas acho que outros podem se beneficiar disso, então eu quero colocá-lo on-line e também tenho planos de tornar tudo mais coerente e transformá-lo em um livro.

Meus artigos não são como um blog, eles são apenas uma coleção de tutoriais e procedimentos, mas eu acho que um software do tipo blog provavelmente seria o modo mais apropriado de formatação desse tipo de coisa. / p>

Agora eu estou usando o recurso de blog de cite u like, que é muito baixa tecnologia e eu realmente preciso de algo melhor. Na minha lista de desejos é, entre outras coisas:

  • snippets de código em caixas roláveis
  • realce de sintaxe para fragmentos de código-fonte
  • marcando artigos com ícones gráficos de acordo com o tópico, como em slashdot
  • é claro que os usuários (ou seja, leitores) devem poder comentar sobre artigos
  • Além disso, apenas mais opções do que um blog super simples
  • deve parecer liso! deve não parecer com o estilo wikipedia

Existe algum software que você possa recomendar para essa finalidade?

    
por gojira 04.04.2012 / 12:26

3 respostas

1

Não é a escolha mais mainstream, mas eu gosto muito de ikiwiki (por Joey Hess da fama do Debian). É um sistema escrito em Perl que compila por padrão as páginas Markdown para arquivos HTML estáticos. Seus modelos de "blog" funcionam para o que você deseja fazer.

Em primeiro lugar, este sistema é muito flexível e capaz de fazer o que quiser pelo seu próprio design. Com o Perl básico, também é possível criar plugins personalizados com facilidade e tempo.

Todo o sistema é construído em sistemas de controle de versão, por exemplo Git. O site é reconstruído (bem, partes relevantes de qualquer maneira) quando o conteúdo é confirmado , o que dá controle de versão como um recurso interno.

Ele fornece um sistema de comentários usando o OpenID para identificação. Você pode codificar facilmente o código-fonte com destaque (preferencialmente) na biblioteca Perl para realçar . O código é colocado em caixas roláveis e também pode ser dobrado (eu uso essa função).

Em sua configuração padrão, parece bastante agradável na minha opinião, mas cada aspecto é estilizado com um arquivo CSS local.

Estou muito feliz com isso, pelo menos. Isso está intimamente ligado ao Git / Mercurial / qualquer que seja um recurso matador para mim, e como todos os aspectos do site em si podem ser alterados por modelos, ele é mais ou menos infinitamente flexível.

    
por 04.04.2012 / 19:13
1

Você pode considerar o Octopress , que tem realce de sintaxe e blocos de código fora da caixa com o Markdown. Ele tem marcação e comentários via Disqus com um pouco de configuração.

Isso se encaixaria em um blog super simples - se você quiser mais recursos, o wordpress é uma opção.

    
por 05.04.2012 / 00:02
-1

Para documentação técnica on-line, que tal algo como link , por exemplo?

    
por 04.04.2012 / 12:35