From a15bfbbd7861d29a2c5c8e3ab64cd429bebe11fa Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micka=C3=ABl=20Schoentgen?= <contact@tiger-222.fr>
Date: Wed, 7 Feb 2024 18:50:45 +0100
Subject: [PATCH] feat: support drafts

---
 .aspell.fr.pws                                |  4 +-
 build.sh                                      |  8 ++-
 sources/brouillons/diff-metadata.md           | 34 +++++++++
 sources/brouillons/images/dusk-logo.svg       |  3 +
 sources/brouillons/node-dusk.md               | 69 +++++++++++++++++++
 sources/brouillons/snippets/diff-metadata.c   | 25 +++++++
 .../brouillons/snippets/diff-metadata.diff    | 12 ++++
 sources/conf.py                               |  4 ++
 sources/index.rst                             |  6 ++
 9 files changed, 163 insertions(+), 2 deletions(-)
 create mode 100644 sources/brouillons/diff-metadata.md
 create mode 100644 sources/brouillons/images/dusk-logo.svg
 create mode 100644 sources/brouillons/node-dusk.md
 create mode 100644 sources/brouillons/snippets/diff-metadata.c
 create mode 100644 sources/brouillons/snippets/diff-metadata.diff

diff --git a/.aspell.fr.pws b/.aspell.fr.pws
index 5825a72..004fc20 100644
--- a/.aspell.fr.pws
+++ b/.aspell.fr.pws
@@ -1,4 +1,4 @@
-personal_ws-1.1 fr 239 
+personal_ws-1.1 fr 241 
 AVAX
 Aborted
 Add
@@ -22,6 +22,7 @@ DIP
 DNS
 Debian
 Deploy
+Dusk
 EKO
 EVO
 Ethereum
@@ -217,6 +218,7 @@ staker
 staking
 stream
 sup
+tDUSK
 tags
 teacher
 than
