### Découverte de l’interface

#### Aides contextuelles

Outre les présentes pages d’aide générale, de nombreuses pages de l’administration disposent d’une aide contextuelle. Si JavaScript est disponible sur votre navigateur, elle se présente sur le côté de la page après avoir cliqué sur le lien Besoin d’aide ? (en haut à droite) ; si JavaScript n’est pas activé elle s’affiche en bas de la page concernée.

Sur chaque page de l’administration, vous retrouverez les mêmes volet en haut, menu principal et pied de page. (Les emplacements de chacun de ces éléments sont indiqués ici pour une consultation sur ordinateur ; sur un mobile ou une tablette, leur emplacement varie selon la place disponible.)

#### Bandeau haut

Le volet en haut de chaque page est composé de trois éléments :

##### Logo

Par défaut, ce logo est celui de Dotclear et son lien conduit vers l’accueil de l’administration. Toutefois, un·e gestionnaire de plate-forme peut choisir un autre logo et diriger le lien vers autre chose que l’accueil (en général la page d’accueil du service).

##### Blog(s)

Le premier élément situé après le logo indique le bloc dit actif, c’est-à-dire celui sur lequel vous êtes en train d’agir. Si vous avez plusieurs blogs sur la même installation, cette information figure dans un menu déroulant qui permet de permuter sur un autre blog.

Le lien suivant le nom du blog permet d’aller voir le blog dans une autre fenêtre ou un autre onglet.

##### Utilisateur

À l’extrême droite du volet haut, le lien Mon tableau de bord permet de revenir à l’accueil du blog.

Le lien suivant, Mes préférences dirige vers la page où vous pourrez modifier vos informations personnelles, configurer votre tableau de bord et choisir vos options d’interface et d’édition.

Étonnamment, le lien Déconnecter [votre login] permet de… se déconnecter, si si. (Chez Dotclear, on est trop forts en ergo.)

#### Menu principal

Le menu principal est situé à gauche de l’écran. Il peut être rétracté en cliquant sur sa bordure droite (puis déployé en cliquant sur cette même bordure).

Il conduit vers les différentes pages d’administration correspondant à vos permissions sur le blog actif. Quatre blocs le composent

- Mes Favoris liste les pages que vous avez désignées comme telles dans l’onglet Mon tableau de bord de Mes préférences. Si vous n’avez encore choisi aucun favori, cette liste correspond au set par défaut de Dotclear ou celui du ou de la gestionnaire de la plate-forme. Si vous ne souhaitez pas afficher ce bloc, décochez la case correspondante dans vos options de tableau de bord.
- Blog regroupe la liste de toutes les pages permettant l’alimentation et les réglages du blog actif, de la rédaction d’un article à la gestion de la médiathèque en passant par le choix de la présentation et autres paramétrages.
  Si vous ne possédez pas de droits d’administration sur le blog actif, il n’y a pas d’autre bloc après celui-ci dans le menu principal.
- Réglages système offre l’accès aux pages permettant d’administrer l’installation Dotclear : gestion des blogs, utilisateur·rice·s et langues disponibles, installation d’extensions, réglages système. Si vous possédez des droits sur plusieurs blogs mais ne disposez pas du statut de super administrateur·rice, il est constitué du seul item Blogs.
- Plugins permet d’effectuer les paramétrages des plugins installés. Si les réglages d’un plugin n’impactent qu’un blog à la fois, sa page d’administration est disponible depuis le bloc Blog, mais si les réglages ont des répercussions sur toutes les pages de l’installation ils figurent ici et ne sont accessibles qu’aux utilisateur·rice·s disposant des droits de super admin.

#### Pied de page

Une version gratuite de Dotclear est offerte à tout utilisateur·rice découvrant le secret du pied de page.

### Aide aux grands débutants

