Capítulo 8. Ajuda e Documentação¶
Sumário
Resumo
O openSUSE® vem com várias fontes de informação e documentação, muitas das quais já estão integradas em seu sistema instalado:
- Centros de ajuda das áreas de trabalho
Os centros de ajuda de ambas as áreas de trabalho, KDE (Centro de ajuda do KDE) e GNOME (Help), fornecem um acesso central para os recursos de documentação mais importantes em seu sistema, de forma pesquisável. Estes recursos incluem ajuda online para aplicações instaladas, páginas man, páginas info e os manuais Novell/SUSE entregues com seu produto. Aprenda mais sobre o centro de ajuda da sua área de trabalho em Seção 8.1, “Usando o Centro de Ajuda do KDE” e Seção 8.2, “Usando o GNOME Help”.
- Pacotes de ajuda separados para alguns aplicativos
Ao instalar novos softwares com o YaST, a documentação do software é instalada automaticamente na maioria dos casos e normalmente aparece no centro de ajuda da sua área de trabalho. No entanto, algumas aplicações, como o GIMP, possuem pacotes de ajuda online diferentes que podem ser instalados com YaST e não se integram aos centros de ajuda.
- Documentação em
/usr/share/doc Este diretório tradicional de ajuda contém vários arquivos de documentação e as notas de lançamento para seu sistema. Encontre informações mais detalhadas em Seção “Documentation Directory” (Capítulo 35, Help and Documentation, ↑Guia de Referência).
- Páginas de manual ou páginas info para comandos do shell
Ao trabalhar com o shell, você não precisa saber de cabeça as opções dos comandos. Tradicionalmente, o shell fornece ajuda integrada através de páginas man e páginas info. Leia mais em Seção “Man Pages” (Capítulo 35, Help and Documentation, ↑Guia de Referência) e Seção “Info Pages” (Capítulo 35, Help and Documentation, ↑Guia de Referência).
8.1. Usando o Centro de Ajuda do KDE¶
A partir da área de trabalho KDE você pode acessar o Centro de ajuda do KDE de várias maneiras: se você precisa de informações a partir de uma aplicação, simplesmente clique no botão da aplicação ou pressione F1 para abrir a documentação da aplicação no centro de ajuda. Se você iniciar o centro de ajuda a partir do menu principal, ou a partir da linha de comando com khelpcenter, você será levado à janela principal do centro de controle, de onde pode navegar pelos tópicos de ajuda.
O menu e a barra de ferramentas fornecem opções para imprimir o conteúdo do centro de ajuda, pesquisar na página exibida e navegar e personalizar o centro de ajuda. O campo de exibição à direita da janela sempre exibe o conteúdo atualmente selecionado, tal como manuais online, resultados de pesquisa ou páginas web.
A área de navegação à esquerda da janela contém várias abas:
Apresenta uma visão em árvore de todas as fontes de informação disponíveis. O centro de ajuda referencia vários grupos alvo, tais como usuários, administradores e desenvolvedores. Clique em uma entrada para abrir e navegar nas categorias individuais. O centro de ajuda também fornece acesso a algumas bases de dados online que cobrem problemas em hardwares especiais e softwares para seu produto. Todas essas fontes podem ser pesquisadas de modo conveniente uma vez que o índice de pesquisa tenha sido gerado.
O conteúdo de seu centro de ajuda depende dos pacotes de softwares atualmente instalados e dos idiomas selecionados como idiomas do sistema.
Fornece uma referência rápida onde você pode procurar as definições de palavras que não lhe são familiares.
Possui opções para pesquisa do texto completo no centro de controle. Você pode combinar vários critérios de busca.
Procedimento 8.1. Pesquisando no Centro de Ajuda
Para usar a busca por texto completo fornecida pelo Centro de ajuda do KDE, gere um índice de busca e defina os parâmetros da busca. Se o índice de busca ainda não foi gerado, o sistema automaticamente o avisa para fazer isso quando você clica na aba .
Para pesquisar por um termo, clique no campo de texto e digite o termo de pesquisa.
Para combinar seus termos de pesquisa com operandos, clique em e selecione o operando para usar.
Escolha uma opção de para limitar o número de resultados a serem exibidos.
Para restringir sua busca a certos tipos de documentação, escolha uma opção de . Com , uma seleção pré-definida de documentos é pesquisada. inclui todos os tipos de documentos na pesquisa. permite que você defina quais documentos incluir em sua pesquisa. Apenas ative os documentos que você deseja na lista.
Depois que você tiver definido as opções, clique em . Os resultados de pesquisa serão exibidos como uma lista de links no campo de exibição e é possível navegar entre ele com cliques do mouse.
Procedimento 8.2. Gerando um Novo Índice de Pesquisa
Para criar um novo índice de pesquisa, selecione + a partir do menu. Uma janela se abrirá, exibindo uma lista da documentação atualmente disponível no centro de configuração. No caso em que não exista o índice de pesquisa, você será perguntado automaticamente para construir um, uma vez que você digite um termo de pesquisa no campo de pesquisa.
Selecione os documentos a integrar no índice de pesquisa e clique em . Depois que o índice for gerado, você pode utilizar a busca por texto completo.
8.2. Usando o GNOME Help¶
Na área de trabalho GNOME, para iniciar o Help diretamente a partir de uma aplicação, clique no botão ou pressione F1. Ambas as opções levam você diretamente à documentação da aplicação no centro de ajuda. No entanto, você também pode iniciar o Help a partir do menu principal ou da linha de comando com yelp e então navegar na janela principal do centro de ajuda.
O menu e a barra de ferramentas fornecem opções de navegação e personalização do centro de ajuda, para pesquisar e imprimir conteúdo do Help. Para visualizar a tabela de conteúdo, clique no ícone da casa ou pressione Alt+Home. Os tópicos da ajuda são agrupados em categorias apresentados em links. Clique em um dos links para abrir uma lista de tópicos para aquela categoria. Para procurar por um item, apenas digite o termo de busca no campo de pesquisa no topo da janela.
8.3. Navegando nas Páginas man e info a Partir de sua Área de Trabalho¶
Com a área de trabalho KDE ou GNOME, você também pode acessar (ou imprimir) páginas man e info:
- KDE
No Dolphin ou no Konqueror, para visualizar a página man para ls, digite man:/ls na barra de localização. Se existirem diferentes categorias para um comando, o Konqueror exibe-as como links. Para exibir a página info sobre o grep, por exemplo, digite info:/grep.
No Centro de ajuda do KDE, clique em ou na tabela de conteúdos para navegar nas páginas de manual ou páginas info. Você também pode usar a pesquisa e limitar o escopo para as .
- GNOME
Execute yelp man:ls ou yelp info:ls para exibir a página man ou página info. Alternativamente digite man:ls ou info:ls no campo de pesquisa do Yelp.
8.4. Recursos de Ajuda Adicionais¶
Além das versões online dos manuais openSUSE instalados em /usr/share/doc, você também pode acessar os manuais específicos de um produto e a documentação na Internet. Para uma visão geral de toda a documentação disponível para seu produto verifique a documentação específica do openSUSE em http://www.novell.com/documentation/.
Se você estiver procurando por informações adicionais relacionadas a um produto você pode visitar as seguintes páginas:
Você poder querer experimentar motores de buscas de propósito geral. Por exemplo, você pode experimentar os termos de busca Linux CD-RW ajuda ou OpenOffice problema conversão arquivo se você estiver tendo problemas com gravação de CD ou com a conversão de arquivos do OpenOffice. O Google™ também possui um mecanismo de busca específico para o Linux em http://www.google.com/linux que pode ser útil.
8.5. Para Mais Informações¶
Além dos recursos de ajuda específicos do produto, existe uma vasta gama de informação disponível para tópicos relativos ao Linux.
8.5.1. Recursos Online Para o openSUSE¶
A comunidade openSUSE é composta por pessoas dispostas a ajudar. Se você tem alguma questão específica você pode escrever para várias listas de e-mail, comunicar-se através do IRC ou navegar em fóruns web. Encontre mais informações em http://en.opensuse.org/Communicate.
8.5.2. Projeto de Documentação do Linux¶
O projeto de documentação do Linux (TLDP) é mantido por uma equipe de voluntários que escrevem documentação relacionada ao Linux (veja http://www.tldp.org). O conjunto de documentos possui tutoriais para iniciantes, mas é focado principalmente em usuários experientes e administradores de sistemas profissionais. O TLDP publica HOWTOs, FAQs (perguntas frequentes) e guias sob uma licença livre. Parte da documentação do TLDP também está disponível no openSUSE
8.5.2.1. HOWTOs¶
HOWTOs normalmente são guias passo-a-passo curtos e informais para realizar determinadas tarefas. Os HOWTOs também podem ser encontrados no pacote howto e são instalados em /usr/share/doc/howto.
8.5.2.2. Perguntas Mais Frequentes¶
FAQs (Perguntas frequentes) são uma série de perguntas e respostas. Elas se originam dos grupos de notícias da Usenet, onde o propósito era reduzir o repetido envio das mesmas perguntas básicas.
8.5.2.3. Guias¶
Manuais e guias para vários tópicos ou programas podem ser encontrados em http://www.tldp.org/guides.html. Eles variam de Guia Bash para Iniciantes a Hierarquia do Sistema de Arquivos do Linux e Guia de Segurança do Administrador Linux. Normalmente, guias são mais detalhados e exaustivos que HOWTOs ou FAQs. Eles são normalmente escritos por experts para experts.
8.5.3. Usenet¶
Criada em 1979, antes do nascimento da Internet, a Usenet é uma das redes de computadores mais antigas e ainda em uso. O formato e transmissão dos artigos Usenet é muito parecido com um e-mail, mas é desenvolvido para uma comunicação entre várias pessoas.
A Usenet é organizada em sete categorias de tópicos: comp.* para discussões relacionadas a computadores, misc.* para tópicos diversos, news.* para assuntos de grupos de notícias, rec.* para entretenimento, sci.* para discussões relacionadas à ciência, soc.* para discussões sociais e talk.* para vários tópicos controversos. Os níveis superiores são divididos em subgrupos. Por exemplo, comp.os.linux.hardware é um grupo de notícias para problemas de hardware específicos no Linux.
Antes de enviar um artigo, conecte seu cliente a um servidor de notícias e assine um grupo de notícias específico. Clientes de notícias incluem o Knode ou o Evolution. Cada servidor de notícia comunica-se com outros servidores e troca artigos com eles. Nem todos os grupos de notícias estão disponíveis em seu servidor de notícias.
Grupos de notícias interessantes para usuários Linux são comp.os.linux.apps, comp.os.linux.questions, e comp.os.linux.hardware. Siga as regras gerais da Usenet disponíveis em http://www.faqs.org/faqs/usenet/posting-rules/part1/.
8.5.4. Wikipedia: A Enciclopédia Online Gratuita¶
A Wikipedia é “uma enciclopédia em vários idiomas criada para ser lida e editada por qualquer pessoa”. (veja http://en.wikipedia.org). O conteúdo da Wikipedia é criado por seus usuários e publicados sob uma licença livre dupla (GPL e CC-BY-SA). Entretanto, como a Wikipedia pode ser alterada por qualquer visitante, deve ser usada somente como um ponto de partida ou guia geral. Existe muitas informações incorretas ou incompletas.
8.5.5. Padrões e Especificações¶
Existem várias fontes que fornecem informações sobre padrões ou especificações.
- http://www.linux-foundation.org/en/LSB
A Linux Foundation (Fundação Linux) é uma organização independente e sem fins lucrativos que promove a distribuição de software livre e de código aberto. A organização tenta atingir esse objetivo definindo padrões independentes de distribuição. A manutenção de vários padrões, tais como o LSB (Linux Standard Base), é supervisionada por essa organização.
- http://www.w3.org
O World Wide Web Consortium (W3C) é uma das organizações padronizadoras mais conhecidas. Foi fundada em Outubro de 1994 por Tim Berners-Lee e concentra-se em padronizar novas tecnologias Web. O W3C promove a disseminação de especificações abertas, livres de licença e independentes de fabricantes, tais como HTML, XHTML e XML. Estes padrões web são desenvolvidos num processo de quatro estágios em grupos de trabalho e são apresentados para o público como recomendações do W3C (REC).
- http://www.oasis-open.org
OASIS (Organização para o Avanço dos Padrões de Informação Estruturada) é um consórcio internacional especializado no desenvolvimento de padrões para segurança na web, negócios eletrônicos, transações de negócios, logística e interoperabilidade entre vários mercados.
- http://www.ietf.org
A Força-Tarefa de Engenharia da Internet (IETF) é uma cooperativa internacional ativa de pesquisadores, projetistas de rede, fornecedores e usuários. Concentra-se no desenvolvimento da arquitetura da Internet e na operação da Internet através de protocolos.
Cada padrão do IETF é publicado como um RFC (Request for Comments) e está disponível gratuitamente. Existem seis tipos de RFC: padrões propostos, rascunhos de padrões, padrões de Internet, protocolos experimentais, documentos de informação e padrões históricos. Somente os três primeiros (proposto, rascunho e completo) são padrões IETF numa definição mais rígida (veja http://www.ietf.org/rfc/rfc1796.txt).
- http://www.ieee.org
O Instituto de Engenheiros Elétricos e Eletrônicos (IEEE) é uma organização que define padrões nas áreas de tecnologia da informação, telecomunicação, medicina e saúde, transporte e outros. Os padrões IEEE devem ser pagos.
- http://www.iso.org
O Comitê ISO (Organização Internacional para Padrões) é o maior desenvolvedor de padrões do mundo e mantém uma rede de institutos nacionais de padronização em mais de 140 países. Os padrões ISO devem ser pagos.
- http://www.din.de , http://www.din.com
O Deutsches Institut für Normung (DIN - Instituto Alemão de Normalização) é uma associação técnica e científica registrada fundada em 1917. De acordo com o DIN, a organização é “a instituição responsável pelos padrões na Alemanha e representa os interesses alemães nas organizações padronizadores no mundo e na Europa.”
A associação reúne fabricantes, consumidores, companhias de serviços, cientistas e outros que possuem interesse no estabelecimento de padrões. Os padrões são pagos e podem ser comprados na página do DIN.
8.6. Suporte para o openSUSE¶
Informações de suporte úteis para o openSUSE estão disponíveis em várias fontes.
Suporte de instalação grátis para o cliente da caixa vendida
Suporte grátis da comunidade http://en.opensuse.org/Communicate
Se você encontrar problemas com a instalação ou uso do openSUSE que você não está apto a resolver, nosso experiente suporte pode oferecer assistência prática com suporte de instalação grátis para versões registradas. Quase todos os problemas comuns do cliente podem ser eliminados rapidamente e com competência. Você também pode usar o suporte extensivo oferecido pela comunidade.
8.6.1. Suporte de Instalação Grátis¶
Nosso suporte de instalação grátis é oferecido por um período de 90 dias após a ativação do seu código de registro http://www.open-slx.com/register ou depois do lançamento de uma versão mais nova. Se você não achar um resposta ao seu problema em qualquer fonte de informação, nós ofereceremos com prazer assistência para os seguintes casos:
Instalação para usuário doméstico típico com computador equipado com um único processador, mínimo de 512 MB de RAM e 3 GB de espaço livre em disco.
Redimensionamento de uma partição do Windows que ocupa todo disco rígido.
Instalação dual-boot com Windows, limitando o suporte ao Linux.
Instalação de uma unidade local de DVD ou CD ATAPI.
Instalação a partir de uma unidade de CD/DVD remota
Instalação em um disco rígido primário ou secundário em um sistema somente IDE (
/dev/sdaou/dev/sdb) ou sistema S-ATA suportado, excluindo RAID.Integração de um teclado e mouse padrões.
Configuração da interface gráfica (sem o recurso de aceleração de hardware da placa de vídeo).
Instalação do controle de boot no MBR do primeiro disco sem modificar o mapeamento da BIOS.
Configuração do acesso à internet com uma placa PCI ISDN suportada ou um modem serial externo (não USB). Por outro lado, configuração da DSL no PPPoE com um NIC suportado.
Configuração básica de um adaptador WLAN suportado.
Configuração básica de uma placa de som PCI com suporte a ALSA.
Configuração básica de impressora local compatível com o YaST.
Configuração básica de um gravador de CD IDE para usar com k3b (programa de gravação de CDs) sem trocar a configuração do jumper.
Configuração de uma placa de rede PCI suportada para acesso LAN com outro cliente DHCP ou IP estático. Isso não inclui a configuração da LAN ou qualquer outro computador ou componente de rede. Isso também não cobre a configuração do computador com um roteador. A análise de falhas é limitada a verificar o carregamento correto do módulo do kernel e das configurações corretas da rede local.
Configuração de um cliente de e-mail (Evolution e KMail) para receber e-mails de uma conta POP3. A análise de falhas é limitada a verificar a configuração correta do cliente de e-mail.
Suporte para a seleção de pacote da área de trabalho KDE ou área de trabalho GNOME.
Atualização de uma versão anterior do produto.
Atualizações do kernel (somente RPMs atualizados oficialmente pela Novell).
Instalação de atualizações de segurança ou correção de erros de um servidor oficial usando atualização online ou método manual.
Para uma lista detalhada de temas cobertos pelo suporte de instalação gratuita, visite http://support.open-slx.com/products/suselinux/support_overview.html.
No caso de você não ter certeza se seu suporte é coberto, por favor, não hesite em nos contatar. Nós ficaremos felizes em ajudá-lo(a).
8.6.1.1. Informação de Contato para o Suporte de Instalação Grátis¶
Contate nossa equipe de suporte pelo seguintes links e números de telefones. Nosso suporte de instalação é oferecido através de retorno de chamada. Depois da descrição do seu problema, nossa equipe ou tenta chamá-lo de volta nas próximas 2 horas ou agenda uma retorno de chamada. Por favor, registre seu produto em http://www.open-slx.com/register antes da sua solicitação de suporte.
Estados Unidos e Canadá: +1-404-5854-269
Alemanha, Austria e Suíça: Telefone: +49 (0)911-8946-0303
Reino Unido: +44-2030-025-943
Todos os outros países (inglês apenas): por favor, veja http://support.open-slx.com/products/opensuse/contact.html
Para a informação de contato mais recente, consulte http://support.open-slx.com/products/opensuse/contact.html.
8.6.1.2. Observações Importantes¶
O suporte de instalação grátis é oferecido para clientes com um código de registro válido e ativado. Você pode ativar seu código de registro em http://www.open-slx.com/register.
O código de registro não é transferível para outra pessoa.
O suporte grátis cobre a instalação inicial em um computador. Consulte nosso site para maiores informações http://support.open-slx.com/products/suselinux/support_overview.html.
8.6.1.3. Recomendações de Contato¶
Nós recomendamos usar o http://support.open-slx.com/eService para abrir um chamado de serviço e nos fornecer informações relevantes, tais como a descrição do problema e arquivos de log. Isso nos ajuda a evitar erros ortográficos em comandos, links ou nomes de diretórios, os quais causam problemas frustantes e são particularmente comuns durante conversas telefônicas. Você irá receber uma resposta em breve, fornecendo uma solução prática.
8.6.2. Preparando uma Solicitação de Suporte¶
Nós nos esforçamos para ajudá-lo o mais rapidamente e precisamente possível. O esforço e o tempo necessário são consideravelmente reduzidos se a questão for formulada claramente. Por favor, tenha as respostas prontas para as seguintes perguntas antes de nos contatar:
Qual programa e versão você está usando? Durante qual processo o problema ocorreu?
Qual é exatamente o problema? Tente descrever o erro o mais precisamente possível, usando frases com palavras como quando (por exemplo, “Quando o X é pressionado, esse erro aparece”).
Qual o hardware que você está usando (placa de vídeo, monitor, impressora, placa ISDN, etc...)? Você pode conseguir essas informações pelo YaST no módulo Informações do hardware.
Documentação detalhada pode ser encontrada nos manuais, ajuda online, e banco de dados de suporte. Essa documentação abrangente do openSUSE fornece orientações para resolver uma série de problemas. A central de ajuda do SUSE na sua área de trabalho fornece informações adicionais sobre pacotes de instalação, os "HOWTOs" principais e páginas info.
Você pode acessar os últimos artigos do banco de dados de suporte online em http://www.open-slx.com/usersupport ou acessando o banco de dados de suporte da comunidade em http://en.open-slx.org/SDB. O banco de dados de suporte, um dos bancos de dados mais frequentemente usados no mundo Linux, oferece aos nossos clientes uma várias abordagens de análises e soluções. Você pode achar soluções testadas usando a busca por palavra-chave, histórico de funções ou pesquisa dependente de versão.