diff --git a/astro.config.mjs b/astro.config.mjs
index 0cf33da..b6c574a 100644
--- a/astro.config.mjs
+++ b/astro.config.mjs
@@ -22,16 +22,12 @@ export default defineConfig({
},
sidebar: [
{
- label: "Guides",
+ label: "Python",
items: [
// Each item here is one entry in the navigation menu.
- { label: "Example Guide", slug: "guides/example" },
+ { label: "Introduction", slug: "python/introduction" },
],
},
- {
- label: "Reference",
- autogenerate: { directory: "reference" },
- },
],
components: {
Header: "./src/components/Header.astro",
diff --git a/public/images/python-logo-generic.svg b/public/images/python-logo-generic.svg
new file mode 100644
index 0000000..116eaac
--- /dev/null
+++ b/public/images/python-logo-generic.svg
@@ -0,0 +1,269 @@
+
+
+
diff --git a/public/images/python-logo-snake-only.svg b/public/images/python-logo-snake-only.svg
new file mode 100644
index 0000000..467b07b
--- /dev/null
+++ b/public/images/python-logo-snake-only.svg
@@ -0,0 +1,265 @@
+
+
+
+
diff --git a/src/components/Navbar.astro b/src/components/Navbar.astro
index 9ea9f52..391239d 100644
--- a/src/components/Navbar.astro
+++ b/src/components/Navbar.astro
@@ -6,7 +6,7 @@ import type { Props } from "@astrojs/starlight/props"
-
Docs
diff --git a/src/content/docs/guides/example.md b/src/content/docs/guides/example.md
deleted file mode 100644
index ebd0f3b..0000000
--- a/src/content/docs/guides/example.md
+++ /dev/null
@@ -1,11 +0,0 @@
----
-title: Example Guide
-description: A guide in my new Starlight docs site.
----
-
-Guides lead a user through a specific task they want to accomplish, often with a sequence of steps.
-Writing a good guide requires thinking about what your users are trying to do.
-
-## Further reading
-
-- Read [about how-to guides](https://diataxis.fr/how-to-guides/) in the Diátaxis framework
diff --git a/src/content/docs/index.mdx b/src/content/docs/index.mdx
index 1ddc21f..90e06c2 100644
--- a/src/content/docs/index.mdx
+++ b/src/content/docs/index.mdx
@@ -18,7 +18,7 @@ hero:
icon: right-arrow
variant: secondary
- text: Qui suis-je ?
- link: /website/guides/example
+ link: https://www.linkedin.com/in/pierre-rochet
icon: external
variant: minimal
---
@@ -29,7 +29,7 @@ import { LinkCard, CardGrid, Badge } from "@astrojs/starlight/components"
une porte d'entrée vers l'univers de la data et de l'IA.
+
+En apprennant Python, vous serez rapidement en mesure de récupérer des données, les manipuler, les analyser, les transformer et bien plus encore. Avec de l'expérience vous serez capables de résoudre des problèmes complexes, une compétence esentielle dans le quotidien d'un ingénieur data.
+
+## A quoi vous attendre dans ce guide ?
+
+Ce guide d'apprentissage de la programmation Python est conçu pour tous, même si vous n’avez aucune expérience en programmation ou en informatique. Vous n’avez pas besoin de connaissances préalables pour commencer: tout sera expliqué de manière simple et progressive.
+
+Vous découvrirez ce qu’est Python, pourquoi il est utile, et comment l’utiliser pour créer des projets concrets. L’objectif est de vous donner les bases nécessaires pour réaliser vos propres idées, que ce soit pour un passe-temps, pour vos études ou pour votre travail. Vous apprendrez à lire, écrire, et comprendre du code.
+
+## Python c'est quoi ?
+
+Python est un langage de programmation, c’est-à-dire un outil qui permet de donner des instructions à un ordinateur pour qu’il réalise des tâches. Il a été créé pour être simple à comprendre et à utiliser, même pour les personnes qui n’ont jamais programmé auparavant. Sa façon d’écrire des instructions ressemble presque à de l’anglais, ce qui le rend idéal pour les débutants. Avec Python, vous pouvez créer des choses variées comme des sites web, des applications ou encore des programmes pour automatiser des tâches répétitives.
+
+Un des grands avantages de Python, c’est que vous pouvez tester vos idées immédiatement. Vous écrivez une commande, vous la faites fonctionner, et vous voyez tout de suite le résultat. C’est donc un très bon outil pour apprendre et expérimenter. En plus, il y a une grande communauté de gens partout dans le monde qui utilisent Python et partagent des astuces, des outils, et des solutions pour rendre les choses encore plus simples.
+
+## Un peu d'histoire ...
+
+Python a été créé au début des années 1990 par Guido van Rossum, un programmeur qui voulait inventer un langage à la fois puissant et facile à utiliser. Il s’est inspiré d’un autre langage informatique nommé ABC, et pour donner un nom à son projet, il a choisi "Python" non pas à cause du serpent, mais parce qu’il aimait les sketchs humoristiques des Monty Python, un célèbre groupe comique britannique.
+
+Depuis sa création, Python a beaucoup évolué pour s’adapter aux besoins modernes. Par exemple, en 2008, une nouvelle version appelée Python 3 est sortie, avec des améliorations pour le rendre encore plus efficace et pratique. Aujourd’hui, Python est utilisé dans plein de domaines différents comme la recherche scientifique, la création de logiciels ou encore l’intelligence artificielle.
+
+## Pourquoi apprendre Python ?
+
+Si vous êtes débutant et que vous voulez apprendre à programmer, Python est un excellent choix. Son écriture est simple et facile à lire, ce qui vous permet de vous concentrer sur ce que votre programme doit faire sans vous perdre dans des détails techniques compliqués. Par exemple, pour afficher un message, il suffit de taper quelques mots simples, et cela fonctionne.
+
+En plus d’être facile à apprendre, Python est aussi très utile dans beaucoup de métiers. Les entreprises l’utilisent pour analyser des données, créer des sites web, ou encore automatiser des tâches. Cela signifie que savoir utiliser Python peut vous ouvrir de nombreuses opportunités professionnelles.
+
+Python est aussi très flexible. Que vous vouliez créer un petit projet personnel, comme un programme qui organise vos tâches, ou quelque chose de plus grand, comme un logiciel utilisé par des milliers de personnes, Python peut s’adapter. C’est un outil idéal pour passer d’une idée à un projet concret.
+
+## Que peut-on faire avec Python ?
+
+### Python en data ingénierie
+
+Dans le domaine des données, Python est un choix très populaire. Il permet de trier, modifier, et organiser des informations facilement grâce à des outils comme Pandas ou NumPy. Imaginez que vous avez une grande liste d’informations désordonnées, comme les notes d’une classe ou des ventes dans un magasin. Avec Python, vous pouvez rapidement mettre de l’ordre et obtenir des statistiques utiles.
+
+Python est aussi très pratique pour les projets dans le "cloud", c’est-à-dire les services qui fonctionnent sur internet au lieu de votre ordinateur. Il est utilisé pour écrire des programmes qui manipulent de grosses quantités de données ou qui automatisent des processus. Cela en fait un outil apprécié par les ingénieurs qui travaillent avec beaucoup d’informations.
+
+### Python dans l'intelligence artificielle et le machine learning
+
+Python est aussi très important dans les domaines de l’intelligence artificielle (IA) et de l’apprentissage automatique (machine learning). Ce sont des technologies qui permettent aux ordinateurs d’apprendre et de prendre des décisions sans qu’on leur donne des instructions précises. Par exemple, un programme peut apprendre à reconnaître des visages ou à recommander des films en analysant des exemples.
+
+Avec Python, des outils comme TensorFlow et PyTorch permettent de créer facilement ce genre de programme. Même si ces concepts peuvent paraître compliqués au début, Python simplifie beaucoup les choses, ce qui le rend accessible même pour les débutants.
+
+### Python pour le développement web
+
+Python est aussi utilisé pour créer des sites internet. Avec des outils comme Django et Flask, vous pouvez construire des sites de manière organisée et rapide. Par exemple, Django est parfait pour créer des sites complexes qui nécessitent beaucoup de fonctionnalités, tandis que Flask est une bonne option pour des projets plus simples. En utilisant Python pour le web, vous pouvez apprendre à gérer tout ce qui se passe derrière un site, comme le stockage d’informations ou la création de pages interactives.
+
+### Python pour l'automatisation et les scripts
+
+Enfin, Python est un excellent outil pour automatiser des tâches répétitives. Par exemple, si vous voulez renommer des centaines de fichiers en une seule fois ou envoyer des emails automatiquement, Python peut vous aider à écrire un petit programme pour le faire. Cela vous fait gagner du temps et vous évite des efforts inutiles.
+
+Même des choses comme récupérer automatiquement des informations sur internet (ce qu’on appelle "scraping") sont possibles avec Python. Avec ses nombreuses possibilités, Python est comme un couteau suisse qui peut simplifier beaucoup d’aspects de la vie numérique.
diff --git a/src/content/docs/reference/example.md b/src/content/docs/reference/example.md
deleted file mode 100644
index 0224f09..0000000
--- a/src/content/docs/reference/example.md
+++ /dev/null
@@ -1,11 +0,0 @@
----
-title: Example Reference
-description: A reference page in my new Starlight docs site.
----
-
-Reference pages are ideal for outlining how things work in terse and clear terms.
-Less concerned with telling a story or addressing a specific use case, they should give a comprehensive outline of what you're documenting.
-
-## Further reading
-
-- Read [about reference](https://diataxis.fr/reference/) in the Diátaxis framework