Autor Tópico: Criando um help usando o yelp do ubuntu  (Lida 5543 vezes)

Offline chackal_sjc

  • Usuário Ubuntu
  • *
  • Mensagens: 75
    • Ver perfil
    • Felipe Tonello . com - Code is poetry.
Criando um help usando o yelp do ubuntu
« Online: 05 de Outubro de 2006, 21:03 »
Todos nós sabemos que o ubuntu usa o yelp para fazer arquivos de help do programa..

gostaria de saber como posso criar o meu? se tem algum tutorial que faça isso ou um editor mesmo..
e depois como faço para chamar a janela o yelp por uma apliação grafica em java?
preciso disso urgente..

Obrigado

Offline Lamego

  • Usuário Ubuntu
  • *
  • Mensagens: 1.943
    • Ver perfil
Re: Criando um help usando o yelp do ubuntu
« Resposta #1 Online: 06 de Outubro de 2006, 16:23 »
man yelp
Citar
       Yelp  can  display  some HTML and XML files when passed on the command-
       line, but it’s primarily called from applications.
Por isso se bem percebi tem que desenvolver os arquivos em html/xml :)
João Luís Marques Pinto
Mais programs e jogos para o Ubuntu

Offline chackal_sjc

  • Usuário Ubuntu
  • *
  • Mensagens: 75
    • Ver perfil
    • Felipe Tonello . com - Code is poetry.
Re: Criando um help usando o yelp do ubuntu
« Resposta #2 Online: 06 de Outubro de 2006, 21:22 »
ahh thanks..

mas como que posso criar ele? lógico que tem certos padrões e tudo mais..

alguem sabe mais a respeito disso??

se tem um comando do genero
Código: [Selecionar]
$ yelp arquivo.html
Obrigado

Offline GDA

  • Usuário Ubuntu
  • *
  • Mensagens: 92
    • Ver perfil
Re: Criando um help usando o yelp do ubuntu
« Resposta #3 Online: 06 de Outubro de 2006, 21:56 »
Oi,

É simples como vc deduziu, mesmo. O Yelp é capaz de abrir qualquer arquivo html apenas com o comando:

Código: [Selecionar]
$ yelp [arquivo]

Se vc quiser, também pode abrir páginas de manual nele:

Código: [Selecionar]
$ yelp man:pagina_manual

O que torna a leitura desses manuais bem mais agradável...
jabber: droopalong@jabber.org - Ubuntu'ser:
Interessado em aprender mais sobre o Ubuntu em português? Comece aqui

Darcamo

  • Visitante
Re: Criando um help usando o yelp do ubuntu
« Resposta #4 Online: 06 de Outubro de 2006, 22:47 »
Boa dica essa de abrir manuais com o yelp. Realmente fica mais agradável de ler.
Posta um tópico com essa dica na sessão dicas e truques.

Offline GDA

  • Usuário Ubuntu
  • *
  • Mensagens: 92
    • Ver perfil
Re: Criando um help usando o yelp do ubuntu
« Resposta #5 Online: 07 de Outubro de 2006, 00:48 »
Boa dica essa de abrir manuais com o yelp. Realmente fica mais agradável de ler.
Posta um tópico com essa dica na sessão dicas e truques.

Bom, já que vc gostou aí vai um complemento que também pode ser útil: vc sabia que nem precisa chamar páginas de manual pela linha de comando?

É que esse procedimento (na outra resposta) só é útil para abrir documentos específicos (em html, por exemplo) que não estão na árvore original. Ah! E por falar nisso, digamos que vc queira ver o livro do "Linux from Scratch" qie vc baixou da web em html e descomapctou numa pasta qualquer... Eu, por exemplo, coloquei o meu em:

~/www/lfs/LFS-BOOK-6.2-HTML/index.html

Caminho longo, nome complicado... pela linha de comando (ou pelo ALT+F2) ficaria assim:

Código: [Selecionar]
yelp ~/www/lfs/LFS-BOOK-6.2-HTML/index.html

Então, para não ter de digitar tudo isso de novo, é só fazer como em qualquer navegador: adiciona ao bookmark (CTRL+D). Deste modo, você pode personalizar a sua biblioteca de ajuda.

Bem... mas voltando aos manuais... Vc chamou o Yelp pelo atalho de teclado (no Ubuntu é F1, eu acho), ou pelo lançador no painel do Gnome, e isso não te dá opção de escolher diretamente uma página de manual, certo?

Errado!

Vc pode chamar o manual do seu interesse digitando na barra Localizar (Search) do próprio Yelp:

Código: [Selecionar]
man [pagina_manual]

E lá vem o manual do mesmo jeito!

Agora, o que mais me deixou pirado, foi a vez que, só de nerdice, eu digitei "man:gcc" na barra de endereços do Firefox... O que aconteceu?

Lá veio o Yelp com a página de manual do bendito gcc!

Santa integração!  :o

[ ]s
jabber: droopalong@jabber.org - Ubuntu'ser:
Interessado em aprender mais sobre o Ubuntu em português? Comece aqui

Offline chackal_sjc

  • Usuário Ubuntu
  • *
  • Mensagens: 75
    • Ver perfil
    • Felipe Tonello . com - Code is poetry.
Re: Criando um help usando o yelp do ubuntu
« Resposta #6 Online: 07 de Outubro de 2006, 15:34 »
Muito boa dica mesmo!

mas alguem tem um exemplo dos padrões de codificações xml/html que o Yelp usa?
eu preciso muito fazer isso para agora.

E como eu posso chamar o yelp pelo java? eu tenho um programa em java que caso o usuário queira ver o help ele abre o yelp. Os programas normais usando gtk usam sempre isso, mas por java eu nunca vi. Alguem sabe também como fazer?