Criando um help usando o yelp do ubuntu

[chackal_sjc]

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

[Lamego]

man yelp

       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

[chackal_sjc]

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

[GDA]

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...

[Darcamo]

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.

[GDA]

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! 

[ ]s

[chackal_sjc]

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?