Skip to content

Commit

Permalink
Mise à jour de la documentation
Browse files Browse the repository at this point in the history
  • Loading branch information
jmhasenfratz committed Dec 12, 2024
1 parent 87690ab commit 723b89f
Show file tree
Hide file tree
Showing 5 changed files with 105 additions and 41 deletions.
2 changes: 2 additions & 0 deletions .github/workflows/main.yml
Original file line number Diff line number Diff line change
@@ -1,4 +1,6 @@
name: Datalake
site_url: https://username.github.io/repository-name/

on:
workflow_dispatch:
push:
Expand Down
45 changes: 45 additions & 0 deletions docs/config-mkdoc.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,45 @@
# Configuration de MkDocs

## Extensions Markdown

1. **admonition** : <a href="https://squidfunk.github.io/mkdocs-material/reference/admonitions/" target="_blank" title="admonition">Documentation</a>
- Permet l'utilisation de blocs spéciaux pour les notes, avertissements, etc.
2. **abbr** : <a href="https://squidfunk.github.io/mkdocs-material/reference/abbreviations/" target="_blank" title="abbr">Documentation</a>
- Gère les abréviations avec infobulles explicatives.
3. **attr_list** : <a href="https://squidfunk.github.io/mkdocs-material/setup/extensions/python-markdown/#attribute-lists" target="_blank" title="attr_list">Documentation</a>
- Ajoute des attributs personnalisés aux éléments Markdown.
4. **def_list** : <a href="https://squidfunk.github.io/mkdocs-material/setup/extensions/python-markdown/#definition-lists" target="_blank" title="def_list">Documentation</a>
- Crée des listes de définitions.
5. **footnotes** : <a href="https://squidfunk.github.io/mkdocs-material/reference/footnotes/" target="_blank" title="footnotes">Documentation</a>
- Insère des notes de bas de page.
7. **md_in_html** : <a href="https://squidfunk.github.io/mkdocs-material/setup/extensions/python-markdown/#markdown-in-html" target="_blank" title="md_in_html">Documentation</a>
- Permet l'utilisation de Markdown à l'intérieur du HTML.
8. **tables** : <a href="https://squidfunk.github.io/mkdocs-material/reference/data-tables/" target="_blank" title="tables">Documentation</a>
- Améliore le rendu et les fonctionnalités des tableaux.
9. **toc** : <a href="https://squidfunk.github.io/mkdocs-material/setup/extensions/python-markdown/#table-of-contents" target="_blank" title="toc">Documentation</a>
- Génère une table des matières avec des liens permanents.
10. **pymdownx.snippets** : <a href="https://facelessuser.github.io/pymdown-extensions/extensions/snippets/" target="_blank" title="pymdownx.snippets">Documentation</a>
- Permet l'inclusion de fragments de code externes.
11. **pymdownx.details** : <a href="https://facelessuser.github.io/pymdown-extensions/extensions/details/" target="_blank" title="pymdownx.details">Documentation</a>
- Crée des blocs repliables pour masquer ou afficher du contenu.
12. **pymdownx.magiclink** : <a href="https://facelessuser.github.io/pymdown-extensions/extensions/magiclink/" target="_blank" title="pymdownx.magiclink">Documentation</a>
- Convertit automatiquement les URLs en liens.
13. **pymdownx.tabbed** : <a href="https://facelessuser.github.io/pymdown-extensions/extensions/tabbed/" target="_blank" title="pymdownx.tabbed">Documentation</a>
- Permet la création d'onglets dans le contenu.
14. **pymdownx.betterem** : <a href="https://facelessuser.github.io/pymdown-extensions/extensions/betterem/" target="_blank" title="pymdownx.betterem">Documentation</a>
- Améliore la détection des emphases (italique, gras).
15. **pymdownx.critic** : <a href="https://facelessuser.github.io/pymdown-extensions/extensions/critic/" target="_blank" title="pymdownx.critic">Documentation</a>
- Gère les révisions et suggestions dans le texte.
16. **pymdownx.keys** : <a href="https://facelessuser.github.io/pymdown-extensions/extensions/keys/" target="_blank" title="pymdownx.keys">Documentation</a>
- Affiche de manière stylisée les touches de clavier.
17. **pymdownx.caret** : <a href="https://facelessuser.github.io/pymdown-extensions/extensions/caret/" target="_blank" title="pymdownx.caret">Documentation</a>
- Supporte le texte en exposant.
18. **pymdownx.mark** : <a href="https://facelessuser.github.io/pymdown-extensions/extensions/mark/" target="_blank" title="pymdownx.mark">Documentation</a>
- Met en surbrillance le texte.
19. **pymdownx.tilde** : <a href="https://facelessuser.github.io/pymdown-extensions/extensions/tilde/" target="_blank" title="pymdownx.tilde">Documentation</a>
- Supporte le texte en indice.
20. **pymdownx.highlight** : <a href="https://facelessuser.github.io/pymdown-extensions/extensions/highlight/" target="_blank" title="pymdownx.highlight">Documentation</a>
- Met en évidence le code avec coloration syntaxique.
21. **pymdownx.superfences** : <a href="https://facelessuser.github.io/pymdown-extensions/extensions/superfences/" target="_blank" title="pymdownx.superfences">Documentation</a>
- Gère de manière avancée les blocs de code.
22. **pymdownx.inlinehilite** : <a href="https://facelessuser.github.io/pymdown-extensions/extensions/inlinehilite/" target="_blank" title="pymdownx.inlinehilite">Documentation</a>
23 changes: 19 additions & 4 deletions docs/index.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,21 @@
# Accueil

