Utilizando includes (SSI) e poupando trabalho

A diretiva Include
é de grande valor para os desenvolvedores da web e também
para nossos amigos designers, pois com o include é possível
criar verdadeiras “bibliotecas”
de funções, constantes e até mesmo partes de códigos HTML↳HTML45 conteúdosA importância do HTML e CSS para quem trabalha com UI Design e Design SystemProduto & UX · dez 2024Como hostear seu site HTML gratuitamente com GitHub PagesDev (Back & Front) · jun 2025SQL Server – Como criar um versionamento de código das suas Stored Procedures em HTML e com comentários da alteraçãoData · nov 2020Ver tudo em Dev (Back & Front) →
que se repetirão em várias páginas de um mesmo site.

A diretiva include acrescenta um arquivo (geralmente
.HTM, .ASP ou algum script em JavaScript armazenado dentro
de um .TXT) em uma página da web. Além de criar códigos reaproveitáveis,
o uso do include agiliza a manutenção do seu site, pois basta
que você altere o código de um arquivo, que todas as páginas
que incorporam este arquivo serão alteradas de uma única vez.

Para aqueles que conhecem a linguagem C, é
inevitável lembrar dos arquivos header que também são acrescentados
ao programa via include. Para os que não conhecem C, ficará
mais fácil a compreensão desta diretiva com um exemplo bem
simples.

Imagine que você decidiu que todas as páginas do site no qual
você está trabalhando deverão mostrar nas duas últimas linhas
da página a data atual e mais uma mensagem qualquer (“todos
os direitos reservados”,por exemplo). Para isto, você teria
que fazer sempre o mesmo código em todas as páginas. É uma
tarefa bem simples porém repetitiva, e você pode agilizar
o seu trabalho se criar um arquivo .ASP com os comandos que
precisa e depois acrescentá-lo em cada página através da diretiva
include.

Para implementar esta idéia, o primeiro passo é criar um arquivo
.ASP qualquer com os comandos que mostram a data atual e a
mensagem desejada (“todos os direitos reservados”). Vamos
chamá-lo de MostraRodape.asp.

<CENTER>
<%
Response.Write(“Data: ” & Date )
%>
<p>Todos os direitos reservados</p>
</CENTER>

Repare que o nosso arquivo MostraRodape.asp pode, sem problema
algum, mesclar código ASP com TAGS ( comandos ) HTML. Lembre-se
que este arquivo nada mais é do que uma página que será incluida
dentro de todas as outras.

Após termos criado o arquivo, basta incluí-lo dentro das demais
páginas.
Imagine que você tem uma página inicial chamada Inicial.asp
com o seguinte código:

<HTML>
<BODY>
<p>Bem-Vindo ao meu site.
<p>Repare na data e na mensagem que estão na última
linha….
</BODY>
<HTML>

Para que o rodapé ( que está dentro do arquivo MostraRodape.asp
) apareça no final da página, basta acrescentar a diretiva
include, de modo que o código da sua página inicial ficará
assim:

<HTML>
<BODY>
<p>Bem-Vindo ao meu site.
<p>Repare no rodapé desta página….
<!– #include file = “MostraRodape.asp” –>
</BODY>
<HTML>

É muito simples! Desta forma, o servidor entende que no lugar
da diretiva include, deve ser colocado o código existente
no arquivo indicado pela diretiva.

Como se pode perceber, a sintaxe do include é:

<!– #include file
= “nome_do_arquivo” –>

Algumas observações

1. O arquivo nome_do_arquivo deve estar no
mesmo diretório que a página onde ele será incluído. Se os
arquivos estiverem em diretórios diferentes, o caminho deve
ser indicado.

Exemplos:

<!– #include file=”/inc/MostraRodape.asp”
–> – Indica que o arquivo MostraRodapé está dentro
do Diretório INC, que por sua vez está dentro do mesmo diretório
que a página que contém a diretiva include.

<!– #include file=”../MostraRodape.asp”
–> – Indica que o arquivo MostraRodapé está um
diretório acima do diretório da página que contém a diretiva
include.

2. Existe uma variância da diretiva include, onde troca-se
o parâmetro file por
virtual.

Enquanto o caminho no include file é procurado
a partir do diretório corrente, no include virtual ele é procurado
sempre a partir da raiz.

Exemplo:

Imagine que dentro do diretório raiz do seu site você tem
a pasta INC e a pasta Paginas.
A pasta Paginas, por sua vez,
contém as pastas Comuns e Administracao.

Imaginando que o arquivo MostraRodape.asp
esteja dentro da pasta INC e o arquivo Inicial.asp esteja
dentro da pasta Comuns, temos
os seguintes caminhos:

MostraRodape.asp : /INC/MOSTRARODAPE.ASP
Inicial.asp : /PAGINAS/COMUNS/MOSTRARODAPE.ASP

Uma forma correta de acrescentar a diretiva include dentro
do arquivo Inicial.asp seria

<!– #include virtual=
“/inc/MostraRodape.asp” –>

Pois o parâmetro Virtual indica
que o caminho deverá ser procurado a paritr da raiz, e não
a partir do diretório corrente.

3. A diretiva include pode ser colocada
em qualquer ponto dentro de uma página. Logo, no código abaixo,
o “rodapé” seria mostrado na primeira e na segunda linha da
página.

<HTML>
<BODY>
<!– #include file = “MostraRodape.asp” –>
<p>Bem-Vindo ao meu site.
<p>Repare no rodapé desta página….
</BODY>
<HTML>

Caso você deseje utilizar a diretiva Include dentro
de uma página HTM, deverá trocar a extensão da página de HTM
para SHTM, e o servidor deve suportar esta tecnologia.