Concepts de Base de l'outil BookStack
Principes : les éléments de base
BookStack, "Pile de Livre" en Anglais, est un outil qui organise nos informations à l'image d'une bibliothèque physique.
-
On dispose d'autant "d'Étagères" que l'on veut, dans lesquelles
-
on range autant de "Livres" que l'on veut,
-
qui contiennent autant de "Pages" simples que l'on veut,
-
et on peut regrouper ces pages en "Chapitres"
La seule particularité avec le "monde physique" est qu'un livre peut être rangé, référencé dans plusieurs étagères, ce qui n'est ni le cas de chapitres, ni le cas des pages.
C'est presque tout ce qu'il faut savoir pour commencer à utiliser l'outil.
Les boutons 
renvoient respectivement aux Catalogues des étagères et celui des livres déjà créés.
Principes : Les autorisations et le Collaboratif !
La question que l'on se pose toujours, c'est qui peut voir (lire), commenter, modifier, créer et supprimer les documents que l'on ajoute.
Chaque éléments (pages, chapitres, livre ou étagère) offre la possibilité de cocher les types d'autorisation que le propriétaire souhaite lui donner :
Il est donc possible de faire des éléments complètement "privés" que seul le créateur (et l'admin) peuvent voir. Cela peut-être commode pour des brouillons de travail qu'on ne veut pas encore partager en cours de travail par exemple.
Comme l'organisation des éléments est Étagère <- Livre <- Chapitre <- Page, il y à un mécanisme d'héritage (transfert) par défaut des droits du parent (contenant) aux enfants (contenus). Ce mécanisme d'attribution des droits d'accès n'est jamais prioritaire sur les droits définis directement sur l'élément.
Par exemple on peut créer un livre partagé avec tous, dans lequel certaines pages ou chapitres sont partagés avec tous par héritage des droits et seulement certaines pages ou chapitres sont rendus invisibles (privés) en cochant les droits plus spécifiques que l'auteur veut leur attribuer.
BookStack propose de travailler avec avec des "Rôles" qui sont attribués à chaque utilisateur.
Commençons par les Utilisateurs.
Il y a par défaut 4 type de rôles : Administrateur, Éditeur, Lecteur, Public
Les DIfférents Rôles par défaut
Administrator of the whole application
61 permissions
User can edit Books, Chapters & Pages
39 permissions
The role given to public visitors if allowed
9 permissions
User can view books & their content behind authentication
9 permissions
Le Public, c'est par défaut un visiteur qui n'a pas de compte sur le site et donc qui ne peut voir que les documents dont l'accès à été donné au public, qui n'a que le droit de 'voir' - lecteur
Par défaut, tous les utilisateurs connectés avec leur compte sont logiquement dans cette catégorie aussi.
Il est donc possible, par exemple, d'attribuer à toute une étagère le fait d'être ou ne pas être visible par le public qui consulte le site.