---
title: Nouveau titre
---
!!! info inline end "Texte et références générés par Perplexity !"

Hello
Un *data lake* (ou lac de données) est un système de stockage conçu pour conserver de grandes quantités de données brutes dans leur format natif. Contrairement aux entrepôts de données traditionnels qui nécessitent une structuration préalable des données, un data lake utilise une architecture flexible appelée *schema-on-read*. Cela signifie que les données peuvent être stockées sans schéma défini et que leur structure est déterminée au moment de l'analyse [\[1\]](https://www.lemagit.fr/definition/Data-lake-lac-de-donnees) [\[2\]](https://datascientest.com/data-lake-tout-savoir) [\[5\]](https://www.salesforce.com/fr/data/what-is-a-data-lake/).

Les data lakes peuvent contenir des données structurées, semi-structurées ou non structurées, provenant de diverses sources telles que des bases de données, des fichiers texte, des images ou des flux IoT. Cette flexibilité permet aux organisations d'ingérer et de stocker toutes sortes de données sans contraintes de format [\[3\]](https://www.journaldunet.fr/web-tech/guide-du-big-data/1165409-data-lake-ou-lac-de-donnees-la-solution-reine-du-big-data/) [\[6\]](https://www.talend.com/fr/resources/guide-data-lake/).

L'un des principaux avantages d'un data lake est sa capacité à servir de plateforme centralisée pour l'analyse des big data et la science des données. Il permet aux entreprises d'explorer et d'analyser les données pour extraire des informations précieuses, développer des modèles prédictifs et améliorer la prise de décision [\[4\]](https://cloud.orange-business.com/paroles-dexperts-fr/data-lake-definition-et-bonnes-pratiques/) [\[8\]](https://www.intelligence-artificielle-school.com/ecole/technologies/data-lake-definition-role-utilisation/). En résumé, un data lake offre une solution puissante et évolutive pour gérer les grands volumes de données hétérogènes générés par les entreprises modernes [\[7\]](https://datavalue-consulting.com/data-lake-definition/) [\[9\]](https://www.oracle.com/fr/database/data-lake-definition/).

**Citations :**

