Home

Bienvenue sur ce mini-wiki, à destination des membres de l'association souhaitant profiter des services offert par le site internet.

##Services disponibles

• Annonces
• Hébergement de pages de compétitions

Annonces

Si vous faites partie de l'association et avez une annonce à diffuser concernant une compétition ou un projet de l'association, il est possible de l'ajouter sur la page d'accueil du site de l'AFS.

Dans la structure actuelle du site, chaque annonce ("news") est un fichier dans ce dossier, dont le nom suit un format prédéfini : yyyy-mm-dd-mon-titre.md. La date dans le nom de fichier sera celle utilisée pour l'annonce, le titre déterminera l'url pour accéder à votre annonce, mais pas le titre affiché sur votre annonce.

Il y a deux types d'annonces :

• Les courtes, constituées de quelques lignes, comme par exemple celle intitulée "Championnats de France 2016" sur la page d'accueil de l'AFS.
• Les longues, proposant un gros contenu, telle que cette annonce de la commission, et dont seul le premier paragraphe s'affiche sur la page d'accueil.

Le plus simple est de récupérer un fichier modèle pour votre annonce (par ici pour une annonce "courte", et par ici pour une "longue"), et de modifier la seule valeur pertinente du préambule du fichier : le titre, avant de remplacer le contenu par le votre !

Le format de fichier est le Markdown, très pratique pour mettre en forme simplement le texte, et dont la syntaxe est rapidement décrite ici. Si vous êtes plus à l'aise avec le html, sachez que vous pouvez également l'utiliser dans votre annonce, même si l'extension du fichier peut prêter à confusion !

Note particulière pour les annonces "longues" : par défaut le site prendra un certain nombre de caractères pour générer le résumé qui sera affiché sur la page d'accueil. Pour contrôler plus finement ce comportement, vous pouvez ajouter une séparation résumé/contenu dans votre annonce, en insérant la chaine de caractère {{post_excerpt}} à l'endroit où se termine votre résumé. Voir un exemple ici.

Une fois votre annonce rédigée, vous pouvez l'envoyer par mail à [email protected]; ou pour ceux à l'aise avec github, vous pouvez directement ouvrir une pull request.

Hébergement de pages de compétitions

TODO

Cette partie reste à rédiger, le principe est le même que pour une annonce : un fichier = une compétition, le format du titre est le même, et des exemples sont dans ce dossier.