PROGRAMA ASSISTENTE PARA GERAÇÃO DE HOMEPAGES - MANUAL DE OPERAÇÃO SUMÁRIO 1) INTRODUÇÃO 2) O QUE É O EDITOR INTERVOX 3) FORMA GERAL DA HOMEPAGE 4) COMO CRIAR E PUBLICAR UMA HOMEPAGE SIMPLES NUM SERVIDOR 5) CONVENÇÕES DO TEXTO CRIADO EM FORMATO .PAG 6) MARCAÇÕES ESPECIAIS DO TEXTO 7) UM EXEMPLO 8) O ARQUIVO DE MODELO 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 possuía 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 navegadores mais usados no mercado: webvox e lynx, que são navegadores textuais, e Internet Explorer, netscape e opera, que são navegadores gráficos. Na internet as páginas se encadeiam, ou seja, uma faz referência a outra. Referenciar uma página na sua é 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, espera-se que uma pessoa com deficiência visual possa criar excelentes homepages, tanto em termos de conteúdo como aparência, incluindo nelas todo conhecimento e experiência pessoais. 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 contém 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 navegador local e garanta que ela funciona. Com o webvox, use a função a (arquivos) para carregar. Se você começou a inventar muito, chame também um vidente para que ele observe se você não fez um carnaval muito grande na tela (mesmo que auditivamente esteja perfeito). e) transporte para o servidor O arquivo gerado deve ser então movido para o servidor, usando, 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 chamá-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 pré-determinado 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. Se qualquer destas linhas for omitida, o programa busca 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ão. 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 aparece no navegador quando o mouse passa sobre a foto, ou é lido pelos navegadores alfanuméricos 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 aparece no navegador. Após esta informação, deve-se incluir um sinal }. a 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 saída de uma linha horizontal separadora (comando hr de html). 7) UM EXEMPLO: Verifique no texto abaixo, quantos espaços existem ao início de cada linha. Isso é muito importante ! As informações ... e ... 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 plugadas 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 rede DialUp? 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 homepage 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 contém comandos HTML em três seções <<>> <<>> <<>> Cada seção é terminada pela frase <<>> 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 você 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 para ativar um som da homepage entre muitas outras.