1. [https://www.lemagit.fr/definition/Data-lake-lac-de-donnees](https://www.lemagit.fr/definition/Data-lake-lac-de-donnees)
2. [https://datascientest.com/data-lake-tout-savoir](https://datascientest.com/data-lake-tout-savoir)
3. [https://www.journaldunet.fr/web-tech/guide-du-big-data/1165409-data-lake-ou-lac-de-donnees-la-solution-reine-du-big-data/](https://www.journaldunet.fr/web-tech/guide-du-big-data/1165409-data-lake-ou-lac-de-donnees-la-solution-reine-du-big-data/)
4. [https://cloud.orange-business.com/paroles-dexperts-fr/data-lake-definition-et-bonnes-pratiques/](https://cloud.orange-business.com/paroles-dexperts-fr/data-lake-definition-et-bonnes-pratiques/)
5. [https://www.salesforce.com/fr/data/what-is-a-data-lake/](https://www.salesforce.com/fr/data/what-is-a-data-lake/)
6. [https://www.talend.com/fr/resources/guide-data-lake/](https://www.talend.com/fr/resources/guide-data-lake/)
7. [https://datavalue-consulting.com/data-lake-definition/](https://datavalue-consulting.com/data-lake-definition/)
8. [https://www.intelligence-artificielle-school.com/ecole/technologies/data-lake-definition-role-utilisation/](https://www.intelligence-artificielle-school.com/ecole/technologies/data-lake-definition-role-utilisation/)
9. [https://www.oracle.com/fr/database/data-lake-definition/](https://www.oracle.com/fr/database/data-lake-definition/)
1 change: 0 additions & 1 deletion docs/maPage.md

This file was deleted.

75 changes: 39 additions & 36 deletions mkdocs.yml
Original file line number Diff line number Diff line change
Expand Up @@ -9,45 +9,48 @@ theme:
features:
- navigation.tabs
markdown_extensions:
- admonition
- abbr
- attr_list
- def_list
- footnotes
- meta
- md_in_html
- meta
- admonition # Blocs spéciaux pour les notes, avertissements, etc.
- abbr # Gestion des abréviations avec infobulles explicatives
- attr_list # Ajout d'attributs personnalisés aux éléments Markdown
- def_list # Création de listes de définitions
- footnotes # Insertion de notes de bas de page
# - meta # Métadonnées au début des fichiers Markdown
- md_in_html # Permet l'utilisation de Markdown à l'intérieur du HTML
- tables # Améliore le rendu et les fonctionnalités des tableaux
- toc:
permalink: true
# - pymdownx.snippets
# - pymdownx.details
# - pymdownx.magiclink
# - pymdownx.tabbed
# - pymdownx.betterem:
# smart_enable: all
# - pymdownx.caret
# - pymdownx.mark
# - pymdownx.tilde
# - pymdownx.highlight
# - pymdownx.superfences
# - pymdownx.inlinehilite
# - pymdownx.keys
# - pymdownx.smartsymbols
# - pymdownx.arithmatex:
# generic: true
# - pymdownx.tasklist:
# custom_checkbox: true
permalink: true # Génère une table des matières avec des liens permanents
- pymdownx.snippets # Inclusion de fragments de code externes
- pymdownx.details # Blocs repliables pour masquer ou afficher du contenu
- pymdownx.magiclink # Conversion automatique des URLs en liens
- pymdownx.tabbed # Création d'onglets dans le contenu
- pymdownx.betterem:
smart_enable: all # Amélioration de la détection des emphases (italique, gras)
- pymdownx.critic # Gestion des révisions et suggestions dans le texte
- pymdownx.keys # Affichage stylisé des touches de clavier
- pymdownx.caret # Support pour le texte en exposant
- pymdownx.mark # Mise en surbrillance du texte
- pymdownx.tilde # Support pour le texte en indice
- pymdownx.highlight # Mise en évidence du code avec coloration syntaxique
- pymdownx.superfences # Gestion avancée des blocs de code
- pymdownx.inlinehilite # Coloration syntaxique pour le code en ligne
- pymdownx.smartsymbols # Conversion automatique de symboles typographiques
- pymdownx.blocks.caption # Ajout de légendes aux blocs de contenu
- pymdownx.arithmatex:
generic: true # Rendu des expressions mathématiques avec MathJax ou KaTeX
- pymdownx.tasklist:
custom_checkbox: true # Listes de tâches avec cases à cocher personnalisées

plugins:
- search:
lang:
- en
- fr
- fr # Plugin de recherche avec support pour l'anglais et le français
- awesome-pages # Organisation avancée des pages
- macros # Définition et utilisation de macros

- awesome-pages
- macros
# - page-to-pdf:
# disableOnServe: true
# displayHeaderFooter: true
# printBackground: true
## exclude:
## - "index.*"
- page-to-pdf:
disableOnServe: true
displayHeaderFooter: true
printBackground: true
# exclude:
# - "index.*"

0 comments on commit 723b89f

Please sign in to comment.