Programa assistente para gerao de homepages - Manual de Operao

1. Introduo

    A criao de homepages por pessoas com pouca vivncia de programao
at pouco tempo era sempre uma tarefa complexa: era necessrio conhecer
a linguagem html e uma srie de outros detalhes de relativa complexidade,
e assim, a criao de pginas ficava restrita a muito poucas pessoas.

    Recentemente, uma srie 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 no so
adequados para operao por deficientes visuais.

    O sistema DOSVOX desde h muito possuia uma ferramenta simples para
criao de homepages, o WWWVOX.   Essa ferramenta, entretanto, tinha uma
srie de limitaes, o que nos levou a criar este programa.

2. O que  o editor Intervox

    O editor Intervox permite criar pginas simples com quase nenhum trabalho,
gerando material atravs de pequenos acrscimos num texto digitado.  O programa
trabalha com "modelos" de homepage, que estabelecem a forma grfica (visual) que a
homepage ter, e desta forma, a qualidade gerada poder ser to complexa
quanto se deseje.

    As pginas geradas so compatveis com os browsers mais usados no mercado:
webvox e lynx, que so browsers textuais, e explorer, netscape e opera, que so
browsers grficos.

    Na internet as pginas se encadeiam, ou seja, uma faz referncia a outras.
Referenciar uma outra pgina na sua pgina  trivial, bem como criar uma
"rede de pginas".  Basta indicar o nome da pgina encadeada no texto, seguindo
uma conveno muito simples, que o intervox faz o resto.

    As homepages produzidas por este programa so eminentemente textuais,
podendo entretanto conter quaisquer elementos multimdia, como fotos,
msica ou filmes.  O modelo bsico fornecido permite a incluso de elementos
extras html (tags) misturados com o texto, fazendo assim com que o poder
de gerao seja amplo.

    Desta forma, se espera que uma pessoa com deficiencia visual possa criar
excelentes homepages, tanto em termos de contedo como aparncia, incluindo
nelas todo conhecimento e experincia pessoal.

3. Forma geral da homepage

    A homepage criada pelo intervox  composta por 3 partes:

a) o cabealho
     a parte superior da homepage, na qual pode-se incluir diversos elementos,
em especial o ttulo da homepage.

b) os tpicos
    So trechos de texto, acima dos quais existe um ttulo daquele tpico.

c) o rodap
     uma rea que contem o e-mail do autor e outras informaes teis.

    Os tpicos so a parte mais importante: eles contm as informaes que
se deseja comunicar.  Os tpicos, quase sempre so baseados em material escrito,
produzido pelo autor ou copiado de outras fontes.  Dentro dos tpicos  possvel
incluir figuras ou filmes, alm de elos (referncias externas, links) para outras
homepages ou para outras partes desta.

4. Como criar e publicar uma homepage simples num servidor

    Os passos so os seguintes:

a) digitao
    Digite um arquivo de texto com tipo .PAG, que descreveremos a seguir.  Este
arquivo contm 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) gerao no formato HTML
    Use o programa intervox para transformar o arquivo .PAG em arquivo .HTM, que
 um texto com marcaes bastante complexo, mas que ser produzido sem sua
interferncia.  Voc em momento nenhum precisa escrever em HTML, a menos que
queira fazer "coisas mirabolantes".

d) teste da pgina
    Use um browser localmente, e garanta que ela funciona.  Com o webvox,
use a funo a (arquivos) para carregar.

Nota:  Se voce comeou 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 ento movido para o servidor, utilizando, por
exemplo, um programa como o FTPVOX, em geral para dentro do espao da sua conta
neste servidor.

e) uso da homepage
    Uma vez que a homepage esteja no seu espao no servidor (geralmente  necessrio
coloc-la num diretrio da conta chamado public_html), o acesso externo  trivial,
basta chama-la atravs 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 usurio possui uma "homepage principal", que pode ser
chamada como

http://nomedoservidor.br/~nomedousuario

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

(Nota: no  possvel com o programa intervox gerar um arquivo com extenso
html, apenas htm.  Mas  a mesma coisa, basta gerar um htm, e ao mover para
o servidor o arquivo trocar a extenso para html durante o processo de ftp).

5. Convenes do texto criado em formato .PAG

    O texto .PAG usa o seguinte formato:

a) as primeiras linhas do arquivo so as informaes sobre a pgina.  Elas contm
as seguintes palavras:

TTULO:
AUTOR:
EMAIL:
CABEALHO:

aps 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 seo [INTERVOX] essas informaes.  Se estas tambm
no existirem ali, o programa assume alguns valores padres.

