Skip to content

The Stephanie's work around the functional documentation of Silverpeas #1

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 9 commits into
base: master
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 4 additions & 4 deletions pom.xml
Original file line number Diff line number Diff line change
Expand Up @@ -44,7 +44,7 @@


<properties>
<wikbook.version>0.9.40</wikbook.version>
<wikbook.version>0.9.42-SNAPSHOT</wikbook.version>
<silverpeas.version>${project.version}</silverpeas.version>
<wikbook.source>${pom.basedir}/src/main/wikbook</wikbook.source>
<wikbook.target>${project.build.directory}/wikbook</wikbook.target>
Expand Down Expand Up @@ -73,7 +73,7 @@
</execution>
</executions>
<configuration>
<sourceDirectory>${wikbook.source}/en/en-US</sourceDirectory>
<sourceDirectory>${wikbook.source}/fr/fr-FR</sourceDirectory>
<extraSourceDirectory>${wikbook.target}/man</extraSourceDirectory>
<sourceFileName>book.wiki</sourceFileName>
<destinationDirectory>${wikbook.target}/src</destinationDirectory>
Expand Down Expand Up @@ -124,8 +124,8 @@
<calloutsExtension>1</calloutsExtension>
<!-- Copy any docbook XML -->
<preProcess>
<copy todir="${wikbook.target}/src">
<fileset dir="${wikbook.source}/en/en-US">
<copy todir="${wikbook.target}/src">
<fileset dir="${wikbook.source}/fr/fr-FR">
<include name="**/*.xml" />
</fileset>
</copy>
Expand Down
7 changes: 7 additions & 0 deletions src/main/wikbook/fr/fr-FR/abonnement.wiki
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
[[haut>>#haut]]

Permet de créer des abonnements sur le plan de classement.
Sur l'onglet "Dossiers", l'utilisateur consulte de façon centralisée tous ses abonnements aux dossiers de toute la plateforme.
Les abonnements aux dossiers sont supprimables depuis cet onglet.

[[retour>>#abonnement]]
35 changes: 35 additions & 0 deletions src/main/wikbook/fr/fr-FR/admin.wiki
Original file line number Diff line number Diff line change
@@ -0,0 +1,35 @@
[[haut>>#haut]]

= Comment sont gérés les droits ? =

Silverpeas propose une gestion fine des droits à plusieurs niveaux. Il existe des administrateurs généraux, des administrateurs d'espace, des gestionnaires d'applications.
Sur ces dernières, il existe également des profils Publieurs, Rédacteurs et Lecteurs. Il est évidemment possible d'affecter les droits à des groupes et/ou à des utilisateurs.
Silverpeas préconise fortement l'utilisation des groupes pour gérer les droits.
Silverpeas permet une gestion décentralisée du portail et offre une réponse fiable au problème de « goulet d'étranglement » souvent rencontré avec d'autres solutions.

[[retour>>#admin]]

= Quelle est la granularité des droits ? =

Il est possible de définir des droits sur les espaces afin que toutes ses applications héritent de ses droits.
Il est possible de « couper l'héritage » pour définir des droits spécifiques à un sous espace ou à une application.
Chaque application met en œuvre ses propres droits. Dans l'application Gestion documentaire, les droits peuvent être affinés au niveau des dossiers.

[[retour>>#admin]]

= Est-il possible d’assigner des thèmes différents (code couleur) en fonction de la navigation à l’intérieur du portail (ex une couleur par service) ? =

Oui, il est possible d'assigner un thème (décliné du look du portail) à n'importe quel espace de n'importe quel niveau.
Ceci est réalisé depuis le back-office et sans connaissances techniques particulières.

[[retour>>#admin]]

= Peut-on ajouter des documents par l’intermédiaire d’un webservice, d’une API, par l’envoi d’un mail ? =

Actuellement, il est possible d'ajouter des documents par l'intermédiaire du moteur d'import. L'importation peut être réalisée à la demande ou de manière périodique et automatique.
Cela est idéal pour intégrer des documents sans développement particulier.
Silverpeas est en train de s'enrichir de services web de type REST. Actuellement, ils permettent seulement la lecture. Ils permettront bientôt l'écriture.
Nous envisageons également d'enrichir la gestion documentaire en pouvant associer une adresse mail à un dossier.
L'envoi d'un fichier à l'adresse mail générera une publication contenant le fichier transmis par mail.

[[retour>>#admin]]
31 changes: 31 additions & 0 deletions src/main/wikbook/fr/fr-FR/agenda.wiki
Original file line number Diff line number Diff line change
@@ -0,0 +1,31 @@
[[haut>>#haut]]

Chaque utilisateur dispose de son agenda personnel. L'utilisateur crée des événements privés ou publics.
Il peut inviter d'autres utilisateurs après avoir identifié leurs disponibilités respectives.
Le catalogue des applications propose un « Almanach » plus collaboratif.

= Est-il possible de faire un lien avec l’agenda Outlook de l'utilisateur (synchronisation des informations) ? =

Oui, il est possible de synchroniser l'agenda personnel avec l'agenda Outlook de l'utilisateur (synchronisation depuis le poste client).

[[retour>>#agenda]]

= Est-il possible de faire un lien avec le serveur MDaemon qui héberge les agendas de chacun ? =

Non, malheureusement l'API offerte par MDaemon est assez pauvre.
Nous savons nous interfacer avec des serveurs tels que MS Exchange ou Zimbra mais MDaemon n'offre pas une interface moderne et de haut niveau permettant une intégration dans le portail.

[[retour>>#agenda]]

= Est-il possible de générer des événements et de donner la possibilité aux utilisateurs de s’y inscrire ? =

Actuellement non.

[[retour>>#agenda]]

= Est-il possible de filtrer et d’effectuer des recherches sur l’agenda ? =

Oui, il est possible de filtrer les événements sur l'agenda selon leurs types.
Il n'y a pas de recherche embarquée dans l'agenda mais les événements sont retrouvables via le moteur de recherche global.

[[retour>>#agenda]]
14 changes: 14 additions & 0 deletions src/main/wikbook/fr/fr-FR/almanach.wiki
Original file line number Diff line number Diff line change
@@ -0,0 +1,14 @@
[[haut>>#haut]]

Les différentes vues proposées présentent des événements ponctuels ou périodiques.
L’application permet l’agrégation et l’accès rapide vers d’autres almanachs.
Tous les événements peuvent être exportés au format iCal.

= Est-il possible de regrouper dans un même agenda tous les événements concernant un utilisateur (agenda global de son service, du ou des projets dont il fait partie) ? =

L'application « Almanach » peut être agrégée afin de regrouper les événements de plusieurs autres almanachs.
Il est ensuite possible de filtrer les événements affichés selon leurs provenances (service, projet).
Seuls les almanachs visibles par l'utilisateur et donc les événements accessibles sont affichés dans cette agrégation.

[[retour>>#almanach]]

87 changes: 87 additions & 0 deletions src/main/wikbook/fr/fr-FR/blog.wiki
Original file line number Diff line number Diff line change
@@ -0,0 +1,87 @@
[[haut>>#haut]]

Ce service permet de gérer le contenu d’un blog. Utile pour le suivi quotidien d’un projet par exemple.
Il permet de classer les billets par catégories et de laisser des commentaires.
Chaque utilisateur peut s’abonner et participer en laissant des commentaires. La gestion des catégories est possible. Les billets sont également accessibles via RSS.

= Comment mettre à disposition mon billet ? =

Par défaut, à la création, le billet est en mode brouillon, pour rendre disponible ce billet, il faut le publier.

[[image:images/BLOG-publier_1.jpg||height="100%" width="100%"]]

Une fois publié, ce billet est alors visible de tous les lecteurs du blog.

[[image:images/BLOG-publier_2.jpg||height="100%" width="100%"]]

{{important}}
Une fois publié, le billet reste modifiable par tous les blogueurs, toutefois il ne peut plus être repassé en brouillon.
{{/important}}

[[retour>>#blog]]

{{anchor id=categorie /}}
= Comment ordonner mes billets ? =

Afin de pouvoir ordonner les billets, il existe, dans le blog, la notion de catégorie.
A la création d'un billet (mais aussi en modification) sur la page d'entête la liste des catégories existantes est disponible.

Pour un billet classé, sa catégorie est visible en bas de ce dernier.

[[image:images/BLOG-categorie_2.jpg||height="60%" width="60%"]]

Il est alors possible de réduire le nombre de billets affiché, à une catégorie. Pour cela il suffit de cliquer sur le libellé de la catégorie :
* dans le bas d'un billet
* dans la liste des catégories
[[image:images/BLOG-categorie_4.jpg||height="25%" width="25%"]]

Pour ne voir afficher que les billets classés sur cette dernière.

[[image:images/BLOG-categorie_5.jpg||height="100%" width="100%"]]

[[retour>>#blog]]

= Comment gérer les catégories ? =

La gestion des catégories est indépendante pour chaque instance de blog.
L'accès se fait
* directement en cliquant sur l'icône //catégorie// [[image:images/BLOG-categorie_6.jpg||height="25%" width="25%"]]
* en choisissant l'option //Gérer les catégories// dans le menu //Que voulez-vous faire ?//

L'ajout d'une catégorie se fait avec l'opération //Ajouter une catégorie// du menu //Que voulez-vous faire ?//
La modification et/ou la suppression des catégories existantes se fait via les icônes [[image:images/modif.jpg]] et [[image:images/suppression.jpg]]

Une fois créées, les catégories peuvent être ordonnées pas simple déplacement par glisser/déposer.

[[image:images/BLOG-categorie_7.jpg||height="100%" width="100%"]]

Ce nouvel ordre, sera alors disponible pour les lecteurs.

[[image:images/BLOG-categorie_8.jpg]]

[[retour>>#blog]]

= Comment retrouver un billet ? =

Il existe plusieurs façons de chercher un billet :
* par une expression plein texte
pour cela il existe une zone de recherche [[image:images/BLOG-recherche_1.jpg]]
* par catégorie
Si la [[catégorie>>#categorie]] est connue, une restriction sur cette dernière permet de réduire le nombre de billet
* par date

De la même façon, si la date du billet est connue, il est très facile de faire afficher les billets relatifs à une date.

Il est possible de sélectionner le mois voulu à partir des archives

[[image:images/BLOG-recherche_2.jpg]]

ou en se déplaçant dans le calendrier

[[image:images/BLOG-recherche_3.jpg]]

Les jours contenant un ou plusieurs billets sont signalés (ces derniers sont cliquables pour afficher les billets de ce jour).

[[image:images/BLOG-recherche_4.jpg]]

[[retour>>#blog]]
Loading