Si vous n’êtes pas familier avec l’univers des blogs, nous vous recommandons notre documentation (sommaire complet dans les onglets Documentation de cette page) ainsi que les tutoriels qui vous sont spécialement dédiés sur le blog abc Dotclear. Par exemple :

- Mon premier billet pas à pas
- Ma première sauvegarde
- Choisir un thème

Le forum est un lieu d’entraide convivial où aucune question n’est considérée comme stupide. N’hésitez pas à y participer pour demander de l’aide et – pourquoi pas – aider d’autres utilisateurs à votre tour.

Nous nous efforçons d’utiliser un vocabulaire compréhensible sans connaissances préalables. Toutefois si nous nous sommes laissés aller à employer un terme de jargon, vous en trouverez sans doute l’explication dans le glossaire de notre documentation en ligne.

### Documentation pour les utilisateur·rice·s

#### Alimentation du blog

- Billets
  - Création et édition
  - Informations du billet
  - Actions sur le billet
  - Commentaires et rétroliens d'un billet
  - Traitement par lots des billets
- Commentaires et rétroliens
  - Suivi
  - Gestion
- Catégories
  - Créer une catégorie
  - Éditer une catégorie
  - Supprimer une catégorie
  - Ordonner la liste des catégories
- Mots-clés (Tags)
  - Ajouter des mots-clés
  - Gestion des mots-clés
  - Supprimer des mots-clés
- Médias et pièces jointes
  - Créer un sous-répertoire
  - Ajouter des fichiers
  - Télécharger une archive zip du dossier courant
  - Modifier ou compléter les informations d'un fichier
  - Ajout direct de fichiers
  - Types de fichier particuliers
  - Pièces jointes
- Contenu du menu du blog (widgets)
  - Bandeau de navigation, volet d'extra
  - Les widgets par défaut
  - Ajouter/Supprimer un widget
  - Paramétrage des widgets
- Blogroll
  - Liste des liens
  - Ajouter un lien
  - Ajouter une catégorie de liens
  - XFN
  - Importer depuis un fichier OPML ou XBEL

#### Paramétrage et personnalisations

- Paramètres du blog
  - Informations du blog
  - Configuration du blog
  - Commentaires et rétroliens
  - Présentation du blog
  - Médias et images
  - Paramètres d'indexation
  - Antispam
  - LightBox
  - Enregistrer
  - Configuration avancée
- Mes préférences
  - Mon profil
  - Mes options
  - Mon tableau de bord
- Apparence du blog
  - Choisir un thème
  - Installer un thème
  - Personnaliser un thème
  - Éditeur de thème

#### Lectures complémentaires

##### Glossaire

- Tous ces mots mystérieux utilisés dans le web et pour Dotclear

##### Syntaxes de saisie

- Syntaxe wiki et correspondances HTML
- Aller plus loin

##### Syndication RSS, Atom

- Kesako ?
- Comment les mettre à disposition ?
- Comment s'abonner ?
- En savoir plus

#### Tutoriels

- abc dotclear, un blog spécialement dédié aux grand·e·s débutant·e·s.
- Tips, des tutoriels pour vous aider à personnaliser votre blog.

#### Entraide

- Le forum de Dotclear
- Questions fréquentes des utilisateur·rice·s

### Documentation pour les administrateur·rice·s

#### Installation et mise à jour

- Installation
  - Prérequis
  - Installation automatique
  - Installation « classique »
  - Assistant d’installation
  - Mise en place manuelle du fichier config.php
  - Fin de l’installation
  - Étapes suivantes
  - Multiblog
- Mise à jour
  - Préparatifs
  - Mise à jour automatique
  - Mise à jour manuelle du programme
  - Mise à jour de la base de données
  - Avec SQLite
  - Annexe : mise à jour d'une copie subversion
- Paramètres du fichier de configuration
  - Introduction
  - Paramètres
  - Ajouts au fichier
- Mise à jour de Dotclear 1.2 vers 2
  - Cas général
  - Si vous changez de serveur
