ajout dossier markdown

This commit is contained in:
2021-10-05 22:33:44 +02:00
parent 2ec14057ad
commit 4d6c8ed58a
5 changed files with 1200 additions and 0 deletions

View File

@@ -0,0 +1,607 @@
{
"cells": [
{
"cell_type": "markdown",
"metadata": {},
"source": [
"# Guide d'utilisation Markdown\n",
"\n",
"## Introduction\n",
"\n",
"Markdown est un _langage de balisage_ simple créé en 2004 par John Gruber avec l'aide d'Aaron Swartz. \n",
"\n",
"En informatique, les langages de balisage représentent une classe de langages spécialisés dans l'enrichissement d'information textuelle. L'inclusion de balises permet de transférer à la fois le contenu et des indications sur la mise en forme (mise en italique, gras...).\n",
"\n",
"Le HTML est un autre langage de balisage. Le Markdown est un langage plus simple à appréhender; son apprentissage facilitera celui de l'HTML.\n",
"\n",
"![Logo Markdown](https://upload.wikimedia.org/wikipedia/commons/thumb/4/48/Markdown-mark.svg/208px-Markdown-mark.svg.png)\n",
"\n",
"Il a été créé dans le but d'offrir une syntaxe facile à lire et à écrire. \n",
"\n",
"Un document balisé par Markdown peut être lu en l'état sans donner limpression d'avoir été balisé ou formaté par des instructions particulières.\n",
"\n",
"## Usages\n",
"\n",
"Le langage de balisage léger Markdown est utilisé dans de nombreuses applications, que ce soit dans des logiciels/éditeurs de code, des logiciels d'écriture, des plateformes de code, ou encore dans des chaînes d'édition avec l'addition d'autres logiciels. Les domaines concernés peuvent être le développement informatique, la rédaction de documentation technique ou encore la publication académique.\n",
"\n",
"Certains sites comme __discord__ permettent la gestion et l'affichage de texte au format Markdown.\n",
"\n",
"La plupart des cours de NSI sont au format mardown, stocké sous la forme de fichier portant l'extension .md ou .ipynb.\n",
"\n",
"Pour ouvrir, modifier ou visualiser les fichiers, il faut utiliser :\n",
"\n",
"- markdown (`.md`), il faut utiliser le logiciel [Typora](https://typora.io/) ou le logiciel en ligne [stackedit](https://stackedit.io/app#),\n",
"- notebook (`.ipynb`), il faut utiliser le logiciel en ligne [Basthon](https://notebook.basthon.fr/)\n",
"\n",
"\n",
"## Formatage\n",
"\n",
"L'emphase est l'exagération dun mot ou d'une phrase en utilisant un style ou une fonte différente de celle du reste du texte — pour mettre laccent dessus.\n",
"\n",
"En markdown, l'emphase se manifeste par les caractères _ utilisés en paire.\n",
"\n",
"### Italique\n",
"\n",
"Pour mettre une partie de texte en italique, il faut l'encadrer par un _.\n",
"\n",
"<u>Exemple</u> : Cette _partie du texte_ est en italique.\n",
"\n",
"Est obtenu par la syntaxe :\n",
"```markdown\n",
"Cette _partie du texte_ est en italique\n",
"```\n",
"\n",
"### Gras\n",
"\n",
"Pour mettre une partie de texte en gras, il faut l'encadrer par un double __.\n",
"\n",
"<u>Exemple</u> : Cette __partie du texte__ est en gras.\n",
"\n",
"Est obtenu par la syntaxe :\n",
"```markdown\n",
"Cette __partie du texte__ est en gras`\n",
"```\n",
"\n",
"#### Remarque\n",
"\n",
"Il est possible de cumuler le formatage de texte.\n",
"\n",
"<u>Exemple</u> : Cette ___partie du texte___ est en italique et en gras.\n",
"\n",
"Est obtenu par la syntaxe constituée d'une paire de triples _\n",
"```markdown\n",
"Cette ___partie du texte___ est en italique et en gras\n",
"```\n",
"\n",
"\n",
"### Paragraphe et saut de ligne\n",
"\n",
"\n",
"Pour faire un nouveau paragraphe, sauter deux lignes, c'est à dire laisser une ligne vide entre les deux paragraphes. Sauter une seule ligne dans le texte d'origine n'aura aucun effet à l'affichage (l'affichage sera en continu).\n",
"\n",
"<u>Exemple</u> :\n",
"\n",
"Premier Paragraphe\n",
"Deuxième Paragraphe\n",
"\n",
"Est obtenu par la syntaxe suivante :\n",
"```markdown\n",
"Premier Pragraphe\n",
"Deuxième Paragraphe\n",
"```\n",
"\n",
"<u>Exemple</u> :\n",
"\n",
"Premier Paragraphe\n",
"\n",
"Deuxième Paragraphe\n",
"\n",
"Est obtenu par la syntaxe suivante :\n",
"```markdown\n",
"Premier Pragraphe\n",
"\n",
"Deuxième Paragraphe\n",
"```\n",
"\n",
"### Citation\n",
"\n",
"Il est possible de faire des citations, c'est-à-dire formater le texte dans un style particulier différent du reste du texte, en utilisant le symbole > en début de phrase. \n",
"Le texte est mis avec espace et une barre verticale afin de symboliser la citation.\n",
"\n",
"<u>Exemple</u> :\n",
"\n",
"> Moi, Monsieur, si javais un tel nez, il faudrait sur le champ que je lamputasse !, Edmond Rostand / Cyrano de Bergerac\n",
"\n",
"Est obtenu par la syntaxe suivantes :\n",
"```markdown\n",
"> Moi, Monsieur, si javais un tel nez, il faudrait sur le champ que je lamputasse !, Edmond Rostand / Cyrano de Bergerac\n",
"```\n",
"\n",
"#### Citation sur plusieurs lignes\n",
"\n",
"Il est possible de faire une citation sur plusieurs lignes. Dans ce cas, il faut utiliser le symbole > à chaque début de lignes constituant la citation.\n",
"\n",
"<u>Exemple</u> :\n",
"\n",
"> Ah ! non ! cest un peu court, jeune homme !\n",
">\n",
"> On pouvait dire… Oh ! Dieu ! … bien des choses en somme…\n",
">\n",
"> En variant le ton, par exemple, tenez :\n",
">\n",
"> Agressif : « Moi, monsieur, si javais un tel nez,\n",
">\n",
"> Il faudrait sur-le-champ que je me lamputasse ! »\n",
">\n",
"> Amical : « Mais il doit tremper dans votre tasse\n",
">\n",
"> Pour boire, faites-vous fabriquer un hanap ! »\n",
">\n",
"> Descriptif : « Cest un roc ! … cest un pic ! … cest un cap !\n",
">\n",
"> Que dis-je, cest un cap ? … Cest une péninsule ! »\n",
">\n",
"> Curieux : « De quoi sert cette oblongue capsule ?\n",
">\n",
"> Décritoire, monsieur, ou de boîte à ciseaux ? »\n",
">\n",
"> Gracieux : « Aimez-vous à ce point les oiseaux\n",
">\n",
"> Que paternellement vous vous préoccupâtes\n",
">\n",
"> De tendre ce perchoir à leurs petites pattes ? »\n",
">\n",
"> Truculent : « Ça, monsieur, lorsque vous pétunez,\n",
">\n",
"> La vapeur du tabac vous sort-elle du nez\n",
">\n",
"> Sans quun voisin ne crie au feu de cheminée ? »\n",
">\n",
"> Prévenant : « Gardez-vous, votre tête entraînée\n",
">\n",
"> Par ce poids, de tomber en avant sur le sol ! »\n",
">\n",
"> Tendre : « Faites-lui faire un petit parasol\n",
">\n",
"> De peur que sa couleur au soleil ne se fane ! »\n",
">\n",
"> Pédant : « Lanimal seul, monsieur, quAristophane\n",
">\n",
"> Appelle Hippocampéléphantocamélos\n",
">\n",
"> Dut avoir sous le front tant de chair sur tant dos ! »\n",
">\n",
"> Cavalier : « Quoi, lami, ce croc est à la mode ?\n",
">\n",
"> Pour pendre son chapeau, cest vraiment très commode ! »\n",
">\n",
"> Emphatique : « Aucun vent ne peut, nez magistral,\n",
">\n",
"> Tenrhumer tout entier, excepté le mistral ! »\n",
">\n",
"> Dramatique : « Cest la Mer Rouge quand il saigne ! »\n",
">\n",
"> Admiratif : « Pour un parfumeur, quelle enseigne ! »\n",
">\n",
"> Lyrique : « Est-ce une conque, êtes-vous un triton ? »\n",
">\n",
"> Naïf : « Ce monument, quand le visite-t-on ? »\n",
">\n",
"> Respectueux : « Souffrez, monsieur, quon vous salue,\n",
">\n",
"> Cest là ce qui sappelle avoir pignon sur rue ! »\n",
">\n",
"> Campagnard : « Hé, ardé ! Cest-y un nez ? Nanain !\n",
">\n",
"> Cest queuqunavet géant ou ben queuqumelon nain ! »\n",
">\n",
"> Militaire : « Pointez contre cavalerie ! »\n",
">\n",
"> Pratique : « Voulez-vous le mettre en loterie ?\n",
">\n",
"> Assurément, monsieur, ce sera le gros lot ! »\n",
">\n",
"> Enfin parodiant Pyrame en un sanglot :\n",
">\n",
"> « Le voilà donc ce nez qui des traits de son maître\n",
">\n",
"> A détruit lharmonie ! Il en rougit, le traître ! »\n",
">\n",
"> Voilà ce quà peu près, mon cher, vous mauriez dit\n",
">\n",
"> Si vous aviez un peu de lettres et desprit\n",
">\n",
"> Mais desprit, ô le plus lamentable des êtres,\n",
">\n",
"> Vous nen eûtes jamais un atome, et de lettres\n",
">\n",
"> Vous navez que les trois qui forment le mot : sot !\n",
">\n",
"> Eussiez-vous eu, dailleurs, linvention quil faut\n",
">\n",
"> Pour pouvoir là, devant ces nobles galeries,\n",
">\n",
"> me servir toutes ces folles plaisanteries,\n",
">\n",
"> Que vous nen eussiez pas articulé le quart\n",
">\n",
"> De la moitié du commencement dune, car\n",
">\n",
"> Je me les sers moi-même, avec assez de verve,\n",
">\n",
"> Mais je ne permets pas quun autre me les serve.\n",
"\n",
"## Listes\n",
"\n",
"Sauter une ligne avant le début de la liste.\n",
"\n",
"### Liste non ordonnée\n",
"\n",
"Pour créer une liste non ordonnée, il faut utiliser le symbole - pour chaque élément.\n",
"\n",
"<u>Exemple</u> :\n",
"Listes des fruits :\n",
"\n",
"- Pommes\n",
"- Poires\n",
"- Raisin\n",
"\n",
"Est obtenu par la syntaxe suivantes :\n",
"\n",
"```markdown\n",
"Listes des fruits :\n",
"\n",
"- Pommes\n",
"- Poires\n",
"- Raisin\n",
"```\n",
"\n",
"___N.B : Une ligne vide doit précéder la liste et un espace est nécessaire entre le symbole - et l'élément de la liste.___\n",
"\n",
"#### Remarque\n",
"\n",
"Il est possible d'imbriquer des listes. Pour cela, un espace est nécessaire entre l'élément parent et la liste imbriquée.\n",
"\n",
"<u>Exemple</u> :\n",
"Listes des fruits :\n",
"\n",
"- Pommes\n",
" - Golden\n",
" - Gala\n",
" - Pink Lady\n",
" - ...\n",
"- Poires\n",
"- Raisin\n",
" - Corinthe noir\n",
" - Muscat d'Alexandrie\n",
" \n",
"Est obtenu par la syntaxe suivantes :\n",
"\n",
"```markdown\n",
"Listes des fruits :\n",
"\n",
"- Pommes\n",
" - Golden\n",
" - Gala\n",
" - Pink Lady\n",
" - ...\n",
"- Poires\n",
"- Raisin\n",
" - Corinthe noir\n",
" - Muscat d'Alexandrie\n",
"```\n",
"\n",
"### Liste ordonnée\n",
"\n",
"Pour créer une liste ordonnée, il faut énumérer chaque élément précédé de son rang, d'un point et d'un espace.\n",
"\n",
"<u>Exemple</u> :\n",
"Liste ordonnée :\n",
"\n",
"1. premier élément\n",
"2. deuxième élément\n",
"3. troisième élément\n",
"\n",
"Est obtenu par la syntaxe suivantes :\n",
"\n",
"```markdown\n",
"Liste ordonnée :\n",
"\n",
"1. premier élément\n",
"2. deuxième élément\n",
"3. troisième élément\n",
"```\n",
"\n",
"#### Remarque 1\n",
"\n",
"La valeur du rang ne doit pas nécessairement être indiqué. C'est le fait que chaque élément se suive qui constitue la liste ordonnée.\n",
"\n",
"<u>Exemple</u> :\n",
"Liste ordonnée :\n",
"\n",
"1. premier élément\n",
"1. deuxième élément\n",
"1. troisième élément\n",
"\n",
"Est obtenu par la syntaxe suivante :\n",
"\n",
"```markdown\n",
"Liste ordonnée :\n",
"\n",
"1. premier élément\n",
"1. deuxième élément\n",
"1. troisième élément\n",
"```\n",
"\n",
"#### Remarque 2\n",
"\n",
"Comme pour les listes non ordonnées, il est possible d'imbriquer des listes ordonnées. Pour cela, un espace est nécessaire entre l'élément parent et la liste imbriquée.\n",
"\n",
"<u>Exemple</u> :\n",
"Liste ordonnée imbriquée:\n",
"\n",
"1. premier élément\n",
" 1. premier sous élément\n",
" 2. deuxième sous élément\n",
"2. deuxième élément\n",
"3. troisième élément\n",
" 1. premier sous élément\n",
"\n",
"Est obtenu par la syntaxe suivante :\n",
"\n",
"```markdown\n",
"Liste ordonnée imbriquée:\n",
"\n",
"1. premier élément\n",
" 1. premier sous élément\n",
" 2. deuxième sous élément\n",
"2. deuxième élément\n",
"3. troisième élément\n",
" 1. premier sous élément\n",
"```\n",
"\n",
"### Liste de cases à cocher\n",
"\n",
"Pour créer une liste de cases à cocher, il faut énumérer chaque élément précédé par `[ ]` pour une case non cochée et `[x]` pour une case cochée.\n",
"\n",
"<u>Exemple</u> :\n",
"Le langage Markdown a été créé par :\n",
"\n",
"- [x] John Gruber\n",
"- [ ] Guido van Rossum\n",
"- [x] Aaron Swartz\n",
"- [ ] Bill Gates\n",
"\n",
"Est obtenu par la syntaxe suivante :\n",
"```markdown\n",
"Le langage Markdown a été créé par :\n",
"\n",
"- [x] John Gruber\n",
"- [ ] Guido van Rossum\n",
"- [x] Aaron Swartz\n",
"- [ ] Bill Gates\n",
"```\n",
"\n",
"__N.B : Le texte entre crochets doit comporter un _seul et un seul caractère_. Soit un espace pour une case non cochée, soit un x pour une case cochée.__\n"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"## Titres\n",
"\n",
"Les titres sont créés avec un certain nombre de #(croisillons) avant le titre, qui correspondent au niveau de titre souhaité (de 1 à 6).\n",
"\n",
"<u>Exemple :</u>\n",
"\n",
"# un titre de premier niveau\n",
"#### un titre de quatrième niveau\n",
"\n",
"Est obtenu par la syntaxe suivante :\n",
"```\n",
"# un titre de premier niveau\n",
"#### un titre de quatrième niveau\n",
"```"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"## Tableaux\n",
"\n",
"Un tableau en Markdown est constitué de 3 éléments :\n",
"\n",
"1. une ligne d'en-tête\n",
"1. une ligne de séparation\n",
"1. un ensemble de lignes de corps du tableau\n",
"\n",
"<u>Exemple</u> :\n",
"\n",
"| Titre 1 | Titre 2 | Titre 3 |\n",
"| :-- | :--: | --: |\n",
"| Colonne | Colonne | Colonne |\n",
"| Alignée à | Alignée au | Alignée à |\n",
"| Gauche | Centre | Droite |\n",
"\n",
"\n",
"Est obtenu par la syntaxe suivante :\n",
"```\n",
"| Titre 1 | Titre 2 | Titre 3 |\n",
"| :-- | :--: | --: |\n",
"| Colonne | Colonne | Colonne |\n",
"| Alignée à | Alignée au | Alignée à |\n",
"| Gauche | Centre | Droite |\n",
"```\n",
"\n",
"### En-tête\n",
"\n",
"L'en-tête contient chaque titre de colonnes, séparés par un symbole |. Le titre sera automatiquement mis en gras.\n",
"\n",
"### Séparation\n",
"\n",
"La ligne de séparation permet de délimiter l'en-tête du corps du tableau et de définir l'alignement du texte du contenu de la colonne.\n",
"\n",
"- `:--`: indique que le contenu est aligné à gauche de la colonne,\n",
"- `:--:`: indique que le contenu est centré,\n",
"- `--:`: indique que le contenu est aligné à droite de la colonne.\n",
"\n",
"### Corps\n",
"\n",
"Chaque ligne du corps du tableau contient le contenu de chaque colonne séparé par un symbole |. La couleur du fond de chaque ligne du tableau est alternée automatiquement."
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"## Liens\n",
"\n",
"Pour créer des liens de type url cliquable, il faut utiliser la syntaxe `[texte du lien](url_du_lien)`.\n",
"\n",
"<u>Exemple</u> : [Site du lycée Masséna](http://www.lycee-massena.fr/)\n",
"\n",
"Est obtenu par la syntaxe :\n",
"```\n",
"[Site du lycée Masséna](http://www.lycee-massena.fr/)\n",
"```\n",
"__N.B : il n'y a pas d'espace entre le crochet fermant et la parenthèse ouvrante. Il faut écrire ..lien](url.. et non ..lien] (url.. )__"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"## Images\n",
"\n",
"Pour afficher une image, il faut utiliser la syntaxe `![Texte alternatif](url_de_l'image)`\n",
"\n",
"<u>Exemple</u> : ![Logo Markdown](https://upload.wikimedia.org/wikipedia/commons/thumb/4/48/Markdown-mark.svg/208px-Markdown-mark.svg.png)\n",
"\n",
"Est obtenu par la syntaxe :\n",
"```\n",
"![Logo Markdown](https://upload.wikimedia.org/wikipedia/commons/thumb/4/48/Markdown-mark.svg/208px-Markdown-mark.svg.png)\n",
"```\n",
"__N.B : il n'y a pas d'espace entre le crochet fermant et la parenthèse ouvrante. Il faut écrire ..lien](url.. et non ..lien] (url.. )__"
]
},
{
"cell_type": "code",
"execution_count": 5,
"metadata": {},
"outputs": [
{
"name": "stdout",
"output_type": "stream",
"text": [
"GUIDO.md GUIDO.pdf MARKDOWN.ipynb README.md\r\n"
]
}
],
"source": [
"ls"
]
},
{
"cell_type": "code",
"execution_count": 6,
"metadata": {},
"outputs": [
{
"data": {
"text/plain": [
"'/Users/florian/Sites/Eleves/NSI/Première/markdown'"
]
},
"execution_count": 6,
"metadata": {},
"output_type": "execute_result"
}
],
"source": [
"pwd"
]
},
{
"cell_type": "code",
"execution_count": 7,
"metadata": {},
"outputs": [],
"source": [
"mkdir toto"
]
},
{
"cell_type": "code",
"execution_count": 8,
"metadata": {},
"outputs": [
{
"name": "stdout",
"output_type": "stream",
"text": [
"GUIDO.md GUIDO.pdf MARKDOWN.ipynb README.md \u001b[34mtoto\u001b[m\u001b[m/\r\n"
]
}
],
"source": [
"ls"
]
},
{
"cell_type": "code",
"execution_count": 9,
"metadata": {},
"outputs": [],
"source": [
"rmdir toto"
]
},
{
"cell_type": "code",
"execution_count": 10,
"metadata": {},
"outputs": [
{
"name": "stdout",
"output_type": "stream",
"text": [
"GUIDO.md GUIDO.pdf MARKDOWN.ipynb README.md\r\n"
]
}
],
"source": [
"ls"
]
},
{
"cell_type": "code",
"execution_count": null,
"metadata": {},
"outputs": [],
"source": []
}
],
"metadata": {
"kernelspec": {
"display_name": "Python 3 (ipykernel)",
"language": "python",
"name": "python3"
},
"language_info": {
"codemirror_mode": {
"name": "ipython",
"version": 3
},
"file_extension": ".py",
"mimetype": "text/x-python",
"name": "python",
"nbconvert_exporter": "python",
"pygments_lexer": "ipython3",
"version": "3.8.8"
}
},
"nbformat": 4,
"nbformat_minor": 2
}