b) em seguida vem o texto.

    O texto  teclado normalmente.  Os pargrafos so indicados pela existncia
de uma linha em branco, pelo menos.

    O texto  formatado unindo-se todas as linhas, uma aps outra, at encontrar
uma linha em branco.  Quando necessrio pular de linha (ou seja, no permitir
que a prxima seja juntada com a anterior), deve-se deixar um espao em branco
ao incio da linha.  Este espao solitrio no  copiado para a sada.

    Sempre que se deseje, pode-se colocar um subttulo.  Para isso, basta colocar
no primeiro caractere da linha o caractere * (asterisco), seguido do texto do ttulo.
Essa e outras marcaes so explicadas a seguir

6. Marcaes especiais do texto

    As marcaes so letras especiais colocadas ao incio da linha.  So as
seguintes:

*  indica que o texto que sucede esta letra  um subttulo
$  indica que o texto que sucede esta letra  a referncia 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.
   Aps esta informao, deve-se incluir um sinal $.
   Depois desta informao,
{  indica que o texto a seguir  o nome de uma referncia externa (um elo para
   outra homepage ou arquivo) seguido do nome que aparecer no browser.  Aps
   esta informao, deve-se incluir um sinal }.
   Nota: esta informao deve estar contida toda numa nica linha do texto.
#  Indica que este ponto do texto  uma "referncia local", ou seja, um lugar
   que ser referenciado como {#nome em outro lugar desta ou de outra homepage.
-----  (cinco ou mais tracinhos)  indica a colocao na saida de uma linha
   horizontal separadora (comando hr de html).

7. um exemplo:

Nota: Verifique no texto abaixo, quantos espaos existem ao incio de cada
linha. Isso  muito importante !  As informaes <i>...</i> e <b>...</b>
so comandos html muito usados, introduzidos para fazer um trecho itlico
ou negrito (bold face).

TTULO: Pgina tira-dvidas
AUTOR: Bernard Condorcet Porto
EMAIL: bernard@nce.ufrj.br
CABEALHO: TIRE SUAS DVIDAS SOBRE O DOSVOX

   Esta  uma pgina de ajuda.  Selecione um dos itens abaixo
para usar melhor o seu Dosvox.

   {#1 Configurao do udio}
   {#2 Utilizao da Internet}

#1
*Configurao do udio

Meu DOSVOX no est falando? Que ser?

 1) J verificou se suas caixinhas de som esto <b>plugadas</b> no lugar correto?
 2) Ao instalar o seu WINDOWS, voc instalou os recursos multimdia?
 3) J verificou se na pasta: "Programas/Acessrios/multimdia/Controle de volumes",
o volume referente  arquivos tipo ".WAV" no est zero (ou inibido)?
 4) J verificou se no diretrio "c:\windows", existe o arquivo "dosvox.ini"?
Caso contrrio, copie-o do diretrio "c:\winvox".

#2
*Utilizao 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 atravs de um
atalho de teclas; por exemplo: CONTROL+ALT+P.
 Obs: Voc conseguir isto atravs do programa: "criaicon.exe", que acompanha
seu pacote DOSVOX.

-----

$fotobernard.gif
Estamos sempre s ordens !
 Mande suas sugestes

Conhea minha
{http://caec.nce.ufrj.br/~bernard homepage}
na mquina caec !

--------- fim do exemplo --------
(a linha anterior no pertence ao arquivo).

8. O arquivo de modelo

    O Intervox cria a home page atravs de um modelo que pode ser modificado.
Desta forma ele pode ser adaptado para muitas situaes.  O arquivo de modelos
original  o \winvox\intervox\modelo.mdl, e  referenciado em \windows\dosvox.ini

    Este arquivo contem comandos HTML em trs sees

<<<CABEALHO>>>
<<<TPICO>>>
<<<ASSINATURA>>>

    Cada seo  terminada pela frase
<<<FIM>>>

    Dentro destas sees, podem ser colocadas algumas palavras
que so substitudas pelos valores lidos do texto:

[TTULO]
[CABEALHO]
[TPICO]
[EMAIL]
[AUTOR]

    Cuidado:  a edio deste modelo  muito sutil.  Uma mudana muito
leve pode produzir uma homepage altamente feia.  Desta forma, aconselha-se
no mudar o modelo, a no ser que voce conhea profundamente a linguagem
html.  Entretanto, mudanas leves podem ser facilmente feitas, como
por exemplo:

. mudana dos cones e figuras usadas
. mudana do tipo de letra global
. incluso de informaes fixas de uma instituio
. incluso de uma linha
  <bgsound=...arquivo de som ...> para ativar um som da homepage

entre muitas outras.
