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: