LDP - Linux Documentation Project
Projeto internacional com o objetivo de criar documentação livre e de boa qualidade para o Linux

Todo usuário ou administrador de Linux eventualmente se depara com um problema incomum ou para o qual a solução não seja óbvia. Alguns contam com uma boa biblioteca ou com a ajuda de gurus locais ou outra forma de suporte; mas o resto de nós acaba tendo que recorrer com freqüência à documentação online.

Uma das características que garantiram o crescimento do Linux foi a qualidade do suporte oferecido diretamente pela comunidade, reunidos em grupos, associações, listas de discussão, canais de bate-papo, websites e fóruns em todo o mundo. Uma das formas pelas quais é oferecido este suporte voluntário é o Linux Documentation Project, ou LDP. Trata-se de um projeto internacional (inclusive com brasileiros em sua diretoria) com o objetivo de criar documentação livre e de qualidade, incluindo os HOWTOs, Guias, e outras publicações como a revista eletrônica Linux Gazette.

De modo geral, você vai encontrar informações mais atualizadas no site do LDP (linuxdoc.org) do que nas livrarias; mais do que isso, os documentos do LDP são extremamente abrangentes, já que recebem contribuição de voluntários de todo o mundo, que escrevem sobre assuntos que dominam e desejam compartilhar sem receber nenhuma recompensa por isto - completamente dentro do espírito do software livre. Todo usuário de Linux deve conhecer a riqueza de temas abordados pelo LDP; lembre-se de que uma olhada mensal no índice de documentos pode poupar "a reinvenção da roda".

Antes de começar

Este artigo irá versar sobre a base de documentos do projeto LDP internacional, baseado no site linuxdoc.org e disponíveis em língua inglesa, embora muitas traduções em outros idiomas estejam disponíveis.

Muitos documentos originais do LDP estão disponíveis em português, graças aos esforços do LDP-BR (ldp-br.conectiva.com.br), braço brasileiro do LDP. Entretanto, o LDP-BR ainda não dispõe de recursos suficientes para traduzir todas as versões mais recentes dos documentos, portanto você poderá ter que recorrer às versões em inglês.

Caso não domine a língua original dos documentos, experimente um dos tradutores online gratuitos, como o babelfish.altavista.com. E lembre-se: sua ajuda será muito bem recebida caso tenha interesse em traduzir textos.

Os guias

O LDP dispõe de vários livros sobre todos os aspectos que envolvem o Linux. Estes livros, denominados guides ou guias, apresentam qualidade superior a ponto de muitas vezes chegarem a ser impressos e vendidos em livrarias, mesmo estando disponíveis gratuitamente na web. O conteúdo é tão rico, que a possibilidade de manuseá-los e tê-los acessíveis a qualquer momento pode valer a pena.

Alguns guias são clássicos, como o Network Administrators Guide (NAG) e o Installation and Getting Started Guide; eles foram lidos e relidos pelos primeiros linuxers, e ainda hoje são excelente leitura inicial para quem realmente pretende vir a dominar este sistema. Com o desenvolvimento do Linux, surgiram guias mais específicos, como o Securing and Optimizing Linux e o Linux System Administration Made Easy. Todos eles mantêm as mesmas características básicas: conteúdo relevante, total liberdade de uso e cópia, alta qualidade da informação.

Os HOWTOs

Os HOWTOs (da expressão inglesa "how to", ou "como fazer", em tradução livre) são a verdadeira alma do LDP. Documentos menores que os guias, de modo geral abordam temas bem específicos, tratando-os com profundidade e precisão. Embora ainda existam muitas perguntas sem respostas pronta, uma análise das perguntas comuns em qualquer lista de discussão, fórum ou chat sobre Linux facilmente demonstrará que a maioria delas já está respondida em algum HOWTO disponível livremente.

Enquanto este artigo está sendo escrito, é possível obter um arquivo compactado contendo todos os HOWTOs em formato TXT ocupando apenas 4MB (antes da descompactação). Entretanto, este volume cresce a cada dia, já que os voluntários do mundo inteiro continuam escrevendo e acrescentando novos títulos à biblioteca todas as semanas. Está fora de cogitação incluir no artigo uma lista dos HOWTOs mais importantes, pois a lista seria imensa. Entretanto, darei uma pequena amostra apenas para garantir uma idéia da diversidade existente no LDP:

• 4mb-Laptops: ensina a instalar o Linux em laptops antigos, com 4MB de RAM;
• Adv-Bash-Scr: como fazer scripts shell avançados em bash;
• Astronomy: como utilizar o Linux em aplicações de Astronomia;
• Cable-Modem: como conectar-se a um provedor a cabo;
• Diskless: como configurar uma estação de trabalho sem disco rígido;
• Filesystems: como funcionam os sistemas de arquivo disponíveis;
• From-PowerUp-To-Bash-Prompt: o que acontece nos bastidores do boot;
• Hardware: quais equipamentos são compatíveis e onde estão os drivers;
• Oracle 8: como instalar o SGBD Oracle 8i;
• PostgreSQL: como instalar o SGBD PostgreSQL;
• Quake: como instalar e configurar os clientes e servidores do jogo Quake;
• RedHat-CD: como criar seus próprios CDs equivalentes aos da Red Hat;
• User-Group: como fundar e manter um grupo de usuários.

Perceba a diversidade existente! Cada item desta amostra aborda um tema bastante específico e procura esgotá-lo ao máximo, de forma a facilitar a sua vida.

Propositadamente selecionei exemplos de interesse bastante específico, já que a idéia era mostrar a abrangência. Entretanto, existem HOWTOs de interesse genérico que deveriam ser leitura obrigatória para todo usuário que quer evitar dificuldades com o Linux. Saber se o modem XYZ tem suporte no Linux? O Modem-HOWTO explica. Driver da sua placa de rede? Veja o Ethernet-HOWTO! Seu equipamento não tem um HOWTO específico? Hardware-HOWTO pode ajudar. Como imprimir em uma impressora remota? Comece pelo Printing- HOWTO. Como instalar uma firewall para a sua rede? O Firewall-HOWTO sabe. Captou a idéia?

Note que muitas vezes ler o HOWTO correspondente pode dar uma resposta mais completa do que uma consulta a outros usuários, e em geral você acaba aprendendo muito mais sobre o assunto, evitando problemas futuros e aprendendo novas técnicas para resolvê-los se aparecerem.

Mini-HOWTOs

Os mini-HOWTOs em geral são ainda mais específicos que os HOWTOs e apresentam menor tamanho também. Vejamos alguns exemplos de temas variados:

• Battery-Powered: como reduzir o consumo de energia do micro com Linux;
• BogoMIPS: o que são, e principalmente o que não são os BogoMIPS;
• Bzip2: como usar a moderna compactação bz2;
• Clock: como ajustar o relógio;
• Home-network: como configurar uma rede doméstica;
• IPMasq+Napster: como usar o Napster através do IP Masquerade;
• Leased-Line: como usar o ppp por uma linha dedicada;
• VPN: como configurar uma rede virtual privada.

Assim como no caso dos HOWTOs, os mini-HOWTOs também variam dos interesses genéricos aos extremamente específicos, e vale a pena ter uma boa noção da lista de assuntos abordados por eles, de modo a sempre saber quando recorrer a esta fonte.

Outros documentos

O LDP também reúne outros documentos importantes e originais. Uma categoria especialmente útil para os que buscam soluções rápidas a problemas são as FAQs, documentos na forma de perguntas e respostas que atendem às dúvidas mais comuns sobre determinados assuntos. Entre as FAQs do LDP encontramos a FAQ genérica do Linux, do RAID, do PPP, do SMP, das Threads e de muitos outros assuntos, alguns com aparência de magia negra, e outros mais comuns ao dia-a-dia de todos os usuários.

Outro tipo de documento mantido pelo LDP são as páginas de manual, normalmente consultadas no prompt do Linux através do comando man. As páginas de manual do LDP são um ótimo recurso na documentação das características mais obscuras do sistema.

Finalmente, temos a Linux Gazette, revista mensal focada no Linux e que só existe em forma digital. Sempre com artigos, dicas e truques interessantes, é leitura obrigatória para quem deseja estar informado sobre o que acontece na cena Linux mundial.

Conclusão

O LDP é um excelente recurso à disposição da comunidade usuária de Linux. Aproveite-o bem, saiba o que está disponível e consulte sempre que precisar. Mas lembre-se também de procurar retribuir este serviço, na forma de contribuições de material inédito, traduções, atualizações ou mesmo de disseminação do conteúdo entre os novos usuários. A comunidade agradece!

Para saber mais

Linux Gazette: www.linuxgazette.com
LDP: linuxdoc.org
LDP-BR: ldp-br.conectiva.com.br