- Migration d'un autre système de blog à Dotclear
- Installer en local
  - Windows
  - Mac OS X
  - Linux
- Installation de Dotclear avec IIS7

##### Annexe hébergeur·euse·s

- Hébergeur·euse·s
  - Documentations spécifiques
  - Hébergeur·euse·s supportant Dotclear
  - Panels d'installation
  - Tester votre hébergeur·euse

#### Administration

- Gestion des utilisateur·rice·s
  - Liste des utilisateur·rice·s existant·e·s
  - Créer un·e utilisateur·rice
  - Modifier un·e utilisateur·rice
  - Permissions de l'utilisateur·rice
- Installation optimisée
  - Installation de Dotclear
  - Isoler les plugins
  - Créer les bases du blog
  - Créer le blog
  - Les thèmes et les médias
  - Et l’administration dans tout ça ?
- Installation multiblogs
- Gestion des extensions
  - Installer une extension
  - Configuration des extensions
  - Suppression d'une extension
  - Mettre à jour une extension
- Blowup, le thème par défaut
  - Styles prédéfinis
  - Je style mon Blowup
  - Contraintes
- Autre apparence
  - Choisir un thème
  - Installer un thème
  - Personnaliser un thème
  - Éditeur de thème
- Configuration avancée

#### Gestion et maintenance

- Sauvegarde et restauration
  - Import/Export
  - Médias
  - Base de données
- Filtre de commentaires indésirables
  - Organisation des filtres
  - Configuration des filtres

#### Entraide

- Le forum de Dotclear
- Questions fréquentes des administrateur·rice·s

### Documentation et ressources pour les développeur·euse·s

#### Design & Thèmes

- Thèmes
  - Guide d'utilisation des thèmes
  - Les balises template
  - Annexes
- L'héritage des thèmes
  - L'héritage des thèmes
  - Principe
  - Limitations
  - Mise en œuvre
- Les balises de template
  - Généralités / utilitaires
  - Blog
  - Billets
  - Pagination des billets
  - Commentaires
  - Prévisualisation d'un commentaire
  - Rétroliens
  - Pièces jointes
  - Catégories
  - Tags
  - Archives
  - Langues
  - Système
  - Widgets

#### Code & Plugins

- Création d’une balise tpl pour un plugin ou un thème
  - Introduction
  - Les valeurs
  - Les blocs d'instruction
  - Démonstration de l'influence du cache des templates
- Plugins
  - Réalisation de plugin
  - Documents annexes
- Construire l'aide contextuelle d'un plugin
- Authentification externe
  - Préambule
  - Une nouvelle classe d'authentification
  - Scénario
  - Application
- Interface XML/RPC
- Documentation de l'API

#### Contribution & Support

- Contribuer
  - Améliorer la documentation
  - Où envoyer vos œuvres?
  - Rapporter les bugs ou proposer une amélioration
  - Suggestions
  - Traduction
- Le dépôt du code source de Dotclear
- Le forum de Dotclear

#### Lectures complémentaires

- Tips, des tutoriels pour vous aider à développer.

#### Conventions

- Conventions de codage
- Charte des pages de l'administration

### Accessibilité et ergonomie

L'interface de Dotclear répond à la quasi totalité des critères WCAG 2.0 ; un reporting précis sera prochainement publié sur le blog du projet. À terme nous aimerions également répondre pleinement aux critères ATAG 2.0.

L'accessibilité et l'ergonomie sont au cœur des préoccupations de l'équipe Dotclear. Nous menons régulièrement des analyses avec l'aide d’expert·e·s et procédons continuellement à des correctifs et améliorations.

Vous pouvez nous aider dans cette tâche en ouvrant des tickets ou en participant au forum pour nous faire part des difficultés que vous rencontrez pour utiliser l'interface. Vous pouvez également y proposer de participer à des tests utilisateur·rice·s ou de rejoindre notre équipe.