documentation: convertit le policopié en markdown

- Convertit et commence à corriger le polycopié au format markdown.
- Ajoute un export biblatex des références utilisées.
- Crée un dossier media avec les images utilisées dans le polycopié.

Co-Authored-by: iGor milhit <igor.milhit@unige.ch>

.gitignore

@@ -1,2 +1,317 @@
 *.pdf
 *.html
+
+# Created by https://www.toptal.com/developers/gitignore/api/latex
+# Edit at https://www.toptal.com/developers/gitignore?templates=latex
+
+### LaTeX ###
+## Core latex/pdflatex auxiliary files:
+*.aux
+*.lof
+*.log
+*.lot
+*.fls
+*.out
+*.toc
+*.fmt
+*.fot
+*.cb
+*.cb2
+.*.lb
+
+## Intermediate documents:
+*.dvi
+*.xdv
+*-converted-to.*
+# these rules might exclude image files for figures etc.
+# *.ps
+# *.eps
+# *.pdf
+
+## Generated if empty string is given at "Please type another file name for output:"
+.pdf
+
+## Bibliography auxiliary files (bibtex/biblatex/biber):
+*.bbl
+*.bcf
+*.blg
+*-blx.aux
+*-blx.bib
+*.run.xml
+
+## Build tool auxiliary files:
+*.fdb_latexmk
+*.synctex
+*.synctex(busy)
+*.synctex.gz
+*.synctex.gz(busy)
+*.pdfsync
+
+## Build tool directories for auxiliary files
+# latexrun
+latex.out/
+
+## Auxiliary and intermediate files from other packages:
+# algorithms
+*.alg
+*.loa
+
+# achemso
+acs-*.bib
+
+# amsthm
+*.thm
+
+# beamer
+*.nav
+*.pre
+*.snm
+*.vrb
+
+# changes
+*.soc
+
+# comment
+*.cut
+
+# cprotect
+*.cpt
+
+# elsarticle (documentclass of Elsevier journals)
+*.spl
+
+# endnotes
+*.ent
+
+# fixme
+*.lox
+
+# feynmf/feynmp
+*.mf
+*.mp
+*.t[1-9]
+*.t[1-9][0-9]
+*.tfm
+
+#(r)(e)ledmac/(r)(e)ledpar
+*.end
+*.?end
+*.[1-9]
+*.[1-9][0-9]
+*.[1-9][0-9][0-9]
+*.[1-9]R
+*.[1-9][0-9]R
+*.[1-9][0-9][0-9]R
+*.eledsec[1-9]
+*.eledsec[1-9]R
+*.eledsec[1-9][0-9]
+*.eledsec[1-9][0-9]R
+*.eledsec[1-9][0-9][0-9]
+*.eledsec[1-9][0-9][0-9]R
+
+# glossaries
+*.acn
+*.acr
+*.glg
+*.glo
+*.gls
+*.glsdefs
+*.lzo
+*.lzs
+*.slg
+*.slo
+*.sls
+
+# uncomment this for glossaries-extra (will ignore makeindex's style files!)
+# *.ist
+
+# gnuplot
+*.gnuplot
+*.table
+
+# gnuplottex
+*-gnuplottex-*
+
+# gregoriotex
+*.gaux
+*.glog
+*.gtex
+
+# htlatex
+*.4ct
+*.4tc
+*.idv
+*.lg
+*.trc
+*.xref
+
+# hyperref
+*.brf
+
+# knitr
+*-concordance.tex
+# TODO Uncomment the next line if you use knitr and want to ignore its generated tikz files
+# *.tikz
+*-tikzDictionary
+
+# listings
+*.lol
+
+# luatexja-ruby
+*.ltjruby
+
+# makeidx
+*.idx
+*.ilg
+*.ind
+
+# minitoc
+*.maf
+*.mlf
+*.mlt
+*.mtc[0-9]*
+*.slf[0-9]*
+*.slt[0-9]*
+*.stc[0-9]*
+
+# minted
+_minted*
+*.pyg
+
+# morewrites
+*.mw
+
+# newpax
+*.newpax
+
+# nomencl
+*.nlg
+*.nlo
+*.nls
+
+# pax
+*.pax
+
+# pdfpcnotes
+*.pdfpc
+
+# sagetex
+*.sagetex.sage
+*.sagetex.py
+*.sagetex.scmd
+
+# scrwfile
+*.wrt
+
+# svg
+svg-inkscape/
+
+# sympy
+*.sout
+*.sympy
+sympy-plots-for-*.tex/
+
+# pdfcomment
+*.upa
+*.upb
+
+# pythontex
+*.pytxcode
+pythontex-files-*/
+
+# tcolorbox
+*.listing
+
+# thmtools
+*.loe
+
+# TikZ & PGF
+*.dpth
+*.md5
+*.auxlock
+
+# titletoc
+*.ptc
+
+# todonotes
+*.tdo
+
+# vhistory
+*.hst
+*.ver
+
+# easy-todo
+*.lod
+
+# xcolor
+*.xcp
+
+# xmpincl
+*.xmpi
+
+# xindy
+*.xdy
+
+# xypic precompiled matrices and outlines
+*.xyc
+*.xyd
+
+# endfloat
+*.ttt
+*.fff
+
+# Latexian
+TSWLatexianTemp*
+
+## Editors:
+# WinEdt
+*.bak
+*.sav
+
+# Texpad
+.texpadtmp
+
+# LyX
+*.lyx~
+
+# Kile
+*.backup
+
+# gummi
+.*.swp
+
+# KBibTeX
+*~[0-9]*
+
+# TeXnicCenter
+*.tps
+
+# auto folder when using emacs and auctex
+./auto/*
+*.el
+
+# expex forward references with \gathertags
+*-tags.tex
+
+# standalone packages
+*.sta
+
+# Makeindex log files
+*.lpz
+
+# xwatermark package
+*.xwm
+
+# REVTeX puts footnotes in the bibliography by default, unless the nofootinbib
+# option is specified. Footnotes are the stored in a file with suffix Notes.bib.
+# Uncomment the next line to have this generated file ignored.
+#*Notes.bib
+
+### LaTeX Patch ###
+# LIPIcs / OASIcs
+*.vtc
+
+# glossaries
+*.glstex
+
+# End of https://www.toptal.com/developers/gitignore/api/latex

exercice/README.md

@@ -0,0 +1,21 @@
+---
+title: Dossier `exercice`.
+date: 2023-03-29T08:45:28+02:00
+id: 20230329084537
+tags: [latex, exercice]
+---
+
+## Exercice
+
+Dans ce dossier se trouvent deux fichiers qui seront utilisés au cours de la
+formation :
+
+- `exercice.tex`, un pseudo article minimal, en français, dans lequel il faut
+  ajoute des appels à citation et des références bibliographiques.
+- `references-exercice.bib`, la base de données des références bibliographiques
+  utilisées dans l'article.
+
+Pour réaliser l'exercice, il faut un environnement LaTeX disposant de Biber et
+de pdfLaTeX ou XeLaTeX, si l'on veut travailler en local. Une autre solution
+est d'utiliser la plateforme <https://www.overleaf.com/>.
+

exercice/exercice.tex

@@ -10,20 +10,15 @@
 % Sets language with the babel package instead of polyglossia
 % Declares the encoding type of the source file
 \usepackage[utf8]{inputenc}
+% URL and link management. Mandatory for Vancouver
+\usepackage{hyperref}
 \usepackage{csquotes}
 \usepackage[main=french]{babel}
 % Uses modern font (better rendering)
 \usepackage{lmodern}
-
 % Sets the encoding of the output file
 \usepackage[T1]{fontenc}
-% URL and link management. Mandatory for Vancouver
+\usepackage[style=numeric,
-\usepackage{hyperref}
-% Loads the BibLaTeX package, with options
-% \usepackage[citestyle=numeric,
-%             style=vancouver,
-%             backend=biber]{biblatex}
-\usepackage[style=apa,
                       backend=biber]{biblatex}
 % Declares the bibliographic database file
 \addbibresource{references-exercice.bib}
@@ -38,11 +33,11 @@
 \section{Introduction}
 
 Dans ce pseudo-travail, nous prétendons introduire notre sujet, comme la
-littérature le conseille généralement \autocite{bohemierBibTeXNatbibBiblatex}.
+littérature le conseille généralement.
 
 Une bonne introduction annonce aux lecteurs et lectrices un certain nombre
 d'éléments indispensables au sujet de l'article qu'elles et ils vont lire,
-comme le suggèrent \autocite{sauvayreMethodesEntretienSciences2013}.
+comme le suggèrent <author>.
 
 \section{Première partie}
 
@@ -54,10 +49,11 @@ levels of effort, and users generally prefer the tools that involve less
 effort. We also found that although reference managers share similar features,
 differences in presentation and organization matter. We conclude this work by
 providing a set of guidelines for both users and developers of reference
-managers. \autocite{caiWhatMakesGood2021}
+managers.
 \end{quote}
 
 \newpage
+
 % Print the bibliography 
 \printbibliography