Perguntas frequentes e solução de problemas
Perguntas gerais
O que eu preciso para usar o BookStax?
Um servidor BookStack auto-hospedado e um token de API. Você cria o token no BookStack, no seu perfil → API Tokens (Token ID e Token Secret).
O que é o BookStax Pro?
O BookStax Pro é uma compra única (sem assinatura). Ele libera cinco coisas: editar páginas sem conexão (as alterações são sincronizadas assim que você volta a ficar online), três temas de leitura adicionais (Reading, Coding, Writing), uma cor de destaque livremente escolhível, uma cor própria por perfil de servidor e quantos perfis de servidor você quiser — sem o Pro, é apenas um servidor. Ler, pesquisar e editar online continuam gratuitos.
Consigo ler meus conteúdos também sem conexão?
Sim, a busca em texto completo e os conteúdos já baixados funcionam offline. Para editar e sincronizar é necessária uma conexão com o servidor.
Dados são enviados para o desenvolvedor?
Não. O BookStax se conecta exclusivamente ao seu próprio servidor. O token fica no chaveiro do iOS, não há nuvem nem rastreamento.
Solução de problemas
O servidor de repente rejeita meu token de API
Esse erro foi corrigido desde a versão 1.4.3 — atualize o app para a versão mais recente. Se o banner continuar aparecendo, cadastre o Token ID e o Secret novamente nos Ajustes.
Ao editar uma página, o editor fica vazio
Páginas criadas no editor rich-text da web do BookStack são convertidas automaticamente para Markdown desde a versão 1.4.3 e abrem normalmente. Uma atualização do app resolve isso.
Alguns livros ou páginas estão faltando
O token de API herda as permissões do seu usuário no BookStack. Se faltar conteúdo, verifique as permissões desse usuário no servidor — o que ele não pode ver lá também não aparece no app.
Um banner de login aparece repetidamente
Isso indica credenciais perdidas ou inválidas. Toque no banner para ir direto aos Ajustes e cadastre novamente a URL do servidor e o token.
As alterações não aparecem no servidor
Verifique a conexão e se seu token tem permissão de escrita. Puxe a tela para baixo para atualizar, para que o estado atual do servidor seja carregado.