Inserir inclusões de servidor no Dreamweaver

Última atualização em 25/04/2024

Você pode usar o Dreamweaver para inserir inclusões de servidor nas páginas, editar as inclusões ou visualizar as páginas que contenham inclusões.

Nota

A interface de usuário foi simplificada no Dreamweaver 2017. Logo, talvez você não consiga encontrar algumas das opções descritas neste artigo no Dreamweaver 2017 e em versões posteriores. Para obter mais informações, consulte este artigo (em inglês).

Sobre as inclusões de servidor

Você pode usar o Dreamweaver para inserir inclusões do lado do servidor em suas páginas, editar as inclusões ou visualizar páginas que contenham inclusões.

Um include do lado do servidor é um arquivo que o servidor incorpora ao seu documento quando um navegador solicita seu documento do servidor.

Quando o navegador de um visitante solicita o documento que contém a instrução de include, seu servidor processa a instrução de include e cria um novo documento no qual a instrução de include é substituída pelo conteúdo do arquivo incluído. O servidor então envia este novo documento ao navegador do visitante. Quando você abre um documento local diretamente em um navegador, no entanto, não há servidor para processar as instruções de inclusão nesse documento, então o navegador abre o documento sem processar essas instruções, e o arquivo que deveria ser incluído não aparece no navegador.Assim, pode ser difícil, sem usar o Dreamweaver, examinar arquivos locais e vê-los como aparecerão aos visitantes depois que você os colocar no servidor.

Com o Dreamweaver você pode visualizar documentos exatamente como aparecerão depois de estarem no servidor, tanto na visualização Design quanto quando usar o recurso Visualizar no navegador. Para fazer isso, no entanto, você deve certificar-se de que está visualizando o arquivo que contém o include como um arquivo temporário. (Selecione Editar > Preferências, selecione a categoria Visualizar no navegador e certifique-se de que a opção Visualizar usando arquivo temporário esteja selecionada.)

Nota

Se você estiver usando um servidor de teste, como Apache ou Microsoft IIS, para visualizar seus arquivos no disco local, não precisa visualizar o arquivo como um arquivo temporário porque o servidor faz o processamento para você.

Colocar um include do lado do servidor em um documento insere uma referência para um arquivo externo; não insere o conteúdo do arquivo especificado no documento atual. O conteúdo do arquivo especificado deve conter apenas o conteúdo que você deseja incluir. Ou seja, o arquivo de include não deve conter tags head, tags body ou tags html (ou seja, a tag <html> — formatação de tags HTML, como tags p, tags div e assim por diante, são adequadas). Se isso acontecer, essas tags entrarão em conflito com as tags no documento original, e o Dreamweaver não exibirá a página adequadamente.

Você não pode editar o arquivo incluído diretamente em um documento. Para editar o conteúdo de um include do lado do servidor, você deve editar diretamente o arquivo que está incluindo. Qualquer alteração no arquivo externo se reflete automaticamente em cada documento que o inclui.

Há dois tipos de inclusões de servidor: Virtual e Arquivo. Dreamweaver insere inclusões do tipo Arquivo por padrão, mas você pode usar o inspetor de propriedades para selecionar a que for apropriada para o tipo de servidor web que usa:

  • Se ele for um servidor Web Apache, selecione Virtual. No Apache, o tipo Virtual funciona em todos os casos, enquanto o tipo Arquivo funciona somente em alguns casos.
  • Se ele for um Microsoft Internet Information Server (IIS), selecione Arquivo. (O tipo Virtual funciona apenas com o IIS em determinadas circunstâncias.)
Nota

Infelizmente, o IIS não permite incluir um arquivo em uma pasta acima da pasta atual na hierarquia de pastas, a menos que um software especial tenha sido instalado no servidor. Se for necessário incluir um arquivo de uma pasta superior na hierarquia de pastas em um servidor IIS, pergunte ao administrador do sistema se o software necessário está instalado.

  • Em outros tipos de servidores, ou se você não souber qual é o tipo do seu servidor, pergunte ao administrador do sistema qual opção deve ser usada.

    Alguns servidores são configurados para examinar todos os arquivos e verificar se eles contêm inclusões de servidor. Outros são configurados para examinar somente arquivos com uma extensão específica, como .shtml, .shtm ou .inc. Se uma inclusão de servidor não estiver funcionando, pergunte ao administrador do sistema se você precisa usar uma extensão especial no nome do arquivo que usa a inclusão. (Por exemplo, se o nome do arquivo for canoe.html, pode ser que você precise renomeá-lo para canoe.shtml.) Se você deseja que seus arquivos retenham as extensões .html ou .htm, peça ao administrador do sistema para configurar o servidor de modo que ele procure inclusões de servidor em todos os arquivos (e não apenas nos arquivos com uma extensão específica). A procura de inclusões de servidor em um arquivo leva algum tempo. Portanto, as páginas que o servidor analisa demoram um pouco mais para serem atendidas do que as outras páginas e alguns administradores não permitem a análise de todos os arquivos.

Inserção das inclusões de servidor

Você pode usar o Dreamweaver para inserir inclusões do lado do servidor em sua página.

Inserção de uma inclusão de servidor

Selecione Inserir > Include do lado do servidor.
Na caixa de diálogo que aparece, navegue e selecione um arquivo.

Por padrão, o tipo de inclusão Arquivo é inserido.

Para alterar o tipo da inclusão, selecione a inclusão do lado do servidor na janela Documento e altere o tipo no inspetor de propriedades (Janela > Propriedades), da seguinte forma:
  • Se ele for um servidor Web Apache, selecione Virtual. No Apache, o tipo Virtual funciona em todos os casos, enquanto o tipo Arquivo funciona somente em alguns casos.
  • Se ele for um Microsoft Internet Information Server (IIS), selecione Arquivo. (O tipo Virtual funciona apenas com o IIS em determinadas circunstâncias.)
Nota

Infelizmente, o IIS não permitirá a inclusão de um arquivo em uma pasta acima da pasta atual na hierarquia de pastas, a menos que um software especial tenha sido instalado no servidor. Se você precisa incluir um arquivo de uma pasta localizada no topo da hierarquia de pastas em um servidor IIS, pergunte ao administrador do sistema se o software necessário está instalado.

  • Em outros tipos de servidores, ou se você não souber qual é o tipo do seu servidor, pergunte ao administrador do sistema qual opção deve ser usada.

Alteração de qual arquivo será incluído

Selecione a inclusão do lado do servidor na janela Documento.
Abra o Inspetor de propriedades (Janela > Propriedades).
Siga um destes procedimentos:
  • Clique no ícone da pasta e navegue e selecione um novo arquivo para incluir.

  • Na caixa, digite o caminho e o nome do novo arquivo a ser incluído.

Editar o conteúdo de inclusões do lado do servidor

Você pode usar o Dreamweaver para editar inclusões do lado do servidor.Para editar o conteúdo associado ao arquivo incluído, é preciso abrir o arquivo.

Selecione a inclusão do lado do servidor na exibição Design ou Código e clique em Editar no inspetor de propriedades.

O arquivo incluído é aberto em uma nova janela Documento.

Edite o arquivo e salve-o.

As alterações são imediatamente refletidas no documento atual e em qualquer documento subsequente aberto que inclua o arquivo.

Carregue o arquivo de inclusão para o site remoto se necessário.