Skip to content
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

Release 1.0.0 : décollage vers les astres 🚀 #56

Draft
wants to merge 41 commits into
base: master
Choose a base branch
from
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
41 commits
Select commit Hold shift + click to select a range
e592f02
Ignition with astro 🚀
goulvenclech Nov 27, 2022
8b777bb
refactor(routing): wip dynamic page routing & wip Courses
goulvenclech Dec 7, 2022
f1bcd4e
fix(courses): better typing
goulvenclech Dec 7, 2022
79e1361
feat(routing): wip getStaticPathFromContentType & wip Chapter
goulvenclech Dec 7, 2022
c5e026d
update(config): Updated formatting config
Princesseuh Dec 12, 2022
8096d19
refactor(content): markdown to mdx
aureliendossantos Dec 12, 2022
9f23c39
refactor(routing): Chapters & Courses, add Pages
goulvenclech Dec 12, 2022
058bb2a
style: Format every file
Princesseuh Dec 12, 2022
28bde21
feat(shiki): Add Ren'py language definition
Princesseuh Dec 12, 2022
333abe2
fix(content): Fix some syntax mistakes causing MDX to crash
Princesseuh Dec 12, 2022
7586a9d
feat(routing): Implement routing for courses, chapters and pages
Princesseuh Dec 13, 2022
75b7beb
config(prettier): Ignore MDX files and TextMate grammars
Princesseuh Dec 13, 2022
079b50e
chore(shiki): Add license for Ren'Py's language definition
Princesseuh Dec 13, 2022
637ee51
fix(pages): Fix getPagesForChapter returning pages in other chapters …
Princesseuh Dec 13, 2022
462569a
fix(glob): Add a safeguard around `getContentForPath` to prevent cras…
Princesseuh Dec 13, 2022
5a708da
feat(frontmatter): Add `url` property to BaseFrontmatter
Princesseuh Dec 13, 2022
01fc1e4
refactor(pages): Remove unintended plural in `getPagesForChapter`
Princesseuh Dec 13, 2022
1597fc5
feat(nav): Add left navigation menu to navigate throughout a course's…
Princesseuh Dec 13, 2022
fc107bc
fix(content): Fix wrongly named file in itchio course
Princesseuh Dec 13, 2022
b75b320
feat(content): Update contribution docs for Astro
aureliendossantos Dec 13, 2022
596db3b
feat(content): Setup autoimports of components commonly used in content
Princesseuh Dec 13, 2022
606723b
feat(assets): Add Image and Video components for usage of respective …
Princesseuh Dec 14, 2022
66aade7
feat(remark): Add Remark plugin to allow for relative links to assets…
Princesseuh Dec 14, 2022
a605761
fix(pico-8): Fix chapter.mdx with wrong file extension
Princesseuh Dec 14, 2022
5203ebc
feat(style): Add pixelated class for pixelated image rendering
Princesseuh Dec 14, 2022
0e1509f
feat(content): Use Image component everywhere
aureliendossantos Dec 14, 2022
f7f4de7
fix(content): Fix wrong file extension for chapter.mdx files in Pico-…
Princesseuh Dec 14, 2022
9295e40
fix(build): Add workaround to make images work in build
Princesseuh Dec 14, 2022
8690a74
fix(build): Fix image path in copy script
Princesseuh Dec 14, 2022
1d881c4
fix(avatars): Add missing assets for bubbles
Princesseuh Dec 14, 2022
fa06f10
feat(content): Use Video component everywhere
aureliendossantos Dec 14, 2022
142ff75
feat(video): Add support for posters
Princesseuh Dec 14, 2022
5e21995
feat(content): YouTube component
aureliendossantos Dec 14, 2022
c708016
fix(video): Wrong caption
aureliendossantos Dec 14, 2022
589972d
fix(assets): Generate hashed assets for Video and Posters to avoid co…
Princesseuh Dec 15, 2022
98d48cd
chore(deps): Upgrade deps
Princesseuh Dec 15, 2022
de17e0c
fix(build): Fix videos not working in build
Princesseuh Dec 15, 2022
ee7b834
perf(netlify): Add cache headers
Princesseuh Dec 15, 2022
3883c65
chore: remove unnecessary file
Princesseuh Dec 15, 2022
8f563ee
perf(prefetch): Add quicklink for prefetching links in viewport
Princesseuh Dec 15, 2022
3850d9e
feat(content): New chapter 'Scripting in Ruby' in RPG Maker
aureliendossantos Dec 15, 2022
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
The table of contents is too big for display.
Diff view
Diff view
  •  
  •  
  •  
3 changes: 1 addition & 2 deletions .editorconfig
Original file line number Diff line number Diff line change
Expand Up @@ -2,8 +2,7 @@ root = true

[*]
end_of_line = lf
indent_style = space
indent_size = 4
indent_style = tab
charset = utf-8
trim_trailing_whitespace = true
insert_final_newline = true
81 changes: 0 additions & 81 deletions .eslintrc.js

This file was deleted.

30 changes: 21 additions & 9 deletions .gitignore
Original file line number Diff line number Diff line change
@@ -1,10 +1,22 @@
*.log
.cache
.DS_Store
src/.temp
node_modules
dist
# build output
dist/
.output/

# dependencies
node_modules/

# logs
npm-debug.log*

# environment variables
.env
.env.*
.vscode
.tool-versions
.env.production

# misc
.DS_Store
.tool-versions

# generated assets
public/assets/videos/*
public/assets/images/*
src/assets/placeholders/*
2 changes: 2 additions & 0 deletions .prettierignore
Original file line number Diff line number Diff line change
@@ -0,0 +1,2 @@
**/*.mdx
scripts/*.tmLanguage.json
18 changes: 18 additions & 0 deletions .prettierrc.cjs
Original file line number Diff line number Diff line change
@@ -0,0 +1,18 @@
/** @type {import("@types/prettier").Options} */
module.exports = {
printWidth: 100,
tabWidth: 2,
trailingComma: "es5",
semi: false,
plugins: ["./node_modules/prettier-plugin-astro", require("prettier-plugin-tailwindcss")],
astroAllowShorthand: false,
tailwindConfig: "./tailwind.config.cjs",
overrides: [
{
files: "*.astro",
options: {
parser: "astro",
},
},
],
}
4 changes: 4 additions & 0 deletions .vscode/extensions.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,4 @@
{
"recommendations": ["astro-build.astro-vscode"],
"unwantedRecommendations": []
}
11 changes: 11 additions & 0 deletions .vscode/launch.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,11 @@
{
"version": "0.2.0",
"configurations": [
{
"command": "./node_modules/.bin/astro dev",
"name": "Development server",
"request": "launch",
"type": "node-terminal"
}
]
}
5 changes: 5 additions & 0 deletions .vscode/settings.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
{
"files.associations": {
"*.mdx": "markdown"
}
}
30 changes: 2 additions & 28 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,32 +4,6 @@ FaireDesJeux.fr est un site collaboratif proposant des formations gratuites pour

