Allow write-ups instead of videos
continuous-integration/drone/push Build is passing Details

This commit is contained in:
nemunaire 2021-10-25 10:09:30 +02:00
parent eeba333518
commit 4ceb66fa2a
3 changed files with 60 additions and 5 deletions

View File

@ -18,7 +18,8 @@ doivent respecter une certaine arborescence que voici :
│ ├── finished.txt (opt.)
│ ├── links.txt
│ ├── overview.txt
│ ├── resolution.mp4
│ ├── resolution.txt (choice)
│ ├── resolution.mp4 (choice)
│ ├── statement.txt
│ ├── hints/ (opt.)
│ │ ├── DIGESTS.txt
@ -113,7 +114,7 @@ Vous pouvez insérer des images dans tous les textes :
![alt](path title)
Le chemin *doit* être un chemin _absolu_ vers l'image, considérant la racine
comme étant le dossier du scémario (pour l'overview du thème) ou de l'exercice
comme étant le dossier du scénario (pour l'overview du thème) ou de l'exercice
(pour les autres textes).
![Rendu overview.txt](scenario_overview_public.png)
@ -168,9 +169,15 @@ envie au public de lire plus en détail.
![Rendu overview.txt](exercice_headline.png)
### `resolution.mp4`
### `resolution.mp4`/`resolution.txt`
Voir la [page dédiée]({{<relref "resolution">}}).
Afin que les participants et les organisateurs puissent avoir un aperçu de la
méthode de résolution attendu de votre défi, vous devez rédiger un article ou
réaliser une vidéo dans lequel vous décrivez ou montrer chaque étape permettant
de conduire aux différents *flags*.
Voir la page dédiée [aux vidéos]({{<relref "resolution">}}) ou [aux
*write-ups*]({{<relref "write-up">}}).
### `statement.txt`

View File

@ -4,6 +4,11 @@ title: resolution.mp4
weight: 35
---
Ce fichier doit contenir la vidéo permettant la résolution du défi et suivant
étape par étape les étapes expliquées. Si vous pensez qu'un article est plus
approprié, vous pouvez remplacer ce fichier par [`resolution.txt`]({{<relref
"write-up">}})
Ce fichier doit contenir la vidéo de résolution, montée selon ces caractéristiques :
- format MP4 (H.264 + AAC + 3GPP Timed Text)
@ -32,7 +37,7 @@ Les vidéos de résolution sont affichées uniquement sur la version du site sta
## Tuto de création de vidéo de résolution
{{% notice info %}}
{{% notice note %}}
Section contribuée par Mahe Charpy.
{{% /notice %}}

43
content/files/write-up.md Normal file
View File

@ -0,0 +1,43 @@
---
date: 2021-10-25T09:48+02:00
title: resolution.txt
weight: 34
---
Ce fichier doit contenir les explications détaillées permettant la résolution
du défi. Si vous pensez qu'une vidéo est plus appropriée, vous pouvez remplacer
ce fichier par [`resolution.mp4`]({{<relref "resolution">}})
Votre article doit respecter les caractéristiques suivantes :
- être écrit en [Markdown](https://spec.commonmark.org/0.30/) et peut être
complété par [des extensions
courantes](https://github.com/russross/blackfriday/tree/v2#extensions) ;
- être rédigé en français (préféré) ou en anglais ;
- être structuré avec un titre et des sections (une section par grande étape) ;
- contenir au moins 1 capture d'écran par étape de résolution : pour quelqu'un
qui connaît les outils, la seule analyse de vos captures d'écran devrait
permettre de reproduire chaque étape ;
- le texte, présenté avant l'image correspondante, doit expliquer et détailler
la démarche d'avancée dans la résolution.
N'hésitez pas à encadrer ou à mettre en valeur les flags ou les éléments
importants sur les captures d'écran.
N'hésitez pas non plus à donner des liens vers des articles techniques expliquant
plus en détail vos techniques. Insérez plutôt ses liens au sein de la section
concernée plutôt qu'à la fin.
### Captures d'écran et image
Vous pouvez insérer des images comme ceci :
![alt](path)
Vous *pouvez* mettre vos images dans un sous-dossier `resolution/` pour ne pas
encombrer le dossier du défi.
## Rendu
{{% notice note %}}Il s'agit d'une nouvelle fonctionnalité, le rendu est encore
à l'étude.
{{% /notice %}}