Dicas de composição

• Quebras de linhas e parágrafos são automaticamente reconhecidos. As tags de quebra de linha, <br />, de parágrafo, <p>, e de fim de parágrafo, <p>, são inseridas automaticamente. Se os parágrafos não forem reconhecidos, basta inserir algumas linhas em branco.

• Tags HTML permitidas: <a> <em> <strong> <cite> <code> <ul> <ol> <li> <dl> <dt> <dd>

  Este site permite que você use HTML. Embora aprender todos os detalhes de HTML possa parecer um pouco difícil, aprender algumas poucas "tags" HTML, as mais básicas, é fácil. Esta tabela apresenta exemplos de cada tag habilitada neste site.

  Para maiores informações, consulte as especificações do HTML, da W3C, ou então use algum site de busca para achar algum outro site que fale sobre HTML.

  Descrição da Tag	Você Escreve	Você Terá
  Âncoras são usadas para criar links para outras páginas.	<a href="http://adroga.casadia.org">*Alcool e Outras Drogas</a>	*Alcool e Outras Drogas
  Ênfase	<em>Ênfase</em>	Ênfase
  Negrito	<strong>Negrito</strong>	Negrito
  Citação	<cite>Citação</cite>	Citação
  Código-fonte de programação	<code>Codificado</code>	Codificado
  Lista não ordenada - use <li> no começo de cada item da lista	<ul> <li>Primeiro item</li> <li>Segundo item</li> </ul>	Primeiro item Segundo item
  Lista ordenada - use <li> para iniciar cada item da lista	<ol> <li>Primeiro item</li> <li>Segundo item</li> </ol>	Primeiro item Segundo item
  Listas de verbetes são similares a outras listas HTML. <dl> inicia a lista de verbetes, <dt> inicia o verbete e <dd> inicia a descrição do verbete.	<dl> <dt>Primeiro termo</dt> <dd>Primeira definição</dd> <dt>Segundo termo</dt> <dd>Definição 2</dd> </dl>	Primeiro termo Primeira definição Segundo termo Definição 2

  A maioria dos caracteres, inclusive os pouco usados, podem ser inseridos nenhum problema.

  Se você encontrar algum problema, tente usar entidades HTML de caractere. Um exemplo comum é &amp; para o caractere "e comercial", &. Para uma lista completa das entidades veja a página entidades HTML (em inglês). Alguns dos caracteres disponíveis são:

  Descrição do caractere	Você Escreve	Você Terá
  "E" comercial	&	&
  Maior que	>	>
  Menor que	&lt;	<
  Aspas	&quot;	"

• Usando código PHP personalizado

  Você pode escrever código PHP em alguns lugares do site, incluíndo posts e blocos. Poder escrever código PHP em um post ou em um bloco pode ser um recurso poderoso e flexível se usado por um usuário confiável e com experiência com PHP, mas pode ser um risco de segurança muito alto se for usado incorretamente. Mesmo um pequeno erro no código pode, acidentalmente comprometer o seu site.

  Se você não tem familiaridade com PHP, SQL ou com o Drupal, não coloque código PHP nos seus posts. Ficar fazendo testes com PHP pode corromper o seu banco de dados, derrubar o seu site ou comprometer significativamente a segurança do site.

  Notas:

  • Lembre-se de conferir atentamente cada linha, antes de salvar, para ver se não há erros de lógica ou sintaxe.
  • Cada comando deve terminar com um ponto-e-vírgula.
  • Variáveis globais usadas no seu código PHP vão ter manter o seu valor depois da execução do seu script.
  • A diretiva register_globals está desligada. Se você precisa usar formulários, estude e use as funções da API de formulários do Drupal.
  • Use o comando print ou return no seu código para exibir o conteúdo.
  • Desenvolva e teste seu código PHP em um ambiente separado antes de aplicar em um site em produção.
  • Veja se não é melhor incluir o seu código PHP personalizado em um módulo específico para o seu site ou no arquivo template.php ao invés de escrever isso diretamente dentro de um post ou bloco.
  • Note que usar código PHP em posts é uma função oferecida pelo módulo filtro PHP. Se esse módulo for desativado ou removido, os blocos e posts que contêm código PHP vão exibir, ao invés de executar, o código PHP.

  Por exemplo: Como criar um bloco "Bem vindo!" que recebe seus visitantes com uma mensagem simples.

  • Adicionar um bloco personalizado ao seu site, com o título de "Bem-vindo". Escolha o formato de entrada "Código PHP" (ou outro formato que suporte entrada PHP) e escreva o seguinte texto no corpo do Bloco:

    print t('Seja bem-vindo, visitante! Obrigado pela visita.');
    

  • Para exibir o nome de um usuário registrado, use este código:

    global $user;
    if ($user->uid) {
    print t('Seja bem-vindo, @name! Obrigado pela visita.', array('@name' => $user->name));
    }
    else {
    print t('Seja bem-vindo, visitante! Obrigado pela visita.');
    }
    

  O site Drupal.org apresenta exemplos de códigos PHP. Com um pouco de experiência com PHP e conhecimento do funcionamento interno do Drupal, você pode criar os seus próprios.

• Endereços de páginas de internet e emails viram links automaticamente.
• The Glossary module will automatically mark terms that have been defined in the glossary vocabulary with links to their descriptions. These marks depend on the settings and may be a superscript character or an icon, or the term may be turned into an acronym, cite, or abbreviation. If there are certain phrases or sections of text that should be excluded from glossary marking and linking, use the special markup, [no-glossary] ... [/no-glossary]. Additionally, these HTML elements will not be scanned: a, abbr, acronym, code, h1, h2, h3, h4, h5, h6, pre.