diff --git a/build.sh b/build.sh
index c014249..b64f488 100755
--- a/build.sh
+++ b/build.sh
@@ -4,6 +4,8 @@ SRC_DIR='sources'
 DST_DIR='luma'
 
 dev_live() {
+    [ -d '_live' ] && /bin/rm -rv '_live'
+
     sphinx-autobuild \
         --host '0.0.0.0' \
         --open-browser \
@@ -40,4 +42,8 @@ build_blog() {
     python minify.py
 }
 
-[ "${1}" == 'live' ] && dev_live || build_blog
+if [ "${1}" == 'live' ]; then
+    dev_live
+else
+    build_blog
+fi
diff --git a/sources/brouillons/diff-metadata.md b/sources/brouillons/diff-metadata.md
new file mode 100644
index 0000000..6dbba17
--- /dev/null
+++ b/sources/brouillons/diff-metadata.md
@@ -0,0 +1,34 @@
+# Comprendre les méta-données de diff
+
+Voici la sortie de `git diff` sur un fichier lambda :
+
+```{literalinclude} snippets/diff-metadata.diff
+    :caption: https://github.com/gorakhargosh/watchdog/issues/1025
+    :linenos:
+    :emphasize-lines: 2
+    :language: diff
+```
+
+Voyons de quoi se compose la ligne n° 2 :
+
+```{literalinclude} snippets/diff-metadata.diff
+    :lines: 2
+    :language: diff
+```
+
+```{literalinclude} snippets/diff-metadata.c
+    :caption: diff.c
+    :lines: 2-
+    :language: c
+```
+
+---
+
+## 🎣 Sources
+
+- [git/git diff.c](https://github.com/git/git/blob/v2.43.0/diff.c#L4480-L4484)
+
+## 📜 Historique
+
+2024-02-07
+: Premier jet.
diff --git a/sources/brouillons/images/dusk-logo.svg b/sources/brouillons/images/dusk-logo.svg
new file mode 100644
index 0000000..8550126
--- /dev/null
+++ b/sources/brouillons/images/dusk-logo.svg
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:8142a9f6586d4f53815a464277edb0cdc0ca0c71229a951152402ef1f48e42ee
+size 1055
diff --git a/sources/brouillons/node-dusk.md b/sources/brouillons/node-dusk.md
new file mode 100644
index 0000000..931a4c2
--- /dev/null
+++ b/sources/brouillons/node-dusk.md
@@ -0,0 +1,69 @@
+# Comment déployer un nœud Dusk ?
+
+```{figure} images/dusk-logo.svg
+ :width: 96
+  :height: 96
+  :alt: NuLink Logo
+  :align: center
+
+  Site web : [dusk.network](https://dusk.network)
+```
+
+```{attention}
+Cet article est en cours de rédaction.
+```
+
+Ce guide est une traduction libre et simplifiée de la [documentation officielle](https://docs.nulink.org/products/stakers/nulink_worker/) pour le déploiement d'un nœud Dusk, plus communément appelé *node validator*, *worker node* ou encore *staker node*.
+
+Configuration requise :
+
+- système d'exploitation : **Debian** GNU/Linux
+- architecture : x86-64
+- espace disque : 250 Gio
+- mémoire : 4 Gio de RAM
+
+À savoir, il te faudra 2 comptes :
+1. un compte *staker* qui *stake* ses [tDUSK](https://testnet.bscscan.com/token/0xa22bfb00be8938c50833bfd2444ec721a9eeacc1), n'importe quel compte Metamask ou Rabby fait l'affaire ;
+2. un compte *worker* qui sera lié au compte *staker* (on parle de *bond* en anglais), et nous allons voir tout de suite comment le générer.
+
+---
+
+## Avant-propos
+
+Les futures commandes à taper dans une console sont précédées par une légende pour indiquer sur quel environnement elles doivent être exécutées.
+
+Exemple avec une commande qui devra être tapée dans la console de ton ordinateur (PC) :
+
+```{code-block} shell
+    :caption: 🖥️ Ordinateur (PC)
+
+echo "Coucou depuis l'ordi !"
+```
+
+Et une commande qui devra être tapée dans la console du serveur (VPS, pour *Virtual Private Server*) sur lequel le nœud sera déployé :
+
+```{code-block} shell
+    :caption: ☁️ Serveur (VPS)
+
+echo 'Coucou depuis le serveur !'
+```
+
+```{tip}
+Chaque commande peut être copiée/collée directement depuis cet article vers ta console (il y a une icône qui apparait en haut à droite de chaque bloc de code quand la souris passe dessus).
+Quand il y a une partie de la commande a modifier manuellement :
+- je le préciserai en amont ;
+- la légende du bloc de code contiendra l'émoji ✍️ ;
+- la/les ligne en question sera surlignée.
+```
+
+```{tip}
+Afin de vérifier qu'une commande se soit terminée avec succès, tu dois voir que la dernière ligne affichée dans la console, après l'avoir exécutée, devra être "OK".
+Si ce n'est pas le cas, il y a eu une erreur.
+```
+
+---
+
+## 📜 Historique
+
+2024-01-27
+: Premier jet.
diff --git a/sources/brouillons/snippets/diff-metadata.c b/sources/brouillons/snippets/diff-metadata.c
new file mode 100644
index 0000000..6364503
--- /dev/null
+++ b/sources/brouillons/snippets/diff-metadata.c
@@ -0,0 +1,25 @@
+/* https://github.com/git/git/blob/v2.43.0/diff.c#L4480-L4484 */
+static void fill_metainfo(
+    struct strbuf *msg,
+    const char *name,
+    const char *other,
+    struct diff_filespec *one,
+    struct diff_filespec *two,
+    struct diff_options *o,
+    struct diff_filepair *p,
+    int *must_show_header,
+    int use_color
+) {
+    /* (...) */
+    strbuf_addf(
+        msg,
+        "%s%sindex %s..%s",
+        line_prefix,
+        set,
+        diff_abbrev_oid(&one->oid, abbrev),
+        diff_abbrev_oid(&two->oid, abbrev)
+    );
+    if (one->mode == two->mode) {
+        strbuf_addf(msg, " %06o", one->mode);
+    }
+}
diff --git a/sources/brouillons/snippets/diff-metadata.diff b/sources/brouillons/snippets/diff-metadata.diff
new file mode 100644
index 0000000..bfa0205
--- /dev/null
+++ b/sources/brouillons/snippets/diff-metadata.diff
@@ -0,0 +1,12 @@
+diff --git a/setup.py b/setup.py
+index 320d951..644d2b7 100644
+--- a/setup.py
++++ b/setup.py
+@@ -71,6 +71,7 @@ if is_macos or os.getenv("FORCE_MACOS_MACHINE", "0") == "1":
+                 "-Wno-newline-eof",
+                 # required w/Xcode 5.1+ and above because of '-mno-fused-madd'
+                 "-Wno-error=unused-command-line-argument",
++                "-mmacosx-version-min=10.13",
+             ],
+         ),
+     ]
diff --git a/sources/conf.py b/sources/conf.py
index 3a88079..287e958 100644
--- a/sources/conf.py
+++ b/sources/conf.py
@@ -71,3 +71,7 @@
     "source_docs_path": "/sources/",
     "source_version": "main",
 }
+
+# Do not include drafts when deploying to production
+if sys.argv[0].endswith("sphinx-build"):
+    exclude_patterns = ["brouillons/**"]
diff --git a/sources/index.rst b/sources/index.rst
index bfc79da..b3cae51 100644
--- a/sources/index.rst
+++ b/sources/index.rst
@@ -10,6 +10,12 @@ Base de Connaissances du `Luma`_
     :alt: Logo
     :align: center
 
+.. toctree::
+    :caption: 🚧 Brouillons
+    :glob:
+
+    brouillons/*
+
 .. toctree::
     :caption: 👾 Blockchain
     :glob: