From 1a97286bb088b35daf51bc665909d231cf89fda6 Mon Sep 17 00:00:00 2001 From: Fred Pauchet Date: Sat, 10 Sep 2022 17:11:20 +0200 Subject: [PATCH] Implement color boxes That can be used for advices, dangers or memorization --- chapters/introduction.tex | 22 +++++++----- chapters/models.tex | 13 +++---- chapters/working-in-isolation.tex | 6 ++-- gwiftemplate.sty | 58 +++++++++++++++++++++++++++++++ main.tex | 1 + 5 files changed, 82 insertions(+), 18 deletions(-) create mode 100644 gwiftemplate.sty diff --git a/chapters/introduction.tex b/chapters/introduction.tex index c4b0c9c..fce2556 100755 --- a/chapters/introduction.tex +++ b/chapters/introduction.tex @@ -62,7 +62,7 @@ A la fin de cette partie, vous disposerez d'un code propre et d'un projet foncti \textbf{Dans la deuxième partie}, nous aborderons les grands principes de modélisation, en suivant les lignes de conduites du cadre de travail. Nous aborderons les concepts clés qui permettent à une application de rester maintenable, les formulaires, leurs validations, comment gérer les données en entrée, les migrations de données et l'administration. -\textbf{Dans la troisième partie}, nous détaillerons précisément les étapes de déploiement, avec la description et la configuration de l'infrastructure, des exemples concrets de mise à disposition sur deux distributions principales (Debian et CentOS), sur une \emph{*Plateform as a Service*}, ainsi que l'utilisation de Docker et Docker-Compose. +\textbf{Dans la troisième partie}, nous détaillerons précisément les étapes de déploiement, avec la description et la configuration de l'infrastructure, des exemples concrets de mise à disposition sur deux distributions principales (Debian et Ubuntu)\index{Debian}\index{Ubuntu}, sur une \emph{Plateform as a Service}\index{Platform as a Service}\index{PaaS}, ainsi que l'utilisation de Docker et Docker-Compose. Nous aborderons également la supervision et la mise à jour d'une application existante, en respectant les bonnes pratiques d'administration système. @@ -82,9 +82,9 @@ Ensuite, ce livre s'adresse autant \item au néophyte qui souhaite se lancer dans le développement Web \item - qu'à l'artisan qui a besoin d'un aide-mémoire et qui ne se rappelle plus toujours du bon ordre des paramètres, + à l'artisan qui a besoin d'un aide-mémoire et qui ne se rappelle plus toujours du bon ordre des paramètres, \item - ou à l'expert qui souhaiterait avoir un aperçu d'une autre technologie que son domaine privilégié de compétences. + à l'expert qui souhaiterait avoir un aperçu d'une autre technologie que son domaine privilégié de compétences. \end{enumerate} Beaucoup de concepts présentés peuvent être oubliés ou restés inconnus jusqu'au moment où ils seront réellement nécessaires: à ce moment-là, pour peu que votre mémoire ait déjà entraperçu le terme, il vous sera plus facile d'y revenir et de l'appliquer. @@ -107,15 +107,21 @@ Restez curieux, ne vous enclavez pas dans une technologie en particulie et garde \subsection*{Conventions} + + Les notes indiquent des anecdotes. -Les conseils indiquent des éléments utiles, mais pas spécialemen indispensables. -Les notes importantes indiquent des éléments à retenir. +\begin{advicebox} + Les conseils indiquent des éléments que nous utilisons personnellement. +\end{advicebox} -Ces éléments indiquent des points d'attention. -Les retenir vous fer gagner du temps en débuggage. +\begin{memorizebox} + Les notes importantes indiquent des éléments à retenir. +\end{memorizebox} -Les avertissements indiquent un (potentiel) danger ou des élément pouvant amener des conséquences pas spécialement sympathiques. +\begin{dangerbox} + Les avertissements indiquent un (potentiel) danger ou des élément pouvant amener des conséquences pas spécialement sympathiques. +\end{dangerbox} Les morceaux de code source seront présentés de la manière suivante: diff --git a/chapters/models.tex b/chapters/models.tex index 4bd99de..f553a0b 100755 --- a/chapters/models.tex +++ b/chapters/models.tex @@ -411,14 +411,11 @@ informations = ( ) \end{minted} - -DANGER: Les requêtes sont sensibles à la casse, \textbf{même} si le -moteur de base de données ne l'est pas. C'est notamment le cas pour -Microsoft SQL Server; faire une recherche directement via les outils de -Microsoft ne retournera pas obligatoirement les mêmes résultats que les -managers, qui seront beaucoup plus tatillons sur la qualité des -recherches par rapport aux filtres paramétrés en entrée. - +\begin{dangerbox} + Les requêtes sont sensibles à la casse, \textbf{même} si le moteur de base de données ne l'est pas. + C'est notamment le cas pour Microsoft SQL Server: faire une recherche directement via les outils de + Microsoft ne retournera pas obligatoirement les mêmes résultats que les managers, qui seront beaucoup plus tatillons sur la qualité des recherches par rapport aux filtres paramétrés en entrée. +\end{dangerbox} \begin{verbatim} diff --git a/chapters/working-in-isolation.tex b/chapters/working-in-isolation.tex index daec278..7f79c58 100755 --- a/chapters/working-in-isolation.tex +++ b/chapters/working-in-isolation.tex @@ -103,8 +103,10 @@ Cette séparation évite que l'environnement virtuel ne se trouve dans le même Elle évite également de rendre ce répertoire "visible" - il ne s'agit au fond que d'un paramètre de configuration lié uniquement à votre environnement de développement; les environnements virtuels étant disposables, il n'est pas conseillé de trop les lier au projet qui l'utilise comme base. Dans la suite de ce chapitre, je considérerai ces mêmes répertoires, mais n'hésitez pas à les modifier. -DANGER: Indépendamment de l'endroit où vous stockerez le répertoire contenant cet environnement, il est primordial de \textbf{ne pas le conserver dans votre dépôt de stockage}. -Cela irait à l'encontre des douze facteurs, cela polluera inutilement vos sources et créera des conflits avec l'environnement des personnes qui souhaiteraient intervenir sur le projet. +\begin{dangerbox} + Indépendamment de l'endroit où vous stockerez le répertoire contenant cet environnement, il est primordial de \textbf{ne pas le conserver dans votre dépôt de stockage}. + Cela irait à l'encontre des douze facteurs, cela polluera inutilement vos sources et créera des conflits avec l'environnement des personnes qui souhaiteraient intervenir sur le projet. +\end{dangerbox} Pur créer notre répertoire de travail et notre environnement virtuel, exécutez les commandes suivantes: diff --git a/gwiftemplate.sty b/gwiftemplate.sty new file mode 100644 index 0000000..4d333e5 --- /dev/null +++ b/gwiftemplate.sty @@ -0,0 +1,58 @@ +% %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% % +% Package definition +% %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% % +\ProvidesPackage{gwiftemplate} + +% %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% % +% Required Package +% %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% % +\RequirePackage{xcolor} +\RequirePackage{tcolorbox} + +% Color definition +\definecolor{ffg_darkblue}{RGB}{21,29,76} +\definecolor{ffg_lightblue}{RGB}{0, 120, 190} +\definecolor{ffg_red}{RGB}{241, 83, 60} + +\definecolor{ffg_title_color}{RGB}{12, 97, 158} +\definecolor{ffg_section_color}{RGB}{24, 146, 239} + +\definecolor{footer_color}{RGB}{128, 128, 128} +\definecolor{flyingblue}{RGB}{49, 123, 181} +\definecolor{greymoreknowledge}{RGB}{200, 200, 200} + +% %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% % +% Define colorbox +% %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% % +\newtcolorbox{knowledgebox}{colback=ffg_red!5!white, colframe=ffg_red!100!black, fonttitle=\bfseries, title={Savoir}, breakable} %breakable +\newtcolorbox{skillsbox}{fonttitle=\bfseries, title={Savoir faire}, breakable} %breakable + +\newenvironment{advicebox} + { + \begin{tcolorbox}[colback=flyingblue!5!white, colframe=flyingblue!100!black,title={Conseils}] + } + { + \end{tcolorbox} + } + +\newenvironment{memorizebox} + { + \begin{tcolorbox}[colback=greymoreknowledge!5!white, colframe=greymoreknowledge!100!black,title={À retenir}] + } + { + \end{tcolorbox} + } + +\newenvironment{dangerbox} + { + \begin{tcolorbox}[colback=red!5!white,colframe=red!75!black,title={Important}] + } + { + \end{tcolorbox} + } + +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +% References +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +% +% https://sources.grimbox.be/Sulley/layout_syllabus_ffg/src/branch/master/ffgTemplate.sty diff --git a/main.tex b/main.tex index ac3406a..24259c6 100755 --- a/main.tex +++ b/main.tex @@ -13,6 +13,7 @@ \usepackage{float} \usepackage[export]{adjustbox} +\usepackage{gwiftemplate} \renewcommand\listlistingname{Liste des morceaux de code}