Programa assistente para geração de homepages - Manual de Operação

1. Introdução

    A criação de homepages por pessoas com pouca vivência de programação
até pouco tempo era sempre uma tarefa complexa: era necessário conhecer
a linguagem html e uma série de outros detalhes de relativa complexidade,
e assim, a criação de páginas ficava restrita a muito poucas pessoas.

    Recentemente, uma série de programas visuais foram criados para
permitir que uma pessoa que enxergue pudesse criar homepages da mesma
forma como usar um editor de textos: digitando e colando coisas nos
devidos lugares com o mouse.  Esses programas, infelizmente não são
adequados para operação por deficientes visuais.

    O sistema DOSVOX desde há muito possuia uma ferramenta simples para
criação de homepages, o WWWVOX.   Essa ferramenta, entretanto, tinha uma
série de limitações, o que nos levou a criar este programa.

2. O que é o editor Intervox

    O editor Intervox permite criar páginas simples com quase nenhum trabalho,
gerando material através de pequenos acréscimos num texto digitado.  O programa
trabalha com "modelos" de homepage, que estabelecem a forma gráfica (visual) que a
homepage terá, e desta forma, a qualidade gerada poderá ser tão complexa
quanto se deseje.

    As páginas geradas são compatíveis com os browsers mais usados no mercado:
webvox e lynx, que são browsers textuais, e explorer, netscape e opera, que são
browsers gráficos.

    Na internet as páginas se encadeiam, ou seja, uma faz referência a outras.
Referenciar uma outra página na sua página é trivial, bem como criar uma
"rede de páginas".  Basta indicar o nome da página encadeada no texto, seguindo
uma convenção muito simples, que o intervox faz o resto.

    As homepages produzidas por este programa são eminentemente textuais,
podendo entretanto conter quaisquer elementos multimídia, como fotos,
música ou filmes.  O modelo básico fornecido permite a inclusão de elementos
extras html (tags) misturados com o texto, fazendo assim com que o poder
de geração seja amplo.

    Desta forma, se espera que uma pessoa com deficiencia visual possa criar
excelentes homepages, tanto em termos de conteúdo como aparência, incluindo
nelas todo conhecimento e experiência pessoal.

3. Forma geral da homepage

    A homepage criada pelo intervox é composta por 3 partes:

a) o cabeçalho
    É a parte superior da homepage, na qual pode-se incluir diversos elementos,
em especial o título da homepage.

b) os tópicos
    São trechos de texto, acima dos quais existe um título daquele tópico.

c) o rodapé
    É uma área que contem o e-mail do autor e outras informações úteis.

    Os tópicos são a parte mais importante: eles contém as informações que
se deseja comunicar.  Os tópicos, quase sempre são baseados em material escrito,
produzido pelo autor ou copiado de outras fontes.  Dentro dos tópicos é possível
incluir figuras ou filmes, além de elos (referências externas, links) para outras
homepages ou para outras partes desta.

4. Como criar e publicar uma homepage simples num servidor

    Os passos são os seguintes:

a) digitação
    Digite um arquivo de texto com tipo .PAG, que descreveremos a seguir.  Este
arquivo contém a homepage numa forma preliminar, que é quase um texto sem nada
de mais, com algumas letras especiais em algumas poucas linhas.  Para isso use
qualquer editor de textos, por exemplo, o edivox ou o minied.

b) geração no formato HTML
    Use o programa intervox para transformar o arquivo .PAG em arquivo .HTM, que
é um texto com marcações bastante complexo, mas que será produzido sem sua
interferência.  Você em momento nenhum precisa escrever em HTML, a menos que
queira fazer "coisas mirabolantes".

d) teste da página
    Use um browser localmente, e garanta que ela funciona.  Com o webvox,
use a função a (arquivos) para carregar.

Nota:  Se voce começou a inventar muito, chame tambem um vidente para que
ele observe se voce nao fez um carnaval muito grande na tela (mesmo que
auditivamente esteja perfeito).

e) transporte para o servidor
    O arquivo gerado vai ser então movido para o servidor, utilizando, por
exemplo, um programa como o FTPVOX, em geral para dentro do espaço da sua conta
neste servidor.

e) uso da homepage
    Uma vez que a homepage esteja no seu espaço no servidor (geralmente é necessário
colocá-la num diretório da conta chamado public_html), o acesso externo é trivial,
basta chama-la através de um navegador (webvox, por exemplo), assim:

http://nomedoservidor.br/~nomedousuario/nomepagina.htm

por exemplo:
http://intervox.nce.ufrj.br/~antonio2/x.htm

Em especial, toda conta de usuário possui uma "homepage principal", que pode ser
chamada como

http://nomedoservidor.br/~nomedousuario

ou seja, sem o nome da página.  Isso é muito simples: basta dar um nome
predefinido a ela, que em grande parte dos servidores é a index.html ou
home.html

(Nota: não é possível com o programa intervox gerar um arquivo com extensão
html, apenas htm.  Mas é a mesma coisa, basta gerar um htm, e ao mover para
o servidor o arquivo trocar a extensão para html durante o processo de ftp).

5. Convenções do texto criado em formato .PAG

    O texto .PAG usa o seguinte formato:

a) as primeiras linhas do arquivo são as informações sobre a página.  Elas contém
as seguintes palavras:

TÍTULO:
AUTOR:
EMAIL:
CABEÇALHO:

após a última linha, deve-se deixar uma linha em branco.

Nota:  Se qualquer destas linhas for omitida, o programa buscará no arquivo
\windows\dosvox.ini na seção [INTERVOX] essas informações.  Se estas também
não existirem ali, o programa assume alguns valores padrões.

b) em seguida vem o texto.

    O texto é teclado normalmente.  Os parágrafos são indicados pela existência
de uma linha em branco, pelo menos.

    O texto é formatado unindo-se todas as linhas, uma após outra, até encontrar
uma linha em branco.  Quando necessário pular de linha (ou seja, não permitir
que a próxima seja juntada com a anterior), deve-se deixar um espaço em branco
ao início da linha.  Este espaço solitário não é copiado para a saída.

    Sempre que se deseje, pode-se colocar um subtítulo.  Para isso, basta colocar
no primeiro caractere da linha o caractere * (asterisco), seguido do texto do título.
Essa e outras marcações são explicadas a seguir

6. Marcações especiais do texto

    As marcações são letras especiais colocadas ao início da linha.  São as
seguintes:

*  indica que o texto que sucede esta letra é um subtítulo
$  indica que o texto que sucede esta letra é a referência a uma foto ou figura
   (por exemplo um arquivo .jpg ou .gif) seguido do nome que aparecerá no browser
   quando o mouse passa sobre a foto, ou é lido pelos browsers alfanumericos
   como webvox para descrever a figura.
   Após esta informação, deve-se incluir um sinal $.
   Depois desta informação,
{  indica que o texto a seguir é o nome de uma referência externa (um elo para
   outra homepage ou arquivo) seguido do nome que aparecerá no browser.  Após
   esta informação, deve-se incluir um sinal }.
   Nota: esta informação deve estar contida toda numa única linha do texto.
#  Indica que este ponto do texto é uma "referência local", ou seja, um lugar
   que será referenciado como {#nome em outro lugar desta ou de outra homepage.
-----  (cinco ou mais tracinhos)  indica a colocação na saida de uma linha
   horizontal separadora (comando hr de html).

7. um exemplo:

Nota: Verifique no texto abaixo, quantos espaços existem ao início de cada
linha. Isso é muito importante !  As informações <i>...</i> e <b>...</b>
são comandos html muito usados, introduzidos para fazer um trecho itálico
ou negrito (bold face).

TÍTULO: Página tira-dúvidas
AUTOR: Bernard Condorcet Porto
EMAIL: bernard@nce.ufrj.br
CABEÇALHO: TIRE SUAS DÚVIDAS SOBRE O DOSVOX

   Esta é uma página de ajuda.  Selecione um dos itens abaixo
para usar melhor o seu Dosvox.

   {#1 Configuração do áudio}
   {#2 Utilização da Internet}

#1
*Configuração do áudio

Meu DOSVOX não está falando? Que será?

 1) Já verificou se suas caixinhas de som estão <b>plugadas</b> no lugar correto?
 2) Ao instalar o seu WINDOWS, você instalou os recursos multimídia?
 3) Já verificou se na pasta: "Programas/Acessórios/multimídia/Controle de volumes",
o volume referente à arquivos tipo ".WAV" não está zero (ou inibido)?
 4) Já verificou se no diretório "c:\windows", existe o arquivo "dosvox.ini"?
Caso contrário, copie-o do diretório "c:\winvox".

#2
*Utilização da Internet

 1) Você já abriu uma conta em um provedor de sua cidade?
 2) Você já configurou sua <i>rede DialUp</i>?
 3) Configure-a de forma que você possa se conectar ao seu provedor através de um
atalho de teclas; por exemplo: CONTROL+ALT+P.
 Obs: Você conseguirá isto através do programa: "criaicon.exe", que acompanha
seu pacote DOSVOX.

-----

$fotobernard.gif
Estamos sempre às ordens !
 Mande suas sugestões

Conheça minha
{http://caec.nce.ufrj.br/~bernard homepage}
na máquina caec !

--------- fim do exemplo --------
(a linha anterior não pertence ao arquivo).

8. O arquivo de modelo

    O Intervox cria a home page através de um modelo que pode ser modificado.
Desta forma ele pode ser adaptado para muitas situações.  O arquivo de modelos
original é o \winvox\intervox\modelo.mdl, e é referenciado em \windows\dosvox.ini

    Este arquivo contem comandos HTML em três seções

<<<CABEÇALHO>>>
<<<TÓPICO>>>
<<<ASSINATURA>>>

    Cada seção é terminada pela frase
<<<FIM>>>

    Dentro destas seções, podem ser colocadas algumas palavras
que são substituídas pelos valores lidos do texto:

[TÍTULO]
[CABEÇALHO]
[TÓPICO]
[EMAIL]
[AUTOR]

    Cuidado:  a edição deste modelo é muito sutil.  Uma mudança muito
leve pode produzir uma homepage altamente feia.  Desta forma, aconselha-se
não mudar o modelo, a não ser que voce conheça profundamente a linguagem
html.  Entretanto, mudanças leves podem ser facilmente feitas, como
por exemplo:

. mudança dos ícones e figuras usadas
. mudança do tipo de letra global
. inclusão de informações fixas de uma instituição
. inclusão de uma linha
  <bgsound=...arquivo de som ...> para ativar um som da homepage

entre muitas outras.