View File

@@ -0,0 +1,57 @@
# Guido van Rossum
## Introduction
__Guido van Rossum__, né le 31 janvier 1956 à Haarlem aux Pays-Bas, est un développeur connu pour être le créateur et leader du projet du langage de programmation [Python](https://www.python.org/).
Au sein de la communauté pythonienne, il est, jusquen juillet 2018, un _Benevolent Dictator for Life_ « dictateur bienveillant à vie », ce qui signifie qu'il suit le développement de Python et arbitre lorsque la situation le requiert.
## Curriculum Vitae
![Guido van Rossum](https://upload.wikimedia.org/wikipedia/commons/thumb/e/e2/Guido-portrait-2014-drc.jpg/320px-Guido-portrait-2014-drc.jpg)
Crédits : Photo de Daniel Stroud, retouchée par Deedub1983 et HarJIT (CC-BY-SA)
Parcours professionnel non exhaustif :
| Années | Société | Activités |
| :----: | :-------: | :----------------------------------------------------------- |
| 1991 | CWI | Chercheur, où il développe le langage ___Python___ |
| 2005 | Google | Engagé pour développer des outils internes |
| 2013 | Dropbox | Engagé pour guider les équipes de développement et promouvoir lépanouissement des femmes au sein des équipes d'ingénieurs |
| 2019 | - | Prend sa retraite |
| 2020 | Microsoft | Membre de la division développeur de Microsoft |
## Python
Le langage inventé par Guido Van Rossum a de nombreux avantages :
1. ___facile d'utilisation___ : la force de Python réside dans le fait que son code est court, facile à comprendre,
2. ___open source___ : Selon [Wikipédia](https://fr.wikipedia.org/wiki/Open_source), s'applique aux logiciels dont la licence respecte des critères précisément établis par l'*Open Source Initiative*, c'est-à-dire les possibilités de libre :
1. redistribution,
2. d'accès au code source
3. de création de travaux dérivés.
3. __Populaire__ : Ce langage fonctionne sur tous les principaux systèmes dexploitation et plateformes informatiques. Il est utilisé aussi bien par des débutants que des experts, notamment les [data scientists](https://www.letudiant.fr/metiers/secteur/informatique-telecom-web/data-scientist.html). Selon l'[étude de Redmonk](https://redmonk.com/sogrady/2020/07/27/language-rankings-6-20/) de Juin 2020, le langage Python est le 2ème plus populaire des langages de programmation.
![](./assets/rankings.png)
_Ce graphique RedMonk suit l'évolution des 20 premiers langages dans l'histoire des classements. Image : RedMonk._
## Citations
> les langages de programmation sont la manière dont les programmeurs expriment et communiquent leurs idées, 27 Avril 2016
> Now, it's my belief that Python is a lot easier than to teach to students programming and teach them C or C++ or Java at the same time because all the details of the languages are so much harder. Other scripting languages really don't work very well there either, date inconnue
> Python va certainement continuer à se développer avec notamment lajout de nouvelles bibliothèques. Concernant lutilisation de Python en classe, jespère que les élèves sapproprieront ce langage et pourront lutiliser pour développer des projets extra scolaires et plus tard au quotidien dans leur carrière !, date inconnue
## Liens
- Page officielle : [https://gvanrossum.github.io/](https://gvanrossum.github.io/)
- L'histoire de Python, par son créateur, Guido van Rossum : [Youtube, 25 Avril 2019](https://www.youtube.com/watch?v=J0Aq44Pze-w)
- [Page Wikipédia](https://fr.wikipedia.org/wiki/Guido_van_Rossum) de Guido Van Rossum
## Quelques caractéristiques
- [x] Porte des lunettes
- [ ] Habite Nice
- [x] Porte une barbe

Binary file not shown.

View File

@@ -0,0 +1,511 @@
{
"cells": [
{
"cell_type": "markdown",
"metadata": {},
"source": [
"# Guide d'utilisation Markdown\n",
"\n",
"## Introduction\n",
"\n",
"Markdown est un _langage de balisage_ simple créé en 2004 par John Gruber avec l'aide d'Aaron Swartz. \n",
"\n",
"En informatique, les langages de balisage représentent une classe de langages spécialisés dans l'enrichissement d'information textuelle. L'inclusion de balises permet de transférer à la fois le contenu et des indications sur la mise en forme (mise en italique, gras...).\n",
"\n",
"Le HTML est un autre langage de balisage. Le Markdown est un langage plus simple à appréhender; son apprentissage facilitera celui de l'HTML.\n",
"\n",
"![Logo Markdown](https://upload.wikimedia.org/wikipedia/commons/thumb/4/48/Markdown-mark.svg/208px-Markdown-mark.svg.png)\n",
"\n",
"Il a été créé dans le but d'offrir une syntaxe facile à lire et à écrire. \n",
"\n",
"Un document balisé par Markdown peut être lu en l'état sans donner limpression d'avoir été balisé ou formaté par des instructions particulières.\n",
"\n",
"## Usages\n",
"\n",
"Le langage de balisage léger Markdown est utilisé dans de nombreuses applications, que ce soit dans des logiciels/éditeurs de code, des logiciels d'écriture, des plateformes de code, ou encore dans des chaînes d'édition avec l'addition d'autres logiciels. Les domaines concernés peuvent être le développement informatique, la rédaction de documentation technique ou encore la publication académique.\n",
"\n",
"Certains sites comme __discord__ permettent la gestion et l'affichage de texte au format Markdown.\n",
"\n",
"La plupart des cours de NSI sont au format mardown, stocké sous la forme de fichier portant l'extension .md ou .ipynb.\n",
"\n",
"Pour ouvrir, modifier ou visualiser les fichiers, il faut utiliser :\n",
"\n",
"- markdown (`.md`), il faut utiliser le logiciel [Typora](https://typora.io/) ou le logiciel en ligne [stackedit](https://stackedit.io/app#),\n",
"- notebook (`.ipynb`), il faut utiliser le logiciel en ligne [Basthon](https://notebook.basthon.fr/)\n",
"\n",
"\n",
"## Formatage\n",
"\n",
"L'emphase est l'exagération dun mot ou d'une phrase en utilisant un style ou une fonte différente de celle du reste du texte — pour mettre laccent dessus.\n",
"\n",
"En markdown, l'emphase se manifeste par les caractères _ utilisés en paire.\n",
"\n",
"### Italique\n",
"\n",
"Pour mettre une partie de texte en italique, il faut l'encadrer par un _.\n",
"\n",
"<u>Exemple</u> : Cette _partie du texte_ est en italique.\n",
"\n",
"Est obtenu par la syntaxe :\n",
"```markdown\n",
"Cette _partie du texte_ est en italique\n",
"```\n",
"\n",
"### Gras\n",
"\n",
"Pour mettre une partie de texte en gras, il faut l'encadrer par un double __.\n",
"\n",
"<u>Exemple</u> : Cette __partie du texte__ est en gras.\n",
"\n",
"Est obtenu par la syntaxe :\n",
"```markdown\n",
"Cette __partie du texte__ est en gras`\n",
"```\n",
"\n",
"#### Remarque\n",
"\n",
"Il est possible de cumuler le formatage de texte.\n",
"\n",
"<u>Exemple</u> : Cette ___partie du texte___ est en italique et en gras.\n",
"\n",
"Est obtenu par la syntaxe constituée d'une paire de triples _\n",
"```markdown\n",
"Cette ___partie du texte___ est en italique et en gras\n",
"```\n",
"\n",
"\n",
"### Paragraphe et saut de ligne\n",
"\n",
"\n",
"Pour faire un nouveau paragraphe, sauter deux lignes, c'est à dire laisser une ligne vide entre les deux paragraphes. Sauter une seule ligne dans le texte d'origine n'aura aucun effet à l'affichage (l'affichage sera en continu).\n",
"\n",
"<u>Exemple</u> :\n",
"\n",
"Premier Paragraphe\n",
"Deuxième Paragraphe\n",
"\n",
"Est obtenu par la syntaxe suivante :\n",
"```markdown\n",
"Premier Pragraphe\n",
"Deuxième Paragraphe\n",
"```\n",
"\n",
"<u>Exemple</u> :\n",
"\n",
"Premier Paragraphe\n",
"\n",
"Deuxième Paragraphe\n",
"\n",
"Est obtenu par la syntaxe suivante :\n",
"```markdown\n",
"Premier Pragraphe\n",
"\n",
"Deuxième Paragraphe\n",
"```\n",
"\n",
"### Citation\n",
"\n",
"Il est possible de faire des citations, c'est-à-dire formater le texte dans un style particulier différent du reste du texte, en utilisant le symbole > en début de phrase. \n",
"Le texte est mis avec espace et une barre verticale afin de symboliser la citation.\n",
"\n",
"<u>Exemple</u> :\n",
"\n",
"> Moi, Monsieur, si javais un tel nez, il faudrait sur le champ que je lamputasse !, Edmond Rostand / Cyrano de Bergerac\n",
"\n",
"Est obtenu par la syntaxe suivantes :\n",
"```markdown\n",
"> Moi, Monsieur, si javais un tel nez, il faudrait sur le champ que je lamputasse !, Edmond Rostand / Cyrano de Bergerac\n",
"```\n",
"\n",
"#### Citation sur plusieurs lignes\n",
"\n",
"Il est possible de faire une citation sur plusieurs lignes. Dans ce cas, il faut utiliser le symbole > à chaque début de lignes constituant la citation.\n",
"\n",
"<u>Exemple</u> :\n",
"\n",
"> Ah ! non ! cest un peu court, jeune homme !\n",
">\n",
"> On pouvait dire… Oh ! Dieu ! … bien des choses en somme…\n",
">\n",
"> En variant le ton, par exemple, tenez :\n",
">\n",
"> Agressif : « Moi, monsieur, si javais un tel nez,\n",
">\n",
"> Il faudrait sur-le-champ que je me lamputasse ! »\n",
">\n",
"> Amical : « Mais il doit tremper dans votre tasse\n",
">\n",
"> Pour boire, faites-vous fabriquer un hanap ! »\n",
">\n",
"> Descriptif : « Cest un roc ! … cest un pic ! … cest un cap !\n",
">\n",
"> Que dis-je, cest un cap ? … Cest une péninsule ! »\n",
">\n",
"> Curieux : « De quoi sert cette oblongue capsule ?\n",
">\n",
"> Décritoire, monsieur, ou de boîte à ciseaux ? »\n",
">\n",
"> Gracieux : « Aimez-vous à ce point les oiseaux\n",
">\n",
"> Que paternellement vous vous préoccupâtes\n",
">\n",
"> De tendre ce perchoir à leurs petites pattes ? »\n",
">\n",
"> Truculent : « Ça, monsieur, lorsque vous pétunez,\n",
">\n",
"> La vapeur du tabac vous sort-elle du nez\n",
">\n",
"> Sans quun voisin ne crie au feu de cheminée ? »\n",
">\n",
"> Prévenant : « Gardez-vous, votre tête entraînée\n",
">\n",
"> Par ce poids, de tomber en avant sur le sol ! »\n",
">\n",
"> Tendre : « Faites-lui faire un petit parasol\n",
">\n",
"> De peur que sa couleur au soleil ne se fane ! »\n",
">\n",
"> Pédant : « Lanimal seul, monsieur, quAristophane\n",
">\n",
"> Appelle Hippocampéléphantocamélos\n",
">\n",
"> Dut avoir sous le front tant de chair sur tant dos ! »\n",
">\n",
"> Cavalier : « Quoi, lami, ce croc est à la mode ?\n",
">\n",
"> Pour pendre son chapeau, cest vraiment très commode ! »\n",
">\n",
"> Emphatique : « Aucun vent ne peut, nez magistral,\n",
">\n",
"> Tenrhumer tout entier, excepté le mistral ! »\n",
">\n",
"> Dramatique : « Cest la Mer Rouge quand il saigne ! »\n",
">\n",
"> Admiratif : « Pour un parfumeur, quelle enseigne ! »\n",
">\n",
"> Lyrique : « Est-ce une conque, êtes-vous un triton ? »\n",
">\n",
"> Naïf : « Ce monument, quand le visite-t-on ? »\n",
">\n",
"> Respectueux : « Souffrez, monsieur, quon vous salue,\n",
">\n",
"> Cest là ce qui sappelle avoir pignon sur rue ! »\n",
">\n",
"> Campagnard : « Hé, ardé ! Cest-y un nez ? Nanain !\n",
">\n",
"> Cest queuqunavet géant ou ben queuqumelon nain ! »\n",
">\n",
"> Militaire : « Pointez contre cavalerie ! »\n",
">\n",
"> Pratique : « Voulez-vous le mettre en loterie ?\n",
">\n",
"> Assurément, monsieur, ce sera le gros lot ! »\n",
">\n",
"> Enfin parodiant Pyrame en un sanglot :\n",
">\n",
"> « Le voilà donc ce nez qui des traits de son maître\n",
">\n",
"> A détruit lharmonie ! Il en rougit, le traître ! »\n",
">\n",
"> Voilà ce quà peu près, mon cher, vous mauriez dit\n",
">\n",
"> Si vous aviez un peu de lettres et desprit\n",
">\n",
"> Mais desprit, ô le plus lamentable des êtres,\n",
">\n",
"> Vous nen eûtes jamais un atome, et de lettres\n",
">\n",
"> Vous navez que les trois qui forment le mot : sot !\n",
">\n",
"> Eussiez-vous eu, dailleurs, linvention quil faut\n",
">\n",
"> Pour pouvoir là, devant ces nobles galeries,\n",
">\n",
"> me servir toutes ces folles plaisanteries,\n",
">\n",
"> Que vous nen eussiez pas articulé le quart\n",
">\n",
"> De la moitié du commencement dune, car\n",
">\n",
"> Je me les sers moi-même, avec assez de verve,\n",
">\n",
"> Mais je ne permets pas quun autre me les serve.\n",
"\n",
"## Listes\n",
"\n",
"Sauter une ligne avant le début de la liste.\n",
"\n",
"### Liste non ordonnée\n",
"\n",
"Pour créer une liste non ordonnée, il faut utiliser le symbole - pour chaque élément.\n",
"\n",
"<u>Exemple</u> :\n",
"Listes des fruits :\n",
"\n",
"- Pommes\n",
"- Poires\n",
"- Raisin\n",
"\n",
"Est obtenu par la syntaxe suivantes :\n",
"\n",
"```markdown\n",
"Listes des fruits :\n",
"\n",
"- Pommes\n",
"- Poires\n",
"- Raisin\n",
"```\n",
"\n",
"___N.B : Une ligne vide doit précéder la liste et un espace est nécessaire entre le symbole - et l'élément de la liste.___\n",
"\n",
"#### Remarque\n",
"\n",
"Il est possible d'imbriquer des listes. Pour cela, un espace est nécessaire entre l'élément parent et la liste imbriquée.\n",
"\n",
"<u>Exemple</u> :\n",
"Listes des fruits :\n",
"\n",
"- Pommes\n",
" - Golden\n",
" - Gala\n",
" - Pink Lady\n",
" - ...\n",
"- Poires\n",
"- Raisin\n",
" - Corinthe noir\n",
" - Muscat d'Alexandrie\n",
" \n",
"Est obtenu par la syntaxe suivantes :\n",
"\n",
"```markdown\n",
"Listes des fruits :\n",
"\n",
"- Pommes\n",
" - Golden\n",
" - Gala\n",
" - Pink Lady\n",
" - ...\n",
"- Poires\n",
"- Raisin\n",
" - Corinthe noir\n",
" - Muscat d'Alexandrie\n",
"```\n",
"\n",
"### Liste ordonnée\n",
"\n",
"Pour créer une liste ordonnée, il faut énumérer chaque élément précédé de son rang, d'un point et d'un espace.\n",
"\n",
"<u>Exemple</u> :\n",
"Liste ordonnée :\n",
"\n",
"1. premier élément\n",
"2. deuxième élément\n",
"3. troisième élément\n",
"\n",
"Est obtenu par la syntaxe suivantes :\n",
"\n",
"```markdown\n",
"Liste ordonnée :\n",
"\n",
"1. premier élément\n",
"2. deuxième élément\n",
"3. troisième élément\n",
"```\n",
"\n",
"#### Remarque 1\n",
"\n",
"La valeur du rang ne doit pas nécessairement être indiqué. C'est le fait que chaque élément se suive qui constitue la liste ordonnée.\n",
"\n",
"<u>Exemple</u> :\n",
"Liste ordonnée :\n",
"\n",
"1. premier élément\n",
"1. deuxième élément\n",
"1. troisième élément\n",
"\n",
"Est obtenu par la syntaxe suivante :\n",
"\n",
"```markdown\n",
"Liste ordonnée :\n",
"\n",
"1. premier élément\n",
"1. deuxième élément\n",
"1. troisième élément\n",
"```\n",
"\n",
"#### Remarque 2\n",
"\n",
"Comme pour les listes non ordonnées, il est possible d'imbriquer des listes ordonnées. Pour cela, un espace est nécessaire entre l'élément parent et la liste imbriquée.\n",
"\n",
"<u>Exemple</u> :\n",
"Liste ordonnée imbriquée:\n",
"\n",
"1. premier élément\n",
" 1. premier sous élément\n",
" 2. deuxième sous élément\n",
"2. deuxième élément\n",
"3. troisième élément\n",
" 1. premier sous élément\n",
"\n",
"Est obtenu par la syntaxe suivante :\n",
"\n",
"```markdown\n",
"Liste ordonnée imbriquée:\n",
"\n",
"1. premier élément\n",
" 1. premier sous élément\n",
" 2. deuxième sous élément\n",
"2. deuxième élément\n",
"3. troisième élément\n",
" 1. premier sous élément\n",
"```\n",
"\n",
"### Liste de cases à cocher\n",
"\n",
"Pour créer une liste de cases à cocher, il faut énumérer chaque élément précédé par `[ ]` pour une case non cochée et `[x]` pour une case cochée.\n",
"\n",
"<u>Exemple</u> :\n",
"Le langage Markdown a été créé par :\n",
"\n",
"- [x] John Gruber\n",
"- [ ] Guido van Rossum\n",
"- [x] Aaron Swartz\n",
"- [ ] Bill Gates\n",
"\n",
"Est obtenu par la syntaxe suivante :\n",
"```markdown\n",
"Le langage Markdown a été créé par :\n",
"\n",
"- [x] John Gruber\n",
"- [ ] Guido van Rossum\n",
"- [x] Aaron Swartz\n",
"- [ ] Bill Gates\n",
"```\n",
"\n",
"__N.B : Le texte entre crochets doit comporter un _seul et un seul caractère_. Soit un espace pour une case non cochée, soit un x pour une case cochée.__\n"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"## Titres\n",
"\n",
"Les titres sont créés avec un certain nombre de #(croisillons) avant le titre, qui correspondent au niveau de titre souhaité (de 1 à 6).\n",
"\n",
"<u>Exemple :</u>\n",
"\n",
"# un titre de premier niveau\n",
"#### un titre de quatrième niveau\n",
"\n",
"Est obtenu par la syntaxe suivante :\n",
"```\n",
"# un titre de premier niveau\n",
"#### un titre de quatrième niveau\n",
"```"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"## Tableaux\n",
"\n",
"Un tableau en Markdown est constitué de 3 éléments :\n",
"\n",
"1. une ligne d'en-tête\n",
"1. une ligne de séparation\n",
"1. un ensemble de lignes de corps du tableau\n",
"\n",
"<u>Exemple</u> :\n",
"\n",
"| Titre 1 | Titre 2 | Titre 3 |\n",
"| :-- | :--: | --: |\n",
"| Colonne | Colonne | Colonne |\n",
"| Alignée à | Alignée au | Alignée à |\n",
"| Gauche | Centre | Droite |\n",
"\n",
"\n",
"Est obtenu par la syntaxe suivante :\n",
"```\n",
"| Titre 1 | Titre 2 | Titre 3 |\n",
"| :-- | :--: | --: |\n",
"| Colonne | Colonne | Colonne |\n",
"| Alignée à | Alignée au | Alignée à |\n",
"| Gauche | Centre | Droite |\n",
"```\n",
"\n",
"### En-tête\n",
"\n",
"L'en-tête contient chaque titre de colonnes, séparés par un symbole |. Le titre sera automatiquement mis en gras.\n",
"\n",
"### Séparation\n",
"\n",
"La ligne de séparation permet de délimiter l'en-tête du corps du tableau et de définir l'alignement du texte du contenu de la colonne.\n",
"\n",
"- `:--`: indique que le contenu est aligné à gauche de la colonne,\n",
"- `:--:`: indique que le contenu est centré,\n",
"- `--:`: indique que le contenu est aligné à droite de la colonne.\n",
"\n",
"### Corps\n",
"\n",
"Chaque ligne du corps du tableau contient le contenu de chaque colonne séparé par un symbole |. La couleur du fond de chaque ligne du tableau est alternée automatiquement."
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"## Liens\n",
"\n",
"Pour créer des liens de type url cliquable, il faut utiliser la syntaxe `[texte du lien](url_du_lien)`.\n",
"\n",
"<u>Exemple</u> : [Site du lycée Masséna](http://www.lycee-massena.fr/)\n",
"\n",
"Est obtenu par la syntaxe :\n",
"```\n",
"[Site du lycée Masséna](http://www.lycee-massena.fr/)\n",
"```\n",
"__N.B : il n'y a pas d'espace entre le crochet fermant et la parenthèse ouvrante. Il faut écrire ..lien](url.. et non ..lien] (url.. )__"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"## Images\n",
"\n",
"Pour afficher une image, il faut utiliser la syntaxe `![Texte alternatif](url_de_l'image)`\n",
"\n",
"<u>Exemple</u> : ![Logo Markdown](https://upload.wikimedia.org/wikipedia/commons/thumb/4/48/Markdown-mark.svg/208px-Markdown-mark.svg.png)\n",
"\n",
"Est obtenu par la syntaxe :\n",
"```\n",
"![Logo Markdown](https://upload.wikimedia.org/wikipedia/commons/thumb/4/48/Markdown-mark.svg/208px-Markdown-mark.svg.png)\n",
"```\n",
"__N.B : il n'y a pas d'espace entre le crochet fermant et la parenthèse ouvrante. Il faut écrire ..lien](url.. et non ..lien] (url.. )__"
]
}
],
"metadata": {
"kernelspec": {
"display_name": "Python 3 (ipykernel)",
"language": "python",
"name": "python3"
},
"language_info": {
"codemirror_mode": {
"name": "ipython",
"version": 3
},
"file_extension": ".py",
"mimetype": "text/x-python",
"name": "python",
"nbconvert_exporter": "python",
"pygments_lexer": "ipython3",
"version": "3.8.8"
}
},
"nbformat": 4,
"nbformat_minor": 2
}

View File

@@ -0,0 +1,25 @@
# Activité - Markdown
## Objectifs
L'activité a pour but d'appréhender le langage de balisage __Markdown__.
Ce langage vous sera utile cette année pour __annoter__ les cours, __réaliser des travaux__ (TD, TP..) et préparer des __présentations__.
## Consignes
- Un guide de la syntaxe Markdown est fournie via le document : [MARKDOWN](./MARKDOWN.ipynb)
- Une fiche concernant Guido Van Rossum, créateur du langage Python est fournie sous la forme du fichier pdf : [GUIDO.pdf](./GUIDO.pdf)
- Vous devez créer un fichier Markdown (extension .md), via le logiciel stakedit.io reproduisant le contenu et la forme de la fiche de Guido Van Rossum
## Méthodologie de travail
Vous devez procéder par étape :
1. Lire le guide et tester la syntaxe markdown en reproduisant les différents exemples,
2. Lire la fiche pdf de Guido Van Rossum et identifier les éléments Titre, formatté, tableaux, listes...
3. Écrire la fiche au format Markdown via le logiciel en ligne [stackedit.io](https://stackedit.io)
4. Exporter la fiche sous la forme d'un fichier `.md`.