Perguntas frequentes e resolução de problemas
Perguntas gerais
De que preciso para usar o BookStax?
De um servidor BookStack autoalojado e de um Token de API. Crias o token no BookStack, em Perfil → API Tokens (Token ID e Token Secret).
O que é o BookStax Pro?
O BookStax Pro é uma compra única (sem subscrição). Desbloqueia cinco coisas: editar páginas sem ligação (as alterações são sincronizadas assim que voltas a estar online), três temas de leitura adicionais (Reading, Coding, Writing), uma cor de destaque à tua escolha, uma cor própria por perfil de servidor e um número ilimitado de perfis de servidor — sem o Pro, é um servidor. Ler, pesquisar e editar online continuam gratuitos.
Consigo ler os meus conteúdos também sem ligação?
Sim, a pesquisa de texto completo e os conteúdos já transferidos funcionam offline. Para editar e sincronizar é necessária uma ligação ao servidor.
Os dados são transmitidos ao programador?
Não. O BookStax liga-se exclusivamente ao teu próprio servidor. O token fica no porta-chaves do iOS, não existe cloud nem monitorização.
Resolução de problemas
O servidor recusa de repente o meu Token de API
Este erro foi corrigido desde a versão 1.4.3 — atualiza a app para a versão mais recente. Se o aviso continuar a aparecer, insere novamente o Token ID e o Secret em Settings.
Ao editar uma página, o editor fica vazio
As páginas criadas no editor web do BookStack com texto formatado são, desde a versão 1.4.3, convertidas automaticamente para Markdown e abrem normalmente. Uma atualização da app resolve isto.
Faltam alguns livros ou páginas
O Token de API herda as permissões do teu utilizador BookStack. Se faltar conteúdo, verifica as permissões desse utilizador no servidor — o que ele não puder ver lá também não aparece na app.
Aparece sempre um aviso de início de sessão
Isto indica dados de acesso perdidos ou inválidos. Toca no aviso para ires diretamente a Settings e insere novamente o URL do servidor e o token.
As alterações não aparecem no servidor
Verifica a ligação e se o teu token tem permissões de escrita. Desliza a vista para baixo para atualizar, para que o estado atual do servidor seja carregado.