A revista do profissional de TI

• Notícias
• |
• Easy Linux
• |
• Guia de TI
• |
• Linux Park
• |
• Livros
• |
• Shopping

Parceiros

O número de artigos que recebemos de autores externos vem aumentando nos últimos meses, e a melhor forma de agilizar o processo de publicação do seu artigo é adequá-lo ao formato da revista.

Neste link existe um modelo de artigo formatado para tirar algumas das suas dúvidas (a versão impressa encontra-se aqui). Se alguma dúvida persistir mesmo após a leitura deste guia, por favor indique-a ao enviar seu artigo para nós.

Nós utilizamos o OpenOffice.org (ou BrOffice.org) para escrita dos artigos, com o objetivo de facilitar e unificar o processo de escrita em qualquer um dos principais sistemas operacionais da atualidade.

Intertítulos (ou subtítulos)

Os artigos da Linux Magazine possuem somente dois níveis hierárquicos: Título (estilo Título 1 no BrOffice.org) e Texto (estilo Padrão no BrOffice.org). Não use múltiplos níveis de título (como Título 2, Título 3 etc.).

Por exemplo, a estrutura de intertítulos a seguir é inválida:

  .Histórico
  ...Até 1999
  ...A partir de 2000
  .Recursos
  ...Acesso via HTTP
  ...Acesso via WebDAV
  ...Acesso via FTP

Nessa estrutura, 'Histórico' está num nível diferente de 'Até 1999' e 'A partir de 2000', enquanto 'Recursos' está num nível diferente de 'Acesso via HTTP', 'Acesso via WebDAV' e 'Acesso via FTP'. Na Linux Magazine, eles precisam ser transformados em um único nível. Normalmente é possível eliminar completamente um dos dois níveis, como por exemplo:

  .Histórico
  .Acesso via HTTP
  .Acesso via WebDAV
  .Acesso via FTP

Se não for o caso, use a imaginação para limitar seus intertítulos a um único nível.

Estilos de parágrafo

Nosso formato utiliza os estilos de parágrafos nativos do OpenOffice.org/BrOffice.org. Portanto, evite usar outros estilos.

Os estilos de parágrafo permitidos são somente os seguintes:

• Título 1 (intertítulos)
• Padrão (texto do artigo)
• Texto pré-formatado (parágrafos inteiros de código

Estilos de caracteres

Novamente, nosso formato utiliza somente os estilos de caracteres nativos do OpenOffice.org/BrOffice.org:

• Padrão (texto sem formatação)
• Texto de origem (comandos, nomes de arquivos, nomes de variáveis, trechos de código ao longo do texto)
• Citação (referências aos elementos do artigo: figuras, exemplos de código, tabelas, quadros de texto)
• Variável (caminhos de menu de aplicativos)
• Entrada de Usuário (tecla. Exemplo: Ctrl+Alt+Del)
• Link da Internet (números de links. Exemplo: [4])
• Negrito (para enfatizar uma ou poucas palavras. Evite usar esse recurso, pois é fácil se exceder nele)
  Veja o artigo de exemplo para mais detalhes.

Fluidez do texto

Em tutoriais, é comum existir uma seqüência de passos a serem seguidos. Porém, em um artigo, é mais interessante manter o texto fluido.

O exemplo a seguir é inválido:

Prefira descrever em maiores detalhes os procedimentos, como por exemplo:

Seções

As seções de formatação do artigo não são fixas, mas geralmente o artigo começa com uma introdução ao assunto que será tratado. (Não confunda a introdução com o curto texto que vem logo abaixo do título do artigo. Esse texto curto se chama “gravata”).

Introdução

Comece pensando em quem será o público-alvo do seu artigo. Por exemplo, um artigo sobre programação web com Python não precisa discutir, em sua introdução, as diferenças entre Python, PHP, Perl e Ruby. No entanto, talvez valha a pena citar que essa linguagem pode ser usada como todas essas outras para a programação web.

Por outro lado, evite ser conciso demais. Nesse mesmo artigo sobre programação web com Python, começar já falando sobre a linguagem de templates de determinado framework web pode assustar aqueles que estão interessados no assunto mas ainda não têm intimidade com a linguagem ou com a programação web.

Tente sempre capturar o máximo possível de leitores. Na dúvida, é melhor uma introdução detalhada demais do que uma exageradamente concisa – os leitores mais experientes sempre podem pular essa seção, caso prefiram.

Restante do texto

No restante do texto fica o texto propriamente dito, juntamente com os intertítulos e os demais elementos.

Elementos como tabelas, figuras, quadros de texto, links e exemplos de código podem ser incluídos no meio do texto (veja abaixo alguns lembretes).

Elementos do artigo

O artigo de exemplo explica com todos os detalhes como devem ser formatados os seus elementos.

Porém, alguns aspectos precisam ser enfatizados:

• Todos os elementos (figuras, tabelas, links, quadros de texto e exemplos de código) precisam ter ao menos uma referência no corpo do texto ou em um quadro de texto, como nos seguintes exemplos:
  • A figura 4 mostra a tela inicial do programa.
  • Veja a tabela 1 para uma lista dos parâmetros do programa e seus significados.
  • Para as otimizações, o programa utiliza algoritmos genéticos (veja o quadro 3).
  • Ao final, acrescente as linhas do exemplo 2 ao final do arquivo de configuração /etc/programa.conf.
  • O código-fonte do aplicativo pode ser baixado em [10].

Referências a elementos como as descritas abaixo são inválidas:

• A figura --ao lado-- mostra a tela inicial do programa.
• Veja a --primeira tabela do artigo-- para uma lista dos parâmetros...
• Para as otimizações, o programa utiliza algoritmos genéticos (veja o --quadro abaixo--)
• Ao final, acrescente as linhas do exemplo --programa.conf-- ao final do arquivo de configuração /etc/programa.conf.
• O código-fonte do aplicativo pode ser baixado em --broffice.org--.

• Todos os elementos dos tipos Quadro, Tabela e Exemplo precisam ter um número seqüencial (por tipo) e um título:
  • Quadro 1: Algoritmos genéticos
  • Exemplo 1: Arquivo /etc/programa.conf
  • Quadro 2: A biblioteca OpenSSL
  • Tabela 1: Opções do comando zenity

• Todas as figuras precisam ter um número seqüencial e uma legenda, que deve ser inserida no próprio OpenOffice.org/BrOffice.org.
  • Evite legendas exageradamente curtas ou longas. Lembre-se de que a maioria dos leitores olha as figuras e lê suas respectivas legendas antes de começar a ler o artigo – então, seja claro com relação ao que a figura mostra, mas tente atrair a atenção do leitor para o corpo do artigo propriamente dito; com isso, você ganha leitores!

• Prefira imagens em formatos vetoriais. Tanto imagens EPS quanto SVG podem ser embutidas nos documentos ODT, e portanto devem ser preferidas. Diagramas feitos com programas como Dia devem ser exportados para o formato SVG.

• Se não for possível enviar a imagem em formato vetorial, mande-a na maior resolução possível, pois a revista impressa utiliza resoluçãode 300 dpi (pontos por polegada), o que significa mais de 3.000 pixels de largura em uma página.

Notícias