Ajuda:Navegação automática

Esta página é somente um esboço. Ampliando-a você ajudará a melhorar o Wikilivros.

Anatomia do código

Uma lista de como funciona a navegação...

• {{livro}} (atalho para saída em diversos formatos de texto, futuramente também impressão - sem relação direta com o código)
• Categoria:Todos os livros catalogados (índices servem de base para criação das listas)
• meta:User:He7d3r/Tools/BookTools.js (converte os índices em listas - instável para meros mortais)
• Especial:Índice por prefixo/Wikilivros:Livros (listas)
• Módulo:Book (Processa as listas e transforma em um vetor que pode ser utilizado de diferentes maneiras)
• Função navegação (detecta a posição de uma capítulo da lista e navega por posições relativas, por exemplo pode-se subtrair ou somar posições, se a páginas está na posição 3: -2 resulta 1, -1 resulta 2, +1 resulta 4, +2 resulta 5 e assim por diante.
  • Atalhos
    • {{Anterior}} (atalho)
      • Dependências:
        • {{EXISTBASEPAGENAME}}
        • {{EXISTSUBPAGENAME}}
    • {{Posterior}} (atalho)
      • Dependências:
        • {{EXISTBASEPAGENAME}}
        • {{EXISTSUBPAGENAME}}
  • {{Navegação automática}} (aplicação)
    • Mediawiki:Common.css (UX)
    • MediaWiki:Gadget-AutoNav.js (UX)
• Função impressão
  • {{Versão para impressão automática}}

Características pendentes

Erros

• Retrocessos com relação a versão anterior (mw:Extension:ParserFunctions)
  • No primeiro módulo do livro, o link para o próximo capítulo encosta no link para o índice. Exemplo: Civilizações da Antiguidade/Como se faz a História Feito
  • Não mostra links vermelhos. Em Civilizações da Antiguidade/Chegada do homem às Américas, a página os astecas não existe. Além disso, ao clicar no link não aparece a caixa de texto para criar a página, como ocorre com links vermelhos normais. Feito
  • Causa timeout em livros grandes: Atualmente, as páginas de alguns livros grandes excedem o tempo alocado para a execução de scripts, e no lugar dos links da barra de navegação aparece apenas a mensagem de "Erro no script" (mesmo que não apareçam na Categoria:Páginas com erros de scripts, provavelmente porque a predefinição é incluída na interface do MediaWiki).
    • Exemplos: Livro de receitas/Acarajé, Guia do Linux/Iniciante+Intermediário/Comandos de rede/finger e Logística/Gestão de armazéns/Necessidades de espaço/Armazenagem aleatória (pesquisa no Google)
    • "Solução" temporária: processar apenas os primeiros 18000 caracteres da coleção (só faz diferença para 7 livros grandes)

Aprimoramentos

• Permitir alterações nos estilos da navegação
• Performace - Tornar o método de processamento das listas mais eficaz: Deveríamos explorar algumas variações e fazer testes (talvez como em w:en:User:Dragons flight/Lua performance) para obter um desempenho bom o bastante para que a navegação e a versão para impressão funcione em livros grandes. Algumas possibilidades:
  • O HTML da Predefinição:Navegação automática poderia ser gerado por uma função em Lua, a qual obteria os capítulos anterior e posterior realizando somente uma busca na lista de capítulos. Atualmente, parece que são realizadas 5 (!) buscas para obter o link anterior e outras 5 para obter o posterior.
  • ...?

Tópicos relacionados

• Tópico:Wikilivros:Diálogos comunitários/Índice do livro e lista de módulos
• Tópico:Wikilivros Discussão:Portal comunitário/Navegação automática
• Tópico:Wikilivros Discussão:Portal comunitário/Navegação automática/resposta (14) - Gambiarra para produzir versões para impressão em HTML