Pergunta

Estou executando alguns aplicativos Rails/Rake em Apache/Passageiro e quero adicionar o aplicativo de documentação servido por gem server Para esses aplicativos, para que eu possa facilmente fornecer um domínio (sub) especial, como docs.example.org, por isso está facilmente disponível para todos os membros de nossa equipe e ninguém precisa iniciar o próprio servidor ou lembrar números de porta (como 8808, o padrão gem server porta).

Foi útil?

Solução

Eu recomendaria olhar para o BDOC em vez de gem server, permite ao usuário acessar todos os seus documentos da GEM sem um servidor em execução. Também seria trivial modificar o BDOC para produzir para um diretório específico, então você poderia facilmente adicionar uma etapa para regenerar os documentos.

O bom de tê -los em arquivos estáticos seria que a configuração do Apache é simples.

Se você deseja fazer uma saída BDOC para uma olhada específica está linha.

Editar:

Na verdade, fui em frente e ramificou isso no github e fez a mudança. Agora você pode fornecer o diretório de saída na linha de comando e ele gerará as páginas RDOC estáticas para você.

Outras dicas

Estou correndo http: //gems.local Na minha máquina, caso eu queira fazer algumas rachaduras offline. (Jornada simples, trens, etc).

Isso é realmente fácil, você pode realmente executar o passageiro com toda a documentação do Ruby Gems localmente sem precisar acessar a rede.

Eu estava seguindo as dicas de Jason e consegui tudo funcionando. Veja o artigo a seguir e você deve estar pronto para ir:

http://jasonseifer.com/2009/02/22/offline-gem-sherver-rdocs

Attila

Eu escrevi um post sobre como tenho minhas jóias, rubi, trilhos e documentos jQuery, usando o servidor de jardas e o nginx para proxing no Mac OS X. As etapas para o Linux são quase as mesmas, a única coisa que muda é a maneira de configurar os daemons.

https://makarius.posterous.com/offline-rails-ruby-jquery-and-gems-docs-with

Licenciado em: CC-BY-SA com atribuição
Não afiliado a StackOverflow
scroll top