Tout le monde peut participer au projet, que ce soit pour corriger une faute ou créer du contenu. Une [charte de qualité](https://fairedesjeux.fr/contribuer/avant-propos/charte/) permet de s'assurer que tout le monde avance dans une même direction, et une [page de référence](https://fairedesjeux.fr/contribuer/comment-contribuer/syntaxe-des-cours/) détaille la syntaxe Markdown ainsi que les fichiers à créer pour commencer l'écriture d'une nouvelle formation.

## Modifier une page rapidement
## V1

Depuis n’importe quelle page du site, cliquez sur *Modifier cette page* dans le sommaire de droite. Cela ouvrira le fichier correspondant dans le dépôt.

## Télécharger le site

### 1. Installer Node.js et npm

#### Windows
[Télécharger la version Current](https://nodejs.org/) et cocher "Install the necessary tools" durant l'installation.

#### Linux
`sudo apt install nodejs` pour la dernière version d'Ubuntu. [Autres distributions.](https://nodejs.org/en/download/package-manager/)

#### macOS
[Installer la version Current.](https://nodejs.org/)

### 2. Préparer le dépôt

1. `git clone --recursive https://github.com/gamedevalliance/fairedesjeux.fr`
2. `cd fairedesjeux.fr`
3. (`sudo`) `npm install` pour télécharger les dépendances dans le dossier.
4. (`sudo`) `npm install --global @gridsome/cli` pour installer Gridsome CLI.

Pour une marche à suivre plus détaillée et accessible aux néophytes, lisez le [guide du site](https://fairedesjeux.fr/contribuer/comment-contribuer/installer-le-site/).

### 3. DĂ©marrer un serveur local

`gridsome develop` démarre un serveur local à l'adresse `localhost:8080` pour voir vos changements en direct alors que vous travaillez.
En cours de refonte avec [Astro](https://astro.build/) 🚀
33 changes: 33 additions & 0 deletions astro.config.mjs
Original file line number Diff line number Diff line change
@@ -0,0 +1,33 @@
import mdx from "@astrojs/mdx"
import tailwind from "@astrojs/tailwind"
import AutoImport from "astro-auto-import"
import { defineConfig } from "astro/config"
import { remarkFixRelativeAssetLinks } from "./scripts/remark-relative-assets"
import renpyLang from "./scripts/renpyLang.mjs"

// https://astro.build/config
export default defineConfig({
site: "https://fairedesjeux.fr",
integrations: [
tailwind(),
AutoImport({
imports: [
{
"./src/components/content/Bulle.astro": [["default", "Bulle"]],
"./src/components/content/Callout.astro": [["default", "Callout"]],
"./src/components/content/Video.astro": [["default", "Video"]],
"./src/components/content/YouTube.astro": [["default", "YouTube"]],
"./src/components/Image.astro": [["default", "Image"]],
},
],
}),
mdx(),
],
markdown: {
shikiConfig: {
langs: [renpyLang],
},
extendDefaultPlugins: true,
remarkPlugins: [remarkFixRelativeAssetLinks()],
},
})
Original file line number Diff line number Diff line change
Expand Up @@ -5,4 +5,4 @@ description: "Voici par où commencer si vous souhaitez créer des jeux !"

Voici par où commencer si vous souhaitez créer des jeux !

`youtube:https://www.youtube.com/watch?v=LgAQWasSAXQ`
<YouTube id="LgAQWasSAXQ" />
Original file line number Diff line number Diff line change
Expand Up @@ -5,4 +5,4 @@ description: "La programmation peut souvent impressionner les débutants et déb

La programmation peut souvent impressionner les débutants et débutantes. Mais ce n'est pas forcément compliqué à apprendre, et ce n'est pas nécessaire dans tous les domaines de la création.

`youtube:https://www.youtube.com/watch?v=AAp3cNlJxCw`
<YouTube id="AAp3cNlJxCw" />
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ description: "Unity, Unreal Engine, GameMaker... Quel est le moteur de jeu qui v

Pour réaliser votre premier jeu, vous vous attendez peut-être à ce qu'il y ait un logiciel idéal, mais ce n'est pas toujours le cas. Chaque moteur a des avantages, des inconvénients, une interface et un style qui vous parleront plus ou moins. Ainsi, même s'il existe des logiciels plus populaires que d'autres pour chaque type de jeu, le choix du moteur est très subjectif. Il ne suffit pas de peser les pour et les contre : c'est aussi une question de *feeling*.

`youtube:https://www.youtube.com/watch?v=VfAM3z45tQU`
<YouTube id="VfAM3z45tQU" />

Une chose est sûre : si vous souhaitez faire du jeu vidéo votre métier, il vous sera très utile d'apprendre Unity ou Unreal Engine, les deux moteurs les plus utilisés dans l'industrie et le multimédia en général. Unity est plus accessible aux autodidactes, en raison des nombreux tutoriels sur Unity Learn ou sur YouTube. Unreal, quant à lui, est plus souvent enseigné en école.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -3,4 +3,4 @@ title: Apprendre des autres créateurs
description: "Quels sont les obstacles les plus courants dans le développement de jeux vidéo ?"
---

`youtube:https://www.youtube.com/watch?v=Cu_BSrnBXzo`
<YouTube id="Cu_BSrnBXzo" />
Original file line number Diff line number Diff line change
Expand Up @@ -14,6 +14,6 @@ opengraph_image: cover_wide

Vous avez envie de créer des jeux vidéo, mais vous débutez complètement et ne savez pas par où commencer ? Cette formation est faite pour vous !

Tous les jours sur notre [serveur Discord](https://discord.gg/RrBppaj), nous voyons de nombreux débutants se confronter aux mêmes problèmes et se poser les mêmes questions, ce qui nous avait poussé à écrire une *foire aux questions* sur notre ancien wiki, et à traiter plusieurs de ces sujets en vidéo.
Tous les jours sur notre [serveur Discord](https://discord.gg/RrBppaj), nous voyons de nombreux débutants se confronter aux mêmes problèmes et se poser les mêmes questions, ce qui nous avait poussé à écrire une _foire aux questions_ sur notre ancien wiki, et à traiter plusieurs de ces sujets en vidéo.

Aujourd'hui, nous vous proposons une formation complète, vous permettant à la fois de comprendre comment débuter sur des bonnes bases, choisir un moteur de jeu ou un logiciel de graphisme, progresser au fil des prototypes, ou tout simplement capturer votre écran pour montrer son projet aux autres. Bonne visite !
Original file line number Diff line number Diff line change
Expand Up @@ -33,7 +33,7 @@ Enfin, sachez que l'équipe de modération et les autres contributeurs et contri

Afin de permettre aux lecteurs et lectrices de connaître la qualité d'une formation, mais également aux contributeurs et contributrices de savoir quelles formations ont besoin d'être actualisées, nous avons mis en place un système de médailles accompagnées d'un commentaire justifiant cette note.

![](./medailles.png)
<Image src="medailles.png" alt="" />

La médaille **bronze** signale qu'une formation est obsolète et qu'elle ne correspond plus du tout à nos critères de qualité. Ces formations nécessitent souvent d'être complètement réécrites.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -23,8 +23,11 @@ C'est un dépôt, ou *repository* en anglais. Entre nous, on appelle simplement

Afin de tous nous coordonner et voir en un clin d'oeil les tâches à réaliser, il existe un système d'issues :

![Issue sur GitHub](./issue.png)
*https://github.com/gamedevalliance/fairedesjeux.fr/issues*
<Image
src="issue.png"
alt="Issue sur GitHub"
caption="https://github.com/gamedevalliance/fairedesjeux.fr/issues"
/>

Une issue permet de consulter une tâche à réaliser et d'écrire des commentaires, comme dans un mini-forum. Vous pouvez voir en un clin d'oeil le domaine concerné par l'issue, les personnes assignées à la tâche... Lorsque la tâche est terminée, on ferme l'issue, et elle est cachée de la liste principale.

Expand All @@ -44,17 +47,23 @@ Le repo original du site s'appelle `gamedevalliance/fairedesjeux.fr`. Dès qu'il

Ainsi, pour travailler sur le site, vous devez copier le repo sur votre profil : on appelle ça un fork. La première fois que vous souhaitez modifier une page, GitHub vous propose de créer un fork en un clic.

![](./bouton-creer-fork.png)
*Une explication détaillée des forks est également disponible.*
<Image
src="bouton-creer-fork.png"
alt=""
caption="Une explication détaillée des forks est également disponible."
/>

La page suivante vous permet d'Ă©diter le fichier, et vous confirme que vous vous situez dans une nouvelle branche de votre propre fork.

![](./message-fork-automatique.png)
<Image src="message-fork-automatique.png" alt="" />

Ecrivez votre modification, puis donnez un titre descriptif Ă  votre commit (votre changement).

![](./propose-file-changes.png)
*Un commit est un changement. Avec git, on peut consulter l'historique entier des commits et revenir dans le temps si nécessaire.*
<Image
src="propose-file-changes.png"
alt=""
caption="Un commit est un changement. Avec git, on peut consulter l'historique entier des commits et revenir dans le temps si nécessaire."
/>

L'écran suivant vous permettra de visualiser votre pull request et de la confirmer. Une pull request est une demande pour fusionner les nouveautés de votre fork avec le repo originel. Dès que vous envoyez une pull request, elle est publique et tout le monde pourra la consulter sur GitHub, même si elle n'est pas encore validée. Assurez-vous donc de bien lire la page avant de confirmer.

Expand Down
Loading