Allow write-ups instead of videos
continuous-integration/drone/push Build is passing
Details
continuous-integration/drone/push Build is passing
Details
This commit is contained in:
parent
eeba333518
commit
4ceb66fa2a
|
@ -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`
|
||||
|
|
|
@ -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 %}}
|
||||
|
||||
|
|
|
@ -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 %}}
|
Loading…
Reference in New Issue